@mrrocket/sdk 0.0.0-stage → 0.1.0

package/dist/client.js

@@ -0,0 +1,373 @@
+"use client";
+
+// src/client.tsx
+import { useCallback, useEffect, useMemo, useRef, useState } from "react";
+import { usePathname } from "next/navigation";
+import { Ctx, useCtx } from "./context.js";
+import { Survey, forgetStoredDismissals } from "./survey.js";
+import {
+  DEFAULT_REFERRAL_DAYS,
+  captureReferral,
+  carriesReferral,
+  forgetStoredReferral,
+  getReferral,
+  resetReferral,
+  storeReferral
+} from "./referral.js";
+import {
+  EMBED_PARAM,
+  ID_COOKIE,
+  PREVIEW_PARAM,
+  SESSION_COOKIE,
+  SESSION_TIMEOUT_MS,
+  envKey,
+  newDistinctId,
+  parsePreview,
+  readUtm,
+  resolveHost,
+  resolveVariant,
+  textChanges
+} from "./core.js";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+var YEAR_S = 60 * 60 * 24 * 365;
+var MAX_BATCH = 100;
+var MAX_BYTES = 6e4;
+var readCookie = (name) => {
+  if (typeof document === "undefined") return void 0;
+  const raw = document.cookie.split("; ").find((c) => c.startsWith(`${name}=`))?.slice(name.length + 1);
+  if (!raw) return void 0;
+  try {
+    return decodeURIComponent(raw);
+  } catch {
+    return raw;
+  }
+};
+var writeCookie = (name, value, maxAge) => {
+  const secure = window.location.protocol === "https:" ? "; secure" : "";
+  document.cookie = `${name}=${encodeURIComponent(value)}; path=/; max-age=${maxAge}; samesite=lax${secure}`;
+};
+var deleteCookie = (name) => {
+  document.cookie = `${name}=; path=/; max-age=0; samesite=lax`;
+};
+var page = { utm: {} };
+var memoryId = () => page.id ??= newDistinctId();
+var visitorId = (mode, write) => {
+  if (mode !== "cookies") return memoryId();
+  const stored = readCookie(ID_COOKIE);
+  if (stored) return page.id = stored;
+  const id = memoryId();
+  if (write) writeCookie(ID_COOKIE, id, YEAR_S);
+  return id;
+};
+var touchSession = (persist) => {
+  const now = Date.now();
+  const s = page.session;
+  const id = (persist ? readCookie(SESSION_COOKIE) : void 0) ?? (s && now - s.last < SESSION_TIMEOUT_MS ? s.id : newDistinctId());
+  page.session = { id, last: now };
+  if (persist) writeCookie(SESSION_COOKIE, id, SESSION_TIMEOUT_MS / 1e3);
+  return id;
+};
+var enterPage = () => {
+  const href = window.location.href;
+  if (page.url === href) return;
+  page.referrer = page.url ?? (document.referrer || void 0);
+  page.url = href;
+  const utm = readUtm(window.location.search);
+  if (Object.keys(utm).length) page.utm = utm;
+};
+var privacySignal = () => {
+  const nav = navigator;
+  const win = window;
+  return nav.doNotTrack === "1" || win.doNotTrack === "1" || nav.globalPrivacyControl === true;
+};
+var warned = /* @__PURE__ */ new Set();
+var warnOnce = (message) => {
+  if (warned.has(message)) return;
+  warned.add(message);
+  console.warn(`[MRRocket] ${message}`);
+};
+var byteLength = (s) => new TextEncoder().encode(s).length;
+var bodies = (key, events) => {
+  const head = `{"key":${JSON.stringify(key)},"events":[`;
+  const empty = byteLength(head) + 2;
+  const out = [];
+  let chunk = [];
+  let size = empty;
+  const close = () => {
+    if (chunk.length) out.push(`${head}${chunk.join(",")}]}`);
+    chunk = [];
+    size = empty;
+  };
+  for (const event of events) {
+    const json = JSON.stringify(event);
+    const n = byteLength(json) + 1;
+    if (empty + n > MAX_BYTES) continue;
+    if (chunk.length === MAX_BATCH || size + n > MAX_BYTES) close();
+    chunk.push(json);
+    size += n;
+  }
+  close();
+  return out;
+};
+var CockpitProvider = ({
+  apiKey: apiKeyProp,
+  host: hostProp,
+  preview: forced,
+  embedded: embeddedProp,
+  config: bootstrapConfig,
+  distinctId: bootstrapId,
+  consent: consentProp = "cookieless",
+  respectDnt = false,
+  surveys = true,
+  attribution = "consent",
+  referralParam = "ref",
+  children
+}) => {
+  const pathname = usePathname();
+  const apiKey = apiKeyProp ?? envKey() ?? "";
+  const host = resolveHost(hostProp);
+  const [config, setConfig] = useState(bootstrapConfig ?? null);
+  const [consent, setConsentState] = useState(consentProp);
+  const [mounted, setMounted] = useState(false);
+  const [dnt, setDnt] = useState(false);
+  const [visitor, setVisitor] = useState(null);
+  const [identified, setIdentified] = useState();
+  const [urlPreview, setUrlPreview] = useState({});
+  const [urlEmbedded, setUrlEmbedded] = useState(false);
+  const [user, setUser] = useState();
+  const [ready, setReady] = useState(!!bootstrapConfig);
+  const queue = useRef([]);
+  const early = useRef([]);
+  const exposed = useRef(/* @__PURE__ */ new Set());
+  const lastPage = useRef(null);
+  const bootstrap = bootstrapId && bootstrapId !== "anonymous" ? bootstrapId : void 0;
+  const preview = useMemo(() => ({ ...urlPreview, ...forced }), [urlPreview, forced]);
+  const embedded = embeddedProp ?? urlEmbedded;
+  const effectiveConsent = respectDnt && dnt ? "off" : consent;
+  const distinctId = identified ?? bootstrap ?? visitor?.id ?? "anonymous";
+  const tracking = !embedded && effectiveConsent !== "off" && visitor?.mode === effectiveConsent;
+  const sendId = effectiveConsent === "cookies" ? distinctId : identified;
+  useEffect(() => {
+    const params = new URLSearchParams(window.location.search);
+    setUrlPreview(parsePreview(params.get(PREVIEW_PARAM)));
+    setUrlEmbedded(params.get(EMBED_PARAM) === "1");
+    setDnt(privacySignal());
+    setMounted(true);
+  }, []);
+  const setConsent = useCallback((mode) => {
+    if (mode === "off") queue.current.length = 0;
+    setConsentState(mode);
+  }, []);
+  const lastProp = useRef(consentProp);
+  useEffect(() => {
+    if (lastProp.current === consentProp) return;
+    lastProp.current = consentProp;
+    setConsent(consentProp);
+  }, [consentProp, setConsent]);
+  const storedFor = useRef(null);
+  useEffect(() => {
+    if (!mounted) return;
+    const before = storedFor.current;
+    storedFor.current = effectiveConsent;
+    if (before === "cookies" && effectiveConsent !== "cookies") {
+      deleteCookie(ID_COOKIE);
+      deleteCookie(SESSION_COOKIE);
+      forgetStoredDismissals();
+    }
+    if (effectiveConsent === "off") {
+      queue.current.length = 0;
+      page.session = void 0;
+    }
+    setVisitor({ mode: effectiveConsent, id: visitorId(effectiveConsent, !bootstrap) });
+  }, [mounted, effectiveConsent, bootstrap]);
+  useEffect(() => {
+    if (!apiKey) warnOnce("No public key. Pass apiKey or set NEXT_PUBLIC_MRROCKET_KEY; nothing is tracked until then.");
+    if (bootstrapConfig || !apiKey) {
+      setReady(true);
+      return;
+    }
+    let live2 = true;
+    fetch(`${host}/api/sdk/config?key=${encodeURIComponent(apiKey)}`).then((r) => {
+      if (!r.ok) warnOnce(`Config request to ${host || "this origin"} answered ${r.status}. Check the public key and NEXT_PUBLIC_MRROCKET_HOST.`);
+      return r.ok ? r.json() : null;
+    }).then((c) => {
+      if (!live2) return;
+      if (c && Array.isArray(c.experiments)) setConfig(c);
+      setReady(true);
+    }).catch(() => {
+      warnOnce(`Could not reach ${host || "this origin"}. Check NEXT_PUBLIC_MRROCKET_HOST. The page keeps working with control variants.`);
+      if (live2) setReady(true);
+    });
+    return () => {
+      live2 = false;
+    };
+  }, [apiKey, host, bootstrapConfig]);
+  const flush = useCallback(
+    (beacon = false) => {
+      if (!queue.current.length) return;
+      if (!apiKey) {
+        queue.current.length = 0;
+        return;
+      }
+      const url = `${host}/api/sdk/events`;
+      for (const body of bodies(apiKey, queue.current.splice(0))) {
+        const sent = beacon && typeof navigator !== "undefined" && "sendBeacon" in navigator && navigator.sendBeacon(url, body);
+        if (!sent)
+          fetch(url, { method: "POST", headers: { "content-type": "application/json" }, body, keepalive: true }).then((r) => {
+            if (!r.ok) warnOnce(`Events were rejected with ${r.status}. Check the public key (Settings \u203A SDK) and NEXT_PUBLIC_MRROCKET_HOST.`);
+          }).catch(() => warnOnce(`Could not reach ${host || "this origin"} to send events. Check NEXT_PUBLIC_MRROCKET_HOST.`));
+      }
+    },
+    [apiKey, host]
+  );
+  useEffect(() => {
+    const timer = window.setInterval(() => flush(), 2e3);
+    const leave = () => flush(true);
+    window.addEventListener("pagehide", leave);
+    return () => {
+      window.clearInterval(timer);
+      window.removeEventListener("pagehide", leave);
+      flush(true);
+    };
+  }, [flush]);
+  const live = useRef({ resolved: false, tracking, distinctId, sendId, persist: false });
+  live.current = { resolved: visitor !== null, tracking, distinctId, sendId, persist: visitor?.mode === "cookies" };
+  const record = useCallback((event, props, ts = Date.now()) => {
+    const now = live.current;
+    if (!now.resolved) {
+      early.current.push(() => record(event, props, ts));
+      return;
+    }
+    if (!now.tracking) return;
+    const referral = carriesReferral(event) ? getReferral() : null;
+    queue.current.push({
+      event,
+      props: referral ? { ...props, $referral: { code: referral.code, clickId: referral.clickId } } : props,
+      distinctId: now.sendId,
+      sessionId: touchSession(now.persist),
+      ts,
+      url: window.location.href,
+      referrer: page.referrer,
+      ...page.utm,
+      screen: { w: window.screen.width, h: window.screen.height }
+    });
+  }, []);
+  const track = useCallback((event, props) => record(event, props), [record]);
+  const identify = useCallback(
+    (id, props) => {
+      const now = live.current;
+      if (!now.resolved) {
+        early.current.push(() => identify(id, props));
+        return;
+      }
+      const previous = now.sendId;
+      live.current = { ...now, distinctId: id, sendId: id };
+      record("$identify", { ...props, id, ...previous && previous !== id ? { previousId: previous } : {} });
+      if (now.persist) writeCookie(ID_COOKIE, id, YEAR_S);
+      setIdentified(id);
+      setUser({ id, ...props });
+    },
+    [record]
+  );
+  useEffect(() => {
+    if (!visitor) return;
+    for (const run of early.current.splice(0)) run();
+  }, [visitor]);
+  const referralDays = config?.referral?.cookieDays ?? DEFAULT_REFERRAL_DAYS;
+  const storeReferrals = attribution === "always" ? effectiveConsent !== "off" : attribution === "consent" && effectiveConsent === "cookies";
+  const captured = useRef(null);
+  const storedReferral = useRef(false);
+  useEffect(() => {
+    if (!visitor || !ready || embedded) return;
+    if (attribution === "off" || effectiveConsent === "off") {
+      resetReferral();
+      if (attribution === "off" || storedReferral.current) forgetStoredReferral();
+      return;
+    }
+    const href = window.location.href;
+    if (captured.current === href) return;
+    captured.current = href;
+    void captureReferral({
+      search: window.location.search,
+      param: referralParam,
+      store: storeReferrals,
+      days: referralDays,
+      beacon: apiKey ? ({ code, clickId }) => fetch(`${host}/api/sdk/affiliate/click`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ key: apiKey, code, clickId, url: href, referrer: document.referrer || void 0 }),
+        keepalive: true
+      }).then((r) => r.ok ? r.json() : null).then((b) => b?.clickId ?? null) : void 0
+    });
+  }, [visitor, ready, embedded, attribution, effectiveConsent, pathname, referralParam, storeReferrals, referralDays, apiKey, host]);
+  useEffect(() => {
+    if (!mounted) return;
+    const r = getReferral();
+    if (storeReferrals && r) storeReferral(r, referralDays);
+    else if (!storeReferrals && storedReferral.current) forgetStoredReferral();
+    storedReferral.current = storeReferrals;
+  }, [mounted, storeReferrals, referralDays]);
+  const expose = useCallback(
+    (key, variant) => {
+      if (!tracking) return;
+      const mark = `${pathname}|${key}`;
+      if (exposed.current.has(mark)) return;
+      exposed.current.add(mark);
+      track("$exposure", { experiment: key, variant });
+    },
+    [pathname, track, tracking]
+  );
+  useEffect(() => {
+    enterPage();
+  }, [pathname]);
+  useEffect(() => {
+    if (!tracking || lastPage.current === pathname) return;
+    lastPage.current = pathname;
+    track("$pageview", { path: pathname });
+  }, [pathname, tracking, track]);
+  useEffect(() => {
+    const onClick = (e) => {
+      const el = e.target?.closest("[data-ck-goal]");
+      if (el?.dataset.ckGoal) track(el.dataset.ckGoal, { text: el.textContent?.trim().slice(0, 80) });
+    };
+    document.addEventListener("click", onClick);
+    return () => document.removeEventListener("click", onClick);
+  }, [track]);
+  const texts = useMemo(() => textChanges(config, distinctId, preview), [config, distinctId, preview]);
+  const value = useMemo(
+    () => ({ apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, setConsent, texts, track, identify, expose }),
+    [apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, setConsent, texts, track, identify, expose]
+  );
+  return /* @__PURE__ */ jsxs(Ctx.Provider, { value, children: [
+    children,
+    surveys ? /* @__PURE__ */ jsx(Survey, {}) : null
+  ] });
+};
+var useCockpit = () => {
+  const { track, identify, distinctId, ready, embedded, consent, setConsent } = useCtx();
+  return { track, identify, distinctId, ready, embedded, consent, setConsent };
+};
+var useVariant = (key) => {
+  const { config, distinctId, preview, expose } = useCtx();
+  const variant = resolveVariant(key, config, distinctId, preview);
+  useEffect(() => {
+    if (config || preview[key]) expose(key, variant);
+  }, [config, preview, key, variant, expose]);
+  return variant;
+};
+var Experiment = ({ name, variants }) => {
+  const variant = useVariant(name);
+  return /* @__PURE__ */ jsx(Fragment, { children: variants[variant] ?? variants.control });
+};
+var Text = ({ id, children }) => {
+  const { texts } = useCtx();
+  return /* @__PURE__ */ jsx(Fragment, { children: texts[id] ?? children });
+};
+export {
+  CockpitProvider,
+  Experiment,
+  Text,
+  useCockpit,
+  useVariant
+};
+//# sourceMappingURL=client.js.map

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 {\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 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    /** 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    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 [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((mode: ConsentMode) => {\n        if (mode === \"off\") queue.current.length = 0;\n        setConsentState(mode);\n    }, []);\n\n    // Follow the `consent` prop when it changes; setConsent() calls in between stay until it does.\n    const lastProp = useRef(consentProp);\n    useEffect(() => {\n        if (lastProp.current === consentProp) return;\n        lastProp.current = consentProp;\n        setConsent(consentProp);\n    }, [consentProp, 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 });\n    live.current = { resolved: visitor !== null, tracking, distinctId, sendId, persist: visitor?.mode === \"cookies\" };\n\n    const record = useCallback((event: string, props: Record<string, unknown> | undefined, ts = Date.now()) => {\n        const now = live.current;\n        if (!now.resolved) {\n            early.current.push(() => record(event, props, ts));\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: window.location.href,\n            referrer: page.referrer,\n            ...page.utm,\n            screen: { w: window.screen.width, h: window.screen.height },\n        });\n    }, []);\n\n    const track = useCallback((event: string, props?: Record<string, unknown>) => record(event, props), [record]);\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 };\n            record(\"$identify\", { ...props, id, ...(previous && previous !== id ? { previousId: previous } : {}) });\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    }, [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.\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        };\n        document.addEventListener(\"click\", onClick);\n        return () => document.removeEventListener(\"click\", onClick);\n    }, [track]);\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, setConsent, texts, track, identify, expose }),\n        [apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, 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/** `track`, `identify`, the consent mode and its setter, the visitor id and whether the experiments have loaded. */\nexport const useCockpit = () => {\n    const { track, identify, distinctId, ready, embedded, consent, setConsent } = useCtx();\n    return { track, identify, distinctId, ready, embedded, consent, 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,31 @@
+import type { CockpitConfig, 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;
+    setConsent: (mode: ConsentMode) => 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, 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    setConsent: (mode: ConsentMode) => 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;AAiCnC,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,107 @@
+/**
+ * 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;
+    };
+}
+/**
+ * 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";
+/** 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;