@mrrocket/sdk 0.1.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/client.js CHANGED
@@ -5,6 +5,8 @@ import { useCallback, useEffect, useMemo, useRef, useState } from "react";
5
5
  import { usePathname } from "next/navigation";
6
6
  import { Ctx, useCtx } from "./context.js";
7
7
  import { Survey, forgetStoredDismissals } from "./survey.js";
8
+ import { RageDetector, clickInfo, seenDepth } from "./capture.js";
9
+ import { startErrorCapture } from "./errors.js";
8
10
  import {
9
11
  DEFAULT_REFERRAL_DAYS,
10
12
  captureReferral,
@@ -18,9 +20,11 @@ import {
18
20
  EMBED_PARAM,
19
21
  ID_COOKIE,
20
22
  PREVIEW_PARAM,
23
+ SDK_VERSION,
21
24
  SESSION_COOKIE,
22
25
  SESSION_TIMEOUT_MS,
23
26
  envKey,
27
+ flagFor,
24
28
  newDistinctId,
25
29
  parsePreview,
26
30
  readUtm,
@@ -87,8 +91,8 @@ var warnOnce = (message) => {
87
91
  console.warn(`[MRRocket] ${message}`);
88
92
  };
89
93
  var byteLength = (s) => new TextEncoder().encode(s).length;
90
- var bodies = (key, events) => {
91
- const head = `{"key":${JSON.stringify(key)},"events":[`;
94
+ var bodies = (key, events, sdk) => {
95
+ const head = `{"key":${JSON.stringify(key)},"sdk":${JSON.stringify(sdk)},"events":[`;
92
96
  const empty = byteLength(head) + 2;
93
97
  const out = [];
94
98
  let chunk = [];
@@ -118,7 +122,11 @@ var CockpitProvider = ({
118
122
  distinctId: bootstrapId,
119
123
  consent: consentProp = "cookieless",
120
124
  respectDnt = false,
125
+ replay: replayProp = false,
126
+ heatmaps = true,
121
127
  surveys = true,
128
+ errors = true,
129
+ release,
122
130
  attribution = "consent",
123
131
  referralParam = "ref",
124
132
  children
@@ -128,6 +136,7 @@ var CockpitProvider = ({
128
136
  const host = resolveHost(hostProp);
129
137
  const [config, setConfig] = useState(bootstrapConfig ?? null);
130
138
  const [consent, setConsentState] = useState(consentProp);
139
+ const [replayConsent, setReplayConsent] = useState(replayProp);
131
140
  const [mounted, setMounted] = useState(false);
132
141
  const [dnt, setDnt] = useState(false);
133
142
  const [visitor, setVisitor] = useState(null);
@@ -154,9 +163,11 @@ var CockpitProvider = ({
154
163
  setDnt(privacySignal());
155
164
  setMounted(true);
156
165
  }, []);
157
- const setConsent = useCallback((mode) => {
166
+ const setConsent = useCallback((choice) => {
167
+ const { analytics: mode, replay } = typeof choice === "string" ? { analytics: choice, replay: void 0 } : choice;
158
168
  if (mode === "off") queue.current.length = 0;
159
- setConsentState(mode);
169
+ if (mode) setConsentState(mode);
170
+ if (typeof replay === "boolean") setReplayConsent(replay);
160
171
  }, []);
161
172
  const lastProp = useRef(consentProp);
162
173
  useEffect(() => {
@@ -164,6 +175,12 @@ var CockpitProvider = ({
164
175
  lastProp.current = consentProp;
165
176
  setConsent(consentProp);
166
177
  }, [consentProp, setConsent]);
178
+ const lastReplayProp = useRef(replayProp);
179
+ useEffect(() => {
180
+ if (lastReplayProp.current === replayProp) return;
181
+ lastReplayProp.current = replayProp;
182
+ setConsent({ replay: replayProp });
183
+ }, [replayProp, setConsent]);
167
184
  const storedFor = useRef(null);
168
185
  useEffect(() => {
169
186
  if (!mounted) return;
@@ -210,7 +227,7 @@ var CockpitProvider = ({
210
227
  return;
211
228
  }
212
229
  const url = `${host}/api/sdk/events`;
213
- for (const body of bodies(apiKey, queue.current.splice(0))) {
230
+ for (const body of bodies(apiKey, queue.current.splice(0), { v: SDK_VERSION, errors })) {
214
231
  const sent = beacon && typeof navigator !== "undefined" && "sendBeacon" in navigator && navigator.sendBeacon(url, body);
215
232
  if (!sent)
216
233
  fetch(url, { method: "POST", headers: { "content-type": "application/json" }, body, keepalive: true }).then((r) => {
@@ -218,7 +235,7 @@ var CockpitProvider = ({
218
235
  }).catch(() => warnOnce(`Could not reach ${host || "this origin"} to send events. Check NEXT_PUBLIC_MRROCKET_HOST.`));
219
236
  }
220
237
  },
221
- [apiKey, host]
238
+ [apiKey, host, errors]
222
239
  );
223
240
  useEffect(() => {
224
241
  const timer = window.setInterval(() => flush(), 2e3);
@@ -230,12 +247,12 @@ var CockpitProvider = ({
230
247
  flush(true);
231
248
  };
232
249
  }, [flush]);
233
- const live = useRef({ resolved: false, tracking, distinctId, sendId, persist: false });
234
- live.current = { resolved: visitor !== null, tracking, distinctId, sendId, persist: visitor?.mode === "cookies" };
235
- const record = useCallback((event, props, ts = Date.now()) => {
250
+ const live = useRef({ resolved: false, tracking, distinctId, sendId, persist: false, identified: false });
251
+ live.current = { resolved: visitor !== null, tracking, distinctId, sendId, persist: visitor?.mode === "cookies", identified: !!identified };
252
+ const record = useCallback((event, props, ts = Date.now(), url) => {
236
253
  const now = live.current;
237
254
  if (!now.resolved) {
238
- early.current.push(() => record(event, props, ts));
255
+ early.current.push(() => record(event, props, ts, url));
239
256
  return;
240
257
  }
241
258
  if (!now.tracking) return;
@@ -246,13 +263,21 @@ var CockpitProvider = ({
246
263
  distinctId: now.sendId,
247
264
  sessionId: touchSession(now.persist),
248
265
  ts,
249
- url: window.location.href,
266
+ url: url ?? window.location.href,
250
267
  referrer: page.referrer,
251
268
  ...page.utm,
252
269
  screen: { w: window.screen.width, h: window.screen.height }
253
270
  });
254
271
  }, []);
255
- const track = useCallback((event, props) => record(event, props), [record]);
272
+ const replayer = useRef(null);
273
+ const errorer = useRef(null);
274
+ const track = useCallback(
275
+ (event, props) => {
276
+ record(event, props);
277
+ if (live.current.tracking) replayer.current?.event(event);
278
+ },
279
+ [record]
280
+ );
256
281
  const identify = useCallback(
257
282
  (id, props) => {
258
283
  const now = live.current;
@@ -261,8 +286,9 @@ var CockpitProvider = ({
261
286
  return;
262
287
  }
263
288
  const previous = now.sendId;
264
- live.current = { ...now, distinctId: id, sendId: id };
289
+ live.current = { ...now, distinctId: id, sendId: id, identified: true };
265
290
  record("$identify", { ...props, id, ...previous && previous !== id ? { previousId: previous } : {} });
291
+ replayer.current?.identify(id);
266
292
  if (now.persist) writeCookie(ID_COOKIE, id, YEAR_S);
267
293
  setIdentified(id);
268
294
  setUser({ id, ...props });
@@ -319,24 +345,118 @@ var CockpitProvider = ({
319
345
  );
320
346
  useEffect(() => {
321
347
  enterPage();
348
+ replayer.current?.page(pathname);
349
+ errorer.current?.crumb("navigation", pathname);
322
350
  }, [pathname]);
351
+ useEffect(() => {
352
+ if (!errors || !apiKey || embedded) return;
353
+ const capture = startErrorCapture({
354
+ host,
355
+ apiKey,
356
+ release,
357
+ context: () => ({ send: live.current.tracking, distinctId: live.current.sendId, sessionId: page.session?.id }),
358
+ warn: warnOnce
359
+ });
360
+ errorer.current = capture;
361
+ capture.crumb("navigation", window.location.pathname);
362
+ return () => {
363
+ capture.stop();
364
+ if (errorer.current === capture) errorer.current = null;
365
+ };
366
+ }, [errors, apiKey, host, release, embedded]);
367
+ const captureError = useCallback((error) => errorer.current?.capture(error, "manual"), []);
323
368
  useEffect(() => {
324
369
  if (!tracking || lastPage.current === pathname) return;
325
370
  lastPage.current = pathname;
326
371
  track("$pageview", { path: pathname });
327
372
  }, [pathname, tracking, track]);
373
+ const rage = useRef(new RageDetector());
328
374
  useEffect(() => {
329
375
  const onClick = (e) => {
330
376
  const el = e.target?.closest("[data-ck-goal]");
331
377
  if (el?.dataset.ckGoal) track(el.dataset.ckGoal, { text: el.textContent?.trim().slice(0, 80) });
378
+ if (!live.current.tracking) return;
379
+ const c = clickInfo(e);
380
+ if (!c) return;
381
+ const raged = rage.current.push(c.x, c.y, Date.now());
382
+ if (c.label || c.selector) errorer.current?.crumb("click", c.label || c.selector);
383
+ replayer.current?.click(c, raged);
384
+ if (!heatmaps) return;
385
+ 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 };
386
+ record("$click", props);
387
+ if (raged) record("$rageclick", props);
332
388
  };
333
389
  document.addEventListener("click", onClick);
334
390
  return () => document.removeEventListener("click", onClick);
335
- }, [track]);
391
+ }, [track, record, heatmaps]);
392
+ const depth = useRef(null);
393
+ useEffect(() => {
394
+ if (!heatmaps || !tracking || embedded) return;
395
+ const send = () => {
396
+ const d = depth.current;
397
+ if (d && d.max > 0) record("$scroll", { depth: d.max, docH: d.docH, vw: window.innerWidth, vh: window.innerHeight }, Date.now(), d.url);
398
+ depth.current = null;
399
+ };
400
+ const measure = () => {
401
+ const doc = document.documentElement;
402
+ const docH = Math.max(doc.scrollHeight, document.body?.scrollHeight ?? 0);
403
+ const max = seenDepth();
404
+ const href = window.location.href;
405
+ if (depth.current?.url !== href) depth.current = { url: href, max, docH };
406
+ else if (max > depth.current.max) depth.current = { url: href, max, docH };
407
+ };
408
+ measure();
409
+ let frame = 0;
410
+ const onScroll = () => {
411
+ if (frame) return;
412
+ frame = window.requestAnimationFrame(() => {
413
+ frame = 0;
414
+ measure();
415
+ });
416
+ };
417
+ const onHide = () => {
418
+ send();
419
+ flush(true);
420
+ };
421
+ window.addEventListener("scroll", onScroll, { passive: true });
422
+ window.addEventListener("pagehide", onHide);
423
+ return () => {
424
+ window.removeEventListener("scroll", onScroll);
425
+ window.removeEventListener("pagehide", onHide);
426
+ window.cancelAnimationFrame(frame);
427
+ send();
428
+ };
429
+ }, [heatmaps, tracking, embedded, pathname, record, flush]);
430
+ const replayConfig = config?.replay;
431
+ const recording = tracking && replayConsent && !!replayConfig && !!apiKey;
432
+ useEffect(() => {
433
+ if (!recording || !replayConfig) return;
434
+ let active = true;
435
+ let handle = null;
436
+ void (typeof window === "undefined" ? Promise.resolve(null) : import("./replay.js")).then(
437
+ (m) => m?.startReplay({
438
+ host,
439
+ apiKey,
440
+ sessionId: touchSession(live.current.persist),
441
+ distinctId: live.current.sendId,
442
+ identified: live.current.identified,
443
+ sampleRate: replayConfig.sampleRate,
444
+ warn: warnOnce
445
+ })
446
+ ).then((h) => {
447
+ if (!active) h?.stop(true);
448
+ else replayer.current = handle = h ?? null;
449
+ }).catch(() => warnOnce("Session recording could not start (the recorder did not load)."));
450
+ return () => {
451
+ active = false;
452
+ handle?.stop(true);
453
+ if (replayer.current === handle) replayer.current = null;
454
+ };
455
+ }, [recording, replayConfig, host, apiKey]);
336
456
  const texts = useMemo(() => textChanges(config, distinctId, preview), [config, distinctId, preview]);
337
457
  const value = useMemo(
338
- () => ({ apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, setConsent, texts, track, identify, expose }),
339
- [apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, setConsent, texts, track, identify, expose]
458
+ () => ({ apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, replayConsent, setConsent, texts, track, identify, expose, captureError }),
459
+ [apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, replayConsent, setConsent, texts, track, identify, expose, captureError]
340
460
  );
341
461
  return /* @__PURE__ */ jsxs(Ctx.Provider, { value, children: [
342
462
  children,
@@ -344,8 +464,17 @@ var CockpitProvider = ({
344
464
  ] });
345
465
  };
346
466
  var useCockpit = () => {
347
- const { track, identify, distinctId, ready, embedded, consent, setConsent } = useCtx();
348
- return { track, identify, distinctId, ready, embedded, consent, setConsent };
467
+ const { track, identify, captureError, distinctId, ready, embedded, consent, replayConsent, setConsent } = useCtx();
468
+ return { track, identify, captureError, distinctId, ready, embedded, consent, replay: replayConsent, setConsent };
469
+ };
470
+ var useFlag = (key) => useFlagValue(key) !== false;
471
+ var useFlagVariant = (key) => {
472
+ const v = useFlagValue(key);
473
+ return typeof v === "string" ? v : null;
474
+ };
475
+ var useFlagValue = (key) => {
476
+ const { config, distinctId, user } = useCtx();
477
+ return useMemo(() => flagFor(key, config, distinctId, { ...user }), [key, config, distinctId, user]);
349
478
  };
350
479
  var useVariant = (key) => {
351
480
  const { config, distinctId, preview, expose } = useCtx();
@@ -368,6 +497,8 @@ export {
368
497
  Experiment,
369
498
  Text,
370
499
  useCockpit,
500
+ useFlag,
501
+ useFlagVariant,
371
502
  useVariant
372
503
  };
373
504
  //# sourceMappingURL=client.js.map
@@ -1 +1 @@
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"]}
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 { type ErrorCapture, startErrorCapture } from \"./errors\";\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 SDK_VERSION,\n SESSION_COOKIE,\n SESSION_TIMEOUT_MS,\n type UtmKey,\n type VariantId,\n envKey,\n flagFor,\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/**\n * Request bodies of at most 100 events each, under the size limit. An event too large on its own is dropped. `sdk` tells\n * MRRocket which SDK the site runs and whether it reports errors (Build › Errors and Feature flags show it).\n */\nconst bodies = (key: string, events: CockpitEvent[], sdk: { v: string; errors: boolean }) => {\n const head = `{\"key\":${JSON.stringify(key)},\"sdk\":${JSON.stringify(sdk)},\"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 * Error tracking for Build › Errors (default true): uncaught errors and unhandled promise rejections, with the page\n * and the last pages and clicks, under the normal analytics consent. Report errors you catch with\n * `useCockpit().captureError(error)`.\n */\n errors?: boolean;\n /** Your release (a version or a commit), so MRRocket can tell which release an error came with. */\n release?: string;\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 errors = true,\n release,\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), { v: SDK_VERSION, errors })) {\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, errors],\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 // Error tracking, while `errors` is on (see the effect below).\n const errorer = useRef<ErrorCapture | 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 errorer.current?.crumb(\"navigation\", pathname);\n }, [pathname]);\n\n // Errors of the page for Build › Errors; sent only while tracking (consent, not a preview), like events.\n useEffect(() => {\n if (!errors || !apiKey || embedded) return;\n const capture = startErrorCapture({\n host,\n apiKey,\n release,\n context: () => ({ send: live.current.tracking, distinctId: live.current.sendId, sessionId: page.session?.id }),\n warn: warnOnce,\n });\n errorer.current = capture;\n capture.crumb(\"navigation\", window.location.pathname);\n return () => {\n capture.stop();\n if (errorer.current === capture) errorer.current = null;\n };\n }, [errors, apiKey, host, release, embedded]);\n\n const captureError = useCallback((error: unknown) => errorer.current?.capture(error, \"manual\"), []);\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 if (c.label || c.selector) errorer.current?.crumb(\"click\", c.label || c.selector);\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, captureError }),\n [apiKey, host, user, ready, distinctId, config, preview, embedded, consent, effectiveConsent, replayConsent, setConsent, texts, track, identify, expose, captureError],\n );\n return (\n <Ctx.Provider value={value}>\n {children}\n {surveys ? <Survey /> : null}\n </Ctx.Provider>\n );\n};\n\n/**\n * `track`, `identify`, `captureError`, the consent mode, the replay consent and their setter, the visitor id and whether\n * the experiments and flags have loaded. `setConsent(\"cookies\")` sets the mode, `setConsent({ replay: true })` the\n * replay consent.\n */\nexport const useCockpit = () => {\n const { track, identify, captureError, distinctId, ready, embedded, consent, replayConsent, setConsent } = useCtx();\n return { track, identify, captureError, distinctId, ready, embedded, consent, replay: replayConsent, setConsent };\n};\n\n/**\n * A feature flag from MRRocket › Build › Feature flags: true while it is on for this visitor (its audience and rollout\n * in Production), false while it is off, unknown, or the flags have not loaded yet (`useCockpit().ready`). The person's\n * properties from `identify(id, props)` feed the audience conditions (\"Email\", \"Plan\" …).\n *\n * const newCheckout = useFlag(\"new-checkout\");\n */\nexport const useFlag = (key: string): boolean => useFlagValue(key) !== false;\n\n/** The variant of a multivariate flag for this visitor (\"control\", \"test\" …), or null while the flag is off. */\nexport const useFlagVariant = (key: string): string | null => {\n const v = useFlagValue(key);\n return typeof v === \"string\" ? v : null;\n};\n\nconst useFlagValue = (key: string) => {\n const { config, distinctId, user } = useCtx();\n return useMemo(() => flagFor(key, config, distinctId, { ...user }), [key, config, distinctId, user]);\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 CHANGED
@@ -1,4 +1,4 @@
1
- import type { CockpitConfig, ConsentMode, VariantId } from "./core.js";
1
+ import type { CockpitConfig, ConsentChoice, ConsentMode, VariantId } from "./core.js";
2
2
  /** Who the visitor is, from identify(). Sent along with feedback and survey answers. */
3
3
  export interface CockpitUser {
4
4
  id: string;
@@ -20,12 +20,16 @@ export interface CockpitContext {
20
20
  consent: ConsentMode;
21
21
  /** What applies right now: "off" when the browser sends Do Not Track and the provider respects it. */
22
22
  effectiveConsent: ConsentMode;
23
- setConsent: (mode: ConsentMode) => void;
23
+ /** The visitor's consent to session recordings (`replay` prop or `setConsent({ replay })`). */
24
+ replayConsent: boolean;
25
+ setConsent: (choice: ConsentChoice) => void;
24
26
  texts: Record<string, string>;
25
27
  track: (event: string, props?: Record<string, unknown>) => void;
26
28
  identify: (id: string, props?: Record<string, unknown>) => void;
27
29
  /** Records that the visitor saw a variant, once per experiment and page view. */
28
30
  expose: (key: string, variant: VariantId) => void;
31
+ /** Reports an error you caught to Build › Errors (while error tracking is on). */
32
+ captureError: (error: unknown) => void;
29
33
  }
30
34
  export declare const Ctx: import("react").Context<CockpitContext | null>;
31
35
  export declare const useCtx: () => CockpitContext;
@@ -1 +1 @@
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":[]}
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 /** Reports an error you caught to Build › Errors (while error tracking is on). */\n captureError: (error: unknown) => 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;AAqCnC,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 CHANGED
@@ -3,6 +3,8 @@
3
3
  * No React, no browser APIs, so the server helper, the proxy helper and the client share it.
4
4
  */
5
5
  export type VariantId = string;
6
+ /** This build of the SDK. Sent with the config request so MRRocket knows what the site runs (error tracking, flags). */
7
+ export declare const SDK_VERSION = "0.3.0";
6
8
  /** One variant of an experiment. `changes` replaces texts that the page marks with `<Text id>`. */
7
9
  export interface VariantConfig {
8
10
  id: VariantId;
@@ -27,6 +29,79 @@ export interface CockpitConfig {
27
29
  referral?: {
28
30
  cookieDays: number;
29
31
  };
32
+ /** Session recordings: present only while the product records (Cockpit › Sessions). See `ReplayConfig`. */
33
+ replay?: ReplayConfig;
34
+ /** Feature flags of the product in Production (MRRocket › Build › Feature flags), evaluated by `useFlag` and `getFlag`. */
35
+ flags?: FlagConfig[];
36
+ }
37
+ /** One condition of a flag's audience, on a property of the person (`identify(id, props)`), the id or the page. */
38
+ export interface FlagCondition {
39
+ /** "Email", "Plan", "Country", "id", "path" … Matched against the person's properties without regard to case. */
40
+ property: string;
41
+ op: "is" | "is not" | "in" | "not in" | "≥" | "in cohort";
42
+ values: string[];
43
+ }
44
+ /** Users who match every condition, of whom `rollout` percent get the flag. No conditions: everyone. */
45
+ export interface FlagConditionSet {
46
+ conditions: FlagCondition[];
47
+ /** 0 to 100. */
48
+ rollout: number;
49
+ }
50
+ export interface FlagConfig {
51
+ key: string;
52
+ /** Off: everyone gets the off side. */
53
+ on: boolean;
54
+ /** The first set a person matches decides; none matched: off. */
55
+ sets: FlagConditionSet[];
56
+ /** Multivariate flags: the variants and their split in percent (control included). Missing for an on/off flag. */
57
+ variants?: {
58
+ key: string;
59
+ split: number;
60
+ payload?: string;
61
+ }[];
62
+ }
63
+ /** What a person is for flag conditions: their properties from identify(), their id and the page they are on. */
64
+ export type FlagPerson = Record<string, unknown>;
65
+ /**
66
+ * The flag for one person: `false` (off), `true` (on, an on/off flag) or the variant's key (a multivariate flag). The
67
+ * bucket is a stable hash of flag and person, so a person keeps their side as the rollout grows.
68
+ */
69
+ export declare const evaluateFlag: (flag: FlagConfig, distinctId: string, person?: FlagPerson) => boolean | string;
70
+ /** A flag of the config for this person; an unknown flag (or no config) is off. */
71
+ export declare const flagFor: (key: string, config: CockpitConfig | null, distinctId: string, person?: FlagPerson) => string | boolean;
72
+ /** One JavaScript error as it goes over the wire to `POST /api/sdk/errors`. */
73
+ export interface ErrorReport {
74
+ /** "TypeError", "Error" … */
75
+ type: string;
76
+ message: string;
77
+ /** The raw stack, at most 8 KB. MRRocket parses it into frames. */
78
+ stack?: string;
79
+ /** "onerror" (uncaught), "onunhandledrejection" (a rejected promise nobody caught) or "manual" (captureError). */
80
+ mechanism: "onerror" | "onunhandledrejection" | "manual";
81
+ handled: boolean;
82
+ url: string;
83
+ ts: number;
84
+ /** What happened just before: pages and clicks, newest last, at most 20. */
85
+ crumbs?: {
86
+ ts: number;
87
+ type: "navigation" | "click" | "lifecycle";
88
+ message: string;
89
+ }[];
90
+ /** Your release (a version or commit), from the provider's `release` prop. */
91
+ release?: string;
92
+ distinctId?: string;
93
+ sessionId?: string;
94
+ }
95
+ /**
96
+ * Session recordings of a product, from the config. Recording also needs the visitor's own replay consent
97
+ * (`<CockpitProvider replay>` or `setConsent({ replay: true })`); without it nothing is recorded or buffered.
98
+ */
99
+ export interface ReplayConfig {
100
+ /**
101
+ * Share of sessions uploaded from their start, 0 to 1 (default 0.1). The others keep only the last minute in
102
+ * memory and upload it when something goes wrong: a JS error, a rage click, a `purchase…` or `checkout…` event.
103
+ */
104
+ sampleRate: number;
30
105
  }
31
106
  /**
32
107
  * What the SDK may send and store.
@@ -36,6 +111,18 @@ export interface CockpitConfig {
36
111
  * - "off": nothing is sent and nothing is stored.
37
112
  */
38
113
  export type ConsentMode = "cookieless" | "cookies" | "off";
114
+ /**
115
+ * What `setConsent` takes: a mode as before, or the parts to change. `replay` is the separate consent for session
116
+ * recordings (default false); it applies only while analytics is not "off".
117
+ *
118
+ * setConsent("cookies");
119
+ * setConsent({ replay: true });
120
+ * setConsent({ analytics: "cookieless", replay: false });
121
+ */
122
+ export type ConsentChoice = ConsentMode | {
123
+ analytics?: ConsentMode;
124
+ replay?: boolean;
125
+ };
39
126
  /** The campaign parameters the SDK reads from the landing URL. */
40
127
  export declare const UTM_KEYS: readonly ["utm_source", "utm_medium", "utm_campaign", "utm_term", "utm_content"];
41
128
  export type UtmKey = (typeof UTM_KEYS)[number];
@@ -77,6 +164,11 @@ export declare const SESSION_TIMEOUT_MS: number;
77
164
  export declare const readUtm: (search: string) => Partial<Record<UtmKey, string>>;
78
165
  /** FNV-1a, 32 bit, mapped to [0, 1). Stable across server and browser. */
79
166
  export declare const hashUnit: (input: string) => number;
167
+ /**
168
+ * FNV-1a with murmur3's finalizer, mapped to [0, 1): ids that differ only at the end ("user-1", "user-2") still spread
169
+ * evenly, so a 30 % rollout reaches about 30 % of people. Flags only; experiments keep `hashUnit` so nobody switches.
170
+ */
171
+ export declare const flagUnit: (input: string) => number;
80
172
  /** The variant a visitor sees: a shipped winner, control while the experiment does not run, else a stable bucket by visitor. */
81
173
  export declare const assign: (experiment: ExperimentConfig, distinctId: string) => VariantId;
82
174
  /** `"a:b,c:d"` → `{ a: "b", c: "d" }`. Ignores anything malformed. */