@mrrocket/sdk 0.0.0-stage → 0.2.0

package/dist/capture.js

@@ -0,0 +1,91 @@
+// src/capture.ts
+var INTERACTIVE = 'a[href],button,input,select,textarea,label,summary,[role="button"],[role="link"],[role="tab"],[role="menuitem"],[role="checkbox"],[role="switch"],[onclick],[data-ck-goal]';
+var MASK_SELECTOR = "[data-ck-mask]";
+var BLOCK_ATTR_SELECTOR = "[data-ck-block]";
+var generated = /\d{4,}|^[a-z]{1,3}-[a-z0-9]{5,}$|^_|__|css-|^sc-|^jsx-/i;
+var part = (el) => {
+  const tag = el.tagName.toLowerCase();
+  if (el.id && !generated.test(el.id) && el.id.length <= 40) return `${tag}#${el.id}`;
+  const cls = typeof el.className === "string" ? el.className.split(/\s+/).filter((c) => c && !generated.test(c) && c.length <= 30 && !c.includes(":")) : [];
+  const base = cls.length ? `${tag}.${cls.slice(0, 2).join(".")}` : tag;
+  const same = el.parentElement ? [...el.parentElement.children].filter((c) => c.tagName === el.tagName) : [];
+  return same.length > 1 ? `${base}:nth-of-type(${same.indexOf(el) + 1})` : base;
+};
+var selectorOf = (el) => {
+  const out = [];
+  let cur = el;
+  while (cur && out.length < 3 && cur.tagName && cur.tagName !== "BODY" && cur.tagName !== "HTML") {
+    const p = part(cur);
+    out.unshift(p);
+    if (p.includes("#")) break;
+    cur = cur.parentElement;
+  }
+  return out.join(" > ").slice(0, 160);
+};
+var clean = (s) => (s ?? "").replace(/\s+/g, " ").trim().slice(0, 40);
+var labelOf = (el) => {
+  if (el.closest(`${MASK_SELECTOR},${BLOCK_ATTR_SELECTOR}`)) return "";
+  const tag = el.tagName.toLowerCase();
+  if (tag === "input") {
+    const type = (el.getAttribute("type") ?? "text").toLowerCase();
+    return type === "submit" || type === "button" ? clean(el.getAttribute("aria-label") ?? el.value) : clean(el.getAttribute("aria-label"));
+  }
+  if (tag === "select" || tag === "textarea") return clean(el.getAttribute("aria-label"));
+  return clean(el.getAttribute("aria-label") ?? el.getAttribute("title") ?? el.innerText ?? el.textContent);
+};
+var clickInfo = (e) => {
+  const target = e.target instanceof Element ? e.target : null;
+  if (!target) return null;
+  const hit = target.closest(INTERACTIVE);
+  const el = hit ?? target;
+  const doc = document.documentElement;
+  return {
+    x: Math.round(e.clientX),
+    y: Math.round(e.clientY + window.scrollY),
+    vw: window.innerWidth,
+    vh: window.innerHeight,
+    docH: Math.max(doc.scrollHeight, document.body?.scrollHeight ?? 0),
+    selector: selectorOf(el),
+    label: hit ? labelOf(hit) : "",
+    interactive: !!hit
+  };
+};
+var RageDetector = class {
+  constructor(windowMs = 1e3, radius = 30, count = 3) {
+    this.windowMs = windowMs;
+    this.radius = radius;
+    this.count = count;
+  }
+  windowMs;
+  radius;
+  count;
+  clicks = [];
+  fired = false;
+  push(x, y, t) {
+    const near = this.clicks.filter((c) => t - c.t <= this.windowMs && Math.hypot(c.x - x, c.y - y) <= this.radius);
+    if (near.length !== this.clicks.length) this.fired = false;
+    this.clicks = [...near, { x, y, t }];
+    if (this.clicks.length >= this.count && !this.fired) {
+      this.fired = true;
+      return true;
+    }
+    return false;
+  }
+};
+var seenDepth = () => {
+  const doc = document.documentElement;
+  const h = Math.max(doc.scrollHeight, document.body?.scrollHeight ?? 0);
+  if (!h) return 0;
+  return Math.min(100, Math.round((window.scrollY + window.innerHeight) / h * 100));
+};
+export {
+  BLOCK_ATTR_SELECTOR,
+  INTERACTIVE,
+  MASK_SELECTOR,
+  RageDetector,
+  clickInfo,
+  labelOf,
+  seenDepth,
+  selectorOf
+};
+//# sourceMappingURL=capture.js.map

package/dist/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/capture.ts"],"sourcesContent":["/**\n * Clicks and scroll depth for heatmaps, and the rage-click detector session recordings share. Small on purpose: it is\n * part of every page that uses the provider. Runs under the normal analytics consent; it never reads what anyone typed.\n *\n * A click is described by where it landed (x in CSS pixels with the viewport width, y in page pixels with the page\n * height), a short CSS selector and, for links and buttons only, a label of at most 40 characters. Nothing inside\n * `data-ck-mask` or `data-ck-block` gets a label, form fields never do.\n */\n\n/** Elements a click is meant for. A click on anything else is a dead click. */\nexport const INTERACTIVE =\n    'a[href],button,input,select,textarea,label,summary,[role=\"button\"],[role=\"link\"],[role=\"tab\"],[role=\"menuitem\"],[role=\"checkbox\"],[role=\"switch\"],[onclick],[data-ck-goal]';\n/** Text inside is masked in recordings and never becomes a click label. */\nexport const MASK_SELECTOR = \"[data-ck-mask]\";\n/** Left out of recordings entirely (a placeholder of the same size) and never labelled. */\nexport const BLOCK_ATTR_SELECTOR = \"[data-ck-block]\";\n\nexport interface ClickInfo {\n    /** Pointer position: x in CSS pixels from the left of the viewport, y in page pixels from the top of the document. */\n    x: number;\n    y: number;\n    /** Viewport width and height, and the page height, in CSS pixels. */\n    vw: number;\n    vh: number;\n    docH: number;\n    /** A short CSS path, like `main > section.pricing > button`. Ids and classes only, never text. */\n    selector: string;\n    /** For links and buttons: what they say (aria-label, title or text), at most 40 characters; else \"\". */\n    label: string;\n    /** On a link, button or field; false is a dead click. */\n    interactive: boolean;\n}\n\n/** Ids and classes that look generated (hashes, long numbers) say nothing across builds. */\nconst generated = /\\d{4,}|^[a-z]{1,3}-[a-z0-9]{5,}$|^_|__|css-|^sc-|^jsx-/i;\n\nconst part = (el: Element) => {\n    const tag = el.tagName.toLowerCase();\n    if (el.id && !generated.test(el.id) && el.id.length <= 40) return `${tag}#${el.id}`;\n    const cls = typeof el.className === \"string\" ? el.className.split(/\\s+/).filter((c) => c && !generated.test(c) && c.length <= 30 && !c.includes(\":\")) : [];\n    const base = cls.length ? `${tag}.${cls.slice(0, 2).join(\".\")}` : tag;\n    // Siblings of the same kind (two plain buttons side by side) are told apart by their place.\n    const same = el.parentElement ? [...el.parentElement.children].filter((c) => c.tagName === el.tagName) : [];\n    return same.length > 1 ? `${base}:nth-of-type(${same.indexOf(el) + 1})` : base;\n};\n\n/** A selector for the element, three levels at most; stops early at an id. */\nexport const selectorOf = (el: Element) => {\n    const out: string[] = [];\n    let cur: Element | null = el;\n    while (cur && out.length < 3 && cur.tagName && cur.tagName !== \"BODY\" && cur.tagName !== \"HTML\") {\n        const p = part(cur);\n        out.unshift(p);\n        if (p.includes(\"#\")) break;\n        cur = cur.parentElement;\n    }\n    return out.join(\" > \").slice(0, 160);\n};\n\nconst clean = (s: string | null | undefined) => (s ?? \"\").replace(/\\s+/g, \" \").trim().slice(0, 40);\n\n/** What a link or button says, never a field's value; \"\" inside masked or blocked parts. */\nexport const labelOf = (el: Element) => {\n    if (el.closest(`${MASK_SELECTOR},${BLOCK_ATTR_SELECTOR}`)) return \"\";\n    const tag = el.tagName.toLowerCase();\n    if (tag === \"input\") {\n        const type = (el.getAttribute(\"type\") ?? \"text\").toLowerCase();\n        return type === \"submit\" || type === \"button\" ? clean(el.getAttribute(\"aria-label\") ?? (el as HTMLInputElement).value) : clean(el.getAttribute(\"aria-label\"));\n    }\n    if (tag === \"select\" || tag === \"textarea\") return clean(el.getAttribute(\"aria-label\"));\n    return clean(el.getAttribute(\"aria-label\") ?? el.getAttribute(\"title\") ?? (el as HTMLElement).innerText ?? el.textContent);\n};\n\n/** The click's description, or null when it did not land on an element. */\nexport const clickInfo = (e: MouseEvent): ClickInfo | null => {\n    const target = e.target instanceof Element ? e.target : null;\n    if (!target) return null;\n    const hit = target.closest(INTERACTIVE);\n    const el = hit ?? target;\n    const doc = document.documentElement;\n    return {\n        x: Math.round(e.clientX),\n        y: Math.round(e.clientY + window.scrollY),\n        vw: window.innerWidth,\n        vh: window.innerHeight,\n        docH: Math.max(doc.scrollHeight, document.body?.scrollHeight ?? 0),\n        selector: selectorOf(el),\n        label: hit ? labelOf(hit) : \"\",\n        interactive: !!hit,\n    };\n};\n\n/**\n * Three or more clicks within one second on the same spot (30 pixels) are a rage click. `push` answers true once per\n * burst, on the third click.\n */\nexport class RageDetector {\n    private clicks: { x: number; y: number; t: number }[] = [];\n    private fired = false;\n    constructor(\n        private readonly windowMs = 1000,\n        private readonly radius = 30,\n        private readonly count = 3,\n    ) {}\n    push(x: number, y: number, t: number) {\n        const near = this.clicks.filter((c) => t - c.t <= this.windowMs && Math.hypot(c.x - x, c.y - y) <= this.radius);\n        if (near.length !== this.clicks.length) this.fired = false;\n        this.clicks = [...near, { x, y, t }];\n        if (this.clicks.length >= this.count && !this.fired) {\n            this.fired = true;\n            return true;\n        }\n        return false;\n    }\n}\n\n/** How far down the page the visitor has seen, 0 to 100. */\nexport const seenDepth = () => {\n    const doc = document.documentElement;\n    const h = Math.max(doc.scrollHeight, document.body?.scrollHeight ?? 0);\n    if (!h) return 0;\n    return Math.min(100, Math.round(((window.scrollY + window.innerHeight) / h) * 100));\n};\n"],"mappings":"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","names":[]}

package/dist/client.d.ts

@@ -0,0 +1,83 @@
+import { type ReactNode } from "react";
+import { type AttributionMode } from "./referral.js";
+import { type CockpitConfig, type ConsentChoice, type ConsentMode, type VariantId } from "./core.js";
+export interface CockpitProviderProps {
+    /** The product's public key from Cockpit › Settings › SDK. Safe in the browser. Default: `NEXT_PUBLIC_MRROCKET_KEY`. */
+    apiKey?: string;
+    /** Where MRRocket runs, like `https://app.example.com`. Default: `NEXT_PUBLIC_MRROCKET_HOST`, else the page's own origin. */
+    host?: string;
+    preview?: Record<string, VariantId>;
+    embedded?: boolean;
+    /** Config fetched on the server, to render the right variant on the first paint. */
+    config?: CockpitConfig;
+    /** Your own id for this visitor, for example a signed-in user id. Keeps variants stable without cookies. */
+    distinctId?: string;
+    /**
+     * "cookieless" (default) stores nothing in the browser, "cookies" keeps a visitor cookie for a year, "off" sends
+     * nothing. The SDK does not remember the choice: set it on every page load, from the prop or setConsent().
+     */
+    consent?: ConsentMode;
+    /** Send nothing when the browser asks not to be tracked (Do Not Track or Global Privacy Control). */
+    respectDnt?: boolean;
+    /**
+     * The visitor's consent to session recordings, separate from analytics (default false). Recording also needs the
+     * product to record (Cockpit › Sessions) and analytics not "off". Without it nothing is recorded or buffered.
+     * Change it later with `setConsent({ replay })`.
+     */
+    replay?: boolean;
+    /**
+     * Clicks and scroll depth for Heatmaps (default true): where a click landed, a short selector and a link's or
+     * button's label, never typed text. Sent under the normal analytics consent as `$click`, `$rageclick` and `$scroll`.
+     */
+    heatmaps?: boolean;
+    /** Ask visitors the surveys you run in Cockpit. Set false to switch them off. */
+    surveys?: boolean;
+    /**
+     * Affiliate referrals (`?ref=` links and MRRocket's tracked links). "consent" (default): stored in the first-party
+     * `mrr_ref` cookie only while consent is "cookies", in memory otherwise. "always": stored whatever the consent (only
+     * where your legal basis allows it). "off": referrals are ignored.
+     */
+    attribution?: AttributionMode;
+    /** The query parameter of direct partner links, default `ref` (`https://your.site/?ref=maya`). */
+    referralParam?: string;
+    children: ReactNode;
+}
+/**
+ * Put it once around your app, in `app/layout.tsx`. It loads your experiments, keeps each visitor in one variant,
+ * records page views and sends your events to Cockpit in small batches.
+ *
+ * `preview` forces variants for this render, for example from the `ck_preview` search param on the server,
+ * so a Cockpit preview never flickers. Without it the provider reads the param itself after the first render.
+ */
+export declare const CockpitProvider: ({ apiKey: apiKeyProp, host: hostProp, preview: forced, embedded: embeddedProp, config: bootstrapConfig, distinctId: bootstrapId, consent: consentProp, respectDnt, replay: replayProp, heatmaps, surveys, attribution, referralParam, children, }: CockpitProviderProps) => import("react").JSX.Element;
+/**
+ * `track`, `identify`, the consent mode, the replay consent and their setter, the visitor id and whether the
+ * experiments have loaded. `setConsent("cookies")` sets the mode, `setConsent({ replay: true })` the replay consent.
+ */
+export declare const useCockpit: () => {
+    track: (event: string, props?: Record<string, unknown>) => void;
+    identify: (id: string, props?: Record<string, unknown>) => void;
+    distinctId: string;
+    ready: boolean;
+    embedded: boolean;
+    consent: ConsentMode;
+    replay: boolean;
+    setConsent: (choice: ConsentChoice) => void;
+};
+/** The variant this visitor sees, for example `"control"` or `"a"`. Records the exposure. */
+export declare const useVariant: (key: string) => VariantId;
+/** Renders the element for the visitor's variant; control when the variant has no element. */
+export declare const Experiment: ({ name, variants }: {
+    name: string;
+    variants: Record<VariantId, ReactNode> & {
+        control: ReactNode;
+    };
+}) => import("react").JSX.Element;
+/**
+ * A text that experiments may change without a deploy: Cockpit sends the new copy for `id` and this renders it.
+ * Write your default as the children.
+ */
+export declare const Text: ({ id, children }: {
+    id: string;
+    children: string;
+}) => import("react").JSX.Element;

package/dist/client.js

@@ -0,0 +1,468 @@
+"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 { RageDetector, clickInfo, seenDepth } from "./capture.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,
+  replay: replayProp = false,
+  heatmaps = true,
+  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 [replayConsent, setReplayConsent] = useState(replayProp);
+  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((choice) => {
+    const { analytics: mode, replay } = typeof choice === "string" ? { analytics: choice, replay: void 0 } : choice;
+    if (mode === "off") queue.current.length = 0;
+    if (mode) setConsentState(mode);
+    if (typeof replay === "boolean") setReplayConsent(replay);
+  }, []);
+  const lastProp = useRef(consentProp);
+  useEffect(() => {
+    if (lastProp.current === consentProp) return;
+    lastProp.current = consentProp;
+    setConsent(consentProp);
+  }, [consentProp, setConsent]);
+  const lastReplayProp = useRef(replayProp);
+  useEffect(() => {
+    if (lastReplayProp.current === replayProp) return;
+    lastReplayProp.current = replayProp;
+    setConsent({ replay: replayProp });
+  }, [replayProp, 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, identified: false });
+  live.current = { resolved: visitor !== null, tracking, distinctId, sendId, persist: visitor?.mode === "cookies", identified: !!identified };
+  const record = useCallback((event, props, ts = Date.now(), url) => {
+    const now = live.current;
+    if (!now.resolved) {
+      early.current.push(() => record(event, props, ts, url));
+      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: url ?? window.location.href,
+      referrer: page.referrer,
+      ...page.utm,
+      screen: { w: window.screen.width, h: window.screen.height }
+    });
+  }, []);
+  const replayer = useRef(null);
+  const track = useCallback(
+    (event, props) => {
+      record(event, props);
+      if (live.current.tracking) replayer.current?.event(event);
+    },
+    [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, identified: true };
+      record("$identify", { ...props, id, ...previous && previous !== id ? { previousId: previous } : {} });
+      replayer.current?.identify(id);
+      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();
+    replayer.current?.page(pathname);
+  }, [pathname]);
+  useEffect(() => {
+    if (!tracking || lastPage.current === pathname) return;
+    lastPage.current = pathname;
+    track("$pageview", { path: pathname });
+  }, [pathname, tracking, track]);
+  const rage = useRef(new RageDetector());
+  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) });
+      if (!live.current.tracking) return;
+      const c = clickInfo(e);
+      if (!c) return;
+      const raged = rage.current.push(c.x, c.y, Date.now());
+      replayer.current?.click(c, raged);
+      if (!heatmaps) return;
+      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 };
+      record("$click", props);
+      if (raged) record("$rageclick", props);
+    };
+    document.addEventListener("click", onClick);
+    return () => document.removeEventListener("click", onClick);
+  }, [track, record, heatmaps]);
+  const depth = useRef(null);
+  useEffect(() => {
+    if (!heatmaps || !tracking || embedded) return;
+    const send = () => {
+      const d = depth.current;
+      if (d && d.max > 0) record("$scroll", { depth: d.max, docH: d.docH, vw: window.innerWidth, vh: window.innerHeight }, Date.now(), d.url);
+      depth.current = null;
+    };
+    const measure = () => {
+      const doc = document.documentElement;
+      const docH = Math.max(doc.scrollHeight, document.body?.scrollHeight ?? 0);
+      const max = seenDepth();
+      const href = window.location.href;
+      if (depth.current?.url !== href) depth.current = { url: href, max, docH };
+      else if (max > depth.current.max) depth.current = { url: href, max, docH };
+    };
+    measure();
+    let frame = 0;
+    const onScroll = () => {
+      if (frame) return;
+      frame = window.requestAnimationFrame(() => {
+        frame = 0;
+        measure();
+      });
+    };
+    const onHide = () => {
+      send();
+      flush(true);
+    };
+    window.addEventListener("scroll", onScroll, { passive: true });
+    window.addEventListener("pagehide", onHide);
+    return () => {
+      window.removeEventListener("scroll", onScroll);
+      window.removeEventListener("pagehide", onHide);
+      window.cancelAnimationFrame(frame);
+      send();
+    };
+  }, [heatmaps, tracking, embedded, pathname, record, flush]);
+  const replayConfig = config?.replay;
+  const recording = tracking && replayConsent && !!replayConfig && !!apiKey;
+  useEffect(() => {
+    if (!recording || !replayConfig) return;
+    let active = true;
+    let handle = null;
+    void (typeof window === "undefined" ? Promise.resolve(null) : import("./replay.js")).then(
+      (m) => m?.startReplay({
+        host,
+        apiKey,
+        sessionId: touchSession(live.current.persist),
+        distinctId: live.current.sendId,
+        identified: live.current.identified,
+        sampleRate: replayConfig.sampleRate,
+        warn: warnOnce
+      })
+    ).then((h) => {
+      if (!active) h?.stop(true);
+      else replayer.current = handle = h ?? null;
+    }).catch(() => warnOnce("Session recording could not start (the recorder did not load)."));
+    return () => {
+      active = false;
+      handle?.stop(true);
+      if (replayer.current === handle) replayer.current = null;
+    };
+  }, [recording, replayConfig, host, apiKey]);
+  const texts = useMemo(() => textChanges(config, distinctId, preview), [config, distinctId, preview]);
+  const value = useMemo(
+    () => ({ apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, replayConsent, setConsent, texts, track, identify, expose }),
+    [apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, replayConsent, 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, replayConsent, setConsent } = useCtx();
+  return { track, identify, distinctId, ready, embedded, consent, replay: replayConsent, 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