@mrrocket/sdk 0.0.0-stage → 0.2.0

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.tsx"],"sourcesContent":["\"use client\";\n\nimport { type ReactNode, useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport { usePathname } from \"next/navigation\";\nimport { Ctx, type CockpitContext, type CockpitUser, useCtx } from \"./context\";\nimport { Survey, forgetStoredDismissals } from \"./survey\";\nimport { RageDetector, clickInfo, seenDepth } from \"./capture\";\nimport type { ReplayHandle } from \"./replay\";\nimport {\n    type AttributionMode,\n    DEFAULT_REFERRAL_DAYS,\n    captureReferral,\n    carriesReferral,\n    forgetStoredReferral,\n    getReferral,\n    resetReferral,\n    storeReferral,\n} from \"./referral\";\nimport {\n    type CockpitConfig,\n    type CockpitEvent,\n    type ConsentChoice,\n    type ConsentMode,\n    EMBED_PARAM,\n    ID_COOKIE,\n    PREVIEW_PARAM,\n    SESSION_COOKIE,\n    SESSION_TIMEOUT_MS,\n    type UtmKey,\n    type VariantId,\n    envKey,\n    newDistinctId,\n    parsePreview,\n    readUtm,\n    resolveHost,\n    resolveVariant,\n    textChanges,\n} from \"./core\";\n\nconst YEAR_S = 60 * 60 * 24 * 365;\n/** The server takes at most 100 events and 64 KB per request; stay a little under the size. */\nconst MAX_BATCH = 100;\nconst MAX_BYTES = 60_000;\n\nconst readCookie = (name: string) => {\n    if (typeof document === \"undefined\") return undefined;\n    const raw = document.cookie\n        .split(\"; \")\n        .find((c) => c.startsWith(`${name}=`))\n        ?.slice(name.length + 1);\n    if (!raw) return undefined;\n    try {\n        return decodeURIComponent(raw);\n    } catch {\n        return raw;\n    }\n};\n\nconst writeCookie = (name: string, value: string, maxAge: number) => {\n    const secure = window.location.protocol === \"https:\" ? \"; secure\" : \"\";\n    document.cookie = `${name}=${encodeURIComponent(value)}; path=/; max-age=${maxAge}; samesite=lax${secure}`;\n};\n\nconst deleteCookie = (name: string) => {\n    document.cookie = `${name}=; path=/; max-age=0; samesite=lax`;\n};\n\n/**\n * What lives for one page load, outside React so it survives a provider that remounts on navigation: the in-memory\n * visitor id, the session, the current page's URL and referrer, and the campaign (UTM) parameters.\n * Only touched in the browser (effects and event handlers), never during a server render.\n */\nconst page: {\n    id?: string;\n    session?: { id: string; last: number };\n    url?: string;\n    referrer?: string;\n    utm: Partial<Record<UtmKey, string>>;\n} = { utm: {} };\n\nconst memoryId = () => (page.id ??= newDistinctId());\n\n/**\n * The visitor id for experiments, surveys and feedback. Only \"cookies\" reads or writes `ck_id`; the other modes keep a\n * random id in memory for this page load. The page id follows the cookie, so leaving \"cookies\" keeps the same variants.\n */\nconst visitorId = (mode: ConsentMode, write: boolean) => {\n    if (mode !== \"cookies\") return memoryId();\n    const stored = readCookie(ID_COOKIE);\n    if (stored) return (page.id = stored);\n    const id = memoryId();\n    if (write) writeCookie(ID_COOKIE, id, YEAR_S);\n    return id;\n};\n\n/** The session id for an event. Every event renews it; after 30 minutes without one a new session starts. */\nconst touchSession = (persist: boolean) => {\n    const now = Date.now();\n    const s = page.session;\n    // In \"cookies\" mode the cookie wins, so tabs share a session.\n    const id = (persist ? readCookie(SESSION_COOKIE) : undefined) ?? (s && now - s.last < SESSION_TIMEOUT_MS ? s.id : newDistinctId());\n    page.session = { id, last: now };\n    if (persist) writeCookie(SESSION_COOKIE, id, SESSION_TIMEOUT_MS / 1000);\n    return id;\n};\n\n/** On every route change: the previous in-app URL becomes the referrer, and a URL with UTM parameters replaces the old ones. */\nconst enterPage = () => {\n    const href = window.location.href;\n    if (page.url === href) return;\n    page.referrer = page.url ?? (document.referrer || undefined);\n    page.url = href;\n    const utm = readUtm(window.location.search);\n    if (Object.keys(utm).length) page.utm = utm;\n};\n\n/** Do Not Track or Global Privacy Control. */\nconst privacySignal = () => {\n    const nav = navigator as Navigator & { doNotTrack?: string | null; globalPrivacyControl?: boolean };\n    const win = window as unknown as { doNotTrack?: string | null };\n    return nav.doNotTrack === \"1\" || win.doNotTrack === \"1\" || nav.globalPrivacyControl === true;\n};\n\n/** Tells the developer once, in the browser console, why the SDK is not reaching MRRocket (a wrong host or key is the usual cause). */\nconst warned = new Set<string>();\nconst warnOnce = (message: string) => {\n    if (warned.has(message)) return;\n    warned.add(message);\n    console.warn(`[MRRocket] ${message}`);\n};\n\nconst byteLength = (s: string) => new TextEncoder().encode(s).length;\n\n/** Request bodies of at most 100 events each, under the size limit. An event too large on its own is dropped. */\nconst bodies = (key: string, events: CockpitEvent[]) => {\n    const head = `{\"key\":${JSON.stringify(key)},\"events\":[`;\n    const empty = byteLength(head) + 2;\n    const out: string[] = [];\n    let chunk: string[] = [];\n    let size = empty;\n    const close = () => {\n        if (chunk.length) out.push(`${head}${chunk.join(\",\")}]}`);\n        chunk = [];\n        size = empty;\n    };\n    for (const event of events) {\n        const json = JSON.stringify(event);\n        const n = byteLength(json) + 1;\n        if (empty + n > MAX_BYTES) continue;\n        if (chunk.length === MAX_BATCH || size + n > MAX_BYTES) close();\n        chunk.push(json);\n        size += n;\n    }\n    close();\n    return out;\n};\n\nexport interface CockpitProviderProps {\n    /** The product's public key from Cockpit › Settings › SDK. Safe in the browser. Default: `NEXT_PUBLIC_MRROCKET_KEY`. */\n    apiKey?: string;\n    /** Where MRRocket runs, like `https://app.example.com`. Default: `NEXT_PUBLIC_MRROCKET_HOST`, else the page's own origin. */\n    host?: string;\n    preview?: Record<string, VariantId>;\n    embedded?: boolean;\n    /** Config fetched on the server, to render the right variant on the first paint. */\n    config?: CockpitConfig;\n    /** Your own id for this visitor, for example a signed-in user id. Keeps variants stable without cookies. */\n    distinctId?: string;\n    /**\n     * \"cookieless\" (default) stores nothing in the browser, \"cookies\" keeps a visitor cookie for a year, \"off\" sends\n     * nothing. The SDK does not remember the choice: set it on every page load, from the prop or setConsent().\n     */\n    consent?: ConsentMode;\n    /** Send nothing when the browser asks not to be tracked (Do Not Track or Global Privacy Control). */\n    respectDnt?: boolean;\n    /**\n     * The visitor's consent to session recordings, separate from analytics (default false). Recording also needs the\n     * product to record (Cockpit › Sessions) and analytics not \"off\". Without it nothing is recorded or buffered.\n     * Change it later with `setConsent({ replay })`.\n     */\n    replay?: boolean;\n    /**\n     * Clicks and scroll depth for Heatmaps (default true): where a click landed, a short selector and a link's or\n     * button's label, never typed text. Sent under the normal analytics consent as `$click`, `$rageclick` and `$scroll`.\n     */\n    heatmaps?: boolean;\n    /** Ask visitors the surveys you run in Cockpit. Set false to switch them off. */\n    surveys?: boolean;\n    /**\n     * Affiliate referrals (`?ref=` links and MRRocket's tracked links). \"consent\" (default): stored in the first-party\n     * `mrr_ref` cookie only while consent is \"cookies\", in memory otherwise. \"always\": stored whatever the consent (only\n     * where your legal basis allows it). \"off\": referrals are ignored.\n     */\n    attribution?: AttributionMode;\n    /** The query parameter of direct partner links, default `ref` (`https://your.site/?ref=maya`). */\n    referralParam?: string;\n    children: ReactNode;\n}\n\n/**\n * Put it once around your app, in `app/layout.tsx`. It loads your experiments, keeps each visitor in one variant,\n * records page views and sends your events to Cockpit in small batches.\n *\n * `preview` forces variants for this render, for example from the `ck_preview` search param on the server,\n * so a Cockpit preview never flickers. Without it the provider reads the param itself after the first render.\n */\nexport const CockpitProvider = ({\n    apiKey: apiKeyProp,\n    host: hostProp,\n    preview: forced,\n    embedded: embeddedProp,\n    config: bootstrapConfig,\n    distinctId: bootstrapId,\n    consent: consentProp = \"cookieless\",\n    respectDnt = false,\n    replay: replayProp = false,\n    heatmaps = true,\n    surveys = true,\n    attribution = \"consent\",\n    referralParam = \"ref\",\n    children,\n}: CockpitProviderProps) => {\n    const pathname = usePathname();\n    const apiKey = apiKeyProp ?? envKey() ?? \"\";\n    const host = resolveHost(hostProp);\n    const [config, setConfig] = useState<CockpitConfig | null>(bootstrapConfig ?? null);\n    const [consent, setConsentState] = useState<ConsentMode>(consentProp);\n    const [replayConsent, setReplayConsent] = useState(replayProp);\n    const [mounted, setMounted] = useState(false);\n    const [dnt, setDnt] = useState(false);\n    // The visitor id and the consent mode it was made for; null until the browser has been read.\n    const [visitor, setVisitor] = useState<{ mode: ConsentMode; id: string } | null>(null);\n    const [identified, setIdentified] = useState<string | undefined>();\n    const [urlPreview, setUrlPreview] = useState<Record<string, VariantId>>({});\n    const [urlEmbedded, setUrlEmbedded] = useState(false);\n    const [user, setUser] = useState<CockpitUser | undefined>();\n    const [ready, setReady] = useState(!!bootstrapConfig);\n    const queue = useRef<CockpitEvent[]>([]);\n    // Calls from before the visitor was known (a child's effect runs before ours); replayed once it is.\n    const early = useRef<(() => void)[]>([]);\n    const exposed = useRef(new Set<string>());\n    const lastPage = useRef<string | null>(null);\n\n    const bootstrap = bootstrapId && bootstrapId !== \"anonymous\" ? bootstrapId : undefined;\n    const preview = useMemo(() => ({ ...urlPreview, ...forced }), [urlPreview, forced]);\n    const embedded = embeddedProp ?? urlEmbedded;\n    const effectiveConsent: ConsentMode = respectDnt && dnt ? \"off\" : consent;\n    const distinctId = identified ?? bootstrap ?? visitor?.id ?? \"anonymous\";\n    const tracking = !embedded && effectiveConsent !== \"off\" && visitor?.mode === effectiveConsent;\n    // Without cookies, events carry an id only after identify(); the server counts everyone else by its daily hash.\n    const sendId = effectiveConsent === \"cookies\" ? distinctId : identified;\n\n    // Preview flags and the browser's privacy signal, once, in the browser.\n    useEffect(() => {\n        const params = new URLSearchParams(window.location.search);\n        setUrlPreview(parsePreview(params.get(PREVIEW_PARAM)));\n        setUrlEmbedded(params.get(EMBED_PARAM) === \"1\");\n        setDnt(privacySignal());\n        setMounted(true);\n    }, []);\n\n    const setConsent = useCallback((choice: ConsentChoice) => {\n        const { analytics: mode, replay } = typeof choice === \"string\" ? { analytics: choice, replay: undefined } : choice;\n        if (mode === \"off\") queue.current.length = 0;\n        if (mode) setConsentState(mode);\n        if (typeof replay === \"boolean\") setReplayConsent(replay);\n    }, []);\n\n    // Follow the `consent` and `replay` props when they change; setConsent() calls in between stay until they do.\n    const lastProp = useRef(consentProp);\n    useEffect(() => {\n        if (lastProp.current === consentProp) return;\n        lastProp.current = consentProp;\n        setConsent(consentProp);\n    }, [consentProp, setConsent]);\n    const lastReplayProp = useRef(replayProp);\n    useEffect(() => {\n        if (lastReplayProp.current === replayProp) return;\n        lastReplayProp.current = replayProp;\n        setConsent({ replay: replayProp });\n    }, [replayProp, setConsent]);\n\n    // Storage follows consent. Leaving \"cookies\" deletes what the SDK stored; this page keeps its id in memory.\n    const storedFor = useRef<ConsentMode | null>(null);\n    useEffect(() => {\n        if (!mounted) return;\n        const before = storedFor.current;\n        storedFor.current = effectiveConsent;\n        if (before === \"cookies\" && effectiveConsent !== \"cookies\") {\n            deleteCookie(ID_COOKIE);\n            deleteCookie(SESSION_COOKIE);\n            forgetStoredDismissals();\n        }\n        if (effectiveConsent === \"off\") {\n            queue.current.length = 0;\n            page.session = undefined;\n        }\n        setVisitor({ mode: effectiveConsent, id: visitorId(effectiveConsent, !bootstrap) });\n    }, [mounted, effectiveConsent, bootstrap]);\n\n    // Experiments for this key. Without a key or when MRRocket is unreachable the page keeps control and carries on.\n    useEffect(() => {\n        if (!apiKey) warnOnce(\"No public key. Pass apiKey or set NEXT_PUBLIC_MRROCKET_KEY; nothing is tracked until then.\");\n        if (bootstrapConfig || !apiKey) {\n            setReady(true);\n            return;\n        }\n        let live = true;\n        fetch(`${host}/api/sdk/config?key=${encodeURIComponent(apiKey)}`)\n            .then((r) => {\n                if (!r.ok) warnOnce(`Config request to ${host || \"this origin\"} answered ${r.status}. Check the public key and NEXT_PUBLIC_MRROCKET_HOST.`);\n                return r.ok ? r.json() : null;\n            })\n            .then((c: CockpitConfig | null) => {\n                if (!live) return;\n                if (c && Array.isArray(c.experiments)) setConfig(c);\n                setReady(true);\n            })\n            .catch(() => {\n                warnOnce(`Could not reach ${host || \"this origin\"}. Check NEXT_PUBLIC_MRROCKET_HOST. The page keeps working with control variants.`);\n                if (live) setReady(true);\n            });\n        return () => {\n            live = false;\n        };\n    }, [apiKey, host, bootstrapConfig]);\n\n    const flush = useCallback(\n        (beacon = false) => {\n            if (!queue.current.length) return;\n            if (!apiKey) {\n                queue.current.length = 0;\n                return;\n            }\n            const url = `${host}/api/sdk/events`;\n            for (const body of bodies(apiKey, queue.current.splice(0))) {\n                const sent = beacon && typeof navigator !== \"undefined\" && \"sendBeacon\" in navigator && navigator.sendBeacon(url, body);\n                if (!sent)\n                    fetch(url, { method: \"POST\", headers: { \"content-type\": \"application/json\" }, body, keepalive: true })\n                        .then((r) => {\n                            if (!r.ok) warnOnce(`Events were rejected with ${r.status}. Check the public key (Settings › SDK) and NEXT_PUBLIC_MRROCKET_HOST.`);\n                        })\n                        .catch(() => warnOnce(`Could not reach ${host || \"this origin\"} to send events. Check NEXT_PUBLIC_MRROCKET_HOST.`));\n            }\n        },\n        [apiKey, host],\n    );\n\n    useEffect(() => {\n        const timer = window.setInterval(() => flush(), 2000);\n        const leave = () => flush(true);\n        window.addEventListener(\"pagehide\", leave);\n        return () => {\n            window.clearInterval(timer);\n            window.removeEventListener(\"pagehide\", leave);\n            flush(true);\n        };\n    }, [flush]);\n\n    // The latest values for callbacks that must not change identity, so effects that use them run once.\n    const live = useRef({ resolved: false, tracking, distinctId, sendId, persist: false, identified: false });\n    live.current = { resolved: visitor !== null, tracking, distinctId, sendId, persist: visitor?.mode === \"cookies\", identified: !!identified };\n\n    const record = useCallback((event: string, props: Record<string, unknown> | undefined, ts = Date.now(), url?: string) => {\n        const now = live.current;\n        if (!now.resolved) {\n            early.current.push(() => record(event, props, ts, url));\n            return;\n        }\n        // Previews in Cockpit never count, and nothing is sent without consent.\n        if (!now.tracking) return;\n        const referral = carriesReferral(event) ? getReferral() : null;\n        queue.current.push({\n            event,\n            props: referral ? { ...props, $referral: { code: referral.code, clickId: referral.clickId } } : props,\n            distinctId: now.sendId,\n            sessionId: touchSession(now.persist),\n            ts,\n            url: url ?? window.location.href,\n            referrer: page.referrer,\n            ...page.utm,\n            screen: { w: window.screen.width, h: window.screen.height },\n        });\n    }, []);\n\n    // The running recorder, if this visit records (see the recording effect below).\n    const replayer = useRef<ReplayHandle | null>(null);\n\n    const track = useCallback(\n        (event: string, props?: Record<string, unknown>) => {\n            record(event, props);\n            if (live.current.tracking) replayer.current?.event(event);\n        },\n        [record],\n    );\n\n    const identify = useCallback(\n        (id: string, props?: Record<string, unknown>) => {\n            const now = live.current;\n            if (!now.resolved) {\n                early.current.push(() => identify(id, props));\n                return;\n            }\n            const previous = now.sendId;\n            // From here on events carry this id in every mode; only \"cookies\" keeps it for the next visit.\n            live.current = { ...now, distinctId: id, sendId: id, identified: true };\n            record(\"$identify\", { ...props, id, ...(previous && previous !== id ? { previousId: previous } : {}) });\n            replayer.current?.identify(id);\n            if (now.persist) writeCookie(ID_COOKIE, id, YEAR_S);\n            setIdentified(id);\n            setUser({ id, ...(props as Omit<CockpitUser, \"id\">) });\n        },\n        [record],\n    );\n\n    // Replay what came in before the visitor was known: sent when tracking is on, dropped when it is not.\n    useEffect(() => {\n        if (!visitor) return;\n        for (const run of early.current.splice(0)) run();\n    }, [visitor]);\n\n    // Affiliate referrals: read once the consent is known and the program's cookie days have loaded.\n    const referralDays = config?.referral?.cookieDays ?? DEFAULT_REFERRAL_DAYS;\n    const storeReferrals = attribution === \"always\" ? effectiveConsent !== \"off\" : attribution === \"consent\" && effectiveConsent === \"cookies\";\n    const captured = useRef<string | null>(null);\n    const storedReferral = useRef(false);\n    useEffect(() => {\n        if (!visitor || !ready || embedded) return;\n        if (attribution === \"off\" || effectiveConsent === \"off\") {\n            resetReferral();\n            if (attribution === \"off\" || storedReferral.current) forgetStoredReferral();\n            return;\n        }\n        const href = window.location.href;\n        if (captured.current === href) return;\n        captured.current = href;\n        void captureReferral({\n            search: window.location.search,\n            param: referralParam,\n            store: storeReferrals,\n            days: referralDays,\n            beacon: apiKey\n                ? ({ code, clickId }) =>\n                      fetch(`${host}/api/sdk/affiliate/click`, {\n                          method: \"POST\",\n                          headers: { \"content-type\": \"application/json\" },\n                          body: JSON.stringify({ key: apiKey, code, clickId, url: href, referrer: document.referrer || undefined }),\n                          keepalive: true,\n                      })\n                          .then((r) => (r.ok ? (r.json() as Promise<{ clickId?: string | null }>) : null))\n                          .then((b) => b?.clickId ?? null)\n                : undefined,\n        });\n    }, [visitor, ready, embedded, attribution, effectiveConsent, pathname, referralParam, storeReferrals, referralDays, apiKey, host]);\n\n    // Consent given later keeps this page load's referral; consent withdrawn deletes what was stored.\n    useEffect(() => {\n        if (!mounted) return;\n        const r = getReferral();\n        if (storeReferrals && r) storeReferral(r, referralDays);\n        else if (!storeReferrals && storedReferral.current) forgetStoredReferral();\n        storedReferral.current = storeReferrals;\n    }, [mounted, storeReferrals, referralDays]);\n\n    // `tracking` is a dependency so that variants seen before consent are recorded once tracking starts.\n    const expose = useCallback(\n        (key: string, variant: VariantId) => {\n            if (!tracking) return;\n            const mark = `${pathname}|${key}`;\n            if (exposed.current.has(mark)) return;\n            exposed.current.add(mark);\n            track(\"$exposure\", { experiment: key, variant });\n        },\n        [pathname, track, tracking],\n    );\n\n    // The referrer and campaign of each page; before the page view below, so it already carries them.\n    useEffect(() => {\n        enterPage();\n        replayer.current?.page(pathname);\n    }, [pathname]);\n\n    // One page view per route change while tracking, so a later setConsent() records the current page right away\n    // (a ref keeps React's dev double-run from counting twice).\n    useEffect(() => {\n        if (!tracking || lastPage.current === pathname) return;\n        lastPage.current = pathname;\n        // Exposures are remembered per path (\"/pricing|test\"), so nothing needs clearing here.\n        track(\"$pageview\", { path: pathname });\n    }, [pathname, tracking, track]);\n\n    // Clicks on anything marked `data-ck-goal=\"signup_started\"` count as that goal. Every click also feeds Heatmaps\n    // (`$click`, `$rageclick` on the third quick click on one spot) and, when this visit records, the recording.\n    const rage = useRef(new RageDetector());\n    useEffect(() => {\n        const onClick = (e: MouseEvent) => {\n            const el = (e.target as HTMLElement | null)?.closest<HTMLElement>(\"[data-ck-goal]\");\n            if (el?.dataset.ckGoal) track(el.dataset.ckGoal, { text: el.textContent?.trim().slice(0, 80) });\n            if (!live.current.tracking) return;\n            const c = clickInfo(e);\n            if (!c) return;\n            const raged = rage.current.push(c.x, c.y, Date.now());\n            replayer.current?.click(c, raged);\n            if (!heatmaps) return;\n            const props = { x: c.x, y: c.y, vw: c.vw, vh: c.vh, docH: c.docH, selector: c.selector, label: c.label, dead: !c.interactive };\n            record(\"$click\", props);\n            if (raged) record(\"$rageclick\", props);\n        };\n        document.addEventListener(\"click\", onClick);\n        return () => document.removeEventListener(\"click\", onClick);\n    }, [track, record, heatmaps]);\n\n    // Scroll depth for Heatmaps: the deepest point seen on each page, sent when the page changes or hides.\n    const depth = useRef<{ url: string; max: number; docH: number } | null>(null);\n    useEffect(() => {\n        if (!heatmaps || !tracking || embedded) return;\n        const send = () => {\n            const d = depth.current;\n            if (d && d.max > 0) record(\"$scroll\", { depth: d.max, docH: d.docH, vw: window.innerWidth, vh: window.innerHeight }, Date.now(), d.url);\n            depth.current = null;\n        };\n        const measure = () => {\n            const doc = document.documentElement;\n            const docH = Math.max(doc.scrollHeight, document.body?.scrollHeight ?? 0);\n            const max = seenDepth();\n            const href = window.location.href;\n            if (depth.current?.url !== href) depth.current = { url: href, max, docH };\n            else if (max > depth.current.max) depth.current = { url: href, max, docH };\n        };\n        measure();\n        let frame = 0;\n        const onScroll = () => {\n            if (frame) return;\n            frame = window.requestAnimationFrame(() => {\n                frame = 0;\n                measure();\n            });\n        };\n        const onHide = () => {\n            send();\n            flush(true);\n        };\n        window.addEventListener(\"scroll\", onScroll, { passive: true });\n        window.addEventListener(\"pagehide\", onHide);\n        return () => {\n            window.removeEventListener(\"scroll\", onScroll);\n            window.removeEventListener(\"pagehide\", onHide);\n            window.cancelAnimationFrame(frame);\n            send();\n        };\n    }, [heatmaps, tracking, embedded, pathname, record, flush]);\n\n    // Session recording: only with the visitor's replay consent, while tracking, and when the product records. The\n    // recorder and rrweb are loaded here, lazily; withdrawing consent stops it and drops what was not sent.\n    const replayConfig = config?.replay;\n    const recording = tracking && replayConsent && !!replayConfig && !!apiKey;\n    useEffect(() => {\n        if (!recording || !replayConfig) return;\n        let active = true;\n        let handle: ReplayHandle | null = null;\n        // `typeof window` is a build-time constant in Next.js: on the server this folds to null and the import (with\n        // rrweb) never enters the server bundle.\n        void (typeof window === \"undefined\" ? Promise.resolve(null) : import(\"./replay\"))\n            .then((m) =>\n                m?.startReplay({\n                    host,\n                    apiKey,\n                    sessionId: touchSession(live.current.persist),\n                    distinctId: live.current.sendId,\n                    identified: live.current.identified,\n                    sampleRate: replayConfig.sampleRate,\n                    warn: warnOnce,\n                }),\n            )\n            .then((h) => {\n                if (!active) h?.stop(true);\n                else replayer.current = handle = h ?? null;\n            })\n            .catch(() => warnOnce(\"Session recording could not start (the recorder did not load).\"));\n        return () => {\n            active = false;\n            handle?.stop(true);\n            if (replayer.current === handle) replayer.current = null;\n        };\n    }, [recording, replayConfig, host, apiKey]);\n\n    const texts = useMemo(() => textChanges(config, distinctId, preview), [config, distinctId, preview]);\n\n    const value = useMemo<CockpitContext>(\n        () => ({ apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, replayConsent, setConsent, texts, track, identify, expose }),\n        [apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, replayConsent, setConsent, texts, track, identify, expose],\n    );\n    return (\n        <Ctx.Provider value={value}>\n            {children}\n            {surveys ? <Survey /> : null}\n        </Ctx.Provider>\n    );\n};\n\n/**\n * `track`, `identify`, the consent mode, the replay consent and their setter, the visitor id and whether the\n * experiments have loaded. `setConsent(\"cookies\")` sets the mode, `setConsent({ replay: true })` the replay consent.\n */\nexport const useCockpit = () => {\n    const { track, identify, distinctId, ready, embedded, consent, replayConsent, setConsent } = useCtx();\n    return { track, identify, distinctId, ready, embedded, consent, replay: replayConsent, setConsent };\n};\n\n/** The variant this visitor sees, for example `\"control\"` or `\"a\"`. Records the exposure. */\nexport const useVariant = (key: string): VariantId => {\n    const { config, distinctId, preview, expose } = useCtx();\n    const variant = resolveVariant(key, config, distinctId, preview);\n    useEffect(() => {\n        if (config || preview[key]) expose(key, variant);\n    }, [config, preview, key, variant, expose]);\n    return variant;\n};\n\n/** Renders the element for the visitor's variant; control when the variant has no element. */\nexport const Experiment = ({ name, variants }: { name: string; variants: Record<VariantId, ReactNode> & { control: ReactNode } }) => {\n    const variant = useVariant(name);\n    return <>{variants[variant] ?? variants.control}</>;\n};\n\n/**\n * A text that experiments may change without a deploy: Cockpit sends the new copy for `id` and this renders it.\n * Write your default as the children.\n */\nexport const Text = ({ id, children }: { id: string; children: string }) => {\n    const { texts } = useCtx();\n    return <>{texts[id] ?? children}</>;\n};\n"],"mappings":"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","names":["live"]}

package/dist/context.d.ts

@@ -0,0 +1,33 @@
+import type { CockpitConfig, ConsentChoice, ConsentMode, VariantId } from "./core.js";
+/** Who the visitor is, from identify(). Sent along with feedback and survey answers. */
+export interface CockpitUser {
+    id: string;
+    name?: string;
+    email?: string;
+    [key: string]: unknown;
+}
+export interface CockpitContext {
+    apiKey: string;
+    host: string;
+    user?: CockpitUser;
+    ready: boolean;
+    distinctId: string;
+    config: CockpitConfig | null;
+    preview: Record<string, VariantId>;
+    /** Embedded in Cockpit as a preview: nothing is tracked. */
+    embedded: boolean;
+    /** The consent mode the site set, with the `consent` prop or setConsent(). */
+    consent: ConsentMode;
+    /** What applies right now: "off" when the browser sends Do Not Track and the provider respects it. */
+    effectiveConsent: ConsentMode;
+    /** The visitor's consent to session recordings (`replay` prop or `setConsent({ replay })`). */
+    replayConsent: boolean;
+    setConsent: (choice: ConsentChoice) => void;
+    texts: Record<string, string>;
+    track: (event: string, props?: Record<string, unknown>) => void;
+    identify: (id: string, props?: Record<string, unknown>) => void;
+    /** Records that the visitor saw a variant, once per experiment and page view. */
+    expose: (key: string, variant: VariantId) => void;
+}
+export declare const Ctx: import("react").Context<CockpitContext | null>;
+export declare const useCtx: () => CockpitContext;

package/dist/context.js

@@ -0,0 +1,15 @@
+"use client";
+
+// src/context.ts
+import { createContext, useContext } from "react";
+var Ctx = createContext(null);
+var useCtx = () => {
+  const c = useContext(Ctx);
+  if (!c) throw new Error("Cockpit: wrap your app in <CockpitProvider apiKey=\u2026>.");
+  return c;
+};
+export {
+  Ctx,
+  useCtx
+};
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts"],"sourcesContent":["\"use client\";\n\nimport { createContext, useContext } from \"react\";\nimport type { CockpitConfig, ConsentChoice, ConsentMode, VariantId } from \"./core\";\n\n/** Who the visitor is, from identify(). Sent along with feedback and survey answers. */\nexport interface CockpitUser {\n    id: string;\n    name?: string;\n    email?: string;\n    [key: string]: unknown;\n}\n\nexport interface CockpitContext {\n    apiKey: string;\n    host: string;\n    user?: CockpitUser;\n    ready: boolean;\n    distinctId: string;\n    config: CockpitConfig | null;\n    preview: Record<string, VariantId>;\n    /** Embedded in Cockpit as a preview: nothing is tracked. */\n    embedded: boolean;\n    /** The consent mode the site set, with the `consent` prop or setConsent(). */\n    consent: ConsentMode;\n    /** What applies right now: \"off\" when the browser sends Do Not Track and the provider respects it. */\n    effectiveConsent: ConsentMode;\n    /** The visitor's consent to session recordings (`replay` prop or `setConsent({ replay })`). */\n    replayConsent: boolean;\n    setConsent: (choice: ConsentChoice) => void;\n    texts: Record<string, string>;\n    track: (event: string, props?: Record<string, unknown>) => void;\n    identify: (id: string, props?: Record<string, unknown>) => void;\n    /** Records that the visitor saw a variant, once per experiment and page view. */\n    expose: (key: string, variant: VariantId) => void;\n}\n\nexport const Ctx = createContext<CockpitContext | null>(null);\n\nexport const useCtx = () => {\n    const c = useContext(Ctx);\n    if (!c) throw new Error(\"Cockpit: wrap your app in <CockpitProvider apiKey=…>.\");\n    return c;\n};\n"],"mappings":";;;AAEA,SAAS,eAAe,kBAAkB;AAmCnC,IAAM,MAAM,cAAqC,IAAI;AAErD,IAAM,SAAS,MAAM;AACxB,QAAM,IAAI,WAAW,GAAG;AACxB,MAAI,CAAC,EAAG,OAAM,IAAI,MAAM,4DAAuD;AAC/E,SAAO;AACX;","names":[]}

package/dist/core.d.ts

@@ -0,0 +1,132 @@
+/**
+ * The part of the SDK that runs anywhere: experiment config, variant assignment, preview links and event shapes.
+ * No React, no browser APIs, so the server helper, the proxy helper and the client share it.
+ */
+export type VariantId = string;
+/** One variant of an experiment. `changes` replaces texts that the page marks with `<Text id>`. */
+export interface VariantConfig {
+    id: VariantId;
+    /** Share of traffic, 0 to 1. The weights of an experiment add up to 1. */
+    weight: number;
+    changes?: Record<string, string>;
+}
+export interface ExperimentConfig {
+    /** The experiment's key, the same as in Cockpit. */
+    key: string;
+    status: "running" | "draft" | "stopped";
+    /** Control first. */
+    variants: VariantConfig[];
+    /** A winner that shipped: everyone gets it, and nobody is assigned anymore. */
+    winner?: VariantId;
+}
+export interface CockpitConfig {
+    /** The product the public key belongs to. */
+    project: string;
+    experiments: ExperimentConfig[];
+    /** The product's affiliate program: how many days a partner's referral is kept. Missing without a program. */
+    referral?: {
+        cookieDays: number;
+    };
+    /** Session recordings: present only while the product records (Cockpit › Sessions). See `ReplayConfig`. */
+    replay?: ReplayConfig;
+}
+/**
+ * Session recordings of a product, from the config. Recording also needs the visitor's own replay consent
+ * (`<CockpitProvider replay>` or `setConsent({ replay: true })`); without it nothing is recorded or buffered.
+ */
+export interface ReplayConfig {
+    /**
+     * Share of sessions uploaded from their start, 0 to 1 (default 0.1). The others keep only the last minute in
+     * memory and upload it when something goes wrong: a JS error, a rage click, a `purchase…` or `checkout…` event.
+     */
+    sampleRate: number;
+}
+/**
+ * What the SDK may send and store.
+ * - "cookieless" (default): no cookie, no localStorage. Events go without a visitor id; the server counts visitors
+ *   with a hash of key, date, IP and user agent that changes every day.
+ * - "cookies": a persistent `ck_id` cookie identifies the visitor across visits, `ck_sid` holds the session.
+ * - "off": nothing is sent and nothing is stored.
+ */
+export type ConsentMode = "cookieless" | "cookies" | "off";
+/**
+ * What `setConsent` takes: a mode as before, or the parts to change. `replay` is the separate consent for session
+ * recordings (default false); it applies only while analytics is not "off".
+ *
+ *     setConsent("cookies");
+ *     setConsent({ replay: true });
+ *     setConsent({ analytics: "cookieless", replay: false });
+ */
+export type ConsentChoice = ConsentMode | {
+    analytics?: ConsentMode;
+    replay?: boolean;
+};
+/** The campaign parameters the SDK reads from the landing URL. */
+export declare const UTM_KEYS: readonly ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
+export type UtmKey = (typeof UTM_KEYS)[number];
+/** One event as it goes over the wire to `POST /api/sdk/events`. */
+export interface CockpitEvent {
+    event: string;
+    /** The visitor. Missing in "cookieless" mode until identify(): the server then uses its daily visitor hash. */
+    distinctId?: string;
+    /** Ends after 30 minutes without an event. */
+    sessionId?: string;
+    props?: Record<string, unknown>;
+    /** Milliseconds since the epoch. */
+    ts: number;
+    url?: string;
+    /** `document.referrer` on the first page of a page load, the previous in-app URL after client-side navigation. */
+    referrer?: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_term?: string;
+    utm_content?: string;
+    /** The screen size in CSS pixels. */
+    screen?: {
+        w: number;
+        h: number;
+    };
+}
+/** The query parameter that forces variants, for previews in Cockpit: `?ck_preview=pricing-annual:a,home-hero:control`. */
+export declare const PREVIEW_PARAM = "ck_preview";
+/** Set when Cockpit embeds the page: nothing is tracked, so previews never count as visits. */
+export declare const EMBED_PARAM = "ck_embed";
+/** The cookie that keeps a visitor in the same variant across visits. Only written in "cookies" mode. */
+export declare const ID_COOKIE = "ck_id";
+/** The cookie that holds the session id in "cookies" mode. */
+export declare const SESSION_COOKIE = "ck_sid";
+/** A session ends after this long without an event. */
+export declare const SESSION_TIMEOUT_MS: number;
+/** The UTM parameters of a query string, like `"?utm_source=x"`. Empty values are left out. */
+export declare const readUtm: (search: string) => Partial<Record<UtmKey, string>>;
+/** FNV-1a, 32 bit, mapped to [0, 1). Stable across server and browser. */
+export declare const hashUnit: (input: string) => number;
+/** The variant a visitor sees: a shipped winner, control while the experiment does not run, else a stable bucket by visitor. */
+export declare const assign: (experiment: ExperimentConfig, distinctId: string) => VariantId;
+/** `"a:b,c:d"` → `{ a: "b", c: "d" }`. Ignores anything malformed. */
+export declare const parsePreview: (value: string | string[] | null | undefined) => Record<string, VariantId>;
+/** A link that shows one variant of a page, for example in Cockpit's preview frames. */
+export declare const previewHref: (url: string, forced: Record<string, VariantId>, embed?: boolean) => string;
+/** The variant for one experiment, from a forced preview first, then the config. Unknown experiments get control. */
+export declare const resolveVariant: (key: string, config: CockpitConfig | null, distinctId: string, preview: Record<string, VariantId>) => VariantId;
+/**
+ * Every text change that applies to this visitor, merged in config order. Control keeps the page's own words,
+ * so only a non-control variant (assigned, forced in a preview, or a shipped winner) changes text.
+ */
+export declare const textChanges: (config: CockpitConfig | null, distinctId: string, preview: Record<string, VariantId>) => Record<string, string>;
+/**
+ * The MRRocket API host from `NEXT_PUBLIC_MRROCKET_HOST`. Written as a literal property access on purpose: Next.js
+ * inlines `process.env.NEXT_PUBLIC_*` at build time, in the browser bundle and in the server bundle (also on
+ * Cloudflare Workers), and only replaces the literal form. Without a bundler (or a `process`) it is undefined.
+ */
+export declare const envHost: () => string | undefined;
+/** The public key from `NEXT_PUBLIC_MRROCKET_KEY`, the default for the `apiKey` prop. Same literal-access rule as `envHost`. */
+export declare const envKey: () => string | undefined;
+/**
+ * Where the API lives: the `host` prop, else `NEXT_PUBLIC_MRROCKET_HOST`, else "" (the page's own origin, which is how
+ * MRRocket's own demo pages call it). Without a trailing slash.
+ */
+export declare const resolveHost: (host?: string) => string;
+/** A random visitor id. */
+export declare const newDistinctId: () => string;

package/dist/core.js

@@ -0,0 +1,104 @@
+// src/core.ts
+var UTM_KEYS = ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
+var PREVIEW_PARAM = "ck_preview";
+var EMBED_PARAM = "ck_embed";
+var ID_COOKIE = "ck_id";
+var SESSION_COOKIE = "ck_sid";
+var SESSION_TIMEOUT_MS = 30 * 60 * 1e3;
+var readUtm = (search) => {
+  const params = new URLSearchParams(search);
+  const out = {};
+  for (const key of UTM_KEYS) {
+    const value = params.get(key)?.trim();
+    if (value) out[key] = value.slice(0, 150);
+  }
+  return out;
+};
+var hashUnit = (input) => {
+  let h = 2166136261;
+  for (let i = 0; i < input.length; i++) {
+    h ^= input.charCodeAt(i);
+    h = Math.imul(h, 16777619);
+  }
+  return (h >>> 0) / 4294967296;
+};
+var assign = (experiment, distinctId) => {
+  const control = experiment.variants[0]?.id ?? "control";
+  if (experiment.winner) return experiment.winner;
+  if (experiment.status !== "running") return control;
+  const u = hashUnit(`${experiment.key}:${distinctId}`);
+  let acc = 0;
+  for (const v of experiment.variants) {
+    acc += v.weight;
+    if (u < acc) return v.id;
+  }
+  return experiment.variants[experiment.variants.length - 1]?.id ?? control;
+};
+var parsePreview = (value) => {
+  const raw = Array.isArray(value) ? value[0] : value;
+  if (!raw) return {};
+  const out = {};
+  for (const pair of raw.split(",")) {
+    const [key, variant] = pair.split(":");
+    if (key && variant) out[key.trim()] = variant.trim();
+  }
+  return out;
+};
+var previewHref = (url, forced, embed = true) => {
+  const [path, query = ""] = url.split("?");
+  const params = new URLSearchParams(query);
+  const value = Object.entries(forced).map(([k, v]) => `${k}:${v}`).join(",");
+  if (value) params.set(PREVIEW_PARAM, value);
+  if (embed) params.set(EMBED_PARAM, "1");
+  return `${path}?${params.toString()}`;
+};
+var resolveVariant = (key, config, distinctId, preview) => {
+  if (preview[key]) return preview[key];
+  const experiment = config?.experiments.find((e) => e.key === key);
+  return experiment ? assign(experiment, distinctId) : "control";
+};
+var textChanges = (config, distinctId, preview) => {
+  const out = {};
+  for (const experiment of config?.experiments ?? []) {
+    const id = resolveVariant(experiment.key, config, distinctId, preview);
+    if (id === (experiment.variants[0]?.id ?? "control")) continue;
+    Object.assign(out, experiment.variants.find((v) => v.id === id)?.changes ?? {});
+  }
+  return out;
+};
+var envHost = () => {
+  try {
+    return process.env.NEXT_PUBLIC_MRROCKET_HOST || void 0;
+  } catch {
+    return void 0;
+  }
+};
+var envKey = () => {
+  try {
+    return process.env.NEXT_PUBLIC_MRROCKET_KEY || void 0;
+  } catch {
+    return void 0;
+  }
+};
+var resolveHost = (host) => (host ?? envHost() ?? "").trim().replace(/\/+$/, "");
+var newDistinctId = () => typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `ck_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
+export {
+  EMBED_PARAM,
+  ID_COOKIE,
+  PREVIEW_PARAM,
+  SESSION_COOKIE,
+  SESSION_TIMEOUT_MS,
+  UTM_KEYS,
+  assign,
+  envHost,
+  envKey,
+  hashUnit,
+  newDistinctId,
+  parsePreview,
+  previewHref,
+  readUtm,
+  resolveHost,
+  resolveVariant,
+  textChanges
+};
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core.ts"],"sourcesContent":["/**\n * The part of the SDK that runs anywhere: experiment config, variant assignment, preview links and event shapes.\n * No React, no browser APIs, so the server helper, the proxy helper and the client share it.\n */\n\nexport type VariantId = string;\n\n/** One variant of an experiment. `changes` replaces texts that the page marks with `<Text id>`. */\nexport interface VariantConfig {\n    id: VariantId;\n    /** Share of traffic, 0 to 1. The weights of an experiment add up to 1. */\n    weight: number;\n    changes?: Record<string, string>;\n}\n\nexport interface ExperimentConfig {\n    /** The experiment's key, the same as in Cockpit. */\n    key: string;\n    status: \"running\" | \"draft\" | \"stopped\";\n    /** Control first. */\n    variants: VariantConfig[];\n    /** A winner that shipped: everyone gets it, and nobody is assigned anymore. */\n    winner?: VariantId;\n}\n\nexport interface CockpitConfig {\n    /** The product the public key belongs to. */\n    project: string;\n    experiments: ExperimentConfig[];\n    /** The product's affiliate program: how many days a partner's referral is kept. Missing without a program. */\n    referral?: { cookieDays: number };\n    /** Session recordings: present only while the product records (Cockpit › Sessions). See `ReplayConfig`. */\n    replay?: ReplayConfig;\n}\n\n/**\n * Session recordings of a product, from the config. Recording also needs the visitor's own replay consent\n * (`<CockpitProvider replay>` or `setConsent({ replay: true })`); without it nothing is recorded or buffered.\n */\nexport interface ReplayConfig {\n    /**\n     * Share of sessions uploaded from their start, 0 to 1 (default 0.1). The others keep only the last minute in\n     * memory and upload it when something goes wrong: a JS error, a rage click, a `purchase…` or `checkout…` event.\n     */\n    sampleRate: number;\n}\n\n/**\n * What the SDK may send and store.\n * - \"cookieless\" (default): no cookie, no localStorage. Events go without a visitor id; the server counts visitors\n *   with a hash of key, date, IP and user agent that changes every day.\n * - \"cookies\": a persistent `ck_id` cookie identifies the visitor across visits, `ck_sid` holds the session.\n * - \"off\": nothing is sent and nothing is stored.\n */\nexport type ConsentMode = \"cookieless\" | \"cookies\" | \"off\";\n\n/**\n * What `setConsent` takes: a mode as before, or the parts to change. `replay` is the separate consent for session\n * recordings (default false); it applies only while analytics is not \"off\".\n *\n *     setConsent(\"cookies\");\n *     setConsent({ replay: true });\n *     setConsent({ analytics: \"cookieless\", replay: false });\n */\nexport type ConsentChoice = ConsentMode | { analytics?: ConsentMode; replay?: boolean };\n\n/** The campaign parameters the SDK reads from the landing URL. */\nexport const UTM_KEYS = [\"utm_source\", \"utm_medium\", \"utm_campaign\", \"utm_term\", \"utm_content\"] as const;\nexport type UtmKey = (typeof UTM_KEYS)[number];\n\n/** One event as it goes over the wire to `POST /api/sdk/events`. */\nexport interface CockpitEvent {\n    event: string;\n    /** The visitor. Missing in \"cookieless\" mode until identify(): the server then uses its daily visitor hash. */\n    distinctId?: string;\n    /** Ends after 30 minutes without an event. */\n    sessionId?: string;\n    props?: Record<string, unknown>;\n    /** Milliseconds since the epoch. */\n    ts: number;\n    url?: string;\n    /** `document.referrer` on the first page of a page load, the previous in-app URL after client-side navigation. */\n    referrer?: string;\n    utm_source?: string;\n    utm_medium?: string;\n    utm_campaign?: string;\n    utm_term?: string;\n    utm_content?: string;\n    /** The screen size in CSS pixels. */\n    screen?: { w: number; h: number };\n}\n\n/** The query parameter that forces variants, for previews in Cockpit: `?ck_preview=pricing-annual:a,home-hero:control`. */\nexport const PREVIEW_PARAM = \"ck_preview\";\n/** Set when Cockpit embeds the page: nothing is tracked, so previews never count as visits. */\nexport const EMBED_PARAM = \"ck_embed\";\n/** The cookie that keeps a visitor in the same variant across visits. Only written in \"cookies\" mode. */\nexport const ID_COOKIE = \"ck_id\";\n/** The cookie that holds the session id in \"cookies\" mode. */\nexport const SESSION_COOKIE = \"ck_sid\";\n/** A session ends after this long without an event. */\nexport const SESSION_TIMEOUT_MS = 30 * 60 * 1000;\n\n/** The UTM parameters of a query string, like `\"?utm_source=x\"`. Empty values are left out. */\nexport const readUtm = (search: string): Partial<Record<UtmKey, string>> => {\n    const params = new URLSearchParams(search);\n    const out: Partial<Record<UtmKey, string>> = {};\n    for (const key of UTM_KEYS) {\n        const value = params.get(key)?.trim();\n        if (value) out[key] = value.slice(0, 150);\n    }\n    return out;\n};\n\n/** FNV-1a, 32 bit, mapped to [0, 1). Stable across server and browser. */\nexport const hashUnit = (input: string) => {\n    let h = 0x811c9dc5;\n    for (let i = 0; i < input.length; i++) {\n        h ^= input.charCodeAt(i);\n        h = Math.imul(h, 0x01000193);\n    }\n    return (h >>> 0) / 4294967296;\n};\n\n/** The variant a visitor sees: a shipped winner, control while the experiment does not run, else a stable bucket by visitor. */\nexport const assign = (experiment: ExperimentConfig, distinctId: string): VariantId => {\n    const control = experiment.variants[0]?.id ?? \"control\";\n    if (experiment.winner) return experiment.winner;\n    if (experiment.status !== \"running\") return control;\n    const u = hashUnit(`${experiment.key}:${distinctId}`);\n    let acc = 0;\n    for (const v of experiment.variants) {\n        acc += v.weight;\n        if (u < acc) return v.id;\n    }\n    return experiment.variants[experiment.variants.length - 1]?.id ?? control;\n};\n\n/** `\"a:b,c:d\"` → `{ a: \"b\", c: \"d\" }`. Ignores anything malformed. */\nexport const parsePreview = (value: string | string[] | null | undefined): Record<string, VariantId> => {\n    const raw = Array.isArray(value) ? value[0] : value;\n    if (!raw) return {};\n    const out: Record<string, VariantId> = {};\n    for (const pair of raw.split(\",\")) {\n        const [key, variant] = pair.split(\":\");\n        if (key && variant) out[key.trim()] = variant.trim();\n    }\n    return out;\n};\n\n/** A link that shows one variant of a page, for example in Cockpit's preview frames. */\nexport const previewHref = (url: string, forced: Record<string, VariantId>, embed = true) => {\n    const [path, query = \"\"] = url.split(\"?\");\n    const params = new URLSearchParams(query);\n    const value = Object.entries(forced)\n        .map(([k, v]) => `${k}:${v}`)\n        .join(\",\");\n    if (value) params.set(PREVIEW_PARAM, value);\n    if (embed) params.set(EMBED_PARAM, \"1\");\n    return `${path}?${params.toString()}`;\n};\n\n/** The variant for one experiment, from a forced preview first, then the config. Unknown experiments get control. */\nexport const resolveVariant = (key: string, config: CockpitConfig | null, distinctId: string, preview: Record<string, VariantId>): VariantId => {\n    if (preview[key]) return preview[key];\n    const experiment = config?.experiments.find((e) => e.key === key);\n    return experiment ? assign(experiment, distinctId) : \"control\";\n};\n\n/**\n * Every text change that applies to this visitor, merged in config order. Control keeps the page's own words,\n * so only a non-control variant (assigned, forced in a preview, or a shipped winner) changes text.\n */\nexport const textChanges = (config: CockpitConfig | null, distinctId: string, preview: Record<string, VariantId>) => {\n    const out: Record<string, string> = {};\n    for (const experiment of config?.experiments ?? []) {\n        const id = resolveVariant(experiment.key, config, distinctId, preview);\n        if (id === (experiment.variants[0]?.id ?? \"control\")) continue;\n        Object.assign(out, experiment.variants.find((v) => v.id === id)?.changes ?? {});\n    }\n    return out;\n};\n\n/**\n * The MRRocket API host from `NEXT_PUBLIC_MRROCKET_HOST`. Written as a literal property access on purpose: Next.js\n * inlines `process.env.NEXT_PUBLIC_*` at build time, in the browser bundle and in the server bundle (also on\n * Cloudflare Workers), and only replaces the literal form. Without a bundler (or a `process`) it is undefined.\n */\nexport const envHost = (): string | undefined => {\n    try {\n        return process.env.NEXT_PUBLIC_MRROCKET_HOST || undefined;\n    } catch {\n        return undefined;\n    }\n};\n\n/** The public key from `NEXT_PUBLIC_MRROCKET_KEY`, the default for the `apiKey` prop. Same literal-access rule as `envHost`. */\nexport const envKey = (): string | undefined => {\n    try {\n        return process.env.NEXT_PUBLIC_MRROCKET_KEY || undefined;\n    } catch {\n        return undefined;\n    }\n};\n\n/**\n * Where the API lives: the `host` prop, else `NEXT_PUBLIC_MRROCKET_HOST`, else \"\" (the page's own origin, which is how\n * MRRocket's own demo pages call it). Without a trailing slash.\n */\nexport const resolveHost = (host?: string) => (host ?? envHost() ?? \"\").trim().replace(/\\/+$/, \"\");\n\n/** A random visitor id. */\nexport const newDistinctId = () =>\n    typeof crypto !== \"undefined\" && \"randomUUID\" in crypto ? crypto.randomUUID() : `ck_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;\n"],"mappings":"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","names":[]}

package/dist/feedback.d.ts

@@ -0,0 +1,28 @@
+import { type Theme } from "./ui.js";
+export interface FeedbackBoardProps {
+    /** Heading above the board. */
+    title?: string;
+    /** Line under the heading. */
+    subtitle?: string;
+    theme?: Theme;
+    /** Accent color for buttons and votes. Default #3f76ff. */
+    accent?: string;
+}
+/** The full board for a /feedback page: requests, roadmap and changelog, with voting, comments and a submit form. */
+export declare const FeedbackBoard: ({ title, subtitle, theme, accent }: FeedbackBoardProps) => import("react").JSX.Element;
+/** Open or close the feedback widget from your own button. */
+export declare const useFeedback: () => {
+    open: () => void;
+    close: () => void;
+};
+export interface FeedbackWidgetProps {
+    position?: "bottom-right" | "bottom-left";
+    /** Text on the floating button. */
+    label?: string;
+    /** Where "See all" goes, for example your /feedback page. */
+    boardUrl?: string;
+    theme?: Theme;
+    accent?: string;
+}
+/** A floating button that opens a small popover with the top requests and a quick suggest form. */
+export declare const FeedbackWidget: ({ position, label, boardUrl, theme, accent }: FeedbackWidgetProps) => import("react").JSX.Element;