@atlasauth/js 0.14.0 → 0.16.0

package/dist/referral-detect.js

@@ -0,0 +1,432 @@
+"use strict";
+/**
+ * Referral sources and consent managers the SDK recognises on the page, so
+ * referral capture works with any referral program and any consent manager.
+ *
+ * Sources: the referral script or cookie a program puts on the merchant's
+ * site. Each reader returns `{code, clickId, anonId}` (and `capturedAt` when
+ * the source says when): the code is the referrer's, the ids are the
+ * visitor's (sent only with consent). The instance lists which sources to read
+ * (`browser_sources`), so one program's script never feeds another program's
+ * connection. A custom program passes its own reader as `referralSource`.
+ *
+ * Consent: the first consent manager found on the page decides whether the
+ * referral cookie's ids may be read, for the instance's consent category, else
+ * its fallback category. The visitor's answer in a consent manager is the
+ * source of truth: the app's own decision (`referralConsent`) applies only
+ * when no manager is on the page, or when the instance says the app decides
+ * (`consent_provider: 'app'`). Common names map onto each manager's own:
+ * `marketing` (also advertising / targeting), `statistics` (analytics /
+ * performance) and `preferences` (functional / personalization); any other
+ * name is looked up as the manager's own category id. IAB TCF v2 managers
+ * answer with Purpose 1 (store and access information on a device).
+ *
+ * Every reader is defensive: a missing, half-loaded or throwing script reads
+ * as "nothing here". The ES5 copy in the Atlas API (hosted pages and the Sign
+ * in with Atlas button) follows the same rules and is tested against the same
+ * fixtures.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONSENT_PROVIDERS = exports.REFERRAL_BROWSER_SOURCES = void 0;
+exports.customReferral = customReferral;
+exports.detectReferralSource = detectReferralSource;
+exports.canonicalCategory = canonicalCategory;
+exports.listenForTcfConsent = listenForTcfConsent;
+exports.resetConsentDetection = resetConsentDetection;
+exports.detectConsent = detectConsent;
+exports.detectConsentProvider = detectConsentProvider;
+const TOKEN = /^[A-Za-z0-9_-]{3,64}$/;
+const isBag = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+const token = (v) => (typeof v === 'string' && TOKEN.test(v.trim()) ? v.trim() : null);
+/** The browser sources the SDK reads, in the order it tries them. */
+exports.REFERRAL_BROWSER_SOURCES = [
+    'referally',
+    'rewardful',
+    'tolt',
+    'promotekit',
+    'firstpromoter',
+    'partnerstack',
+    'dub',
+];
+/** The consent managers the SDK reads, in the order `auto` tries them. */
+exports.CONSENT_PROVIDERS = [
+    'cookiemunch',
+    'onetrust',
+    'cookiebot',
+    'didomi',
+    'usercentrics',
+    'osano',
+    'cookieyes',
+    'complianz',
+    'klaro',
+    'tcf',
+    'consent_mode',
+];
+function prop(o, key) {
+    try {
+        return o != null && (typeof o === 'object' || typeof o === 'function') ? o[key] : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function call(fn, self, ...args) {
+    try {
+        return typeof fn === 'function' ? fn.apply(self, args) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function cookie(cookies, name) {
+    if (!cookies)
+        return null;
+    for (const part of cookies.split(';')) {
+        const p = part.trim();
+        if (p.startsWith(`${name}=`)) {
+            const raw = p.slice(name.length + 1);
+            try {
+                return decodeURIComponent(raw);
+            }
+            catch {
+                return raw;
+            }
+        }
+    }
+    return null;
+}
+function time(v) {
+    if (typeof v === 'number' && Number.isFinite(v) && v > 0)
+        return new Date(v < 1e12 ? v * 1000 : v).toISOString();
+    if (typeof v === 'string' && v && v.length <= 40) {
+        if (/^\d{9,13}$/.test(v))
+            return time(Number(v));
+        const t = Date.parse(v);
+        if (Number.isFinite(t))
+            return new Date(t).toISOString();
+    }
+    return undefined;
+}
+function found(source, code, clickId, anonId, at) {
+    const out = { source, code: token(code), clickId: token(clickId), anonId: token(anonId) };
+    const ts = time(at);
+    if (ts)
+        out.capturedAt = ts;
+    return out.code || out.clickId || out.anonId ? out : null;
+}
+/** Each known source: where its script or cookie keeps the referral. */
+const READERS = {
+    // Referalli's aff.js: aff.getReferral() → {code, clickId, anonId, ts}.
+    referally: ({ win }) => {
+        const aff = prop(win, 'aff');
+        const r = call(prop(aff, 'getReferral'), aff);
+        if (!isBag(r))
+            return null;
+        return found('referally', r.code, r.clickId ?? r.click_id, r.anonId ?? r.anon_id, r.ts);
+    },
+    // Rewardful's rw.js: Rewardful.referral (the referral id) and Rewardful.affiliate.token (the link code).
+    rewardful: ({ win }) => {
+        const rw = prop(win, 'Rewardful');
+        return found('rewardful', prop(prop(rw, 'affiliate'), 'token'), prop(rw, 'referral'), null);
+    },
+    // Tolt's script: window.tolt_referral (the referral id).
+    tolt: ({ win }) => found('tolt', null, prop(win, 'tolt_referral'), null),
+    // PromoteKit's script: window.promotekit_referral (the referral id).
+    promotekit: ({ win }) => found('promotekit', null, prop(win, 'promotekit_referral'), null),
+    // FirstPromoter's cookies: _fprom_tid (tracking id) and _fprom_ref (the referral code).
+    firstpromoter: ({ cookies }) => found('firstpromoter', cookie(cookies, '_fprom_ref'), cookie(cookies, '_fprom_tid'), null),
+    // PartnerStack's cookies: ps_xid (click id) and ps_partner_key (the partner's key).
+    partnerstack: ({ cookies }) => found('partnerstack', cookie(cookies, 'ps_partner_key'), cookie(cookies, 'ps_xid'), null),
+    // Dub's analytics script cookie: dub_id (click id).
+    dub: ({ cookies }) => found('dub', null, cookie(cookies, 'dub_id'), null),
+};
+/** The app's own reader, as a detected referral (source `custom`). Never throws. */
+function customReferral(reader) {
+    if (typeof reader !== 'function')
+        return null;
+    let r;
+    try {
+        r = reader();
+    }
+    catch {
+        return null;
+    }
+    if (!isBag(r))
+        return null;
+    return found('custom', r.code, r.clickId ?? r.click_id, r.anonId ?? r.anon_id, r.capturedAt ?? r.ts);
+}
+/** The first of `sources` with a referral on the page, or null. Unknown ids are skipped. */
+function detectReferralSource(page, sources) {
+    for (const id of sources) {
+        const read = READERS[id];
+        if (!read)
+            continue;
+        let r = null;
+        try {
+            r = read(page);
+        }
+        catch {
+            r = null;
+        }
+        if (r)
+            return r;
+    }
+    return null;
+}
+const ALIASES = {
+    necessary: 'necessary',
+    essential: 'necessary',
+    strictly_necessary: 'necessary',
+    preferences: 'preferences',
+    functional: 'preferences',
+    functionality: 'preferences',
+    personalization: 'preferences',
+    statistics: 'statistics',
+    analytics: 'statistics',
+    performance: 'statistics',
+    marketing: 'marketing',
+    advertising: 'marketing',
+    advertisement: 'marketing',
+    targeting: 'marketing',
+    ads: 'marketing',
+};
+/** A consent category's common meaning, if it has one. */
+function canonicalCategory(name) {
+    return ALIASES[name.trim().toLowerCase()] ?? null;
+}
+const bool = (v) => (typeof v === 'boolean' ? v : undefined);
+/** Look a category up by its own name, then by its common meaning's native name. */
+function byName(native, lookup) {
+    return (_win, category) => {
+        const own = lookup(category);
+        if (own !== undefined)
+            return own;
+        const c = canonicalCategory(category);
+        const mapped = c ? native[c] : undefined;
+        return mapped ? lookup(mapped) : undefined;
+    };
+}
+/** The latest IAB TCF data, kept by a listener registered when the SDK loads. */
+let tcfCache = null;
+let tcfListening = false;
+/**
+ * Start listening to an IAB TCF v2 manager (`__tcfapi`), so its answer is
+ * ready synchronously when a sign-in starts. Safe to call more than once.
+ */
+function listenForTcfConsent(win) {
+    const api = prop(win, '__tcfapi');
+    if (tcfListening || typeof api !== 'function')
+        return;
+    tcfListening = true;
+    call(api, win, 'addEventListener', 2, (data, ok) => {
+        if (ok && isBag(data))
+            tcfCache = data;
+    });
+}
+/** Forget the cached TCF data (tests). */
+function resetConsentDetection() {
+    tcfCache = null;
+    tcfListening = false;
+}
+function tcfData(win) {
+    if (tcfCache)
+        return tcfCache;
+    // Most managers answer getTCData synchronously once loaded.
+    let data = null;
+    call(prop(win, '__tcfapi'), win, 'getTCData', 2, (d, ok) => {
+        if (ok && isBag(d))
+            data = d;
+    });
+    return data;
+}
+const STANDARD = { necessary: 'necessary', preferences: 'preferences', statistics: 'statistics', marketing: 'marketing' };
+const has = (list, k) => Array.isArray(list) && list.includes(k);
+const MANAGERS = {
+    // Cookie Munch: CookieMunch.consent → {necessary, preferences, statistics, marketing, <custom>…}.
+    cookiemunch: {
+        present: (w) => isBag(prop(prop(w, 'CookieMunch'), 'consent')),
+        ask: (w, category) => {
+            const c = prop(prop(w, 'CookieMunch'), 'consent');
+            return byName(STANDARD, (k) => bool(prop(c, k)))(w, category);
+        },
+    },
+    // OneTrust: OnetrustActiveGroups = ",C0001,C0002,…" (the groups consented to).
+    onetrust: {
+        present: (w) => typeof (prop(w, 'OnetrustActiveGroups') ?? prop(w, 'OptanonActiveGroups')) === 'string',
+        ask: (w, category) => {
+            const groups = String(prop(w, 'OnetrustActiveGroups') ?? prop(w, 'OptanonActiveGroups') ?? '')
+                .split(',')
+                .map((g) => g.trim())
+                .filter(Boolean);
+            // A group id (C0004, or a custom one the page uses) is answered by membership; other names are unknown.
+            return byName({ necessary: 'C0001', statistics: 'C0002', preferences: 'C0003', marketing: 'C0004' }, (k) => /^C\d{4}$/.test(k) || groups.includes(k) ? groups.includes(k) : undefined)(w, category);
+        },
+    },
+    // Cookiebot: Cookiebot.consent → {necessary, preferences, statistics, marketing}. Cookie Munch also
+    // publishes a Cookiebot alias, so Cookiebot counts only without Cookie Munch.
+    cookiebot: {
+        present: (w) => !prop(w, 'CookieMunch') && isBag(prop(prop(w, 'Cookiebot'), 'consent')),
+        ask: (w, category) => {
+            const c = prop(prop(w, 'Cookiebot'), 'consent');
+            return byName(STANDARD, (k) => bool(prop(c, k)))(w, category);
+        },
+    },
+    // Didomi: Didomi.getUserStatus().purposes.global.{enabled, disabled}. Marketing maps to
+    // Purpose 1 ("cookies": store and access information on a device).
+    didomi: {
+        present: (w) => typeof prop(prop(w, 'Didomi'), 'getUserStatus') === 'function',
+        ask: (w, category) => {
+            const didomi = prop(w, 'Didomi');
+            const global = prop(prop(call(prop(didomi, 'getUserStatus'), didomi), 'purposes'), 'global');
+            const enabled = prop(global, 'enabled');
+            const disabled = prop(global, 'disabled');
+            return byName({ marketing: 'cookies', statistics: 'measure_content_performance' }, (k) => has(enabled, k) ? true : has(disabled, k) ? false : undefined)(w, category);
+        },
+    },
+    // Usercentrics: UC_UI.getServicesBaseInfo() → [{categorySlug, consent: {status}}]; a category is
+    // granted when every service in it is.
+    usercentrics: {
+        present: (w) => typeof prop(prop(w, 'UC_UI'), 'getServicesBaseInfo') === 'function',
+        ask: (w, category) => {
+            const uc = prop(w, 'UC_UI');
+            const services = call(prop(uc, 'getServicesBaseInfo'), uc);
+            if (!Array.isArray(services))
+                return undefined;
+            return byName({ necessary: 'essential', preferences: 'functional', statistics: 'functional', marketing: 'marketing' }, (slug) => {
+                const inCategory = services.filter((s) => prop(s, 'categorySlug') === slug);
+                return inCategory.length ? inCategory.every((s) => prop(prop(s, 'consent'), 'status') === true) : undefined;
+            })(w, category);
+        },
+    },
+    // Osano: Osano.cm.getConsent() → {MARKETING: 'ACCEPT' | 'DENY', ANALYTICS, PERSONALIZATION, ESSENTIAL}.
+    osano: {
+        present: (w) => typeof prop(prop(prop(w, 'Osano'), 'cm'), 'getConsent') === 'function',
+        ask: (w, category) => {
+            const cm = prop(prop(w, 'Osano'), 'cm');
+            const consent = call(prop(cm, 'getConsent'), cm);
+            return byName({ necessary: 'ESSENTIAL', preferences: 'PERSONALIZATION', statistics: 'ANALYTICS', marketing: 'MARKETING' }, (k) => {
+                const v = prop(consent, k) ?? prop(consent, k.toUpperCase());
+                return v === 'ACCEPT' ? true : v === 'DENY' ? false : undefined;
+            })(w, category);
+        },
+    },
+    // CookieYes: getCkyConsent().categories → {necessary, functional, analytics, performance, advertisement}.
+    cookieyes: {
+        present: (w) => typeof prop(w, 'getCkyConsent') === 'function',
+        ask: (w, category) => {
+            const categories = prop(call(prop(w, 'getCkyConsent'), w), 'categories');
+            return byName({ necessary: 'necessary', preferences: 'functional', statistics: 'analytics', marketing: 'advertisement' }, (k) => bool(prop(categories, k)))(w, category);
+        },
+    },
+    // Complianz: cmplz_has_consent(category) → boolean.
+    complianz: {
+        present: (w) => typeof prop(w, 'cmplz_has_consent') === 'function',
+        ask: (w, category) => byName({ necessary: 'functional', preferences: 'preferences', statistics: 'statistics', marketing: 'marketing' }, (k) => bool(call(prop(w, 'cmplz_has_consent'), w, k)))(w, category),
+    },
+    // Klaro: klaro.getManager().consents → {service: boolean}; the category names a service.
+    klaro: {
+        present: (w) => typeof prop(prop(w, 'klaro'), 'getManager') === 'function',
+        ask: (w, category) => {
+            const klaro = prop(w, 'klaro');
+            const consents = prop(call(prop(klaro, 'getManager'), klaro), 'consents');
+            return bool(prop(consents, category));
+        },
+    },
+    // IAB TCF v2: Purpose 1 (store and access information on a device) governs the cookie; where
+    // GDPR doesn't apply, no consent is needed.
+    tcf: {
+        present: (w) => typeof prop(w, '__tcfapi') === 'function',
+        ask: (w) => {
+            const data = tcfData(w);
+            if (!data)
+                return undefined;
+            if (data.gdprApplies === false)
+                return true;
+            return bool(prop(prop(prop(data, 'purpose'), 'consents'), '1')) ?? false;
+        },
+    },
+    // Google Consent Mode: ad_storage / analytics_storage / functionality_storage, updated else default.
+    consent_mode: {
+        present: (w) => isBag(prop(prop(prop(w, 'google_tag_data'), 'ics'), 'entries')),
+        ask: (w, category) => {
+            const entries = prop(prop(prop(w, 'google_tag_data'), 'ics'), 'entries');
+            return byName({ preferences: 'functionality_storage', statistics: 'analytics_storage', marketing: 'ad_storage' }, (k) => {
+                const e = prop(entries, k);
+                return bool(prop(e, 'update')) ?? bool(prop(e, 'default'));
+            })(w, category);
+        },
+    },
+};
+function appDecision(appConsent) {
+    let d = appConsent;
+    if (typeof appConsent === 'function') {
+        try {
+            d = appConsent();
+        }
+        catch {
+            d = undefined;
+        }
+    }
+    if (d === 'granted' || d === true)
+        return true;
+    if (d === 'denied' || d === false)
+        return false;
+    return undefined;
+}
+/**
+ * Whether the referral cookie's ids may be read, and who decided. A consent
+ * manager on the page decides (`provider`: `auto` tries each in order, a
+ * manager id asks only that one); a manager that doesn't know either category
+ * answers no. With no manager, or `provider: 'app'`, the app's definite answer
+ * decides; else no.
+ */
+function detectConsent(win, categories, options = {}) {
+    const provider = options.provider || 'auto';
+    const fromApp = () => {
+        const app = appDecision(options.appConsent);
+        return app === undefined ? { granted: false, by: 'none' } : { granted: app, by: 'app' };
+    };
+    if (provider === 'app')
+        return fromApp();
+    const ids = provider === 'auto' ? exports.CONSENT_PROVIDERS : [provider];
+    const names = categories.filter((c) => typeof c === 'string' && c.trim().length > 0);
+    for (const id of ids) {
+        const m = MANAGERS[id];
+        let present = false;
+        try {
+            present = !!m && m.present(win);
+        }
+        catch {
+            present = false;
+        }
+        if (!m || !present)
+            continue;
+        for (const name of names) {
+            let v;
+            try {
+                v = m.ask(win, name);
+            }
+            catch {
+                v = undefined;
+            }
+            if (v !== undefined)
+                return { granted: v, by: id };
+        }
+        return { granted: false, by: id };
+    }
+    return fromApp();
+}
+/** Which consent manager is on the page (`auto` order), or null. For diagnostics. */
+function detectConsentProvider(win) {
+    for (const id of exports.CONSENT_PROVIDERS) {
+        try {
+            if (MANAGERS[id].present(win))
+                return id;
+        }
+        catch {
+            // keep looking
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=referral-detect.js.map

package/dist/referral-detect.js.map

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

package/dist/referral.d.ts

@@ -6,25 +6,31 @@
  * What is captured, when the instance has referrals on (`referrals` in
  * `GET /v1/client/environment`): ONE source, in precedence order, never
  * mixing fields across sources:
- *  1. the page's referral script, `window.aff.getReferral()`
- *     (`{code, clickId, anonId, ts}`), or explicit `ref_*` parameters
- *     (`ref`, `ref_click_id`, `ref_anon_id`, `ref_consent`, `ref_captured_at`)
- *     on the page URL;
- *  2. the referral code from the page URL — the instance's URL parameters
+ *  1. the app's own reader (`referralSource`), for any referral program;
+ *  2. a referral program's script on the page, among the instance's
+ *     `browser_sources` (Referalli's `aff.getReferral()`, Rewardful, Tolt,
+ *     PromoteKit; see ./referral-detect);
+ *  3. explicit `ref_*` parameters (`ref`, `ref_click_id`, `ref_anon_id`,
+ *     `ref_consent`, `ref_captured_at`) on the page URL;
+ *  4. the referral code from the page URL — the instance's URL parameters
  *     (default `ref`, `via`, `aff`) on the current page, the page the SDK first
  *     loaded on, and the `redirect_url` / `after_url` query of either;
- *  3. the referral platform's first-party tracking cookie (the instance's
- *     `context_cookie`): JSON or URL-encoded JSON
- *     `{code?, clickId?, anonId?, ts?, exp?}`, or a plain click id. An expired
- *     cookie is ignored.
+ *  5. the instance's tracking cookie (`context_cookie`): JSON or URL-encoded
+ *     JSON `{code?, clickId?, anonId?, ts?, exp?}`, or a plain click id. An
+ *     expired cookie is ignored;
+ *  6. a referral program's own cookies, among `browser_sources`
+ *     (FirstPromoter, PartnerStack, Dub).
  * Click and anonymous ids are sent only with consent; without it only the
- * code goes.
+ * code goes. The capture says where it came from (`source`) and who decided
+ * consent (`consent_by`), for the delivery log.
  *
- * Consent: when Cookie Munch is on the page (`window.CookieMunch`), the cookie
- * is read only when the instance's consent category is granted (else its
- * fallback category). Without a consent manager the cookie is read only when
- * the app says its own consent manager allowed it (`referralConsent:
- * 'granted'`). Otherwise the URL code alone is sent. The SDK never writes the
+ * Consent: the consent manager on the page decides (the instance's
+ * `consent_provider`: `auto` finds Cookie Munch, OneTrust, Cookiebot, Didomi,
+ * Usercentrics, Osano, CookieYes, Complianz, Klaro, any IAB TCF v2 manager or
+ * Google Consent Mode), for the instance's consent category, else its fallback
+ * category. With no manager on the page, or `consent_provider: 'app'`, the
+ * app's own decision (`referralConsent`) applies. Otherwise only the code is
+ * sent. The SDK never writes a
  * cookie. Nothing captured is trusted: the server re-validates every field.
  *
  * Opt out with `referral: false` (per client, or page-wide with
@@ -34,9 +40,15 @@
  * `ref_*` query parameters: {@link signIn} / {@link signUp},
  * {@link withReferralParams} and {@link referralParams}.
  */
+import { type ReferralSourceReader } from './referral-detect';
+export type { ReferralSourceReader } from './referral-detect';
 /** The instance's public referral settings, camelCased. */
 export interface ReferralConfig {
     enabled: boolean;
+    /** The referral programs' scripts and cookies to read (`browser_sources`), in order. */
+    sources: string[];
+    /** Which consent manager decides: `auto`, a manager id, or `app` (only the app's `referralConsent`). */
+    consentProvider: string;
     /** URL query parameters that carry a code, in priority order. */
     urlParams: string[];
     /** The tracking cookie to read under consent; null = never read a cookie. */
@@ -58,6 +70,10 @@ export interface ReferralCapture {
     consent: 'granted' | 'not_required';
     /** ISO 8601. */
     captured_at: string;
+    /** Where it came from: `custom`, a program id (e.g. `rewardful`), `url` or `cookie`. */
+    source?: string;
+    /** Who decided consent for the ids: `app`, `url`, a consent manager id, or `none`. */
+    consent_by?: string;
 }
 /**
  * The app's own consent decision for the referral cookie, used only when no
@@ -71,6 +87,11 @@ export interface ReferralCaptureOptions {
     referral?: false | 'auto' | undefined;
     /** See {@link ReferralConsent}. */
     referralConsent?: ReferralConsent;
+    /**
+     * Your own reader, for a referral program the SDK doesn't know: return
+     * `{code, clickId, anonId}` (any of them) or null. Tried before everything else.
+     */
+    referralSource?: ReferralSourceReader;
 }
 export declare const DISABLED_REFERRAL_CONFIG: Readonly<ReferralConfig>;
 /** A well-formed code / click id / anonymous id, or null. */
@@ -104,9 +125,11 @@ export declare function parseReferralCookie(value: string | null | undefined, no
 /** A cookie's value from a `document.cookie` string, or null. */
 export declare function readCookieValue(cookies: string | null | undefined, name: string): string | null;
 /**
- * Whether the referral cookie may be read. Cookie Munch on the page decides
- * when present (the instance's category, else its fallback category); else
- * the app's own `referralConsent`.
+ * Whether the referral cookie may be read, with only Cookie Munch to ask (the
+ * shape before consent managers were detected generally). Cookie Munch on the
+ * page decides when present (the instance's category, else its fallback
+ * category); else the app's own `referralConsent`. See {@link detectConsent}
+ * for every manager.
  */
 export declare function referralConsentGranted(config: Pick<ReferralConfig, 'consentCategory' | 'consentFallbackCategory'>, cookieMunch: unknown, appConsent: ReferralConsent | undefined): boolean;
 /** Everything {@link captureReferral} reads from the page. */
@@ -115,9 +138,11 @@ export interface ReferralPage {
     searches: readonly string[];
     /** `document.cookie`. */
     cookies?: string | null;
-    /** `window.CookieMunch`, if any. */
+    /** `window`: its referral scripts and consent manager are read. */
+    win?: unknown;
+    /** `window.CookieMunch`, when no `win` is given (older callers). */
     cookieMunch?: unknown;
-    /** `window.aff`, the page's referral script, if any (`getReferral()` → `{code, clickId, anonId, ts}`). */
+    /** `window.aff`, when no `win` is given (older callers). */
     aff?: unknown;
     /** Base for resolving a relative redirect_url. */
     base?: string;
@@ -132,13 +157,12 @@ export declare function explicitReferralFromSearch(search: string | null | undef
 }) | null;
 /**
  * Capture the referral for a request, or null when there is nothing to send.
- * Pure. One source wins, in order: the page's referral script, explicit
- * `ref_*` URL parameters, a code in the instance's URL parameters, the
- * tracking cookie. Fields are never mixed across sources. Ids need consent
- * (Cookie Munch, the app's `referralConsent`, or `ref_consent=granted` on an
- * explicit URL).
+ * Pure. One source wins, in the order described at the top of this module;
+ * fields are never mixed across sources. Ids need consent: the app's
+ * `referralConsent`, `ref_consent=granted` on an explicit URL, or the consent
+ * manager on the page.
  */
-export declare function captureReferral(config: ReferralConfig, page: ReferralPage, appConsent?: ReferralConsent): ReferralCapture | null;
+export declare function captureReferral(config: ReferralConfig, page: ReferralPage, appConsent?: ReferralConsent, customSource?: ReferralSourceReader): ReferralCapture | null;
 /** Whether a FAPI POST path starts or continues a sign-in / sign-up (and so takes `referral`). */
 export declare function acceptsReferral(path: string): boolean;
 /**
@@ -191,11 +215,17 @@ export interface ReferralRedirectOptions {
     referral?: false | 'auto';
     /**
      * The app's consent for referral tracking (click and anonymous ids). When
-     * omitted, the page-wide `referralConsent` applies, else Cookie Munch on the
-     * page (`referrals`, else `marketing`), else no consent (code only).
+     * omitted, the page-wide `referralConsent` applies, else the consent manager
+     * on the page (`referrals`, else `marketing`), else no consent (code only).
      */
     consent?: ReferralConsent;
-    /** The instance's config, when the app has it; defaults to `ref` / `via` / `aff` and no cookie. */
+    /** Your own reader for a referral program the SDK doesn't know (see {@link ReferralCaptureOptions.referralSource}). */
+    source?: ReferralSourceReader;
+    /**
+     * The instance's config, when the app has it. Defaults: `ref` / `via` /
+     * `aff`, no tracking cookie, every known referral script and cookie, and
+     * any consent manager.
+     */
     config?: ReferralConfig;
 }
 /**