@mrrocket/sdk 0.0.0-stage → 0.2.0

package/dist/proxy.d.ts

@@ -0,0 +1,28 @@
+/** What `request.cookies` (Next's `RequestCookies`) offers: read, and set so that the page of this request sees the id. */
+interface IncomingCookies {
+    get(name: string): {
+        value: string;
+    } | undefined;
+    set(name: string, value: string): unknown;
+}
+/** What `response.cookies` (Next's `ResponseCookies`) offers: set with options. */
+interface OutgoingCookies {
+    set(name: string, value: string, options?: {
+        path?: string;
+        maxAge?: number;
+        sameSite?: "lax" | "strict" | "none";
+    }): unknown;
+}
+/**
+ * For `proxy.ts`: gives a first-time visitor their `ck_id` before the page renders, so the server already assigns
+ * the variant they will keep. It writes a cookie, so only use it with `consent="cookies"` and only once the visitor
+ * agreed; in the default cookieless mode leave it out.
+ *
+ *   export function proxy(request: NextRequest) {
+ *       const response = NextResponse.next();
+ *       withCockpitId(request.cookies, response.cookies);
+ *       return response;
+ *   }
+ */
+export declare const withCockpitId: (incoming: IncomingCookies, outgoing: OutgoingCookies) => void;
+export {};

package/dist/proxy.js

@@ -0,0 +1,12 @@
+// src/proxy.ts
+import { ID_COOKIE, newDistinctId } from "./core.js";
+var withCockpitId = (incoming, outgoing) => {
+  if (incoming.get(ID_COOKIE)) return;
+  const id = newDistinctId();
+  incoming.set(ID_COOKIE, id);
+  outgoing.set(ID_COOKIE, id, { path: "/", maxAge: 60 * 60 * 24 * 365, sameSite: "lax" });
+};
+export {
+  withCockpitId
+};
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/proxy.ts"],"sourcesContent":["import { ID_COOKIE, newDistinctId } from \"./core\";\n\n/** What `request.cookies` (Next's `RequestCookies`) offers: read, and set so that the page of this request sees the id. */\ninterface IncomingCookies {\n    get(name: string): { value: string } | undefined;\n    set(name: string, value: string): unknown;\n}\n\n/** What `response.cookies` (Next's `ResponseCookies`) offers: set with options. */\ninterface OutgoingCookies {\n    set(name: string, value: string, options?: { path?: string; maxAge?: number; sameSite?: \"lax\" | \"strict\" | \"none\" }): unknown;\n}\n\n/**\n * For `proxy.ts`: gives a first-time visitor their `ck_id` before the page renders, so the server already assigns\n * the variant they will keep. It writes a cookie, so only use it with `consent=\"cookies\"` and only once the visitor\n * agreed; in the default cookieless mode leave it out.\n *\n *   export function proxy(request: NextRequest) {\n *       const response = NextResponse.next();\n *       withCockpitId(request.cookies, response.cookies);\n *       return response;\n *   }\n */\nexport const withCockpitId = (incoming: IncomingCookies, outgoing: OutgoingCookies) => {\n    if (incoming.get(ID_COOKIE)) return;\n    const id = newDistinctId();\n    incoming.set(ID_COOKIE, id);\n    outgoing.set(ID_COOKIE, id, { path: \"/\", maxAge: 60 * 60 * 24 * 365, sameSite: \"lax\" });\n};\n"],"mappings":";AAAA,SAAS,WAAW,qBAAqB;AAwBlC,IAAM,gBAAgB,CAAC,UAA2B,aAA8B;AACnF,MAAI,SAAS,IAAI,SAAS,EAAG;AAC7B,QAAM,KAAK,cAAc;AACzB,WAAS,IAAI,WAAW,EAAE;AAC1B,WAAS,IAAI,WAAW,IAAI,EAAE,MAAM,KAAK,QAAQ,KAAK,KAAK,KAAK,KAAK,UAAU,MAAM,CAAC;AAC1F;","names":[]}

package/dist/referral.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Affiliate referrals, after Rewardful's and Dub's client scripts. A partner's tracked link (`<mrrocket>/r/<code>`)
+ * counts the click on MRRocket and sends the visitor to your site with `?mrr_ref=<code>&mrr_click=<clickId>`; a direct
+ * link is `https://your.site/?ref=<code>`. The provider reads either on page load, keeps the referral for the program's
+ * cookie days in a FIRST-PARTY cookie on your domain (`mrr_ref`) plus localStorage, and sends a click beacon for direct
+ * links. MRRocket never sets a cookie for you: its domain is not yours.
+ *
+ * Storage follows consent (see the README): with `attribution="consent"` (default) the referral is only stored when
+ * the provider's consent is "cookies"; otherwise it lives in memory for the page load. `attribution="always"` stores
+ * it whatever the consent (your legal call), `"off"` ignores referrals.
+ *
+ * Plain functions, no React: `getReferral()` and `referralForCheckout()` work in any client code, and on the server
+ * with the cookie's value (`readReferralCookie`).
+ */
+export interface Referral {
+    /** The partner's code. */
+    code: string;
+    /** The click MRRocket counted (tracked link or beacon); null when it was not counted. */
+    clickId: string | null;
+    /** When the visitor arrived through the partner, ms. */
+    at: number;
+}
+/** What to pass to Stripe Checkout (`stripe.checkout.sessions.create({ ..., ...referralForCheckout() })`). */
+export interface CheckoutReferral {
+    client_reference_id: string;
+    metadata: {
+        mrr_ref: string;
+        mrr_click: string;
+    };
+}
+export type AttributionMode = "consent" | "always" | "off";
+export declare const REFERRAL_COOKIE = "mrr_ref";
+export declare const REFERRAL_STORAGE_KEY = "mrr_ref";
+export declare const REF_PARAM = "mrr_ref";
+export declare const CLICK_PARAM = "mrr_click";
+export declare const DEFAULT_REFERRAL_DAYS = 60;
+/** The referral in the landing URL: the tracked link's markers first, else the direct-link parameter (`ref`). */
+export declare const readReferralParams: (search: string, param?: string) => {
+    code: string;
+    clickId: string | null;
+    direct: boolean;
+} | null;
+/** `code.clickId.at`: dots never occur in a code or a click id. */
+export declare const encodeReferral: (r: Referral) => string;
+/** A stored referral, or null when it is malformed or older than `maxDays`. */
+export declare const decodeReferral: (value: string | null | undefined, maxDays?: number, now?: number) => Referral | null;
+/** The referral for a Stripe Checkout Session: `client_reference_id` and `metadata`. Null without a referral. */
+export declare const referralForCheckout: (r?: Referral | null) => CheckoutReferral | null;
+/**
+ * A Stripe Payment Link (or Pricing Table URL) with the referral as `client_reference_id`. Payment Links only accept
+ * letters, digits, `-` and `_` there, so the form is `mrr_ref__<code>__<clickId>`. Without a referral the URL is unchanged.
+ */
+export declare const referralLink: (url: string, r?: Referral | null) => string;
+/** The visitor's referral: this page load's, else the stored one. Null on the server (use `readReferralCookie` there). */
+export declare const getReferral: () => Referral | null;
+/** The referral from the `mrr_ref` cookie's value, for server code (a route that creates the Checkout Session). */
+export declare const readReferralCookie: (value: string | null | undefined) => Referral | null;
+/** Writes the referral to the first-party cookie and localStorage for `days`. */
+export declare const storeReferral: (r: Referral, days: number) => void;
+/** Deletes what was stored (consent withdrawn); the referral of this page load stays in memory. */
+export declare const forgetStoredReferral: () => void;
+/** For tests and `consent="off"`: forget the page load's referral too. */
+export declare const resetReferral: () => void;
+export interface CaptureOptions {
+    /** `location.search` of the landing page. */
+    search: string;
+    /** The direct-link parameter, default `ref`. */
+    param?: string;
+    /** May the referral be stored (consent)? */
+    store: boolean;
+    /** Days to keep it. */
+    days: number;
+    /** Sends the click beacon; answers the click id MRRocket counted (or confirmed). */
+    beacon?: (body: {
+        code: string;
+        clickId: string | null;
+    }) => Promise<string | null>;
+    now?: number;
+}
+/**
+ * Reads the referral of a page load: a new one from the URL (sent to the beacon and stored when allowed) or the stored
+ * one. A new link replaces an older referral (last click within the window wins). Returns the referral in effect.
+ */
+export declare const captureReferral: (o: CaptureOptions) => Promise<Referral | null>;
+/** Events that carry the referral: identify, signup and your own events (not page views or exposures). */
+export declare const carriesReferral: (event: string) => boolean;

package/dist/referral.js

@@ -0,0 +1,128 @@
+// src/referral.ts
+var REFERRAL_COOKIE = "mrr_ref";
+var REFERRAL_STORAGE_KEY = "mrr_ref";
+var REF_PARAM = "mrr_ref";
+var CLICK_PARAM = "mrr_click";
+var DEFAULT_REFERRAL_DAYS = 60;
+var CODE = /^[A-Za-z0-9_-]{1,64}$/;
+var DAY_MS = 864e5;
+var readReferralParams = (search, param = "ref") => {
+  const q = new URLSearchParams(search);
+  const marked = q.get(REF_PARAM);
+  if (marked && CODE.test(marked)) {
+    const click = q.get(CLICK_PARAM);
+    return { code: marked, clickId: click && CODE.test(click) ? click : null, direct: false };
+  }
+  const direct = q.get(param);
+  return direct && CODE.test(direct) ? { code: direct, clickId: null, direct: true } : null;
+};
+var encodeReferral = (r) => `${r.code}.${r.clickId ?? ""}.${r.at}`;
+var decodeReferral = (value, maxDays = DEFAULT_REFERRAL_DAYS, now = Date.now()) => {
+  if (!value) return null;
+  const [code, click, at] = value.split(".");
+  const t = Number(at);
+  if (!code || !CODE.test(code) || !Number.isFinite(t) || click && !CODE.test(click)) return null;
+  if (now - t > maxDays * DAY_MS || t > now + DAY_MS) return null;
+  return { code, clickId: click || null, at: t };
+};
+var referralForCheckout = (r = getReferral()) => r ? { client_reference_id: `mrr_ref:${r.code}:${r.clickId ?? ""}`, metadata: { mrr_ref: r.code, mrr_click: r.clickId ?? "" } } : null;
+var referralLink = (url, r = getReferral()) => {
+  if (!r) return url;
+  try {
+    const u = new URL(url);
+    u.searchParams.set("client_reference_id", `mrr_ref__${r.code}__${r.clickId ?? ""}`);
+    return u.toString();
+  } catch {
+    return url;
+  }
+};
+var current = null;
+var hasDocument = () => typeof document !== "undefined";
+var readCookie = (name) => {
+  if (!hasDocument()) return void 0;
+  const raw = document.cookie.split("; ").find((c) => c.startsWith(`${name}=`))?.slice(name.length + 1);
+  try {
+    return raw ? decodeURIComponent(raw) : void 0;
+  } catch {
+    return raw;
+  }
+};
+var storage = () => {
+  try {
+    return typeof localStorage === "undefined" ? null : localStorage;
+  } catch {
+    return null;
+  }
+};
+var getReferral = () => {
+  if (current) return current;
+  if (!hasDocument()) return null;
+  return decodeReferral(readCookie(REFERRAL_COOKIE), 3650) ?? decodeReferral(storage()?.getItem(REFERRAL_STORAGE_KEY), 3650);
+};
+var readReferralCookie = (value) => decodeReferral(value, 3650);
+var storeReferral = (r, days) => {
+  if (!hasDocument()) return;
+  const maxAge = Math.max(1, Math.round(days)) * 86400;
+  const secure = typeof location !== "undefined" && location.protocol === "https:" ? "; secure" : "";
+  document.cookie = `${REFERRAL_COOKIE}=${encodeURIComponent(encodeReferral(r))}; path=/; max-age=${maxAge}; samesite=lax${secure}`;
+  try {
+    storage()?.setItem(REFERRAL_STORAGE_KEY, encodeReferral(r));
+  } catch {
+  }
+};
+var forgetStoredReferral = () => {
+  if (!hasDocument()) return;
+  document.cookie = `${REFERRAL_COOKIE}=; path=/; max-age=0; samesite=lax`;
+  try {
+    storage()?.removeItem(REFERRAL_STORAGE_KEY);
+  } catch {
+  }
+};
+var resetReferral = () => {
+  current = null;
+};
+var captureReferral = async (o) => {
+  const found = readReferralParams(o.search, o.param);
+  const now = o.now ?? Date.now();
+  if (!found) {
+    if (!current && o.store) {
+      current = decodeReferral(readCookie(REFERRAL_COOKIE), o.days, now) ?? decodeReferral(storage()?.getItem(REFERRAL_STORAGE_KEY), o.days, now);
+      if (!current) forgetStoredReferral();
+    }
+    return current;
+  }
+  current = { code: found.code, clickId: found.clickId, at: now };
+  if (o.store) storeReferral(current, o.days);
+  if (o.beacon) {
+    try {
+      const id = await o.beacon({ code: found.code, clickId: found.clickId });
+      if (id && current && current.code === found.code && !current.clickId) {
+        current = { ...current, clickId: id };
+        if (o.store) storeReferral(current, o.days);
+      }
+    } catch {
+    }
+  }
+  return current;
+};
+var carriesReferral = (event) => event === "$identify" || !event.startsWith("$");
+export {
+  CLICK_PARAM,
+  DEFAULT_REFERRAL_DAYS,
+  REFERRAL_COOKIE,
+  REFERRAL_STORAGE_KEY,
+  REF_PARAM,
+  captureReferral,
+  carriesReferral,
+  decodeReferral,
+  encodeReferral,
+  forgetStoredReferral,
+  getReferral,
+  readReferralCookie,
+  readReferralParams,
+  referralForCheckout,
+  referralLink,
+  resetReferral,
+  storeReferral
+};
+//# sourceMappingURL=referral.js.map

package/dist/referral.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/referral.ts"],"sourcesContent":["/**\n * Affiliate referrals, after Rewardful's and Dub's client scripts. A partner's tracked link (`<mrrocket>/r/<code>`)\n * counts the click on MRRocket and sends the visitor to your site with `?mrr_ref=<code>&mrr_click=<clickId>`; a direct\n * link is `https://your.site/?ref=<code>`. The provider reads either on page load, keeps the referral for the program's\n * cookie days in a FIRST-PARTY cookie on your domain (`mrr_ref`) plus localStorage, and sends a click beacon for direct\n * links. MRRocket never sets a cookie for you: its domain is not yours.\n *\n * Storage follows consent (see the README): with `attribution=\"consent\"` (default) the referral is only stored when\n * the provider's consent is \"cookies\"; otherwise it lives in memory for the page load. `attribution=\"always\"` stores\n * it whatever the consent (your legal call), `\"off\"` ignores referrals.\n *\n * Plain functions, no React: `getReferral()` and `referralForCheckout()` work in any client code, and on the server\n * with the cookie's value (`readReferralCookie`).\n */\n\nexport interface Referral {\n    /** The partner's code. */\n    code: string;\n    /** The click MRRocket counted (tracked link or beacon); null when it was not counted. */\n    clickId: string | null;\n    /** When the visitor arrived through the partner, ms. */\n    at: number;\n}\n\n/** What to pass to Stripe Checkout (`stripe.checkout.sessions.create({ ..., ...referralForCheckout() })`). */\nexport interface CheckoutReferral {\n    client_reference_id: string;\n    metadata: { mrr_ref: string; mrr_click: string };\n}\n\nexport type AttributionMode = \"consent\" | \"always\" | \"off\";\n\nexport const REFERRAL_COOKIE = \"mrr_ref\";\nexport const REFERRAL_STORAGE_KEY = \"mrr_ref\";\nexport const REF_PARAM = \"mrr_ref\";\nexport const CLICK_PARAM = \"mrr_click\";\nexport const DEFAULT_REFERRAL_DAYS = 60;\n\nconst CODE = /^[A-Za-z0-9_-]{1,64}$/;\nconst DAY_MS = 86_400_000;\n\n/** The referral in the landing URL: the tracked link's markers first, else the direct-link parameter (`ref`). */\nexport const readReferralParams = (search: string, param = \"ref\"): { code: string; clickId: string | null; direct: boolean } | null => {\n    const q = new URLSearchParams(search);\n    const marked = q.get(REF_PARAM);\n    if (marked && CODE.test(marked)) {\n        const click = q.get(CLICK_PARAM);\n        return { code: marked, clickId: click && CODE.test(click) ? click : null, direct: false };\n    }\n    const direct = q.get(param);\n    return direct && CODE.test(direct) ? { code: direct, clickId: null, direct: true } : null;\n};\n\n/** `code.clickId.at`: dots never occur in a code or a click id. */\nexport const encodeReferral = (r: Referral) => `${r.code}.${r.clickId ?? \"\"}.${r.at}`;\n\n/** A stored referral, or null when it is malformed or older than `maxDays`. */\nexport const decodeReferral = (value: string | null | undefined, maxDays = DEFAULT_REFERRAL_DAYS, now = Date.now()): Referral | null => {\n    if (!value) return null;\n    const [code, click, at] = value.split(\".\");\n    const t = Number(at);\n    if (!code || !CODE.test(code) || !Number.isFinite(t) || (click && !CODE.test(click))) return null;\n    if (now - t > maxDays * DAY_MS || t > now + DAY_MS) return null;\n    return { code, clickId: click || null, at: t };\n};\n\n/** The referral for a Stripe Checkout Session: `client_reference_id` and `metadata`. Null without a referral. */\nexport const referralForCheckout = (r: Referral | null = getReferral()): CheckoutReferral | null =>\n    r ? { client_reference_id: `mrr_ref:${r.code}:${r.clickId ?? \"\"}`, metadata: { mrr_ref: r.code, mrr_click: r.clickId ?? \"\" } } : null;\n\n/**\n * A Stripe Payment Link (or Pricing Table URL) with the referral as `client_reference_id`. Payment Links only accept\n * letters, digits, `-` and `_` there, so the form is `mrr_ref__<code>__<clickId>`. Without a referral the URL is unchanged.\n */\nexport const referralLink = (url: string, r: Referral | null = getReferral()) => {\n    if (!r) return url;\n    try {\n        const u = new URL(url);\n        u.searchParams.set(\"client_reference_id\", `mrr_ref__${r.code}__${r.clickId ?? \"\"}`);\n        return u.toString();\n    } catch {\n        return url;\n    }\n};\n\n// ---------- The browser side ----------\n\nlet current: Referral | null = null;\n\nconst hasDocument = () => typeof document !== \"undefined\";\n\nconst readCookie = (name: string) => {\n    if (!hasDocument()) return undefined;\n    const raw = document.cookie\n        .split(\"; \")\n        .find((c) => c.startsWith(`${name}=`))\n        ?.slice(name.length + 1);\n    try {\n        return raw ? decodeURIComponent(raw) : undefined;\n    } catch {\n        return raw;\n    }\n};\n\nconst storage = () => {\n    try {\n        return typeof localStorage === \"undefined\" ? null : localStorage;\n    } catch {\n        return null;\n    }\n};\n\n/** The visitor's referral: this page load's, else the stored one. Null on the server (use `readReferralCookie` there). */\nexport const getReferral = (): Referral | null => {\n    if (current) return current;\n    if (!hasDocument()) return null;\n    return decodeReferral(readCookie(REFERRAL_COOKIE), 3650) ?? decodeReferral(storage()?.getItem(REFERRAL_STORAGE_KEY), 3650);\n};\n\n/** The referral from the `mrr_ref` cookie's value, for server code (a route that creates the Checkout Session). */\nexport const readReferralCookie = (value: string | null | undefined) => decodeReferral(value, 3650);\n\n/** Writes the referral to the first-party cookie and localStorage for `days`. */\nexport const storeReferral = (r: Referral, days: number) => {\n    if (!hasDocument()) return;\n    const maxAge = Math.max(1, Math.round(days)) * 86_400;\n    const secure = typeof location !== \"undefined\" && location.protocol === \"https:\" ? \"; secure\" : \"\";\n    document.cookie = `${REFERRAL_COOKIE}=${encodeURIComponent(encodeReferral(r))}; path=/; max-age=${maxAge}; samesite=lax${secure}`;\n    try {\n        storage()?.setItem(REFERRAL_STORAGE_KEY, encodeReferral(r));\n    } catch {\n        // Storage full or blocked: the cookie is enough.\n    }\n};\n\n/** Deletes what was stored (consent withdrawn); the referral of this page load stays in memory. */\nexport const forgetStoredReferral = () => {\n    if (!hasDocument()) return;\n    document.cookie = `${REFERRAL_COOKIE}=; path=/; max-age=0; samesite=lax`;\n    try {\n        storage()?.removeItem(REFERRAL_STORAGE_KEY);\n    } catch {\n        // Nothing stored.\n    }\n};\n\n/** For tests and `consent=\"off\"`: forget the page load's referral too. */\nexport const resetReferral = () => {\n    current = null;\n};\n\nexport interface CaptureOptions {\n    /** `location.search` of the landing page. */\n    search: string;\n    /** The direct-link parameter, default `ref`. */\n    param?: string;\n    /** May the referral be stored (consent)? */\n    store: boolean;\n    /** Days to keep it. */\n    days: number;\n    /** Sends the click beacon; answers the click id MRRocket counted (or confirmed). */\n    beacon?: (body: { code: string; clickId: string | null }) => Promise<string | null>;\n    now?: number;\n}\n\n/**\n * Reads the referral of a page load: a new one from the URL (sent to the beacon and stored when allowed) or the stored\n * one. A new link replaces an older referral (last click within the window wins). Returns the referral in effect.\n */\nexport const captureReferral = async (o: CaptureOptions): Promise<Referral | null> => {\n    const found = readReferralParams(o.search, o.param);\n    const now = o.now ?? Date.now();\n    if (!found) {\n        if (!current && o.store) {\n            current = decodeReferral(readCookie(REFERRAL_COOKIE), o.days, now) ?? decodeReferral(storage()?.getItem(REFERRAL_STORAGE_KEY), o.days, now);\n            if (!current) forgetStoredReferral();\n        }\n        return current;\n    }\n    current = { code: found.code, clickId: found.clickId, at: now };\n    if (o.store) storeReferral(current, o.days);\n    if (o.beacon) {\n        try {\n            const id = await o.beacon({ code: found.code, clickId: found.clickId });\n            if (id && current && current.code === found.code && !current.clickId) {\n                current = { ...current, clickId: id };\n                if (o.store) storeReferral(current, o.days);\n            }\n        } catch {\n            // The referral still counts for checkout without a click id.\n        }\n    }\n    return current;\n};\n\n/** Events that carry the referral: identify, signup and your own events (not page views or exposures). */\nexport const carriesReferral = (event: string) => event === \"$identify\" || !event.startsWith(\"$\");\n"],"mappings":"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","names":[]}

package/dist/replay-core.d.ts

@@ -0,0 +1,93 @@
+export declare const DEFAULT_SAMPLE_RATE = 0.1;
+/** A recording stops after 30 minutes. */
+export declare const MAX_RECORDING_MS: number;
+/** A visit outside the sample keeps about this much in memory, from the last full snapshot on. */
+export declare const BUFFER_MS: number;
+/** How often a buffering visit takes a new full snapshot, so the buffer can drop what is older. */
+export declare const CHECKOUT_MS: number;
+/** Upload a chunk every 5 seconds or once it holds about 64 KB of events, whichever comes first. */
+export declare const FLUSH_MS: number;
+export declare const FLUSH_BYTES: number;
+/** The buffer never holds more than this; the oldest snapshot goes first. */
+export declare const BUFFER_MAX_BYTES: number;
+/** The server takes at most 1 MB per request; a chunk that would not fit ends the recording. */
+export declare const MAX_REQUEST_BYTES: number;
+/** Why a recording was uploaded. */
+export type ReplayTrigger = "sample" | "error" | "rage" | "purchase" | "checkout";
+/** Never recorded: password, hidden and card fields, payment iframes, and whatever the site marks `data-ck-block`. */
+export declare const BLOCK_SELECTOR: string;
+export declare const MASK_TEXT_SELECTOR = "[data-ck-mask]";
+/** Whether this session uploads from its start. Stable per session id, so every page of a session agrees. */
+export declare const inSample: (sessionId: string, rate: number) => boolean;
+/** A tracked event that uploads the buffered minute: names starting with `purchase` or `checkout`. */
+export declare const triggerOfEvent: (event: string) => "purchase" | "checkout" | null;
+/** Typed text never reaches MRRocket: every input value becomes stars, at most 12. */
+export declare const maskInput: (text: string) => string;
+/**
+ * rrweb's record options: all inputs masked, blocked fields left out, text in `data-ck-mask` masked, no canvas, video,
+ * fonts or inlined images, scripts and head clutter dropped. `emit` receives the events.
+ */
+export declare const recordOptions: <E>(emit: (e: E) => void) => {
+    emit: (e: E) => void;
+    maskAllInputs: boolean;
+    maskInputOptions: {
+        color: boolean;
+        date: boolean;
+        "datetime-local": boolean;
+        email: boolean;
+        month: boolean;
+        number: boolean;
+        range: boolean;
+        search: boolean;
+        tel: boolean;
+        text: boolean;
+        time: boolean;
+        url: boolean;
+        week: boolean;
+        textarea: boolean;
+        select: boolean;
+        password: boolean;
+    };
+    maskInputFn: (text: string) => string;
+    maskTextSelector: string;
+    blockSelector: string;
+    recordCanvas: boolean;
+    recordCrossOriginIframes: boolean;
+    collectFonts: boolean;
+    inlineImages: boolean;
+    slimDOMOptions: "all";
+    sampling: {
+        mousemove: number;
+        scroll: number;
+        media: number;
+        input: "last";
+    };
+};
+/** The few rrweb fields this module reads. Type 4 is the Meta event that starts each full snapshot. */
+export interface ReplayEvent {
+    type: number;
+    timestamp: number;
+}
+/**
+ * The last minute of a visit that is not uploaded (yet). Events are kept in segments that each start at a full
+ * snapshot; a segment is dropped once the next one already covers the whole window, so whatever is drained starts
+ * with a full snapshot and holds at least the last `windowMs`.
+ */
+export declare class RingBuffer<E extends ReplayEvent = ReplayEvent> {
+    private readonly windowMs;
+    private readonly maxBytes;
+    private segments;
+    constructor(windowMs?: number, maxBytes?: number);
+    push(e: E, bytes: number): void;
+    get bytes(): number;
+    get size(): number;
+    /** The oldest event kept, or null when empty. */
+    get first(): number;
+    /** Everything kept, oldest first, and empties the buffer. */
+    drain(): E[];
+    clear(): void;
+}
+/** Whether a chunk is due: enough bytes, or enough time since the last upload. */
+export declare const chunkDue: (bytes: number, sinceFlushMs: number) => boolean;
+/** Base64 of bytes, in slices so a large chunk does not overflow the call stack. */
+export declare const toBase64: (bytes: Uint8Array) => string;

package/dist/replay-core.js

@@ -0,0 +1,122 @@
+// src/replay-core.ts
+import { BLOCK_ATTR_SELECTOR, MASK_SELECTOR } from "./capture.js";
+import { hashUnit } from "./core.js";
+var DEFAULT_SAMPLE_RATE = 0.1;
+var MAX_RECORDING_MS = 30 * 60 * 1e3;
+var BUFFER_MS = 60 * 1e3;
+var CHECKOUT_MS = 30 * 1e3;
+var FLUSH_MS = 5 * 1e3;
+var FLUSH_BYTES = 64 * 1024;
+var BUFFER_MAX_BYTES = 4 * 1024 * 1024;
+var MAX_REQUEST_BYTES = 1024 * 1024;
+var BLOCK_SELECTOR = [
+  BLOCK_ATTR_SELECTOR,
+  'input[type="password"]',
+  'input[type="hidden"]',
+  '[autocomplete^="cc-"]',
+  'input[name*="card" i]',
+  'input[name*="cvc" i]',
+  'input[name*="cvv" i]',
+  'iframe[src*="js.stripe.com"]',
+  'iframe[src*="paypal.com"]'
+].join(",");
+var MASK_TEXT_SELECTOR = MASK_SELECTOR;
+var inSample = (sessionId, rate) => hashUnit(`replay:${sessionId}`) < Math.min(1, Math.max(0, rate));
+var triggerOfEvent = (event) => {
+  const e = event.toLowerCase().replace(/^\$/, "");
+  return e.startsWith("purchase") ? "purchase" : e.startsWith("checkout") ? "checkout" : null;
+};
+var maskInput = (text) => "*".repeat(Math.min(12, text.length));
+var recordOptions = (emit) => ({
+  emit,
+  maskAllInputs: true,
+  maskInputOptions: {
+    color: true,
+    date: true,
+    "datetime-local": true,
+    email: true,
+    month: true,
+    number: true,
+    range: true,
+    search: true,
+    tel: true,
+    text: true,
+    time: true,
+    url: true,
+    week: true,
+    textarea: true,
+    select: true,
+    password: true
+  },
+  maskInputFn: maskInput,
+  maskTextSelector: MASK_TEXT_SELECTOR,
+  blockSelector: BLOCK_SELECTOR,
+  recordCanvas: false,
+  recordCrossOriginIframes: false,
+  collectFonts: false,
+  inlineImages: false,
+  slimDOMOptions: "all",
+  sampling: { mousemove: 50, scroll: 150, media: 800, input: "last" }
+});
+var RingBuffer = class {
+  constructor(windowMs = BUFFER_MS, maxBytes = BUFFER_MAX_BYTES) {
+    this.windowMs = windowMs;
+    this.maxBytes = maxBytes;
+  }
+  windowMs;
+  maxBytes;
+  segments = [];
+  push(e, bytes) {
+    if (e.type === 4 || !this.segments.length) this.segments.push({ events: [], bytes: 0 });
+    const seg = this.segments[this.segments.length - 1];
+    seg.events.push(e);
+    seg.bytes += bytes;
+    const from = e.timestamp - this.windowMs;
+    while (this.segments.length > 1 && (this.segments[1].events[0].timestamp <= from || this.bytes > this.maxBytes)) this.segments.shift();
+  }
+  get bytes() {
+    return this.segments.reduce((s, x) => s + x.bytes, 0);
+  }
+  get size() {
+    return this.segments.reduce((s, x) => s + x.events.length, 0);
+  }
+  /** The oldest event kept, or null when empty. */
+  get first() {
+    return this.segments[0]?.events[0]?.timestamp ?? null;
+  }
+  /** Everything kept, oldest first, and empties the buffer. */
+  drain() {
+    const out = this.segments.flatMap((s) => s.events);
+    this.segments = [];
+    return out;
+  }
+  clear() {
+    this.segments = [];
+  }
+};
+var chunkDue = (bytes, sinceFlushMs) => bytes >= FLUSH_BYTES || bytes > 0 && sinceFlushMs >= FLUSH_MS;
+var toBase64 = (bytes) => {
+  let s = "";
+  for (let i = 0; i < bytes.length; i += 32768) s += String.fromCharCode(...bytes.subarray(i, i + 32768));
+  return btoa(s);
+};
+export {
+  BLOCK_SELECTOR,
+  BUFFER_MAX_BYTES,
+  BUFFER_MS,
+  CHECKOUT_MS,
+  DEFAULT_SAMPLE_RATE,
+  FLUSH_BYTES,
+  FLUSH_MS,
+  MASK_TEXT_SELECTOR,
+  MAX_RECORDING_MS,
+  MAX_REQUEST_BYTES,
+  RingBuffer,
+  chunkDue,
+  inSample,
+  maskInput,
+  recordOptions,
+  toBase64,
+  triggerOfEvent
+};
+//# sourceMappingURL=replay-core.js.map

package/dist/replay-core.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/replay-core.ts"],"sourcesContent":["/**\n * The rules of session recording, without the browser: which visits upload from the start, what a trigger is, how the\n * last minute is kept in memory, how events become upload chunks, and the privacy defaults handed to rrweb. The\n * recorder itself (./replay.ts) is loaded only when a visit records; this file is shared with MRRocket's own checks.\n */\nimport { BLOCK_ATTR_SELECTOR, MASK_SELECTOR } from \"./capture\";\nimport { hashUnit } from \"./core\";\n\nexport const DEFAULT_SAMPLE_RATE = 0.1;\n/** A recording stops after 30 minutes. */\nexport const MAX_RECORDING_MS = 30 * 60 * 1000;\n/** A visit outside the sample keeps about this much in memory, from the last full snapshot on. */\nexport const BUFFER_MS = 60 * 1000;\n/** How often a buffering visit takes a new full snapshot, so the buffer can drop what is older. */\nexport const CHECKOUT_MS = 30 * 1000;\n/** Upload a chunk every 5 seconds or once it holds about 64 KB of events, whichever comes first. */\nexport const FLUSH_MS = 5 * 1000;\nexport const FLUSH_BYTES = 64 * 1024;\n/** The buffer never holds more than this; the oldest snapshot goes first. */\nexport const BUFFER_MAX_BYTES = 4 * 1024 * 1024;\n/** The server takes at most 1 MB per request; a chunk that would not fit ends the recording. */\nexport const MAX_REQUEST_BYTES = 1024 * 1024;\n\n/** Why a recording was uploaded. */\nexport type ReplayTrigger = \"sample\" | \"error\" | \"rage\" | \"purchase\" | \"checkout\";\n\n/** Never recorded: password, hidden and card fields, payment iframes, and whatever the site marks `data-ck-block`. */\nexport const BLOCK_SELECTOR = [\n    BLOCK_ATTR_SELECTOR,\n    'input[type=\"password\"]',\n    'input[type=\"hidden\"]',\n    '[autocomplete^=\"cc-\"]',\n    'input[name*=\"card\" i]',\n    'input[name*=\"cvc\" i]',\n    'input[name*=\"cvv\" i]',\n    'iframe[src*=\"js.stripe.com\"]',\n    'iframe[src*=\"paypal.com\"]',\n].join(\",\");\nexport const MASK_TEXT_SELECTOR = MASK_SELECTOR;\n\n/** Whether this session uploads from its start. Stable per session id, so every page of a session agrees. */\nexport const inSample = (sessionId: string, rate: number) => hashUnit(`replay:${sessionId}`) < Math.min(1, Math.max(0, rate));\n\n/** A tracked event that uploads the buffered minute: names starting with `purchase` or `checkout`. */\nexport const triggerOfEvent = (event: string): \"purchase\" | \"checkout\" | null => {\n    const e = event.toLowerCase().replace(/^\\$/, \"\");\n    return e.startsWith(\"purchase\") ? \"purchase\" : e.startsWith(\"checkout\") ? \"checkout\" : null;\n};\n\n/** Typed text never reaches MRRocket: every input value becomes stars, at most 12. */\nexport const maskInput = (text: string) => \"*\".repeat(Math.min(12, text.length));\n\n/**\n * rrweb's record options: all inputs masked, blocked fields left out, text in `data-ck-mask` masked, no canvas, video,\n * fonts or inlined images, scripts and head clutter dropped. `emit` receives the events.\n */\nexport const recordOptions = <E>(emit: (e: E) => void) => ({\n    emit,\n    maskAllInputs: true,\n    maskInputOptions: {\n        color: true,\n        date: true,\n        \"datetime-local\": true,\n        email: true,\n        month: true,\n        number: true,\n        range: true,\n        search: true,\n        tel: true,\n        text: true,\n        time: true,\n        url: true,\n        week: true,\n        textarea: true,\n        select: true,\n        password: true,\n    },\n    maskInputFn: maskInput,\n    maskTextSelector: MASK_TEXT_SELECTOR,\n    blockSelector: BLOCK_SELECTOR,\n    recordCanvas: false,\n    recordCrossOriginIframes: false,\n    collectFonts: false,\n    inlineImages: false,\n    slimDOMOptions: \"all\" as const,\n    sampling: { mousemove: 50, scroll: 150, media: 800, input: \"last\" as const },\n});\n\n/** The few rrweb fields this module reads. Type 4 is the Meta event that starts each full snapshot. */\nexport interface ReplayEvent {\n    type: number;\n    timestamp: number;\n}\n\n/**\n * The last minute of a visit that is not uploaded (yet). Events are kept in segments that each start at a full\n * snapshot; a segment is dropped once the next one already covers the whole window, so whatever is drained starts\n * with a full snapshot and holds at least the last `windowMs`.\n */\nexport class RingBuffer<E extends ReplayEvent = ReplayEvent> {\n    private segments: { events: E[]; bytes: number }[] = [];\n    constructor(\n        private readonly windowMs = BUFFER_MS,\n        private readonly maxBytes = BUFFER_MAX_BYTES,\n    ) {}\n\n    push(e: E, bytes: number) {\n        if (e.type === 4 || !this.segments.length) this.segments.push({ events: [], bytes: 0 });\n        const seg = this.segments[this.segments.length - 1];\n        seg.events.push(e);\n        seg.bytes += bytes;\n        const from = e.timestamp - this.windowMs;\n        while (this.segments.length > 1 && (this.segments[1].events[0].timestamp <= from || this.bytes > this.maxBytes)) this.segments.shift();\n    }\n\n    get bytes() {\n        return this.segments.reduce((s, x) => s + x.bytes, 0);\n    }\n\n    get size() {\n        return this.segments.reduce((s, x) => s + x.events.length, 0);\n    }\n\n    /** The oldest event kept, or null when empty. */\n    get first() {\n        return this.segments[0]?.events[0]?.timestamp ?? null;\n    }\n\n    /** Everything kept, oldest first, and empties the buffer. */\n    drain(): E[] {\n        const out = this.segments.flatMap((s) => s.events);\n        this.segments = [];\n        return out;\n    }\n\n    clear() {\n        this.segments = [];\n    }\n}\n\n/** Whether a chunk is due: enough bytes, or enough time since the last upload. */\nexport const chunkDue = (bytes: number, sinceFlushMs: number) => bytes >= FLUSH_BYTES || (bytes > 0 && sinceFlushMs >= FLUSH_MS);\n\n/** Base64 of bytes, in slices so a large chunk does not overflow the call stack. */\nexport const toBase64 = (bytes: Uint8Array) => {\n    let s = \"\";\n    for (let i = 0; i < bytes.length; i += 0x8000) s += String.fromCharCode(...bytes.subarray(i, i + 0x8000));\n    return btoa(s);\n};\n"],"mappings":"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","names":[]}

package/dist/replay.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The session recorder. The provider imports this file (and rrweb's recorder with it) only when a visit records: the
+ * product has recordings on and the visitor gave replay consent. Pages without recording never load it.
+ *
+ * A visit in the product's sample uploads from its start. Any other visit keeps the last minute in memory and uploads
+ * it only when something happens worth watching: a JS error, a rage click, or a `purchase…` / `checkout…` event; from
+ * then on it uploads like a sampled one. Chunks go every 5 seconds or 64 KB, gzip'd where the browser can, to
+ * `POST {host}/api/sdk/replay`; the last one leaves with sendBeacon when the page hides. A recording ends after 30
+ * minutes. Withdrawing consent stops it and drops what was not sent.
+ */
+import type { ClickInfo } from "./capture.js";
+export interface ReplayOptions {
+    host: string;
+    apiKey: string;
+    /** The SDK's session id; every chunk carries it, so the recording joins the session's events. */
+    sessionId: string;
+    /** The identify() id or the cookie id; missing cookieless until identify(). */
+    distinctId?: string;
+    /** Whether `distinctId` comes from identify() (a person) rather than the visitor cookie. */
+    identified?: boolean;
+    sampleRate: number;
+    warn: (message: string) => void;
+}
+export interface ReplayHandle {
+    /** A tracked event; `purchase…` and `checkout…` upload the buffered minute. */
+    event(name: string): void;
+    click(c: ClickInfo, rage: boolean): void;
+    /** A client-side navigation. */
+    page(path: string): void;
+    identify(id: string): void;
+    /** Stops recording. `discard` (consent withdrawn) drops everything not sent yet. */
+    stop(discard?: boolean): void;
+}
+export declare const startReplay: (o: ReplayOptions) => Promise<ReplayHandle | null>;