@boltclaw/referrals 0.0.0-stage → 0.4.0

package/dist/loader.js

@@ -0,0 +1,524 @@
+import { normaliseOrigin } from "./origin.js";
+import { EMBED_TOKEN_FORMAT, SHARE_EVENT_CHANNELS } from "./types.js";
+export const PANEL_SOURCE = "boltclaw-referrals";
+export const HOST_SOURCE = "boltclaw-referrals-host";
+export const PROTOCOL_VERSION = 1;
+export const MIN_HEIGHT = 100;
+export const MAX_HEIGHT = 4000;
+export const PANEL_EVENT_TYPES = ["ready", "resize", "copied", "shared", "expired", "closed", "error", "inviteRequested", "dismissed"];
+export const PANEL_VIEWS = ["panel", "thank-you"];
+const TOKEN_COLOURS = ["surface", "surface_raised", "text", "muted", "border", "accent", "on_accent", "success", "warning", "danger"];
+export function checkTokens(tokens) {
+    if (typeof tokens !== "object" || tokens === null || Array.isArray(tokens))
+        throw new TypeError("tokens must be an object like { surface: \"#ffffff\" }.");
+    const colours = (value, where, numbers) => {
+        for (const [key, v] of Object.entries(value)) {
+            if (TOKEN_COLOURS.includes(key)) {
+                if (typeof v !== "string" || !/^#[0-9a-fA-F]{6}$/.test(v))
+                    throw new TypeError(`${where}${key} must be a colour like #2a9d8f.`);
+            }
+            else if (numbers && key === "radius") {
+                if (typeof v !== "number" || !Number.isInteger(v) || v < 0 || v > 24)
+                    throw new TypeError("radius must be a whole number from 0 to 24.");
+            }
+            else if (numbers && key === "spacing") {
+                if (v !== "compact" && v !== "normal" && v !== "roomy")
+                    throw new TypeError("spacing must be compact, normal or roomy.");
+            }
+            else if (numbers && key === "font_scale") {
+                const hundredths = typeof v === "number" ? Math.round(v * 100) : NaN;
+                if (!(hundredths >= 85 && hundredths <= 125 && hundredths % 5 === 0 && Math.abs(v * 100 - hundredths) < 1e-6)) {
+                    throw new TypeError("font_scale must be a step of 0.05 from 0.85 to 1.25.");
+                }
+            }
+            else if (numbers && key === "dark") {
+                if (typeof v !== "object" || v === null || Array.isArray(v))
+                    throw new TypeError("dark must be an object of colours.");
+                colours(v, "dark.", false);
+            }
+            else {
+                throw new TypeError(`${where}${key} is not a panel token.`);
+            }
+        }
+    };
+    colours(tokens, "", true);
+    return JSON.parse(JSON.stringify(tokens));
+}
+const SHARE_CHANNEL_SET = new Set(SHARE_EVENT_CHANNELS);
+const TYPE_SET = new Set(PANEL_EVENT_TYPES);
+export function parsePanelMessage(data) {
+    if (typeof data !== "object" || data === null || Array.isArray(data))
+        return null;
+    const d = data;
+    if (d.source !== PANEL_SOURCE || d.version !== PROTOCOL_VERSION)
+        return null;
+    const type = d.type;
+    if (typeof type !== "string" || !TYPE_SET.has(type))
+        return null;
+    switch (type) {
+        case "ready":
+        case "expired":
+        case "closed":
+        case "dismissed":
+            return { type: type, payload: {} };
+        case "resize": {
+            if (typeof d.height !== "number" || !Number.isFinite(d.height))
+                return null;
+            const height = Math.min(MAX_HEIGHT, Math.max(MIN_HEIGHT, Math.round(d.height)));
+            return { type: "resize", payload: { height } };
+        }
+        case "copied":
+            return d.what === "link" ? { type: "copied", payload: { what: "link" } } : null;
+        case "shared":
+            return typeof d.channel === "string" && SHARE_CHANNEL_SET.has(d.channel) ? { type: "shared", payload: { channel: d.channel } } : null;
+        case "error":
+            return typeof d.code === "string" && d.code.length > 0 && d.code.length <= 64 ? { type: "error", payload: { code: d.code } } : null;
+        case "inviteRequested":
+            return typeof d.email === "string" && d.email.length > 0 && d.email.length <= 320 ? { type: "inviteRequested", payload: { email: d.email } } : null;
+    }
+    return null;
+}
+function checkOptions(options) {
+    if (typeof options !== "object" || options === null)
+        throw new TypeError("Panel options are required.");
+    if (typeof options.token !== "string" || !EMBED_TOKEN_FORMAT.test(options.token)) {
+        throw new TypeError("token must be an embed token minted by your server (bcet_...).");
+    }
+    if (typeof options.embedKey !== "string" || options.embedKey.length === 0 || options.embedKey.length > 200) {
+        throw new TypeError("embedKey is required.");
+    }
+    const theme = options.theme === "light" || options.theme === "dark" || options.theme === "auto" ? options.theme : undefined;
+    if (options.locale !== undefined &&
+        (typeof options.locale !== "string" || options.locale.length > 35 || !/^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8}){0,2}$/.test(options.locale))) {
+        throw new TypeError("locale must be a language tag like de, fr or pt-BR.");
+    }
+    return {
+        token: options.token,
+        embedKey: options.embedKey,
+        origin: normaliseOrigin(options.origin),
+        theme,
+        thankYou: options.mode === "thank-you",
+        locale: options.locale,
+    };
+}
+function hostOrigin() {
+    const origin = typeof location !== "undefined" ? location.origin : "";
+    return origin && origin !== "null" ? origin : "";
+}
+function frameUrl(checked, modal) {
+    let fragment = `#t=${checked.token}&o=${encodeURIComponent(hostOrigin())}`;
+    if (modal)
+        fragment += "&m=1";
+    if (checked.theme)
+        fragment += `&th=${checked.theme}`;
+    if (checked.thankYou)
+        fragment += "&v=thank-you";
+    if (checked.locale)
+        fragment += `&l=${encodeURIComponent(checked.locale)}`;
+    return `${checked.origin}/r/embed/${encodeURIComponent(checked.embedKey)}${fragment}`;
+}
+function buildIframe(url, title, theme) {
+    const iframe = document.createElement("iframe");
+    iframe.setAttribute("title", title);
+    iframe.setAttribute("referrerpolicy", "no-referrer");
+    iframe.setAttribute("allow", "clipboard-write; web-share");
+    iframe.setAttribute("sandbox", "allow-scripts allow-same-origin allow-popups allow-popups-to-escape-sandbox");
+    iframe.setAttribute("src", url);
+    iframe.style.border = "0";
+    iframe.style.width = "100%";
+    iframe.style.display = "block";
+    if (theme === "light" || theme === "dark")
+        iframe.style.colorScheme = theme;
+    return iframe;
+}
+const LOCALE_TAG = /^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8}){0,2}$/;
+function createCore(iframe, origin, onMessage, unmount) {
+    const listeners = new Map();
+    let live = true;
+    let loaded = false;
+    let pendingLocale = null;
+    let pendingTheme = null;
+    let pendingTokens = null;
+    const emit = (type, payload) => {
+        for (const fn of [...(listeners.get(type) ?? [])]) {
+            try {
+                fn(payload);
+            }
+            catch {
+            }
+        }
+    };
+    const post = (message) => {
+        const target = iframe.contentWindow;
+        if (!live || !target)
+            return;
+        target.postMessage({ source: HOST_SOURCE, version: PROTOCOL_VERSION, ...message }, origin);
+    };
+    const onWindowMessage = (event) => {
+        if (!live)
+            return;
+        if (event.source !== iframe.contentWindow || iframe.contentWindow === null)
+            return;
+        if (event.origin !== origin)
+            return;
+        const parsed = parsePanelMessage(event.data);
+        if (!parsed)
+            return;
+        if (parsed.type === "resize")
+            iframe.style.height = `${parsed.payload.height}px`;
+        emit(parsed.type, parsed.payload);
+        onMessage(parsed.type);
+    };
+    window.addEventListener("message", onWindowMessage);
+    iframe.addEventListener("load", () => {
+        loaded = true;
+        if (pendingLocale !== null) {
+            post({ type: "locale", locale: pendingLocale });
+            pendingLocale = null;
+        }
+        if (pendingTheme !== null) {
+            post({ type: "theme", theme: pendingTheme });
+            pendingTheme = null;
+        }
+        if (pendingTokens !== null) {
+            post({ type: "tokens", tokens: pendingTokens });
+            pendingTokens = null;
+        }
+    });
+    const handle = {
+        iframe,
+        update(next) {
+            if (typeof next?.token !== "string" || !EMBED_TOKEN_FORMAT.test(next.token)) {
+                throw new TypeError("token must be an embed token minted by your server (bcet_...).");
+            }
+            post({ type: "token", token: next.token });
+        },
+        refresh() {
+            post({ type: "refresh" });
+        },
+        setLocale(locale) {
+            if (typeof locale !== "string" || locale.length > 35 || !LOCALE_TAG.test(locale)) {
+                throw new TypeError("locale must be a language tag like de, fr or pt-BR.");
+            }
+            if (loaded)
+                post({ type: "locale", locale });
+            else
+                pendingLocale = locale;
+        },
+        setTheme(theme) {
+            if (theme !== "light" && theme !== "dark" && theme !== "auto")
+                throw new TypeError("theme must be light, dark or auto.");
+            if (loaded)
+                post({ type: "theme", theme });
+            else
+                pendingTheme = theme;
+        },
+        setTokens(tokens) {
+            const checked = checkTokens(tokens);
+            if (loaded)
+                post({ type: "tokens", tokens: checked });
+            else
+                pendingTokens = checked;
+        },
+        unmount,
+        on(type, listener) {
+            if (!TYPE_SET.has(type))
+                return handle;
+            let set = listeners.get(type);
+            if (!set)
+                listeners.set(type, (set = new Set()));
+            set.add(listener);
+            return handle;
+        },
+        off(type, listener) {
+            listeners.get(type)?.delete(listener);
+            return handle;
+        },
+    };
+    return {
+        handle,
+        emit,
+        dispose() {
+            if (!live)
+                return;
+            live = false;
+            window.removeEventListener("message", onWindowMessage);
+            listeners.clear();
+        },
+    };
+}
+export function mountPanel(element, options) {
+    if (!element || typeof element.appendChild !== "function")
+        throw new TypeError("mountPanel needs a DOM element.");
+    const checked = checkOptions(options);
+    const iframe = buildIframe(frameUrl(checked, false), "Your referrals", checked.theme);
+    iframe.style.height = checked.thankYou ? "320px" : "480px";
+    let core = null;
+    const unmount = () => {
+        if (!core)
+            return;
+        core.dispose();
+        core = null;
+        iframe.remove();
+    };
+    core = createCore(iframe, checked.origin, () => undefined, unmount);
+    const handle = core.handle;
+    element.appendChild(iframe);
+    return handle;
+}
+let openModal = null;
+const FOCUSABLE = "a[href], button:not([disabled]), input:not([disabled]), select:not([disabled]), textarea:not([disabled]), iframe, [tabindex]:not([tabindex='-1'])";
+export function openPanel(options) {
+    const checked = checkOptions(options);
+    closePanel();
+    const opener = document.activeElement;
+    const body = document.body;
+    const previousOverflow = body.style.overflow;
+    const overlay = document.createElement("div");
+    overlay.setAttribute("data-boltclaw-referrals-overlay", "");
+    Object.assign(overlay.style, {
+        position: "fixed",
+        top: "0",
+        right: "0",
+        bottom: "0",
+        left: "0",
+        zIndex: "2147483000",
+        display: "flex",
+        alignItems: "center",
+        justifyContent: "center",
+        padding: "16px",
+        background: "rgba(0, 0, 0, 0.5)",
+    });
+    const dialog = document.createElement("div");
+    dialog.setAttribute("role", "dialog");
+    dialog.setAttribute("aria-modal", "true");
+    dialog.setAttribute("aria-label", "Your referrals");
+    dialog.setAttribute("tabindex", "-1");
+    Object.assign(dialog.style, { width: "100%", maxWidth: "480px", maxHeight: "100%", overflow: "auto", borderRadius: "12px", outline: "none" });
+    const iframe = buildIframe(frameUrl(checked, true), "Your referrals", checked.theme);
+    iframe.style.height = checked.thankYou ? "360px" : "560px";
+    dialog.appendChild(iframe);
+    overlay.appendChild(dialog);
+    let core = null;
+    let closing = false;
+    const restore = () => {
+        document.removeEventListener("keydown", onKeydown, true);
+        document.removeEventListener("focusin", onFocusin, true);
+        overlay.removeEventListener("click", onBackdrop);
+        overlay.remove();
+        body.style.overflow = previousOverflow;
+        if (opener && typeof opener.focus === "function")
+            opener.focus();
+    };
+    const unmount = () => {
+        if (!core)
+            return;
+        const done = core;
+        core = null;
+        done.dispose();
+        restore();
+        if (openModal === closer)
+            openModal = null;
+    };
+    const close = () => {
+        if (closing || !core)
+            return;
+        closing = true;
+        core.emit("closed", {});
+        unmount();
+    };
+    const closer = { close };
+    const onKeydown = (event) => {
+        if (event.key === "Escape") {
+            event.preventDefault();
+            close();
+        }
+        else if (event.key === "Tab") {
+            event.preventDefault();
+            focusInside();
+        }
+    };
+    const onFocusin = (event) => {
+        const target = event.target;
+        if (!target || !dialog.contains(target))
+            focusInside();
+    };
+    const onBackdrop = (event) => {
+        if (event.target === overlay)
+            close();
+    };
+    const focusInside = () => {
+        const target = dialog.querySelector(FOCUSABLE);
+        (target ?? dialog).focus();
+    };
+    core = createCore(iframe, checked.origin, (type) => {
+        if (type === "closed") {
+            closing = true;
+            unmount();
+        }
+        else if (type === "dismissed") {
+            close();
+        }
+    }, close);
+    const handle = core.handle;
+    body.style.overflow = "hidden";
+    body.appendChild(overlay);
+    document.addEventListener("keydown", onKeydown, true);
+    document.addEventListener("focusin", onFocusin, true);
+    overlay.addEventListener("click", onBackdrop);
+    openModal = closer;
+    dialog.focus();
+    return handle;
+}
+export function closePanel() {
+    openModal?.close();
+}
+export const NOTICE_EVENT_TYPES = ["ready", "shown", "empty", "open", "closed", "expired", "error"];
+export function checkNoticeHref(href) {
+    if (typeof href !== "string" || href.length === 0 || href.length > 512 || /[\s\\]/.test(href)) {
+        throw new TypeError("href must be a path like /settings/referrals or an https address.");
+    }
+    if (href.startsWith("/") && !href.startsWith("//"))
+        return href;
+    if (/^https:\/\/[^/?#@\s]+([/?#].*)?$/i.test(href))
+        return href;
+    throw new TypeError("href must be a path like /settings/referrals or an https address.");
+}
+export function parseNoticeMessage(data) {
+    if (typeof data !== "object" || data === null || Array.isArray(data))
+        return null;
+    const d = data;
+    if (d.source !== PANEL_SOURCE || d.version !== PROTOCOL_VERSION)
+        return null;
+    switch (d.type) {
+        case "notice":
+            if (typeof d.count !== "number" || !Number.isFinite(d.count) || typeof d.height !== "number" || !Number.isFinite(d.height))
+                return null;
+            return { type: "notice", payload: { count: Math.max(0, Math.min(10, Math.round(d.count))), height: Math.max(0, Math.min(800, Math.round(d.height))) } };
+        case "ready":
+        case "open":
+        case "closed":
+        case "expired":
+            return { type: d.type, payload: {} };
+        case "error":
+            return typeof d.code === "string" && d.code.length > 0 && d.code.length <= 64 ? { type: "error", payload: { code: d.code } } : null;
+        default:
+            return null;
+    }
+}
+export function mountNotice(element, options) {
+    if (!element || typeof element.appendChild !== "function")
+        throw new TypeError("mountNotice needs a DOM element.");
+    const checked = checkOptions({ token: options?.token, embedKey: options?.embedKey, origin: options?.origin, theme: options?.theme, locale: options?.locale });
+    const href = checkNoticeHref(options.href);
+    const navigate = options.navigate !== false;
+    const url = frameUrl(checked, false).replace("#t=", "#v=notice&h=" + encodeURIComponent(href) + "&t=");
+    const iframe = buildIframe(url, "Your new rewards", checked.theme);
+    iframe.style.height = "0px";
+    iframe.style.visibility = "hidden";
+    const listeners = new Map();
+    let live = true;
+    let loaded = false;
+    let pendingTheme = null;
+    let pendingTokens = null;
+    const emit = (type, payload) => {
+        for (const fn of [...(listeners.get(type) ?? [])]) {
+            try {
+                fn(payload);
+            }
+            catch {
+            }
+        }
+    };
+    const post = (message) => {
+        const target = iframe.contentWindow;
+        if (!live || !target)
+            return;
+        target.postMessage({ source: HOST_SOURCE, version: PROTOCOL_VERSION, ...message }, checked.origin);
+    };
+    const onWindowMessage = (event) => {
+        if (!live || event.source !== iframe.contentWindow || iframe.contentWindow === null || event.origin !== checked.origin)
+            return;
+        const parsed = parseNoticeMessage(event.data);
+        if (!parsed)
+            return;
+        if (parsed.type === "notice") {
+            const count = parsed.payload.count;
+            if (count === 0) {
+                iframe.style.display = "none";
+                emit("empty", {});
+            }
+            else {
+                const wasHidden = iframe.style.visibility === "hidden";
+                iframe.style.display = "block";
+                iframe.style.visibility = "visible";
+                const height = parsed.payload.height;
+                iframe.style.height = `${height > 0 ? height : 160}px`;
+                if (wasHidden)
+                    emit("shown", { count });
+            }
+            return;
+        }
+        if (parsed.type === "closed")
+            iframe.style.display = "none";
+        if (parsed.type === "open") {
+            emit("open", { href });
+            if (navigate)
+                window.location.assign(href);
+            return;
+        }
+        emit(parsed.type, parsed.payload);
+    };
+    window.addEventListener("message", onWindowMessage);
+    iframe.addEventListener("load", () => {
+        loaded = true;
+        if (pendingTheme !== null)
+            post({ type: "theme", theme: pendingTheme });
+        if (pendingTokens !== null)
+            post({ type: "tokens", tokens: pendingTokens });
+        pendingTheme = null;
+        pendingTokens = null;
+    });
+    const handle = {
+        iframe,
+        setTheme(theme) {
+            if (theme !== "light" && theme !== "dark" && theme !== "auto")
+                throw new TypeError("theme must be light, dark or auto.");
+            if (loaded)
+                post({ type: "theme", theme });
+            else
+                pendingTheme = theme;
+        },
+        setTokens(tokens) {
+            const t = checkTokens(tokens);
+            if (loaded)
+                post({ type: "tokens", tokens: t });
+            else
+                pendingTokens = t;
+        },
+        unmount() {
+            if (!live)
+                return;
+            live = false;
+            window.removeEventListener("message", onWindowMessage);
+            listeners.clear();
+            iframe.remove();
+        },
+        on(type, listener) {
+            if (!NOTICE_EVENT_TYPES.includes(type))
+                return handle;
+            let set = listeners.get(type);
+            if (!set)
+                listeners.set(type, (set = new Set()));
+            set.add(listener);
+            return handle;
+        },
+        off(type, listener) {
+            listeners.get(type)?.delete(listener);
+            return handle;
+        },
+    };
+    element.appendChild(iframe);
+    return handle;
+}
+//# sourceMappingURL=loader.js.map

package/dist/loader.js.map

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

package/dist/middleware.d.ts

@@ -0,0 +1,100 @@
+import { ReferralsServer, type ReferralsServerOptions } from "./server.js";
+export declare const REFERRAL_COOKIE = "bc_ref";
+export declare const DEFAULT_REFERRAL_PARAM = "via";
+export declare const ACCEPTED_PARAMS: readonly ["ref", "via", "fpr", "lmref", "tolt_referral"];
+export type AcceptedParam = (typeof ACCEPTED_PARAMS)[number];
+export declare const DEFAULT_COOKIE_DAYS = 30;
+export declare const MAX_PARAMS = 20;
+export declare function isReferralCode(value: unknown): value is string;
+export interface ReferralsMiddlewareOptions {
+    cookieDays?: number;
+    attribution?: "last_click" | "first_click";
+    params?: readonly string[];
+    programs?: Readonly<Record<string, string>>;
+    param?: string;
+    acceptParams?: readonly AcceptedParam[];
+    ipHeader?: string | false;
+    reportClicks?: ReferralsServer | (Omit<ReferralsServerOptions, "programId"> & {
+        programId?: string;
+    });
+    waitUntil?: (promise: Promise<unknown>) => void;
+    onError?: (error: unknown) => void;
+}
+export interface ReferralVisit {
+    code: string | null;
+    existing: string | null;
+    current: string | null;
+    setCookie: string | null;
+    setSubCookie: string | null;
+    click: string | null;
+    sub: string | null;
+    codes: ReferralCodeSeen[];
+    setCookies: string[];
+}
+export interface ReferralCodeSeen {
+    param: string;
+    programId: string | null;
+    code: string;
+    cookie: string;
+    existing: string | null;
+    current: string;
+    setCookie: string | null;
+    setSubCookie: string | null;
+}
+export interface RequestFacts {
+    url: string;
+    cookie: string | null;
+    secure: boolean;
+    ip?: string | null;
+    userAgent?: string | null;
+    referrer?: string | null;
+    country?: string | null;
+}
+export declare function referralCookieName(param: string | null): string;
+export declare function codeFromSearch(search: string, params: readonly string[]): string | null;
+export declare function codeFromCookie(cookie: string | null | undefined, name?: string): string | null;
+export declare function referralCodeFor(cookie: string | null | undefined, programId?: string | null, options?: Pick<ReferralsMiddlewareOptions, "programs">): string | null;
+export declare function subCookie(sub: string | null, days: number, secure: boolean, name?: string): string;
+export declare function referralCookie(code: string, days: number, secure: boolean, name?: string): string;
+export declare function referralVisit(facts: Pick<RequestFacts, "url" | "cookie" | "secure">, options?: ReferralsMiddlewareOptions): ReferralVisit;
+export declare function clientAddress(header: (name: string) => string | string[] | null | undefined, options?: Pick<ReferralsMiddlewareOptions, "ipHeader">, platform?: string | null): string | null;
+export interface WebRequestLike {
+    url: string;
+    headers: {
+        get(name: string): string | null;
+    };
+    nextUrl?: {
+        href?: string;
+        protocol?: string;
+    };
+    ip?: string;
+    geo?: {
+        country?: string;
+    };
+}
+export declare function nextReferralsMiddleware(options?: ReferralsMiddlewareOptions): (request: WebRequestLike, response?: {
+    headers: {
+        append(name: string, value: string): void;
+    };
+}, event?: {
+    waitUntil?(promise: Promise<unknown>): void;
+}) => ReferralVisit & {
+    headers: Headers;
+};
+export declare const nextReferralsProxy: typeof nextReferralsMiddleware;
+export interface ExpressRequestLike {
+    originalUrl?: string;
+    url?: string;
+    protocol?: string;
+    secure?: boolean;
+    ip?: string;
+    headers: Record<string, string | string[] | undefined>;
+}
+export interface ExpressResponseLike {
+    append?(name: string, value: string | string[]): unknown;
+    getHeader?(name: string): number | string | string[] | undefined;
+    setHeader?(name: string, value: string | string[]): unknown;
+    locals?: Record<string, unknown>;
+}
+export declare function expressReferralsMiddleware(options?: ReferralsMiddlewareOptions): (req: ExpressRequestLike, res: ExpressResponseLike, next: (error?: unknown) => void) => void;
+export declare function referralsMiddleware(options?: ReferralsMiddlewareOptions): (facts: RequestFacts) => ReferralVisit;