@iann29/rastro 0.4.0 → 0.5.0

package/dist/component/trackedLinks.js

@@ -0,0 +1,314 @@
+import { v } from "convex/values";
+import { internal } from "./_generated/api.js";
+import { internalMutation, mutation, query } from "./_generated/server.js";
+import { DAY_MS, MAX_TRACKED_LINKS_PER_SITE, TRACKED_LINK_CLICK_SHARDS, } from "./constants.js";
+import { fail } from "./errors.js";
+import { cleanString, originAllowed, sanitizeOpaqueId } from "./sanitize.js";
+import { trackedLinkChannelValidator, trackedLinkFieldsValidator, } from "./validators.js";
+const SLUG = /^[a-z0-9][a-z0-9-]{1,30}[a-z0-9]$/;
+const PLATFORM = /^[a-z0-9_]{2,24}$/;
+const MAX_DESTINATION_LENGTH = 2048;
+const MAX_CAMPAIGN_LENGTH = 64;
+const RECENT_DAYS = 30;
+// Each shard's all-time counter sits beside the daily ones under this day, so
+// a link's total is TRACKED_LINK_CLICK_SHARDS rows however long it has lived.
+const ALL_TIME = 0;
+const PURGE_BATCH = 500;
+const trackedLinkDocumentValidator = trackedLinkFieldsValidator.extend({
+    _id: v.id("trackedLinks"),
+    _creationTime: v.number(),
+});
+const redirectValidator = trackedLinkFieldsValidator.pick("slug", "destination", "platform", "channel", "campaign");
+export function isTrackedLinkSlug(value) {
+    return SLUG.test(value);
+}
+/**
+ * Where a click lands: the destination with the link's utm_* appended. A key
+ * the destination already carries wins, and its own query keeps its exact
+ * encoding because the tags are appended as text.
+ */
+export function trackedLinkLocation(link) {
+    const url = new URL(link.destination);
+    const utm = [
+        ["utm_source", link.platform],
+        ["utm_medium", link.channel],
+        ["utm_campaign", link.campaign ?? link.slug],
+        ["utm_content", link.slug],
+    ];
+    const tags = new URLSearchParams(utm.filter(([key]) => !url.searchParams.has(key))).toString();
+    if (tags)
+        url.search = url.search ? `${url.search}&${tags}` : `?${tags}`;
+    return url.href;
+}
+function sanitizeLinkSlug(value) {
+    const slug = value.trim().toLowerCase();
+    if (!isTrackedLinkSlug(slug)) {
+        fail("INVALID_ARGUMENT", "slug must be 3 to 32 lowercase letters, digits or hyphens, starting and ending with a letter or digit");
+    }
+    return slug;
+}
+function sanitizePlatform(value) {
+    const platform = value.trim().toLowerCase();
+    if (!PLATFORM.test(platform)) {
+        fail("INVALID_ARGUMENT", "platform must be 2 to 24 lowercase letters, digits or underscores");
+    }
+    return platform;
+}
+function sanitizeCampaign(value) {
+    return value === undefined
+        ? undefined
+        : cleanString(value, MAX_CAMPAIGN_LENGTH) || undefined;
+}
+// No open redirect: the destination is an absolute http(s) URL on one of the
+// site's own domains, the same rule the ingestion origin check applies.
+function sanitizeDestination(value, domains) {
+    let url;
+    try {
+        if (value.length <= MAX_DESTINATION_LENGTH) {
+            url = new URL(cleanString(value, MAX_DESTINATION_LENGTH));
+        }
+    }
+    catch {
+        url = undefined;
+    }
+    if (!url ||
+        (url.protocol !== "http:" && url.protocol !== "https:") ||
+        url.username ||
+        url.password) {
+        fail("INVALID_ARGUMENT", "destination must be an absolute http(s) URL without credentials");
+    }
+    if (!originAllowed(url.href, domains)) {
+        fail("INVALID_ARGUMENT", "destination must be on one of the site's domains");
+    }
+    return url.href;
+}
+export const create = mutation({
+    args: {
+        siteId: v.id("sites"),
+        slug: v.string(),
+        destination: v.string(),
+        platform: v.string(),
+        channel: trackedLinkChannelValidator,
+        campaign: v.optional(v.string()),
+        createdBy: v.string(),
+    },
+    returns: v.id("trackedLinks"),
+    handler: async (ctx, args) => {
+        const site = await ctx.db.get("sites", args.siteId);
+        if (!site)
+            fail("NOT_FOUND", "site not found");
+        const slug = sanitizeLinkSlug(args.slug);
+        const destination = sanitizeDestination(args.destination, site.domains);
+        const platform = sanitizePlatform(args.platform);
+        let createdBy;
+        try {
+            createdBy = sanitizeOpaqueId(args.createdBy, "createdBy");
+        }
+        catch (error) {
+            fail("INVALID_ARGUMENT", error instanceof Error ? error.message : "invalid createdBy");
+        }
+        const taken = await ctx.db
+            .query("trackedLinks")
+            .withIndex("by_slug", (range) => range.eq("slug", slug))
+            .unique();
+        if (taken)
+            fail("CONFLICT", "another tracked link already uses this slug");
+        const links = await ctx.db
+            .query("trackedLinks")
+            .withIndex("by_siteId", (range) => range.eq("siteId", args.siteId))
+            .take(MAX_TRACKED_LINKS_PER_SITE);
+        if (links.length >= MAX_TRACKED_LINKS_PER_SITE) {
+            fail("LIMIT_EXCEEDED", "tracked link limit reached", {
+                limit: MAX_TRACKED_LINKS_PER_SITE,
+            });
+        }
+        return await ctx.db.insert("trackedLinks", {
+            siteId: args.siteId,
+            slug,
+            destination,
+            platform,
+            channel: args.channel,
+            campaign: sanitizeCampaign(args.campaign),
+            createdAt: Date.now(),
+            createdBy,
+        });
+    },
+});
+/** Everything but the slug, which every link already printed carries. */
+export const update = mutation({
+    args: {
+        siteId: v.id("sites"),
+        linkId: v.id("trackedLinks"),
+        destination: v.optional(v.string()),
+        platform: v.optional(v.string()),
+        channel: v.optional(trackedLinkChannelValidator),
+        campaign: v.optional(v.union(v.string(), v.null())),
+        disabled: v.optional(v.boolean()),
+    },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const link = await ctx.db.get("trackedLinks", args.linkId);
+        if (!link || link.siteId !== args.siteId) {
+            fail("NOT_FOUND", "tracked link not found");
+        }
+        const patch = {};
+        if (args.destination !== undefined) {
+            const site = await ctx.db.get("sites", args.siteId);
+            if (!site)
+                fail("NOT_FOUND", "site not found");
+            patch.destination = sanitizeDestination(args.destination, site.domains);
+        }
+        if (args.platform !== undefined) {
+            patch.platform = sanitizePlatform(args.platform);
+        }
+        if (args.channel !== undefined)
+            patch.channel = args.channel;
+        if (args.campaign !== undefined) {
+            patch.campaign = sanitizeCampaign(args.campaign ?? undefined);
+        }
+        if (args.disabled !== undefined) {
+            patch.disabledAt = args.disabled
+                ? (link.disabledAt ?? Date.now())
+                : undefined;
+        }
+        await ctx.db.patch("trackedLinks", args.linkId, patch);
+        return null;
+    },
+});
+export const remove = mutation({
+    args: { siteId: v.id("sites"), linkId: v.id("trackedLinks") },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const link = await ctx.db.get("trackedLinks", args.linkId);
+        if (!link || link.siteId !== args.siteId) {
+            fail("NOT_FOUND", "tracked link not found");
+        }
+        await ctx.db.delete("trackedLinks", args.linkId);
+        await ctx.scheduler.runAfter(0, internal.trackedLinks.purgeClicks, {
+            linkId: args.linkId,
+        });
+        return null;
+    },
+});
+/**
+ * The site's links, newest first, with their clicks and bot hits: all time,
+ * and over the 30 UTC days ending on the day of `now`. The caller passes the
+ * clock so the subscription does not go stale.
+ */
+export const list = query({
+    args: { siteId: v.id("sites"), now: v.number() },
+    returns: v.array(trackedLinkDocumentValidator.extend({
+        clicks: v.number(),
+        bots: v.number(),
+        clicksLast30Days: v.number(),
+        botsLast30Days: v.number(),
+    })),
+    handler: async (ctx, args) => {
+        if (!Number.isSafeInteger(args.now) || args.now < RECENT_DAYS * DAY_MS) {
+            fail("INVALID_ARGUMENT", "now must be a Unix time in milliseconds");
+        }
+        const since = Math.floor(args.now / DAY_MS) * DAY_MS - (RECENT_DAYS - 1) * DAY_MS;
+        const links = await ctx.db
+            .query("trackedLinks")
+            .withIndex("by_siteId", (range) => range.eq("siteId", args.siteId))
+            .order("desc")
+            .take(MAX_TRACKED_LINKS_PER_SITE);
+        const sum = (rows) => rows.reduce((total, row) => ({
+            clicks: total.clicks + row.clicks,
+            bots: total.bots + row.bots,
+        }), { clicks: 0, bots: 0 });
+        // Up to 4 + 120 counter rows per link, so a full site of 200 links whose
+        // every link fills every shard every day reads about 24,800 rows, inside
+        // the 32,000 documents a query may read. Raising either cap needs a
+        // finished day's shards folded into one row first.
+        return await Promise.all(links.map(async (link) => {
+            const total = sum(await ctx.db
+                .query("trackedLinkClicks")
+                .withIndex("by_linkId_and_dayStart_and_shard", (range) => range.eq("linkId", link._id).eq("dayStart", ALL_TIME))
+                .take(TRACKED_LINK_CLICK_SHARDS));
+            const recent = sum(await ctx.db
+                .query("trackedLinkClicks")
+                .withIndex("by_linkId_and_dayStart_and_shard", (range) => range
+                .eq("linkId", link._id)
+                .gte("dayStart", since)
+                .lt("dayStart", since + RECENT_DAYS * DAY_MS))
+                .take(RECENT_DAYS * TRACKED_LINK_CLICK_SHARDS));
+            return {
+                ...link,
+                clicks: total.clicks,
+                bots: total.bots,
+                clicksLast30Days: recent.clicks,
+                botsLast30Days: recent.bots,
+            };
+        }));
+    },
+});
+/**
+ * Counts one click on a live link and returns where it goes, or null for an
+ * unknown or disabled slug. Bots are counted apart and never as clicks. The
+ * destination is checked against the site's domains again, so a domain the
+ * site has since dropped stops redirecting.
+ */
+export const recordClick = internalMutation({
+    args: { slug: v.string(), bot: v.boolean() },
+    returns: v.union(redirectValidator, v.null()),
+    handler: async (ctx, args) => {
+        const link = await ctx.db
+            .query("trackedLinks")
+            .withIndex("by_slug", (range) => range.eq("slug", args.slug))
+            .unique();
+        if (!link || link.disabledAt !== undefined)
+            return null;
+        const site = await ctx.db.get("sites", link.siteId);
+        if (!site || !originAllowed(link.destination, site.domains))
+            return null;
+        const now = Date.now();
+        const shard = Math.floor(Math.random() * TRACKED_LINK_CLICK_SHARDS);
+        for (const dayStart of [Math.floor(now / DAY_MS) * DAY_MS, ALL_TIME]) {
+            const row = await ctx.db
+                .query("trackedLinkClicks")
+                .withIndex("by_linkId_and_dayStart_and_shard", (range) => range
+                .eq("linkId", link._id)
+                .eq("dayStart", dayStart)
+                .eq("shard", shard))
+                .unique();
+            if (row) {
+                await ctx.db.patch("trackedLinkClicks", row._id, args.bot ? { bots: row.bots + 1 } : { clicks: row.clicks + 1 });
+            }
+            else {
+                await ctx.db.insert("trackedLinkClicks", {
+                    linkId: link._id,
+                    dayStart,
+                    shard,
+                    clicks: args.bot ? 0 : 1,
+                    bots: args.bot ? 1 : 0,
+                });
+            }
+        }
+        return {
+            slug: link.slug,
+            destination: link.destination,
+            platform: link.platform,
+            channel: link.channel,
+            ...(link.campaign === undefined ? {} : { campaign: link.campaign }),
+        };
+    },
+});
+/** Deletes a removed link's counters a batch at a time. */
+export const purgeClicks = internalMutation({
+    args: { linkId: v.id("trackedLinks") },
+    returns: v.null(),
+    handler: async (ctx, args) => {
+        const rows = await ctx.db
+            .query("trackedLinkClicks")
+            .withIndex("by_linkId_and_dayStart_and_shard", (range) => range.eq("linkId", args.linkId))
+            .take(PURGE_BATCH);
+        for (const row of rows)
+            await ctx.db.delete("trackedLinkClicks", row._id);
+        if (rows.length === PURGE_BATCH) {
+            await ctx.scheduler.runAfter(0, internal.trackedLinks.purgeClicks, args);
+        }
+        return null;
+    },
+});
+//# sourceMappingURL=trackedLinks.js.map

package/dist/component/trackedLinks.js.map

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

package/dist/component/useragent.d.ts

@@ -5,5 +5,11 @@ export type ClientClassification = {
 };
 export declare function classifyClient(userAgent: string, headers: Headers): ClientClassification;
 export declare function classifyUserAgent(userAgent: string): ClientClassification;
+/**
+ * The platform whose in-app browser sent the request (Instagram, Facebook,
+ * TikTok…), from the marker each app appends to the User-Agent. The system
+ * browser a messaging app hands a link to carries none.
+ */
+export declare function inAppPlatform(userAgent: string): string | undefined;
 export declare function isKnownBot(userAgent: string): boolean;
 //# sourceMappingURL=useragent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"useragent.d.ts","sourceRoot":"","sources":["../../src/component/useragent.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA2EF,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,oBAAoB,CAUtB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAMzE;AAoED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAErD"}
+{"version":3,"file":"useragent.d.ts","sourceRoot":"","sources":["../../src/component/useragent.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,oBAAoB,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AA2EF,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,OAAO,GACf,oBAAoB,CAUtB;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,oBAAoB,CAMzE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEnE;AAoED,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAErD"}

package/dist/component/useragent.js

@@ -1,3 +1,4 @@
+import { PLATFORMS } from "./platforms.js";
 // The tracker never reports the client: everything here is derived from headers
 // the browser sets itself. Chromium sends the low-entropy `Sec-CH-UA` hints on
 // cross-origin requests without an `Accept-CH` opt-in, which is the only way to
@@ -80,6 +81,14 @@ export function classifyUserAgent(userAgent) {
         device: matchAgent(AGENT_DEVICES, userAgent) ?? "desktop",
     };
 }
+/**
+ * The platform whose in-app browser sent the request (Instagram, Facebook,
+ * TikTok…), from the marker each app appends to the User-Agent. The system
+ * browser a messaging app hands a link to carries none.
+ */
+export function inAppPlatform(userAgent) {
+    return PLATFORMS.find((row) => row.agent?.test(userAgent))?.id;
+}
 function matchAgent(table, userAgent) {
     for (const [pattern, value] of table) {
         if (pattern.test(userAgent))

package/dist/component/useragent.js.map

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

package/dist/component/validators.d.ts

@@ -5,6 +5,7 @@ export declare const propertyValueValidator: import("convex/values").VUnion<stri
 export declare const eventPropertiesValidator: import("convex/values").VRecord<Record<string, string | number | boolean | null>, import("convex/values").VString<string, "required">, import("convex/values").VUnion<string | number | boolean | null, [import("convex/values").VString<string, "required">, import("convex/values").VFloat64<number, "required">, import("convex/values").VBoolean<boolean, "required">, import("convex/values").VNull<null, "required">], "required", never>, "required", string>;
 export declare const trackerEventValidator: import("convex/values").VObject<{
     affiliateSlug?: string | undefined;
+    clid?: string[] | undefined;
     currency?: string | undefined;
     eventId: string;
     href?: string | undefined;
@@ -37,12 +38,14 @@ export declare const trackerEventValidator: import("convex/values").VObject<{
     currency: import("convex/values").VString<string | undefined, "optional">;
     affiliateSlug: import("convex/values").VString<string | undefined, "optional">;
     value: import("convex/values").VFloat64<number | undefined, "optional">;
-}, "required", "affiliateSlug" | "currency" | "eventId" | "href" | "name" | "path" | "properties" | "referrer" | "revenueCents" | "sequence" | "sessionId" | "target" | "timestamp" | "type" | "value" | "visitorId" | `properties.${string}`>;
+    clid: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+}, "required", "affiliateSlug" | "clid" | "currency" | "eventId" | "href" | "name" | "path" | "properties" | "referrer" | "revenueCents" | "sequence" | "sessionId" | "target" | "timestamp" | "type" | "value" | "visitorId" | `properties.${string}`>;
 export declare const ingestContextValidator: import("convex/values").VObject<{
     browser?: string | undefined;
     city?: string | undefined;
     country?: string | undefined;
     device?: string | undefined;
+    inApp?: string | undefined;
     latitude?: number | undefined;
     longitude?: number | undefined;
     os?: string | undefined;
@@ -56,17 +59,22 @@ export declare const ingestContextValidator: import("convex/values").VObject<{
     os: import("convex/values").VString<string | undefined, "optional">;
     device: import("convex/values").VString<string | undefined, "optional">;
     visitorKey: import("convex/values").VString<string | undefined, "optional">;
-}, "required", "browser" | "city" | "country" | "device" | "latitude" | "longitude" | "os" | "visitorKey">;
+    inApp: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "browser" | "city" | "country" | "device" | "inApp" | "latitude" | "longitude" | "os" | "visitorKey">;
+export declare const channelValidator: import("convex/values").VUnion<"affiliate" | "ai" | "direct" | "display" | "email" | "messaging" | "offline" | "organic_search" | "organic_social" | "paid_search" | "paid_social" | "referral", [import("convex/values").VLiteral<"direct", "required">, import("convex/values").VLiteral<"organic_search", "required">, import("convex/values").VLiteral<"paid_search", "required">, import("convex/values").VLiteral<"organic_social", "required">, import("convex/values").VLiteral<"paid_social", "required">, import("convex/values").VLiteral<"messaging", "required">, import("convex/values").VLiteral<"email", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"ai", "required">, import("convex/values").VLiteral<"display", "required">, import("convex/values").VLiteral<"referral", "required">, import("convex/values").VLiteral<"offline", "required">], "required", never>;
+export declare const evidenceValidator: import("convex/values").VUnion<"affiliate" | "clickId" | "inApp" | "legacy" | "none" | "referrer" | "utm", [import("convex/values").VLiteral<"utm", "required">, import("convex/values").VLiteral<"clickId", "required">, import("convex/values").VLiteral<"referrer", "required">, import("convex/values").VLiteral<"inApp", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"none", "required">, import("convex/values").VLiteral<"legacy", "required">], "required", never>;
 export declare const batchedEventValidator: import("convex/values").VObject<{
     affiliateSlug?: string | undefined;
     aggregateCountry?: string | undefined;
     browser?: string | undefined;
     city?: string | undefined;
+    clid?: string[] | undefined;
     country?: string | undefined;
     currency?: string | undefined;
     device?: string | undefined;
     eventId: string;
     href?: string | undefined;
+    inApp?: string | undefined;
     latitude?: number | undefined;
     longitude?: number | undefined;
     name?: string | undefined;
@@ -100,6 +108,7 @@ export declare const batchedEventValidator: import("convex/values").VObject<{
     currency: import("convex/values").VString<string | undefined, "optional">;
     affiliateSlug: import("convex/values").VString<string | undefined, "optional">;
     value: import("convex/values").VFloat64<number | undefined, "optional">;
+    clid: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
     country: import("convex/values").VString<string | undefined, "optional">;
     city: import("convex/values").VString<string | undefined, "optional">;
     latitude: import("convex/values").VFloat64<number | undefined, "optional">;
@@ -108,8 +117,9 @@ export declare const batchedEventValidator: import("convex/values").VObject<{
     os: import("convex/values").VString<string | undefined, "optional">;
     device: import("convex/values").VString<string | undefined, "optional">;
     visitorKey: import("convex/values").VString<string | undefined, "optional">;
+    inApp: import("convex/values").VString<string | undefined, "optional">;
     aggregateCountry: import("convex/values").VString<string | undefined, "optional">;
-}, "required", "affiliateSlug" | "aggregateCountry" | "browser" | "city" | "country" | "currency" | "device" | "eventId" | "href" | "latitude" | "longitude" | "name" | "os" | "path" | "properties" | "referrer" | "revenueCents" | "sequence" | "sessionId" | "target" | "timestamp" | "type" | "value" | "visitorId" | "visitorKey" | `properties.${string}`>;
+}, "required", "affiliateSlug" | "aggregateCountry" | "browser" | "city" | "clid" | "country" | "currency" | "device" | "eventId" | "href" | "inApp" | "latitude" | "longitude" | "name" | "os" | "path" | "properties" | "referrer" | "revenueCents" | "sequence" | "sessionId" | "target" | "timestamp" | "type" | "value" | "visitorId" | "visitorKey" | `properties.${string}`>;
 export declare const siteFieldsValidator: import("convex/values").VObject<{
     cookieless: boolean;
     createdAt: number;
@@ -137,6 +147,7 @@ export declare const sessionFieldsValidator: import("convex/values").VObject<{
     affiliateId?: import("convex/values").GenericId<"affiliates"> | undefined;
     affiliateSlug?: string | undefined;
     browser: string;
+    channel?: "affiliate" | "ai" | "direct" | "display" | "email" | "messaging" | "offline" | "organic_search" | "organic_social" | "paid_search" | "paid_social" | "referral" | undefined;
     city?: string | undefined;
     conversionCount: number;
     country?: string | undefined;
@@ -145,6 +156,7 @@ export declare const sessionFieldsValidator: import("convex/values").VObject<{
     durationMs: number;
     entryPath: string;
     eventCount: number;
+    evidence?: "affiliate" | "clickId" | "inApp" | "legacy" | "none" | "referrer" | "utm" | undefined;
     exitPath: string;
     lastSeenAt: number;
     latitude?: number | undefined;
@@ -152,6 +164,7 @@ export declare const sessionFieldsValidator: import("convex/values").VObject<{
     newVisitor?: boolean | undefined;
     os: string;
     pageviewCount: number;
+    platform?: string | undefined;
     referrer?: string | undefined;
     revenueCents: number;
     sessionId: string;
@@ -175,6 +188,9 @@ export declare const sessionFieldsValidator: import("convex/values").VObject<{
     exitPath: import("convex/values").VString<string, "required">;
     referrer: import("convex/values").VString<string | undefined, "optional">;
     source: import("convex/values").VString<string, "required">;
+    platform: import("convex/values").VString<string | undefined, "optional">;
+    channel: import("convex/values").VUnion<"affiliate" | "ai" | "direct" | "display" | "email" | "messaging" | "offline" | "organic_search" | "organic_social" | "paid_search" | "paid_social" | "referral" | undefined, [import("convex/values").VLiteral<"direct", "required">, import("convex/values").VLiteral<"organic_search", "required">, import("convex/values").VLiteral<"paid_search", "required">, import("convex/values").VLiteral<"organic_social", "required">, import("convex/values").VLiteral<"paid_social", "required">, import("convex/values").VLiteral<"messaging", "required">, import("convex/values").VLiteral<"email", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"ai", "required">, import("convex/values").VLiteral<"display", "required">, import("convex/values").VLiteral<"referral", "required">, import("convex/values").VLiteral<"offline", "required">], "optional", never>;
+    evidence: import("convex/values").VUnion<"affiliate" | "clickId" | "inApp" | "legacy" | "none" | "referrer" | "utm" | undefined, [import("convex/values").VLiteral<"utm", "required">, import("convex/values").VLiteral<"clickId", "required">, import("convex/values").VLiteral<"referrer", "required">, import("convex/values").VLiteral<"inApp", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"none", "required">, import("convex/values").VLiteral<"legacy", "required">], "optional", never>;
     utmSource: import("convex/values").VString<string | undefined, "optional">;
     utmMedium: import("convex/values").VString<string | undefined, "optional">;
     utmCampaign: import("convex/values").VString<string | undefined, "optional">;
@@ -195,7 +211,7 @@ export declare const sessionFieldsValidator: import("convex/values").VObject<{
     affiliateId: import("convex/values").VId<import("convex/values").GenericId<"affiliates"> | undefined, "optional">;
     affiliateAttributedAt: import("convex/values").VFloat64<number | undefined, "optional">;
     affiliateExpiresAt: import("convex/values").VFloat64<number | undefined, "optional">;
-}, "required", "affiliateAttributedAt" | "affiliateExpiresAt" | "affiliateId" | "affiliateSlug" | "browser" | "city" | "conversionCount" | "country" | "currency" | "device" | "durationMs" | "entryPath" | "eventCount" | "exitPath" | "lastSeenAt" | "latitude" | "longitude" | "newVisitor" | "os" | "pageviewCount" | "referrer" | "revenueCents" | "sessionId" | "siteId" | "source" | "startedAt" | "utmCampaign" | "utmMedium" | "utmSource" | "visitorId" | "visitorKey">;
+}, "required", "affiliateAttributedAt" | "affiliateExpiresAt" | "affiliateId" | "affiliateSlug" | "browser" | "channel" | "city" | "conversionCount" | "country" | "currency" | "device" | "durationMs" | "entryPath" | "eventCount" | "evidence" | "exitPath" | "lastSeenAt" | "latitude" | "longitude" | "newVisitor" | "os" | "pageviewCount" | "platform" | "referrer" | "revenueCents" | "sessionId" | "siteId" | "source" | "startedAt" | "utmCampaign" | "utmMedium" | "utmSource" | "visitorId" | "visitorKey">;
 export declare const eventFieldsValidator: import("convex/values").VObject<{
     affiliateSlug?: string | undefined;
     browser: string;
@@ -245,17 +261,17 @@ export declare const eventFieldsValidator: import("convex/values").VObject<{
     os: import("convex/values").VString<string, "required">;
     device: import("convex/values").VString<string, "required">;
 }, "required", "affiliateSlug" | "browser" | "city" | "country" | "currency" | "device" | "eventId" | "href" | "latitude" | "longitude" | "name" | "os" | "path" | "properties" | "referrer" | "revenueCents" | "sequence" | "sessionId" | "siteId" | "target" | "timestamp" | "type" | "visitorId" | `properties.${string}`>;
-export declare const dimensionTypeValidator: import("convex/values").VUnion<"browser" | "campaign" | "country" | "device" | "event" | "goal" | "medium" | "outbound" | "page" | "source", [import("convex/values").VLiteral<"source", "required">, import("convex/values").VLiteral<"campaign", "required">, import("convex/values").VLiteral<"page", "required">, import("convex/values").VLiteral<"country", "required">, import("convex/values").VLiteral<"device", "required">, import("convex/values").VLiteral<"browser", "required">, import("convex/values").VLiteral<"event", "required">, import("convex/values").VLiteral<"goal", "required">, import("convex/values").VLiteral<"medium", "required">, import("convex/values").VLiteral<"outbound", "required">], "required", never>;
+export declare const dimensionTypeValidator: import("convex/values").VUnion<"browser" | "campaign" | "channel" | "country" | "device" | "event" | "evidence" | "goal" | "medium" | "outbound" | "page" | "platform" | "source", [import("convex/values").VLiteral<"source", "required">, import("convex/values").VLiteral<"campaign", "required">, import("convex/values").VLiteral<"page", "required">, import("convex/values").VLiteral<"country", "required">, import("convex/values").VLiteral<"device", "required">, import("convex/values").VLiteral<"browser", "required">, import("convex/values").VLiteral<"event", "required">, import("convex/values").VLiteral<"goal", "required">, import("convex/values").VLiteral<"medium", "required">, import("convex/values").VLiteral<"outbound", "required">, import("convex/values").VLiteral<"platform", "required">, import("convex/values").VLiteral<"channel", "required">, import("convex/values").VLiteral<"evidence", "required">], "required", never>;
 export declare const dimensionSlotValidator: import("convex/values").VObject<{
     count: number;
     pageviews?: number | undefined;
     revenueCents: number;
     sessions?: number | undefined;
     slot: number;
-    type: "browser" | "campaign" | "country" | "device" | "event" | "goal" | "medium" | "outbound" | "page" | "source";
+    type: "browser" | "campaign" | "channel" | "country" | "device" | "event" | "evidence" | "goal" | "medium" | "outbound" | "page" | "platform" | "source";
     value: string;
 }, {
-    type: import("convex/values").VUnion<"browser" | "campaign" | "country" | "device" | "event" | "goal" | "medium" | "outbound" | "page" | "source", [import("convex/values").VLiteral<"source", "required">, import("convex/values").VLiteral<"campaign", "required">, import("convex/values").VLiteral<"page", "required">, import("convex/values").VLiteral<"country", "required">, import("convex/values").VLiteral<"device", "required">, import("convex/values").VLiteral<"browser", "required">, import("convex/values").VLiteral<"event", "required">, import("convex/values").VLiteral<"goal", "required">, import("convex/values").VLiteral<"medium", "required">, import("convex/values").VLiteral<"outbound", "required">], "required", never>;
+    type: import("convex/values").VUnion<"browser" | "campaign" | "channel" | "country" | "device" | "event" | "evidence" | "goal" | "medium" | "outbound" | "page" | "platform" | "source", [import("convex/values").VLiteral<"source", "required">, import("convex/values").VLiteral<"campaign", "required">, import("convex/values").VLiteral<"page", "required">, import("convex/values").VLiteral<"country", "required">, import("convex/values").VLiteral<"device", "required">, import("convex/values").VLiteral<"browser", "required">, import("convex/values").VLiteral<"event", "required">, import("convex/values").VLiteral<"goal", "required">, import("convex/values").VLiteral<"medium", "required">, import("convex/values").VLiteral<"outbound", "required">, import("convex/values").VLiteral<"platform", "required">, import("convex/values").VLiteral<"channel", "required">, import("convex/values").VLiteral<"evidence", "required">], "required", never>;
     slot: import("convex/values").VFloat64<number, "required">;
     value: import("convex/values").VString<string, "required">;
     count: import("convex/values").VFloat64<number, "required">;
@@ -285,7 +301,7 @@ export declare const aggregateFieldsValidator: import("convex/values").VObject<{
         revenueCents: number;
         sessions?: number | undefined;
         slot: number;
-        type: "browser" | "campaign" | "country" | "device" | "event" | "goal" | "medium" | "outbound" | "page" | "source";
+        type: "browser" | "campaign" | "channel" | "country" | "device" | "event" | "evidence" | "goal" | "medium" | "outbound" | "page" | "platform" | "source";
         value: string;
     }[];
     durationMs?: number | undefined;
@@ -335,7 +351,7 @@ export declare const aggregateFieldsValidator: import("convex/values").VObject<{
         revenueCents: number;
         sessions?: number | undefined;
         slot: number;
-        type: "browser" | "campaign" | "country" | "device" | "event" | "goal" | "medium" | "outbound" | "page" | "source";
+        type: "browser" | "campaign" | "channel" | "country" | "device" | "event" | "evidence" | "goal" | "medium" | "outbound" | "page" | "platform" | "source";
         value: string;
     }[], import("convex/values").VObject<{
         count: number;
@@ -343,10 +359,10 @@ export declare const aggregateFieldsValidator: import("convex/values").VObject<{
         revenueCents: number;
         sessions?: number | undefined;
         slot: number;
-        type: "browser" | "campaign" | "country" | "device" | "event" | "goal" | "medium" | "outbound" | "page" | "source";
+        type: "browser" | "campaign" | "channel" | "country" | "device" | "event" | "evidence" | "goal" | "medium" | "outbound" | "page" | "platform" | "source";
         value: string;
     }, {
-        type: import("convex/values").VUnion<"browser" | "campaign" | "country" | "device" | "event" | "goal" | "medium" | "outbound" | "page" | "source", [import("convex/values").VLiteral<"source", "required">, import("convex/values").VLiteral<"campaign", "required">, import("convex/values").VLiteral<"page", "required">, import("convex/values").VLiteral<"country", "required">, import("convex/values").VLiteral<"device", "required">, import("convex/values").VLiteral<"browser", "required">, import("convex/values").VLiteral<"event", "required">, import("convex/values").VLiteral<"goal", "required">, import("convex/values").VLiteral<"medium", "required">, import("convex/values").VLiteral<"outbound", "required">], "required", never>;
+        type: import("convex/values").VUnion<"browser" | "campaign" | "channel" | "country" | "device" | "event" | "evidence" | "goal" | "medium" | "outbound" | "page" | "platform" | "source", [import("convex/values").VLiteral<"source", "required">, import("convex/values").VLiteral<"campaign", "required">, import("convex/values").VLiteral<"page", "required">, import("convex/values").VLiteral<"country", "required">, import("convex/values").VLiteral<"device", "required">, import("convex/values").VLiteral<"browser", "required">, import("convex/values").VLiteral<"event", "required">, import("convex/values").VLiteral<"goal", "required">, import("convex/values").VLiteral<"medium", "required">, import("convex/values").VLiteral<"outbound", "required">, import("convex/values").VLiteral<"platform", "required">, import("convex/values").VLiteral<"channel", "required">, import("convex/values").VLiteral<"evidence", "required">], "required", never>;
         slot: import("convex/values").VFloat64<number, "required">;
         value: import("convex/values").VString<string, "required">;
         count: import("convex/values").VFloat64<number, "required">;
@@ -443,6 +459,28 @@ export declare const affiliateFieldsValidator: import("convex/values").VObject<{
     createdAt: import("convex/values").VFloat64<number, "required">;
     updatedAt: import("convex/values").VFloat64<number, "required">;
 }, "required", "active" | "attributionWindowDays" | "commissionBps" | "createdAt" | "name" | "siteId" | "slug" | "updatedAt">;
+export declare const trackedLinkChannelValidator: import("convex/values").VUnion<"affiliate" | "display" | "email" | "messaging" | "offline" | "organic_social" | "paid_social" | "referral", [import("convex/values").VLiteral<"organic_social", "required">, import("convex/values").VLiteral<"paid_social", "required">, import("convex/values").VLiteral<"messaging", "required">, import("convex/values").VLiteral<"email", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"display", "required">, import("convex/values").VLiteral<"referral", "required">, import("convex/values").VLiteral<"offline", "required">], "required", never>;
+export declare const trackedLinkFieldsValidator: import("convex/values").VObject<{
+    campaign?: string | undefined;
+    channel: "affiliate" | "display" | "email" | "messaging" | "offline" | "organic_social" | "paid_social" | "referral";
+    createdAt: number;
+    createdBy: string;
+    destination: string;
+    disabledAt?: number | undefined;
+    platform: string;
+    siteId: import("convex/values").GenericId<"sites">;
+    slug: string;
+}, {
+    siteId: import("convex/values").VId<import("convex/values").GenericId<"sites">, "required">;
+    slug: import("convex/values").VString<string, "required">;
+    destination: import("convex/values").VString<string, "required">;
+    platform: import("convex/values").VString<string, "required">;
+    channel: import("convex/values").VUnion<"affiliate" | "display" | "email" | "messaging" | "offline" | "organic_social" | "paid_social" | "referral", [import("convex/values").VLiteral<"organic_social", "required">, import("convex/values").VLiteral<"paid_social", "required">, import("convex/values").VLiteral<"messaging", "required">, import("convex/values").VLiteral<"email", "required">, import("convex/values").VLiteral<"affiliate", "required">, import("convex/values").VLiteral<"display", "required">, import("convex/values").VLiteral<"referral", "required">, import("convex/values").VLiteral<"offline", "required">], "required", never>;
+    campaign: import("convex/values").VString<string | undefined, "optional">;
+    createdAt: import("convex/values").VFloat64<number, "required">;
+    createdBy: import("convex/values").VString<string, "required">;
+    disabledAt: import("convex/values").VFloat64<number | undefined, "optional">;
+}, "required", "campaign" | "channel" | "createdAt" | "createdBy" | "destination" | "disabledAt" | "platform" | "siteId" | "slug">;
 export declare const ingestResultValidator: import("convex/values").VObject<{
     accepted: number;
     duplicates: number;
@@ -480,4 +518,6 @@ export type IngestContext = Infer<typeof ingestContextValidator>;
 export type EventProperties = Infer<typeof eventPropertiesValidator>;
 export type FunnelStep = Infer<typeof funnelStepValidator>;
 export type EventType = Infer<typeof eventTypeValidator>;
+export type Channel = Infer<typeof channelValidator>;
+export type Evidence = Infer<typeof evidenceValidator>;
 //# sourceMappingURL=validators.d.ts.map