@atlasauth/js 0.11.0 → 0.13.0

package/dist/referral.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Referral attribution: capture the referral a visitor arrived with and send it
+ * on every sign-in / sign-up start, so the user Atlas creates is attributed to
+ * whoever referred them.
+ *
+ * What is captured, when the instance has referrals on (`referrals` in
+ * `GET /v1/client/environment`):
+ *  - 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;
+ *  - with consent, the referral platform's first-party tracking cookie (the
+ *    instance's `context_cookie`): JSON or URL-encoded JSON
+ *    `{code?, clickId?, anonId?}`, or a plain click id. A URL code wins over the
+ *    cookie's code.
+ *
+ * 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
+ * cookie. Nothing captured is trusted: the server re-validates every field.
+ *
+ * Opt out with `referral: false` (per client, or page-wide with
+ * {@link configureReferralCapture}).
+ */
+/** The instance's public referral settings, camelCased. */
+export interface ReferralConfig {
+    enabled: boolean;
+    /** URL query parameters that carry a code, in priority order. */
+    urlParams: string[];
+    /** The tracking cookie to read under consent; null = never read a cookie. */
+    contextCookie: string | null;
+    consentCategory: string;
+    consentFallbackCategory: string | null;
+    /** `always`: a sign-up carrying a referral code must pass the bot challenge. */
+    challengeReferredSignups: 'always' | 'inherit';
+}
+/** The `referral` object a sign-in / sign-up request carries (snake_case, as the API takes it). */
+export interface ReferralCapture {
+    code: string | null;
+    click_id: string | null;
+    anon_id: string | null;
+    consent: 'granted' | 'not_required';
+    /** ISO 8601. */
+    captured_at: string;
+}
+/**
+ * The app's own consent decision for the referral cookie, used only when no
+ * Cookie Munch is on the page. `'granted'` / `true` allow reading it; anything
+ * else does not. A function is asked at each sign-in / sign-up start.
+ */
+export type ReferralConsent = 'granted' | 'denied' | boolean | (() => 'granted' | 'denied' | boolean | null | undefined);
+/** The referral options a FAPI client and the prebuilt components take. */
+export interface ReferralCaptureOptions {
+    /** `false` turns referral capture off. */
+    referral?: false | undefined;
+    /** See {@link ReferralConsent}. */
+    referralConsent?: ReferralConsent;
+}
+export declare const DISABLED_REFERRAL_CONFIG: Readonly<ReferralConfig>;
+/** A well-formed code / click id / anonymous id, or null. */
+export declare function referralToken(value: unknown): string | null;
+/**
+ * Read the referral config from a `/v1/client/environment` body (or its
+ * `referrals` object). Missing or malformed → disabled.
+ */
+export declare function referralConfigFrom(body: unknown): ReferralConfig;
+/** The first well-formed code among `params` in a query string. */
+export declare function referralCodeFromSearch(search: string | null | undefined, params: readonly string[]): string | null;
+/** The query strings a code may be in: each search, plus its `redirect_url` / `after_url` targets' queries. */
+export declare function referralSearches(searches: readonly string[], base?: string): string[];
+/**
+ * Parse a tracking-cookie value: JSON or URL-encoded JSON `{code?, clickId?,
+ * anonId?}` (snake_case accepted too); a plain value is a click id.
+ */
+export declare function parseReferralCookie(value: string | null | undefined): {
+    code: string | null;
+    clickId: string | null;
+    anonId: string | null;
+} | null;
+/** 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`.
+ */
+export declare function referralConsentGranted(config: Pick<ReferralConfig, 'consentCategory' | 'consentFallbackCategory'>, cookieMunch: unknown, appConsent: ReferralConsent | undefined): boolean;
+/** Everything {@link captureReferral} reads from the page. */
+export interface ReferralPage {
+    /** Query strings to look in, most relevant first (current page, landing page). */
+    searches: readonly string[];
+    /** `document.cookie`. */
+    cookies?: string | null;
+    /** `window.CookieMunch`, if any. */
+    cookieMunch?: unknown;
+    /** Base for resolving a relative redirect_url. */
+    base?: string;
+    /** ISO time of capture. */
+    capturedAt?: string;
+}
+/** Capture the referral for a request, or null when there is nothing to send. Pure. */
+export declare function captureReferral(config: ReferralConfig, page: ReferralPage, appConsent?: ReferralConsent): 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;
+/**
+ * Remember the current page's query, so a code the visitor landed with
+ * survives client-side navigation that drops it. In memory only (never
+ * stored). Called when the SDK loads and whenever a client is created.
+ */
+export declare function rememberReferralLanding(): void;
+/**
+ * Page-wide referral options, for apps whose framework creates FAPI clients
+ * internally: `configureReferralCapture({ referral: false })` opts out,
+ * `{ referralConsent: 'granted' }` tells the SDK the app's own consent
+ * manager allowed the referral cookie. A client's own options win.
+ */
+export declare function configureReferralCapture(options: ReferralCaptureOptions): void;
+/** The page-wide options set with {@link configureReferralCapture}. */
+export declare function referralCaptureDefaults(): ReferralCaptureOptions;
+/** The key an instance's referral config is cached under (a FAPI origin + publishable key). */
+export declare function referralCacheKeyFor(baseUrl: string | null | undefined, publishableKey: string): string;
+/**
+ * Record an instance's referral config from a `/v1/client/environment` or
+ * `/v1/appearance` body it was fetched with. A body without `referrals` (an
+ * older server) is ignored.
+ */
+export declare function seedReferralConfig(cacheKey: string, environmentBody: unknown): void;
+/** Forget every cached referral config (tests; an app switching instances). */
+export declare function resetReferralCapture(): void;
+/** What the referral helpers need from a FAPI client. */
+export interface ReferralClient {
+    readonly referralCacheKey: string;
+    readonly referralOptions: ReferralCaptureOptions;
+    get<T>(path: string): Promise<{
+        ok: boolean;
+        data: T | null;
+    }>;
+}
+/** The instance's referral config, fetched once per page (and seeded by any environment read). */
+export declare function loadReferralConfig(client: ReferralClient): Promise<ReferralConfig>;
+/** The referral this client should send now, or null (off, opted out, nothing captured). Never throws. */
+export declare function currentReferral(client: ReferralClient): Promise<ReferralCapture | null>;
+/**
+ * Whether a sign-up / sign-in form should show the bot challenge because a
+ * referral code was captured and the instance requires it for referred
+ * sign-ups (even with the captcha otherwise off).
+ */
+export declare function referralChallengeRequired(client: ReferralClient): Promise<boolean>;

package/dist/referral.js

@@ -0,0 +1,399 @@
+"use strict";
+/**
+ * Referral attribution: capture the referral a visitor arrived with and send it
+ * on every sign-in / sign-up start, so the user Atlas creates is attributed to
+ * whoever referred them.
+ *
+ * What is captured, when the instance has referrals on (`referrals` in
+ * `GET /v1/client/environment`):
+ *  - 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;
+ *  - with consent, the referral platform's first-party tracking cookie (the
+ *    instance's `context_cookie`): JSON or URL-encoded JSON
+ *    `{code?, clickId?, anonId?}`, or a plain click id. A URL code wins over the
+ *    cookie's code.
+ *
+ * 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
+ * cookie. Nothing captured is trusted: the server re-validates every field.
+ *
+ * Opt out with `referral: false` (per client, or page-wide with
+ * {@link configureReferralCapture}).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DISABLED_REFERRAL_CONFIG = void 0;
+exports.referralToken = referralToken;
+exports.referralConfigFrom = referralConfigFrom;
+exports.referralCodeFromSearch = referralCodeFromSearch;
+exports.referralSearches = referralSearches;
+exports.parseReferralCookie = parseReferralCookie;
+exports.readCookieValue = readCookieValue;
+exports.referralConsentGranted = referralConsentGranted;
+exports.captureReferral = captureReferral;
+exports.acceptsReferral = acceptsReferral;
+exports.rememberReferralLanding = rememberReferralLanding;
+exports.configureReferralCapture = configureReferralCapture;
+exports.referralCaptureDefaults = referralCaptureDefaults;
+exports.referralCacheKeyFor = referralCacheKeyFor;
+exports.seedReferralConfig = seedReferralConfig;
+exports.resetReferralCapture = resetReferralCapture;
+exports.loadReferralConfig = loadReferralConfig;
+exports.currentReferral = currentReferral;
+exports.referralChallengeRequired = referralChallengeRequired;
+exports.DISABLED_REFERRAL_CONFIG = Object.freeze({
+    enabled: false,
+    urlParams: [],
+    contextCookie: null,
+    consentCategory: 'referrals',
+    consentFallbackCategory: 'marketing',
+    challengeReferredSignups: 'inherit',
+});
+const TOKEN = /^[A-Za-z0-9_-]{3,64}$/;
+const PARAM = /^[A-Za-z0-9_.-]{1,40}$/;
+const COOKIE_NAME = /^[A-Za-z0-9_.-]{1,64}$/;
+const isRecord = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+/** A well-formed code / click id / anonymous id, or null. */
+function referralToken(value) {
+    if (typeof value !== 'string')
+        return null;
+    const v = value.trim();
+    return TOKEN.test(v) ? v : null;
+}
+/**
+ * Read the referral config from a `/v1/client/environment` body (or its
+ * `referrals` object). Missing or malformed → disabled.
+ */
+function referralConfigFrom(body) {
+    const raw = isRecord(body) && isRecord(body.referrals) ? body.referrals : body;
+    if (!isRecord(raw) || raw.enabled !== true)
+        return { ...exports.DISABLED_REFERRAL_CONFIG, urlParams: [] };
+    const params = Array.isArray(raw.url_params)
+        ? raw.url_params.filter((p) => typeof p === 'string' && PARAM.test(p)).slice(0, 10)
+        : [];
+    return {
+        enabled: true,
+        urlParams: params.length ? params : ['ref', 'via', 'aff'],
+        contextCookie: typeof raw.context_cookie === 'string' && COOKIE_NAME.test(raw.context_cookie) ? raw.context_cookie : null,
+        consentCategory: typeof raw.consent_category === 'string' && raw.consent_category ? raw.consent_category : 'referrals',
+        consentFallbackCategory: typeof raw.consent_fallback_category === 'string' && raw.consent_fallback_category
+            ? raw.consent_fallback_category
+            : null,
+        challengeReferredSignups: raw.challenge_referred_signups === 'always' ? 'always' : 'inherit',
+    };
+}
+/** The first well-formed code among `params` in a query string. */
+function referralCodeFromSearch(search, params) {
+    if (!search)
+        return null;
+    let query;
+    try {
+        query = new URLSearchParams(search);
+    }
+    catch {
+        return null;
+    }
+    for (const name of params) {
+        const code = referralToken(query.get(name));
+        if (code)
+            return code;
+    }
+    return null;
+}
+/** The query strings a code may be in: each search, plus its `redirect_url` / `after_url` targets' queries. */
+function referralSearches(searches, base) {
+    const out = [];
+    const add = (s) => {
+        if (s && !out.includes(s))
+            out.push(s);
+    };
+    for (const search of searches)
+        add(search);
+    for (const search of searches) {
+        let query;
+        try {
+            query = new URLSearchParams(search);
+        }
+        catch {
+            continue;
+        }
+        for (const key of ['redirect_url', 'after_url', 'redirect_url_complete', 'after_sign_up_url', 'after_sign_in_url']) {
+            const target = query.get(key);
+            if (!target)
+                continue;
+            try {
+                add(new URL(target, base ?? 'https://invalid.example').search);
+            }
+            catch {
+                // not a URL
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Parse a tracking-cookie value: JSON or URL-encoded JSON `{code?, clickId?,
+ * anonId?}` (snake_case accepted too); a plain value is a click id.
+ */
+function parseReferralCookie(value) {
+    if (typeof value !== 'string' || !value || value.length > 4096)
+        return null;
+    let decoded = value;
+    try {
+        decoded = decodeURIComponent(value);
+    }
+    catch {
+        // keep the raw value
+    }
+    const json = (s) => {
+        if (!s.startsWith('{'))
+            return null;
+        try {
+            const parsed = JSON.parse(s);
+            return isRecord(parsed) ? parsed : null;
+        }
+        catch {
+            return null;
+        }
+    };
+    const obj = json(value.trim()) ?? json(decoded.trim());
+    if (obj) {
+        const out = {
+            code: referralToken(obj.code),
+            clickId: referralToken(obj.clickId ?? obj.click_id),
+            anonId: referralToken(obj.anonId ?? obj.anon_id),
+        };
+        return out.code || out.clickId || out.anonId ? out : null;
+    }
+    const clickId = referralToken(decoded);
+    return clickId ? { code: null, clickId, anonId: null } : null;
+}
+/** A cookie's value from a `document.cookie` string, or null. */
+function readCookieValue(cookies, name) {
+    if (!cookies)
+        return null;
+    for (const part of cookies.split(';')) {
+        const p = part.trim();
+        if (p.startsWith(`${name}=`))
+            return p.slice(name.length + 1);
+    }
+    return 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`.
+ */
+function referralConsentGranted(config, cookieMunch, appConsent) {
+    let consent;
+    try {
+        consent = isRecord(cookieMunch) || typeof cookieMunch === 'function' ? cookieMunch.consent : undefined;
+    }
+    catch {
+        consent = undefined;
+    }
+    if (isRecord(consent)) {
+        let v = consent[config.consentCategory];
+        if (typeof v !== 'boolean' && config.consentFallbackCategory)
+            v = consent[config.consentFallbackCategory];
+        return v === true;
+    }
+    let decision = appConsent;
+    if (typeof appConsent === 'function') {
+        try {
+            decision = appConsent();
+        }
+        catch {
+            decision = undefined;
+        }
+    }
+    return decision === 'granted' || decision === true;
+}
+/** Capture the referral for a request, or null when there is nothing to send. Pure. */
+function captureReferral(config, page, appConsent) {
+    if (!config.enabled)
+        return null;
+    let code = null;
+    for (const search of referralSearches(page.searches, page.base)) {
+        code = referralCodeFromSearch(search, config.urlParams);
+        if (code)
+            break;
+    }
+    const cookie = config.contextCookie && referralConsentGranted(config, page.cookieMunch, appConsent)
+        ? parseReferralCookie(readCookieValue(page.cookies, config.contextCookie))
+        : null;
+    const out = {
+        code: code ?? cookie?.code ?? null,
+        click_id: cookie?.clickId ?? null,
+        anon_id: cookie?.anonId ?? null,
+        consent: cookie ? 'granted' : 'not_required',
+        captured_at: page.capturedAt ?? new Date().toISOString(),
+    };
+    return out.code || out.click_id || out.anon_id ? out : null;
+}
+/** The FAPI POST paths that take `referral`: every sign-in / sign-up start and the steps that continue one. */
+const REFERRAL_EXACT = new Set([
+    '/v1/client/sign_ups',
+    '/v1/client/sign_ins',
+    '/v1/client/sign_ins/oauth',
+    '/v1/client/sign_ins/sso',
+    '/v1/client/sign_ins/saml',
+    '/v1/client/sign_ins/discourse',
+    '/v1/client/sign_ins/id_token',
+    '/v1/client/sign_ins/id_token/nonce',
+    '/v1/client/sign_ins/external_jwt',
+    '/v1/client/sign_ins/ldap',
+    '/v1/client/sign_ins/passkey/finish',
+    '/v1/oauth/telegram',
+    '/v1/oauth/siwe/nonce',
+    '/v1/oauth/siwe/verify',
+    '/v1/oauth/siws/nonce',
+    '/v1/oauth/siws/verify',
+    '/v1/oauth/siwf/nonce',
+    '/v1/oauth/siwf/verify',
+]);
+const REFERRAL_STEP = /^\/v1\/client\/(sign_ins\/[^/]+\/(prepare_first_factor|attempt_first_factor)|sign_ups\/[^/]+\/(prepare_verification|attempt_verification))$/;
+/** Whether a FAPI POST path starts or continues a sign-in / sign-up (and so takes `referral`). */
+function acceptsReferral(path) {
+    const p = path.split('?')[0] ?? path;
+    return REFERRAL_EXACT.has(p) || REFERRAL_STEP.test(p);
+}
+const browser = () => typeof window === 'undefined' ? null : window;
+/** The query strings the page has shown since the SDK loaded (the landing query first). */
+const landingSearches = [];
+let landingAt = null;
+/**
+ * Remember the current page's query, so a code the visitor landed with
+ * survives client-side navigation that drops it. In memory only (never
+ * stored). Called when the SDK loads and whenever a client is created.
+ */
+function rememberReferralLanding() {
+    const search = browser()?.location?.search;
+    if (!search || landingSearches.includes(search))
+        return;
+    landingSearches.push(search);
+    landingAt ??= new Date().toISOString();
+}
+rememberReferralLanding();
+let pageOptions = {};
+/**
+ * Page-wide referral options, for apps whose framework creates FAPI clients
+ * internally: `configureReferralCapture({ referral: false })` opts out,
+ * `{ referralConsent: 'granted' }` tells the SDK the app's own consent
+ * manager allowed the referral cookie. A client's own options win.
+ */
+function configureReferralCapture(options) {
+    pageOptions = { ...options };
+}
+/** The page-wide options set with {@link configureReferralCapture}. */
+function referralCaptureDefaults() {
+    return pageOptions;
+}
+const configs = new Map();
+/** The key an instance's referral config is cached under (a FAPI origin + publishable key). */
+function referralCacheKeyFor(baseUrl, publishableKey) {
+    return `${baseUrl ?? ''}|${publishableKey}`;
+}
+/**
+ * Record an instance's referral config from a `/v1/client/environment` or
+ * `/v1/appearance` body it was fetched with. A body without `referrals` (an
+ * older server) is ignored.
+ */
+function seedReferralConfig(cacheKey, environmentBody) {
+    if (!isRecord(environmentBody) || !('referrals' in environmentBody))
+        return;
+    configs.set(cacheKey, Promise.resolve(referralConfigFrom(environmentBody)));
+}
+/** Forget every cached referral config (tests; an app switching instances). */
+function resetReferralCapture() {
+    configs.clear();
+    landingSearches.length = 0;
+    landingAt = null;
+    pageOptions = {};
+}
+/** The instance's referral config, fetched once per page (and seeded by any environment read). */
+function loadReferralConfig(client) {
+    let pending = configs.get(client.referralCacheKey);
+    if (!pending) {
+        const key = client.referralCacheKey;
+        // A failed read reads as "off" for this start and is not cached, so a later
+        // start asks again.
+        const failed = () => {
+            if (configs.get(key) === pending)
+                configs.delete(key);
+            return { ...exports.DISABLED_REFERRAL_CONFIG, urlParams: [] };
+        };
+        pending = client
+            .get('/v1/client/environment')
+            .then((r) => (r.ok ? referralConfigFrom(r.data) : failed()))
+            .catch(failed);
+        configs.set(key, pending);
+    }
+    return pending;
+}
+/**
+ * No config yet (no environment / appearance read on this page) and no query
+ * anywhere to find a code in: nothing to send, and no reason to ask the
+ * server. A cookie-only referral is sent once a prebuilt form (or any
+ * environment read) has loaded the config.
+ */
+function worthAsking(client) {
+    return configs.has(client.referralCacheKey) || !!browser()?.location?.search || landingSearches.length > 0;
+}
+function effectiveOptions(client) {
+    const own = client.referralOptions;
+    return {
+        referral: own.referral ?? pageOptions.referral,
+        referralConsent: own.referralConsent ?? pageOptions.referralConsent,
+    };
+}
+/** The referral this client should send now, or null (off, opted out, nothing captured). Never throws. */
+async function currentReferral(client) {
+    const win = browser();
+    if (!win)
+        return null;
+    const options = effectiveOptions(client);
+    if (options.referral === false)
+        return null;
+    try {
+        const current = win.location?.search ?? '';
+        if (!worthAsking(client))
+            return null;
+        const config = await loadReferralConfig(client);
+        if (!config.enabled)
+            return null;
+        return captureReferral(config, {
+            searches: [current, ...landingSearches],
+            cookies: win.document?.cookie ?? null,
+            cookieMunch: win.CookieMunch,
+            base: win.location?.href,
+            capturedAt: landingAt ?? undefined,
+        }, options.referralConsent);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Whether a sign-up / sign-in form should show the bot challenge because a
+ * referral code was captured and the instance requires it for referred
+ * sign-ups (even with the captcha otherwise off).
+ */
+async function referralChallengeRequired(client) {
+    if (!browser() || effectiveOptions(client).referral === false || !worthAsking(client))
+        return false;
+    try {
+        const config = await loadReferralConfig(client);
+        if (config.challengeReferredSignups !== 'always')
+            return false;
+        const ref = await currentReferral(client);
+        return !!ref?.code;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=referral.js.map

package/dist/referral.js.map

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

package/dist/sdk-advisory.d.ts

@@ -0,0 +1,44 @@
+/**
+ * SDK version advisories.
+ *
+ * Every Atlas browser SDK names itself on its Frontend API requests
+ * (`X-Atlas-SDK: @atlasauth/react/0.10.0`). When that version has a known bug
+ * fixed in a later release, the response carries
+ * `Atlas-SDK-Advisory: upgrade; min=0.8.1; reason=email_code_sign_in` (several
+ * comma-separated), and the SDK logs ONE console warning per advisory per page
+ * load, so a pinned 0.x version (the caret trap: `^0.8.0` never moves past a
+ * lockfile's 0.8.0) is noticed by whoever opens the console.
+ */
+/** Which SDK a request comes from. */
+export interface AtlasSdkInfo {
+    /** The npm package, e.g. `@atlasauth/react`. */
+    name: string;
+    version: string;
+}
+export declare const ATLAS_JS_SDK: AtlasSdkInfo;
+/** The request header naming the SDK. */
+export declare const SDK_HEADER = "x-atlas-sdk";
+/** The response header carrying advisories (exposed to cross-origin SDKs by the Frontend API). */
+export declare const SDK_ADVISORY_HEADER = "atlas-sdk-advisory";
+/** `@atlasauth/react/0.10.0`. */
+export declare function sdkHeaderValue(sdk: AtlasSdkInfo): string;
+export interface SdkAdvisoryNotice {
+    action: string;
+    /** The first version that fixes it. */
+    min: string | null;
+    reason: string | null;
+}
+/** Parse an `Atlas-SDK-Advisory` value; unknown parameters are ignored, garbage yields []. */
+export declare function parseSdkAdvisory(value: string | null | undefined): SdkAdvisoryNotice[];
+/** Test hook: forget what has been logged, as a new page load would. */
+export declare function resetSdkAdvisoryLog(): void;
+/**
+ * Read a response's advisory header and warn once per page load per advisory.
+ * Never throws; a response without the header (or a server that does not send
+ * it) does nothing. Returns the advisories newly logged.
+ */
+export declare function reportSdkAdvisory(response: {
+    headers?: {
+        get(name: string): string | null;
+    };
+} | null | undefined, sdk: AtlasSdkInfo, warn?: (message: string) => void): SdkAdvisoryNotice[];