@mrrocket/sdk 0.18.0 → 0.22.0

package/dist/messenger.d.ts

@@ -24,6 +24,8 @@ export interface MessengerProps {
     launcher?: boolean;
     /** The Help tab with your published help articles (default true; hidden while there are none). */
     help?: boolean;
+    /** The Updates tab with your published changelog (default true; hidden while there are none). */
+    updates?: boolean;
     /** A short sound when an answer arrives (default true). */
     sound?: boolean;
     /** A preview of a new answer above the closed launcher (default true). */
@@ -42,4 +44,4 @@ export interface MessengerProps {
  *
  *     <Messenger title="Acme" greeting="Hi! How can we help?" />
  */
-export declare const Messenger: ({ position, title, greeting, askEmail, label, launcher, help, sound, preview, theme, accent, corners, font, header }: MessengerProps) => null;
+export declare const Messenger: ({ position, title, greeting, askEmail, label, launcher, help, updates, sound, preview, theme, accent, corners, font, header }: MessengerProps) => null;

package/dist/messenger.js

@@ -14,7 +14,7 @@ var useMessenger = () => ({
   close: () => handle?.close(),
   toggle: () => withHandle((h) => h.toggle())
 });
-var Messenger = ({ position, title, greeting, askEmail, label, launcher, help, sound, preview, theme, accent, corners, font, header }) => {
+var Messenger = ({ position, title, greeting, askEmail, label, launcher, help, updates, sound, preview, theme, accent, corners, font, header }) => {
   const ctx = useCtx();
   const who = useRef({ distinctId: ctx.distinctId, user: ctx.user, userHash: ctx.userHash });
   who.current = { distinctId: ctx.distinctId, user: ctx.user, userHash: ctx.userHash };
@@ -38,6 +38,7 @@ var Messenger = ({ position, title, greeting, askEmail, label, launcher, help, s
         askEmail,
         label,
         help,
+        updates,
         sound,
         preview,
         theme,
@@ -63,7 +64,7 @@ var Messenger = ({ position, title, greeting, askEmail, label, launcher, help, s
       mine?.destroy();
       if (handle === mine) handle = null;
     };
-  }, [apiKey, host, embedded, launcher, position, title, greeting, askEmail, label, help, sound, preview, theme, accent, corners, font, header]);
+  }, [apiKey, host, embedded, launcher, position, title, greeting, askEmail, label, help, updates, sound, preview, theme, accent, corners, font, header]);
   return null;
 };
 export {

package/dist/messenger.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/messenger.tsx"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\nimport type { MessengerCorners, MessengerPosition } from \"./api-client\";\nimport { useCtx } from \"./context\";\nimport type { MessengerHandle, MessengerView } from \"./messenger-ui\";\nimport type { Theme } from \"./ui\";\n\n/**\n * The messenger, after Featurebase's: a launcher and a panel with Home, Messages (a chat with the product's team) and\n * Help (the product's published help articles). A visitor's messages become a Support conversation (channel \"chat\")\n * in MRRocket's inbox, where the owner answers or the Customer experience agent does (Support › Automation › AI\n * answers). A new answer plays a short sound and shows a preview above the closed launcher.\n *\n * The panel is plain DOM (messenger-ui.ts, shared with the script tag), loaded with a dynamic import after the page\n * rendered. The visitor is the provider's id; a person the site identified carries their name and email.\n */\n\nlet handle: MessengerHandle | null = null;\n/** A call made before the panel loaded runs once it has. */\nlet waiting: ((h: MessengerHandle) => void) | null = null;\nconst withHandle = (fn: (h: MessengerHandle) => void) => {\n    if (handle) fn(handle);\n    else waiting = fn;\n};\n\n/** Open (on Home, a tab or an article), close or toggle the messenger from your own button (or mark any element `data-ck-messenger`). */\nexport const useMessenger = () => ({\n    open: (view?: MessengerView | { article: string }) => withHandle((h) => h.open(view)),\n    close: () => handle?.close(),\n    toggle: () => withHandle((h) => h.toggle()),\n});\n\nexport interface MessengerProps {\n    /** A corner, the middle of the top or bottom edge, or the middle of a side (default \"bottom-right\"). */\n    position?: MessengerPosition;\n    /** The team's name beside its mark on Home (default: the product's name). */\n    title?: string;\n    /** The big line on Home and the first line of an empty chat. */\n    greeting?: string;\n    /** Ask anonymous visitors for an email (optional for them). Default true. */\n    askEmail?: boolean;\n    /** Text on the launcher; empty shows the icon only. */\n    label?: string;\n    /** Show the round launcher (default true). False: open it with `useMessenger()` or `data-ck-messenger`. */\n    launcher?: boolean;\n    /** The Help tab with your published help articles (default true; hidden while there are none). */\n    help?: boolean;\n    /** A short sound when an answer arrives (default true). */\n    sound?: boolean;\n    /** A preview of a new answer above the closed launcher (default true). */\n    preview?: boolean;\n    theme?: Theme;\n    accent?: string;\n    /** \"round\" (default), \"soft\" or \"square\". */\n    corners?: MessengerCorners;\n    /** Your site's font (default) or \"system\". */\n    font?: \"site\" | \"system\";\n    /** Home's top: \"plain\" (default) or \"color\" (the accent). */\n    header?: \"plain\" | \"color\";\n}\n\n/**\n * A floating launcher that opens the messenger. Put it once inside `<CockpitProvider>`:\n *\n *     <Messenger title=\"Acme\" greeting=\"Hi! How can we help?\" />\n */\nexport const Messenger = ({ position, title, greeting, askEmail, label, launcher, help, sound, preview, theme, accent, corners, font, header }: MessengerProps) => {\n    const ctx = useCtx();\n    // The panel reads the visitor at each request, so a later identify or reset needs no remount.\n    const who = useRef({ distinctId: ctx.distinctId, user: ctx.user, userHash: ctx.userHash });\n    who.current = { distinctId: ctx.distinctId, user: ctx.user, userHash: ctx.userHash };\n    const { apiKey, host, embedded } = ctx;\n\n    useEffect(() => {\n        if (embedded || !apiKey) return;\n        let gone = false;\n        let mine: MessengerHandle | null = null;\n        void import(\"./messenger-ui\").then(({ mountMessenger }) => {\n            if (gone) return;\n            mine = mountMessenger({\n                host,\n                apiKey,\n                distinctId: () => who.current.distinctId,\n                user: () => who.current.user as { id?: string; name?: string; email?: string } | undefined,\n                userHash: () => who.current.userHash,\n                launcher,\n                position,\n                title,\n                greeting,\n                askEmail,\n                label,\n                help,\n                sound,\n                preview,\n                theme,\n                accent,\n                corners,\n                font,\n                header,\n            });\n            handle = mine;\n            waiting?.(mine);\n            waiting = null;\n        });\n        const click = (e: MouseEvent) => {\n            if ((e.target as HTMLElement | null)?.closest(\"[data-ck-messenger]\")) {\n                e.preventDefault();\n                withHandle((h) => h.open());\n            }\n        };\n        document.addEventListener(\"click\", click);\n        return () => {\n            gone = true;\n            document.removeEventListener(\"click\", click);\n            mine?.destroy();\n            if (handle === mine) handle = null;\n        };\n    }, [apiKey, host, embedded, launcher, position, title, greeting, askEmail, label, help, sound, preview, theme, accent, corners, font, header]);\n\n    return null;\n};\n"],"mappings":";;;AAEA,SAAS,WAAW,cAAc;AAElC,SAAS,cAAc;AAcvB,IAAI,SAAiC;AAErC,IAAI,UAAiD;AACrD,IAAM,aAAa,CAAC,OAAqC;AACrD,MAAI,OAAQ,IAAG,MAAM;AAAA,MAChB,WAAU;AACnB;AAGO,IAAM,eAAe,OAAO;AAAA,EAC/B,MAAM,CAAC,SAA+C,WAAW,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC;AAAA,EACpF,OAAO,MAAM,QAAQ,MAAM;AAAA,EAC3B,QAAQ,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC;AAC9C;AAoCO,IAAM,YAAY,CAAC,EAAE,UAAU,OAAO,UAAU,UAAU,OAAO,UAAU,MAAM,OAAO,SAAS,OAAO,QAAQ,SAAS,MAAM,OAAO,MAAsB;AAC/J,QAAM,MAAM,OAAO;AAEnB,QAAM,MAAM,OAAO,EAAE,YAAY,IAAI,YAAY,MAAM,IAAI,MAAM,UAAU,IAAI,SAAS,CAAC;AACzF,MAAI,UAAU,EAAE,YAAY,IAAI,YAAY,MAAM,IAAI,MAAM,UAAU,IAAI,SAAS;AACnF,QAAM,EAAE,QAAQ,MAAM,SAAS,IAAI;AAEnC,YAAU,MAAM;AACZ,QAAI,YAAY,CAAC,OAAQ;AACzB,QAAI,OAAO;AACX,QAAI,OAA+B;AACnC,SAAK,OAAO,mBAAgB,EAAE,KAAK,CAAC,EAAE,eAAe,MAAM;AACvD,UAAI,KAAM;AACV,aAAO,eAAe;AAAA,QAClB;AAAA,QACA;AAAA,QACA,YAAY,MAAM,IAAI,QAAQ;AAAA,QAC9B,MAAM,MAAM,IAAI,QAAQ;AAAA,QACxB,UAAU,MAAM,IAAI,QAAQ;AAAA,QAC5B;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACJ,CAAC;AACD,eAAS;AACT,gBAAU,IAAI;AACd,gBAAU;AAAA,IACd,CAAC;AACD,UAAM,QAAQ,CAAC,MAAkB;AAC7B,UAAK,EAAE,QAA+B,QAAQ,qBAAqB,GAAG;AAClE,UAAE,eAAe;AACjB,mBAAW,CAAC,MAAM,EAAE,KAAK,CAAC;AAAA,MAC9B;AAAA,IACJ;AACA,aAAS,iBAAiB,SAAS,KAAK;AACxC,WAAO,MAAM;AACT,aAAO;AACP,eAAS,oBAAoB,SAAS,KAAK;AAC3C,YAAM,QAAQ;AACd,UAAI,WAAW,KAAM,UAAS;AAAA,IAClC;AAAA,EACJ,GAAG,CAAC,QAAQ,MAAM,UAAU,UAAU,UAAU,OAAO,UAAU,UAAU,OAAO,MAAM,OAAO,SAAS,OAAO,QAAQ,SAAS,MAAM,MAAM,CAAC;AAE7I,SAAO;AACX;","names":[]}
+{"version":3,"sources":["../src/messenger.tsx"],"sourcesContent":["\"use client\";\n\nimport { useEffect, useRef } from \"react\";\nimport type { MessengerCorners, MessengerPosition } from \"./api-client\";\nimport { useCtx } from \"./context\";\nimport type { MessengerHandle, MessengerView } from \"./messenger-ui\";\nimport type { Theme } from \"./ui\";\n\n/**\n * The messenger, after Featurebase's: a launcher and a panel with Home, Messages (a chat with the product's team) and\n * Help (the product's published help articles). A visitor's messages become a Support conversation (channel \"chat\")\n * in MRRocket's inbox, where the owner answers or the Customer experience agent does (Support › Automation › AI\n * answers). A new answer plays a short sound and shows a preview above the closed launcher.\n *\n * The panel is plain DOM (messenger-ui.ts, shared with the script tag), loaded with a dynamic import after the page\n * rendered. The visitor is the provider's id; a person the site identified carries their name and email.\n */\n\nlet handle: MessengerHandle | null = null;\n/** A call made before the panel loaded runs once it has. */\nlet waiting: ((h: MessengerHandle) => void) | null = null;\nconst withHandle = (fn: (h: MessengerHandle) => void) => {\n    if (handle) fn(handle);\n    else waiting = fn;\n};\n\n/** Open (on Home, a tab or an article), close or toggle the messenger from your own button (or mark any element `data-ck-messenger`). */\nexport const useMessenger = () => ({\n    open: (view?: MessengerView | { article: string }) => withHandle((h) => h.open(view)),\n    close: () => handle?.close(),\n    toggle: () => withHandle((h) => h.toggle()),\n});\n\nexport interface MessengerProps {\n    /** A corner, the middle of the top or bottom edge, or the middle of a side (default \"bottom-right\"). */\n    position?: MessengerPosition;\n    /** The team's name beside its mark on Home (default: the product's name). */\n    title?: string;\n    /** The big line on Home and the first line of an empty chat. */\n    greeting?: string;\n    /** Ask anonymous visitors for an email (optional for them). Default true. */\n    askEmail?: boolean;\n    /** Text on the launcher; empty shows the icon only. */\n    label?: string;\n    /** Show the round launcher (default true). False: open it with `useMessenger()` or `data-ck-messenger`. */\n    launcher?: boolean;\n    /** The Help tab with your published help articles (default true; hidden while there are none). */\n    help?: boolean;\n    /** The Updates tab with your published changelog (default true; hidden while there are none). */\n    updates?: boolean;\n    /** A short sound when an answer arrives (default true). */\n    sound?: boolean;\n    /** A preview of a new answer above the closed launcher (default true). */\n    preview?: boolean;\n    theme?: Theme;\n    accent?: string;\n    /** \"round\" (default), \"soft\" or \"square\". */\n    corners?: MessengerCorners;\n    /** Your site's font (default) or \"system\". */\n    font?: \"site\" | \"system\";\n    /** Home's top: \"plain\" (default) or \"color\" (the accent). */\n    header?: \"plain\" | \"color\";\n}\n\n/**\n * A floating launcher that opens the messenger. Put it once inside `<CockpitProvider>`:\n *\n *     <Messenger title=\"Acme\" greeting=\"Hi! How can we help?\" />\n */\nexport const Messenger = ({ position, title, greeting, askEmail, label, launcher, help, updates, sound, preview, theme, accent, corners, font, header }: MessengerProps) => {\n    const ctx = useCtx();\n    // The panel reads the visitor at each request, so a later identify or reset needs no remount.\n    const who = useRef({ distinctId: ctx.distinctId, user: ctx.user, userHash: ctx.userHash });\n    who.current = { distinctId: ctx.distinctId, user: ctx.user, userHash: ctx.userHash };\n    const { apiKey, host, embedded } = ctx;\n\n    useEffect(() => {\n        if (embedded || !apiKey) return;\n        let gone = false;\n        let mine: MessengerHandle | null = null;\n        void import(\"./messenger-ui\").then(({ mountMessenger }) => {\n            if (gone) return;\n            mine = mountMessenger({\n                host,\n                apiKey,\n                distinctId: () => who.current.distinctId,\n                user: () => who.current.user as { id?: string; name?: string; email?: string } | undefined,\n                userHash: () => who.current.userHash,\n                launcher,\n                position,\n                title,\n                greeting,\n                askEmail,\n                label,\n                help,\n                updates,\n                sound,\n                preview,\n                theme,\n                accent,\n                corners,\n                font,\n                header,\n            });\n            handle = mine;\n            waiting?.(mine);\n            waiting = null;\n        });\n        const click = (e: MouseEvent) => {\n            if ((e.target as HTMLElement | null)?.closest(\"[data-ck-messenger]\")) {\n                e.preventDefault();\n                withHandle((h) => h.open());\n            }\n        };\n        document.addEventListener(\"click\", click);\n        return () => {\n            gone = true;\n            document.removeEventListener(\"click\", click);\n            mine?.destroy();\n            if (handle === mine) handle = null;\n        };\n    }, [apiKey, host, embedded, launcher, position, title, greeting, askEmail, label, help, updates, sound, preview, theme, accent, corners, font, header]);\n\n    return null;\n};\n"],"mappings":";;;AAEA,SAAS,WAAW,cAAc;AAElC,SAAS,cAAc;AAcvB,IAAI,SAAiC;AAErC,IAAI,UAAiD;AACrD,IAAM,aAAa,CAAC,OAAqC;AACrD,MAAI,OAAQ,IAAG,MAAM;AAAA,MAChB,WAAU;AACnB;AAGO,IAAM,eAAe,OAAO;AAAA,EAC/B,MAAM,CAAC,SAA+C,WAAW,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC;AAAA,EACpF,OAAO,MAAM,QAAQ,MAAM;AAAA,EAC3B,QAAQ,MAAM,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC;AAC9C;AAsCO,IAAM,YAAY,CAAC,EAAE,UAAU,OAAO,UAAU,UAAU,OAAO,UAAU,MAAM,SAAS,OAAO,SAAS,OAAO,QAAQ,SAAS,MAAM,OAAO,MAAsB;AACxK,QAAM,MAAM,OAAO;AAEnB,QAAM,MAAM,OAAO,EAAE,YAAY,IAAI,YAAY,MAAM,IAAI,MAAM,UAAU,IAAI,SAAS,CAAC;AACzF,MAAI,UAAU,EAAE,YAAY,IAAI,YAAY,MAAM,IAAI,MAAM,UAAU,IAAI,SAAS;AACnF,QAAM,EAAE,QAAQ,MAAM,SAAS,IAAI;AAEnC,YAAU,MAAM;AACZ,QAAI,YAAY,CAAC,OAAQ;AACzB,QAAI,OAAO;AACX,QAAI,OAA+B;AACnC,SAAK,OAAO,mBAAgB,EAAE,KAAK,CAAC,EAAE,eAAe,MAAM;AACvD,UAAI,KAAM;AACV,aAAO,eAAe;AAAA,QAClB;AAAA,QACA;AAAA,QACA,YAAY,MAAM,IAAI,QAAQ;AAAA,QAC9B,MAAM,MAAM,IAAI,QAAQ;AAAA,QACxB,UAAU,MAAM,IAAI,QAAQ;AAAA,QAC5B;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,QACA;AAAA,MACJ,CAAC;AACD,eAAS;AACT,gBAAU,IAAI;AACd,gBAAU;AAAA,IACd,CAAC;AACD,UAAM,QAAQ,CAAC,MAAkB;AAC7B,UAAK,EAAE,QAA+B,QAAQ,qBAAqB,GAAG;AAClE,UAAE,eAAe;AACjB,mBAAW,CAAC,MAAM,EAAE,KAAK,CAAC;AAAA,MAC9B;AAAA,IACJ;AACA,aAAS,iBAAiB,SAAS,KAAK;AACxC,WAAO,MAAM;AACT,aAAO;AACP,eAAS,oBAAoB,SAAS,KAAK;AAC3C,YAAM,QAAQ;AACd,UAAI,WAAW,KAAM,UAAS;AAAA,IAClC;AAAA,EACJ,GAAG,CAAC,QAAQ,MAAM,UAAU,UAAU,UAAU,OAAO,UAAU,UAAU,OAAO,MAAM,SAAS,OAAO,SAAS,OAAO,QAAQ,SAAS,MAAM,MAAM,CAAC;AAEtJ,SAAO;AACX;","names":[]}

package/dist/onboarding-report.d.ts

@@ -0,0 +1,19 @@
+export type OnboardingReportType = "questions" | "checklist" | "tour";
+export interface OnboardingReportOptions {
+    /** Every step's id in the order people meet them, so a step only some people see keeps its place. */
+    order?: string[];
+    /** "questions" (the default), a "checklist" or a "tour". */
+    type?: OnboardingReportType;
+}
+export interface OnboardingReport {
+    /** The person sees this step; `title` is its name in MRRocket. Sent once per step and page. */
+    saw(step: string, title: string): void;
+    /** The person answered a question with one of its options: its id, and its words in MRRocket. */
+    answered(question: string, answer: string, label?: string): void;
+    /** The person did this task or tour step. */
+    done(step: string): void;
+    /** The person closed it or skipped the rest, at this step if you name one. */
+    closed(step?: string): void;
+}
+/** The report behind `useOnboardingReport` and the script tag's `onboarding.report`, over the SDK's `track`. */
+export declare const createOnboardingReport: (track: (event: string, props?: Record<string, unknown>) => void, name: string, options?: OnboardingReportOptions) => OnboardingReport;

package/dist/onboarding-report.js

@@ -0,0 +1,23 @@
+// src/onboarding-report.ts
+import { ONBOARDING_EVENT, eventSlug } from "./flows.js";
+var KIND = { questions: "question", checklist: "checklist", tour: "tour" };
+var createOnboardingReport = (track, name, options = {}) => {
+  const type = options.type ?? "questions";
+  const kind = KIND[type] ?? "question";
+  const seen = /* @__PURE__ */ new Set();
+  const send = (props) => track(ONBOARDING_EVENT, { code: eventSlug(name), name, type, ...options.order?.length ? { order: options.order } : {}, ...props });
+  return {
+    saw: (step, title) => {
+      if (seen.has(step)) return;
+      seen.add(step);
+      send({ step, title, kind, action: "shown" });
+    },
+    answered: (question, answer, label) => send({ step: question, kind: "question", action: "completed", question, answer, label: label ?? answer }),
+    done: (step) => send({ step, kind, action: "completed" }),
+    closed: (step) => send({ ...step ? { step } : {}, kind, action: "dismissed" })
+  };
+};
+export {
+  createOnboardingReport
+};
+//# sourceMappingURL=onboarding-report.js.map

package/dist/onboarding-report.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/onboarding-report.ts"],"sourcesContent":["/**\n * 0.22.0: an onboarding the app keeps in its own code. There is nothing to set up in MRRocket: the app reports its\n * steps by name, and the first report makes the item (Win customers › Onboarding, \"From your code\"). MRRocket then shows\n * who saw each step, who did it and what they answered, and keeps the answers on the contact. It never draws such an\n * item and has no say in when it shows; that stays in the app.\n *\n *     const report = useOnboardingReport(\"Welcome questions\", { order: [\"goal\", \"role\", \"source\"] });\n *     report.saw(\"goal\", \"What brings you here?\");\n *     report.answered(\"goal\", \"dream\", \"Dream game\");\n *     report.closed(\"goal\"); // the person skipped the rest\n *\n * Everything goes through `track`, so it follows the visitor's consent like any other event. Report the words in one\n * language, whatever the visitor reads: the ids count the people, the words only name them in MRRocket.\n */\nimport { ONBOARDING_EVENT, eventSlug } from \"./flows\";\n\nexport type OnboardingReportType = \"questions\" | \"checklist\" | \"tour\";\n\nexport interface OnboardingReportOptions {\n    /** Every step's id in the order people meet them, so a step only some people see keeps its place. */\n    order?: string[];\n    /** \"questions\" (the default), a \"checklist\" or a \"tour\". */\n    type?: OnboardingReportType;\n}\n\nexport interface OnboardingReport {\n    /** The person sees this step; `title` is its name in MRRocket. Sent once per step and page. */\n    saw(step: string, title: string): void;\n    /** The person answered a question with one of its options: its id, and its words in MRRocket. */\n    answered(question: string, answer: string, label?: string): void;\n    /** The person did this task or tour step. */\n    done(step: string): void;\n    /** The person closed it or skipped the rest, at this step if you name one. */\n    closed(step?: string): void;\n}\n\nconst KIND = { questions: \"question\", checklist: \"checklist\", tour: \"tour\" } as const;\n\n/** The report behind `useOnboardingReport` and the script tag's `onboarding.report`, over the SDK's `track`. */\nexport const createOnboardingReport = (track: (event: string, props?: Record<string, unknown>) => void, name: string, options: OnboardingReportOptions = {}): OnboardingReport => {\n    const type = options.type ?? \"questions\";\n    const kind = KIND[type] ?? \"question\";\n    const seen = new Set<string>();\n    const send = (props: Record<string, unknown>) =>\n        track(ONBOARDING_EVENT, { code: eventSlug(name), name, type, ...(options.order?.length ? { order: options.order } : {}), ...props });\n    return {\n        saw: (step, title) => {\n            if (seen.has(step)) return;\n            seen.add(step);\n            send({ step, title, kind, action: \"shown\" });\n        },\n        answered: (question, answer, label) => send({ step: question, kind: \"question\", action: \"completed\", question, answer, label: label ?? answer }),\n        done: (step) => send({ step, kind, action: \"completed\" }),\n        closed: (step) => send({ ...(step ? { step } : {}), kind, action: \"dismissed\" }),\n    };\n};\n"],"mappings":";AAcA,SAAS,kBAAkB,iBAAiB;AAsB5C,IAAM,OAAO,EAAE,WAAW,YAAY,WAAW,aAAa,MAAM,OAAO;AAGpE,IAAM,yBAAyB,CAAC,OAAiE,MAAc,UAAmC,CAAC,MAAwB;AAC9K,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,OAAO,KAAK,IAAI,KAAK;AAC3B,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,OAAO,CAAC,UACV,MAAM,kBAAkB,EAAE,MAAM,UAAU,IAAI,GAAG,MAAM,MAAM,GAAI,QAAQ,OAAO,SAAS,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC,GAAI,GAAG,MAAM,CAAC;AACvI,SAAO;AAAA,IACH,KAAK,CAAC,MAAM,UAAU;AAClB,UAAI,KAAK,IAAI,IAAI,EAAG;AACpB,WAAK,IAAI,IAAI;AACb,WAAK,EAAE,MAAM,OAAO,MAAM,QAAQ,QAAQ,CAAC;AAAA,IAC/C;AAAA,IACA,UAAU,CAAC,UAAU,QAAQ,UAAU,KAAK,EAAE,MAAM,UAAU,MAAM,YAAY,QAAQ,aAAa,UAAU,QAAQ,OAAO,SAAS,OAAO,CAAC;AAAA,IAC/I,MAAM,CAAC,SAAS,KAAK,EAAE,MAAM,MAAM,QAAQ,YAAY,CAAC;AAAA,IACxD,QAAQ,CAAC,SAAS,KAAK,EAAE,GAAI,OAAO,EAAE,KAAK,IAAI,CAAC,GAAI,MAAM,QAAQ,YAAY,CAAC;AAAA,EACnF;AACJ;","names":[]}

package/dist/onboarding-state.d.ts

@@ -1,4 +1,5 @@
 import type { FlowsController, OnboardingFlow, OnboardingItemState } from "./flows.js";
+import { type OnboardingReport, type OnboardingReportOptions } from "./onboarding-report.js";
 export interface UseOnboarding {
     /** The item as MRRocket published it, or null while the config is loading, or when it is not live. */
     item: OnboardingFlow | null;
@@ -21,3 +22,5 @@ export interface UseOnboarding {
 }
 /** The hook behind `useOnboarding` on both platforms. */
 export declare const useOnboardingItem: (flows: FlowsController | null | undefined, id: string | undefined, start: (id?: string) => boolean) => UseOnboarding;
+/** 0.22.0: the hook behind `useOnboardingReport` on both platforms: one report per name and options. */
+export declare const useReportWith: (track: (event: string, props?: Record<string, unknown>) => void, name: string, options?: OnboardingReportOptions) => OnboardingReport;

package/dist/onboarding-state.js

@@ -1,5 +1,6 @@
 // src/onboarding-state.ts
 import { useEffect, useMemo, useState } from "react";
+import { createOnboardingReport } from "./onboarding-report.js";
 var none = [];
 var useOnboardingItem = (flows, id, start) => {
   const [state, setState] = useState(() => flows && id ? flows.onboarding.item(id) : null);
@@ -37,7 +38,12 @@ var useOnboardingItem = (flows, id, start) => {
     [state, flows, id, start]
   );
 };
+var useReportWith = (track, name, options) => {
+  const key = JSON.stringify(options ?? null);
+  return useMemo(() => createOnboardingReport(track, name, options), [track, name, key]);
+};
 export {
-  useOnboardingItem
+  useOnboardingItem,
+  useReportWith
 };
 //# sourceMappingURL=onboarding-state.js.map

package/dist/onboarding-state.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/onboarding-state.ts"],"sourcesContent":["/**\n * 0.18.0: `useOnboarding(id)` for an onboarding item the app draws itself (\"Shown by: your code\" in MRRocket): its\n * content and the person's progress, and the calls that report what they did. Shared by the Next.js provider and React\n * Native (only React here). The SDK draws nothing for such an item and never starts it; what the app reports still\n * reaches MRRocket (who saw it, who finished it, the answers on the contact), and the item after it follows as usual.\n *\n *     const { item, steps, done, complete, dismiss, answer } = useOnboarding(\"flow_123\");\n *     if (!item || done) return null;\n *     return steps.map((s) => <Task key={s.id} title={s.title} done={s.done} onPress={() => complete(s.id)} />);\n */\nimport { useEffect, useMemo, useState } from \"react\";\nimport type { FlowsController, OnboardingFlow, OnboardingItemState } from \"./flows\";\n\nexport interface UseOnboarding {\n    /** The item as MRRocket published it, or null while the config is loading, or when it is not live. */\n    item: OnboardingFlow | null;\n    /** Its steps (a tour's steps, a checklist's tasks, the questions), each with `done` (and a question's `answer`). */\n    steps: OnboardingItemState[\"steps\"];\n    /** Every step is done. */\n    done: boolean;\n    /** The person closed it. */\n    dismissed: boolean;\n    /** Its moment has come for this person (the trigger MRRocket set, and who it is for). */\n    eligible: boolean;\n    /** Marks a step done (a tour step, a task). */\n    complete(stepId: string): void;\n    /** The person closed it; the item after it follows. */\n    dismiss(): void;\n    /** Answers a question (its step id or its key) with an option's id or a text; it is kept on the contact. */\n    answer(question: string, value: string): void;\n    /** Starts an item the SDK draws (the first live one without an id). */\n    start(id?: string): boolean;\n}\n\nconst none: OnboardingItemState[\"steps\"] = [];\n\n/** The hook behind `useOnboarding` on both platforms. */\nexport const useOnboardingItem = (flows: FlowsController | null | undefined, id: string | undefined, start: (id?: string) => boolean): UseOnboarding => {\n    const [state, setState] = useState<OnboardingItemState | null>(() => (flows && id ? flows.onboarding.item(id) : null));\n    useEffect(() => {\n        if (!flows || !id) {\n            setState(null);\n            return;\n        }\n        const up = () => {\n            const s = flows.onboarding.item(id);\n            setState(s);\n            // Asked for by the app: counted as seen (started, and its first open steps), once per page.\n            if (s && !s.done && !s.dismissed) flows.onboarding.seen(id);\n        };\n        up();\n        return flows.subscribe(up);\n    }, [flows, id]);\n    return useMemo(\n        () => ({\n            item: state?.item ?? null,\n            steps: state?.steps ?? none,\n            done: !!state?.done,\n            dismissed: !!state?.dismissed,\n            eligible: !!state?.eligible,\n            complete: (stepId: string) => {\n                if (flows && id) flows.onboarding.complete(id, stepId);\n            },\n            dismiss: () => {\n                if (flows && id) flows.onboarding.dismissItem(id);\n            },\n            answer: (question: string, value: string) => {\n                if (flows && id) flows.onboarding.answerItem(id, question, value);\n            },\n            start,\n        }),\n        [state, flows, id, start],\n    );\n};\n"],"mappings":";AAUA,SAAS,WAAW,SAAS,gBAAgB;AAwB7C,IAAM,OAAqC,CAAC;AAGrC,IAAM,oBAAoB,CAAC,OAA2C,IAAwB,UAAmD;AACpJ,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAqC,MAAO,SAAS,KAAK,MAAM,WAAW,KAAK,EAAE,IAAI,IAAK;AACrH,YAAU,MAAM;AACZ,QAAI,CAAC,SAAS,CAAC,IAAI;AACf,eAAS,IAAI;AACb;AAAA,IACJ;AACA,UAAM,KAAK,MAAM;AACb,YAAM,IAAI,MAAM,WAAW,KAAK,EAAE;AAClC,eAAS,CAAC;AAEV,UAAI,KAAK,CAAC,EAAE,QAAQ,CAAC,EAAE,UAAW,OAAM,WAAW,KAAK,EAAE;AAAA,IAC9D;AACA,OAAG;AACH,WAAO,MAAM,UAAU,EAAE;AAAA,EAC7B,GAAG,CAAC,OAAO,EAAE,CAAC;AACd,SAAO;AAAA,IACH,OAAO;AAAA,MACH,MAAM,OAAO,QAAQ;AAAA,MACrB,OAAO,OAAO,SAAS;AAAA,MACvB,MAAM,CAAC,CAAC,OAAO;AAAA,MACf,WAAW,CAAC,CAAC,OAAO;AAAA,MACpB,UAAU,CAAC,CAAC,OAAO;AAAA,MACnB,UAAU,CAAC,WAAmB;AAC1B,YAAI,SAAS,GAAI,OAAM,WAAW,SAAS,IAAI,MAAM;AAAA,MACzD;AAAA,MACA,SAAS,MAAM;AACX,YAAI,SAAS,GAAI,OAAM,WAAW,YAAY,EAAE;AAAA,MACpD;AAAA,MACA,QAAQ,CAAC,UAAkB,UAAkB;AACzC,YAAI,SAAS,GAAI,OAAM,WAAW,WAAW,IAAI,UAAU,KAAK;AAAA,MACpE;AAAA,MACA;AAAA,IACJ;AAAA,IACA,CAAC,OAAO,OAAO,IAAI,KAAK;AAAA,EAC5B;AACJ;","names":[]}
+{"version":3,"sources":["../src/onboarding-state.ts"],"sourcesContent":["/**\n * 0.18.0: `useOnboarding(id)` for an onboarding item the app draws itself (\"Shown by: your code\" in MRRocket): its\n * content and the person's progress, and the calls that report what they did. Shared by the Next.js provider and React\n * Native (only React here). The SDK draws nothing for such an item and never starts it; what the app reports still\n * reaches MRRocket (who saw it, who finished it, the answers on the contact), and the item after it follows as usual.\n *\n *     const { item, steps, done, complete, dismiss, answer } = useOnboarding(\"flow_123\");\n *     if (!item || done) return null;\n *     return steps.map((s) => <Task key={s.id} title={s.title} done={s.done} onPress={() => complete(s.id)} />);\n */\nimport { useEffect, useMemo, useState } from \"react\";\nimport type { FlowsController, OnboardingFlow, OnboardingItemState } from \"./flows\";\nimport { type OnboardingReport, type OnboardingReportOptions, createOnboardingReport } from \"./onboarding-report\";\n\nexport interface UseOnboarding {\n    /** The item as MRRocket published it, or null while the config is loading, or when it is not live. */\n    item: OnboardingFlow | null;\n    /** Its steps (a tour's steps, a checklist's tasks, the questions), each with `done` (and a question's `answer`). */\n    steps: OnboardingItemState[\"steps\"];\n    /** Every step is done. */\n    done: boolean;\n    /** The person closed it. */\n    dismissed: boolean;\n    /** Its moment has come for this person (the trigger MRRocket set, and who it is for). */\n    eligible: boolean;\n    /** Marks a step done (a tour step, a task). */\n    complete(stepId: string): void;\n    /** The person closed it; the item after it follows. */\n    dismiss(): void;\n    /** Answers a question (its step id or its key) with an option's id or a text; it is kept on the contact. */\n    answer(question: string, value: string): void;\n    /** Starts an item the SDK draws (the first live one without an id). */\n    start(id?: string): boolean;\n}\n\nconst none: OnboardingItemState[\"steps\"] = [];\n\n/** The hook behind `useOnboarding` on both platforms. */\nexport const useOnboardingItem = (flows: FlowsController | null | undefined, id: string | undefined, start: (id?: string) => boolean): UseOnboarding => {\n    const [state, setState] = useState<OnboardingItemState | null>(() => (flows && id ? flows.onboarding.item(id) : null));\n    useEffect(() => {\n        if (!flows || !id) {\n            setState(null);\n            return;\n        }\n        const up = () => {\n            const s = flows.onboarding.item(id);\n            setState(s);\n            // Asked for by the app: counted as seen (started, and its first open steps), once per page.\n            if (s && !s.done && !s.dismissed) flows.onboarding.seen(id);\n        };\n        up();\n        return flows.subscribe(up);\n    }, [flows, id]);\n    return useMemo(\n        () => ({\n            item: state?.item ?? null,\n            steps: state?.steps ?? none,\n            done: !!state?.done,\n            dismissed: !!state?.dismissed,\n            eligible: !!state?.eligible,\n            complete: (stepId: string) => {\n                if (flows && id) flows.onboarding.complete(id, stepId);\n            },\n            dismiss: () => {\n                if (flows && id) flows.onboarding.dismissItem(id);\n            },\n            answer: (question: string, value: string) => {\n                if (flows && id) flows.onboarding.answerItem(id, question, value);\n            },\n            start,\n        }),\n        [state, flows, id, start],\n    );\n};\n\n/** 0.22.0: the hook behind `useOnboardingReport` on both platforms: one report per name and options. */\nexport const useReportWith = (track: (event: string, props?: Record<string, unknown>) => void, name: string, options?: OnboardingReportOptions): OnboardingReport => {\n    const key = JSON.stringify(options ?? null);\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n    return useMemo(() => createOnboardingReport(track, name, options), [track, name, key]);\n};\n"],"mappings":";AAUA,SAAS,WAAW,SAAS,gBAAgB;AAE7C,SAA8D,8BAA8B;AAuB5F,IAAM,OAAqC,CAAC;AAGrC,IAAM,oBAAoB,CAAC,OAA2C,IAAwB,UAAmD;AACpJ,QAAM,CAAC,OAAO,QAAQ,IAAI,SAAqC,MAAO,SAAS,KAAK,MAAM,WAAW,KAAK,EAAE,IAAI,IAAK;AACrH,YAAU,MAAM;AACZ,QAAI,CAAC,SAAS,CAAC,IAAI;AACf,eAAS,IAAI;AACb;AAAA,IACJ;AACA,UAAM,KAAK,MAAM;AACb,YAAM,IAAI,MAAM,WAAW,KAAK,EAAE;AAClC,eAAS,CAAC;AAEV,UAAI,KAAK,CAAC,EAAE,QAAQ,CAAC,EAAE,UAAW,OAAM,WAAW,KAAK,EAAE;AAAA,IAC9D;AACA,OAAG;AACH,WAAO,MAAM,UAAU,EAAE;AAAA,EAC7B,GAAG,CAAC,OAAO,EAAE,CAAC;AACd,SAAO;AAAA,IACH,OAAO;AAAA,MACH,MAAM,OAAO,QAAQ;AAAA,MACrB,OAAO,OAAO,SAAS;AAAA,MACvB,MAAM,CAAC,CAAC,OAAO;AAAA,MACf,WAAW,CAAC,CAAC,OAAO;AAAA,MACpB,UAAU,CAAC,CAAC,OAAO;AAAA,MACnB,UAAU,CAAC,WAAmB;AAC1B,YAAI,SAAS,GAAI,OAAM,WAAW,SAAS,IAAI,MAAM;AAAA,MACzD;AAAA,MACA,SAAS,MAAM;AACX,YAAI,SAAS,GAAI,OAAM,WAAW,YAAY,EAAE;AAAA,MACpD;AAAA,MACA,QAAQ,CAAC,UAAkB,UAAkB;AACzC,YAAI,SAAS,GAAI,OAAM,WAAW,WAAW,IAAI,UAAU,KAAK;AAAA,MACpE;AAAA,MACA;AAAA,IACJ;AAAA,IACA,CAAC,OAAO,OAAO,IAAI,KAAK;AAAA,EAC5B;AACJ;AAGO,IAAM,gBAAgB,CAAC,OAAiE,MAAc,YAAwD;AACjK,QAAM,MAAM,KAAK,UAAU,WAAW,IAAI;AAE1C,SAAO,QAAQ,MAAM,uBAAuB,OAAO,MAAM,OAAO,GAAG,CAAC,OAAO,MAAM,GAAG,CAAC;AACzF;","names":[]}

package/dist/paywall.js

@@ -1,5 +1,6 @@
 // src/paywall.ts
 import { assign } from "./core.js";
+import { t } from "./i18n.js";
 var PAYWALL_EVENT = "$paywall";
 var paywallPages = (config, w, distinctId) => {
   const e = w.experiment ? config?.experiments.find((x) => x.key === w.experiment) : void 0;
@@ -58,7 +59,7 @@ var createPaywallHost = (env) => {
       },
       () => {
         c.busy = false;
-        c.error = "The purchase did not go through. Please try again.";
+        c.error = t("The purchase did not go through. Please try again.");
         emit();
       }
     );

package/dist/paywall.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/paywall.ts"],"sourcesContent":["/**\n * Paywalls with several pages (SDK 0.14.0): what MRRocket's config serves under `paywalls` (one per placement, built\n * in MRRocket › Conversion › Paywalls) and a small controller that walks the person through its pages, page after page,\n * until the last one hands the chosen plan to the app. No DOM and no React: the web renderer (`mountPaywall` in\n * flows-ui.ts, loaded only when a paywall opens) and the React Native one (native/flows-view.ts) draw `view()` and\n * call the actions.\n *\n * MRRocket never takes a payment. The last page's button calls the app's `onPurchase(plan)`, which buys through the\n * app's own store code (StoreKit or Play through RevenueCat or Adapty, or Stripe Checkout on the web); only when it\n * resolves is the purchase recorded. It throwing keeps the paywall open with an error, resolving `false` (the person\n * closed the store sheet) keeps it open without one.\n *\n * A running test on the paywall (`experiment`) gives each person their variant's pages, by the same stable hash as\n * every other test (`assign`), and records `$exposure` when the paywall opens. What it records, as normal events under\n * the SDK's analytics consent:\n * - `$paywall` `{paywall, placement, variant, page, index, action: \"page\"}` the first time each page shows in a run,\n *   so MRRocket shows how many reach page 2 and 3;\n * - `{action: \"purchased\", plan}` after `onPurchase` went through (a test's purchase goal counts it), and\n *   `{action: \"closed\", index}` when the person closed it.\n */\nimport { type CockpitConfig, type VariantId, assign } from \"./core\";\n\nexport const PAYWALL_EVENT = \"$paywall\";\n\n/** One page of a paywall. Plans pages list the plans and buy; the others say why and go on. */\nexport interface PaywallPage {\n    id: string;\n    /** \"benefits\": a list of what the person gets; \"proof\": quotes of happy customers; \"plans\": the plans and the buy button. */\n    kind: \"benefits\" | \"proof\" | \"plans\";\n    title: string;\n    body?: string;\n    /** Benefits: one line each. */\n    items?: string[];\n    /** Proof: what customers said, and who. */\n    quotes?: { text: string; by?: string }[];\n    /** The button: \"Continue\" on the way, the buy button on the plans page (\"Start free trial\"). */\n    button?: string;\n}\n\n/** A plan the paywall offers. `id` is what the app buys: the store product id or the Stripe price, as set in MRRocket. */\nexport interface PaywallPlan {\n    id: string;\n    name: string;\n    /** As shown (\"€59.99 / year\"). The app's own store prices win when it passes `plans`. */\n    price: string;\n    /** A line under it (\"€5 a month\", \"7 days free\"). */\n    note?: string;\n}\n\n/** A published paywall as the config serves it. */\nexport interface PaywallConfig {\n    id: string;\n    /** The placement's key (`onboarding_end`), what the app opens: `paywall.open(\"onboarding_end\")`. */\n    placement: string;\n    /** The running test on it, a key of `experiments`; each of its variants has pages under `variants`. */\n    experiment?: string;\n    /** Control (the live paywall) first. */\n    variants: { id: VariantId; pages: PaywallPage[] }[];\n    plans: PaywallPlan[];\n    /** The plan picked before the person picks one. */\n    highlight?: string;\n}\n\nexport interface PaywallResult {\n    /**\n     * \"purchased\": `onPurchase` went through; \"chosen\": the person picked a plan and there is no `onPurchase`, so the app\n     * buys it now (the store's purchase still counts for a test through RevenueCat or Adapty); \"closed\": the person\n     * closed it (or there was no paywall).\n     */\n    outcome: \"purchased\" | \"chosen\" | \"closed\";\n    plan?: PaywallPlan;\n    paywall?: string;\n    variant?: VariantId;\n    /** The page the person was on, from 0. */\n    index: number;\n}\n\nexport interface PaywallOptions {\n    /**\n     * Buy the plan in your code (RevenueCat `purchasePackage`, Adapty `makePurchase`, Stripe Checkout). Throwing keeps\n     * the paywall open with an error; `false` keeps it open without one (the person cancelled the store sheet).\n     */\n    onPurchase?: (plan: PaywallPlan) => unknown;\n    /** Your store's plans with their local prices, by the same ids; they replace what MRRocket has for them. */\n    plans?: PaywallPlan[];\n    onClose?: (result: PaywallResult) => void;\n}\n\nexport interface PaywallView {\n    paywall: PaywallConfig;\n    variant: VariantId;\n    page: PaywallPage;\n    index: number;\n    total: number;\n    last: boolean;\n    plans: PaywallPlan[];\n    /** The picked plan's id. */\n    plan?: string;\n    busy: boolean;\n    error?: string;\n}\n\nexport interface PaywallEnv {\n    config: () => CockpitConfig | null;\n    distinctId: () => string;\n    /** Records an event under the SDK's consent. */\n    track: (event: string, props?: Record<string, unknown>) => void;\n}\n\nexport interface PaywallHost {\n    /** Opens the paywall of a placement; resolves when it is bought or closed (at once with \"closed\" when there is none). */\n    open(placement: string, options?: PaywallOptions): Promise<PaywallResult>;\n    view(): PaywallView | null;\n    subscribe(listener: () => void): () => void;\n    next(): void;\n    back(): void;\n    pick(planId: string): void;\n    close(): void;\n}\n\n/** The pages of a person's variant: the test's when it runs (or shipped), else control's. */\nexport const paywallPages = (config: CockpitConfig | null, w: PaywallConfig, distinctId: string) => {\n    const e = w.experiment ? config?.experiments.find((x) => x.key === w.experiment) : undefined;\n    const id = e ? assign(e, distinctId) : w.variants[0]?.id;\n    const v = w.variants.find((x) => x.id === id) ?? w.variants[0];\n    return v ? { variant: v.id, pages: v.pages, test: e?.status === \"running\" && !e.winner ? e.key : undefined } : null;\n};\n\nexport const createPaywallHost = (env: PaywallEnv): PaywallHost => {\n    let run: {\n        w: PaywallConfig;\n        variant: VariantId;\n        pages: PaywallPage[];\n        plans: PaywallPlan[];\n        index: number;\n        plan?: string;\n        busy: boolean;\n        error?: string;\n        seen: Set<number>;\n        options: PaywallOptions;\n        resolve: (r: PaywallResult) => void;\n        promise: Promise<PaywallResult>;\n    } | null = null;\n    const listeners = new Set<() => void>();\n    const emit = () => {\n        for (const l of [...listeners]) {\n            try {\n                l();\n            } catch {\n                // One renderer must not stop another.\n            }\n        }\n    };\n    const base = () => (run ? { paywall: run.w.id, placement: run.w.placement, variant: run.variant } : {});\n    const show = () => {\n        if (run && !run.seen.has(run.index)) {\n            run.seen.add(run.index);\n            env.track(PAYWALL_EVENT, { ...base(), page: run.pages[run.index].id, index: run.index, action: \"page\" });\n        }\n        emit();\n    };\n    const end = (r: PaywallResult) => {\n        const c = run;\n        if (!c) return;\n        run = null;\n        if (r.outcome === \"closed\") c.options.onClose?.(r);\n        c.resolve(r);\n        emit();\n    };\n    const result = (outcome: PaywallResult[\"outcome\"]): PaywallResult => ({\n        outcome,\n        index: run?.index ?? 0,\n        ...(run ? { paywall: run.w.id, variant: run.variant } : {}),\n        ...(outcome !== \"closed\" && run ? { plan: run.plans.find((p) => p.id === run!.plan) } : {}),\n    });\n\n    const buy = () => {\n        const c = run;\n        const plan = c?.plans.find((p) => p.id === c.plan);\n        if (!c || !plan || c.busy) return;\n        if (!c.options.onPurchase) return end(result(\"chosen\"));\n        c.busy = true;\n        c.error = undefined;\n        emit();\n        Promise.resolve()\n            .then(() => c.options.onPurchase?.(plan))\n            .then(\n                (ok) => {\n                    c.busy = false;\n                    if (run !== c) return;\n                    if (ok === false) return emit();\n                    env.track(PAYWALL_EVENT, { ...base(), page: c.pages[c.index].id, index: c.index, plan: plan.id, action: \"purchased\" });\n                    end(result(\"purchased\"));\n                },\n                () => {\n                    c.busy = false;\n                    c.error = \"The purchase did not go through. Please try again.\";\n                    emit();\n                },\n            );\n    };\n\n    return {\n        open: (placement, options = {}) => {\n            if (run) return run.promise;\n            const config = env.config();\n            const w = config?.paywalls?.find((x) => x.placement === placement);\n            const picked = w ? paywallPages(config, w, env.distinctId()) : null;\n            if (!w || !picked?.pages.length) return Promise.resolve({ outcome: \"closed\", index: 0 });\n            // The app's store prices replace MRRocket's for the same plans.\n            const own = new Map((options.plans ?? []).map((p) => [p.id, p]));\n            const plans = w.plans.map((p) => own.get(p.id) ?? p);\n            let resolve: (r: PaywallResult) => void = () => {};\n            const promise = new Promise<PaywallResult>((r) => (resolve = r));\n            const plan = plans.some((p) => p.id === w.highlight) ? w.highlight : plans[0]?.id;\n            run = { w, variant: picked.variant, pages: picked.pages, plans, index: 0, plan, busy: false, seen: new Set(), options, resolve, promise };\n            if (picked.test) env.track(\"$exposure\", { experiment: picked.test, variant: picked.variant });\n            show();\n            return promise;\n        },\n        view: () =>\n            run\n                ? {\n                      paywall: run.w,\n                      variant: run.variant,\n                      page: run.pages[run.index],\n                      index: run.index,\n                      total: run.pages.length,\n                      last: run.index === run.pages.length - 1,\n                      plans: run.plans,\n                      plan: run.plan,\n                      busy: run.busy,\n                      error: run.error,\n                  }\n                : null,\n        subscribe: (l) => {\n            listeners.add(l);\n            return () => listeners.delete(l);\n        },\n        next: () => {\n            if (!run || run.busy) return;\n            // A plans page or the last page buys; any other page goes on.\n            if (run.pages[run.index].kind === \"plans\" || run.index === run.pages.length - 1) return buy();\n            run.index++;\n            run.error = undefined;\n            show();\n        },\n        back: () => {\n            if (!run || run.busy || !run.index) return;\n            run.index--;\n            run.error = undefined;\n            emit();\n        },\n        pick: (id) => {\n            if (!run || run.busy || !run.plans.some((p) => p.id === id)) return;\n            run.plan = id;\n            run.error = undefined;\n            emit();\n        },\n        close: () => {\n            if (!run || run.busy) return;\n            env.track(PAYWALL_EVENT, { ...base(), index: run.index, action: \"closed\" });\n            end(result(\"closed\"));\n        },\n    };\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/paywall.ts"],"sourcesContent":["/**\n * Paywalls with several pages (SDK 0.14.0): what MRRocket's config serves under `paywalls` (one per placement, built\n * in MRRocket › Conversion › Paywalls) and a small controller that walks the person through its pages, page after page,\n * until the last one hands the chosen plan to the app. No DOM and no React: the web renderer (`mountPaywall` in\n * flows-ui.ts, loaded only when a paywall opens) and the React Native one (native/flows-view.ts) draw `view()` and\n * call the actions.\n *\n * MRRocket never takes a payment. The last page's button calls the app's `onPurchase(plan)`, which buys through the\n * app's own store code (StoreKit or Play through RevenueCat or Adapty, or Stripe Checkout on the web); only when it\n * resolves is the purchase recorded. It throwing keeps the paywall open with an error, resolving `false` (the person\n * closed the store sheet) keeps it open without one.\n *\n * A running test on the paywall (`experiment`) gives each person their variant's pages, by the same stable hash as\n * every other test (`assign`), and records `$exposure` when the paywall opens. What it records, as normal events under\n * the SDK's analytics consent:\n * - `$paywall` `{paywall, placement, variant, page, index, action: \"page\"}` the first time each page shows in a run,\n *   so MRRocket shows how many reach page 2 and 3;\n * - `{action: \"purchased\", plan}` after `onPurchase` went through (a test's purchase goal counts it), and\n *   `{action: \"closed\", index}` when the person closed it.\n */\nimport { type CockpitConfig, type VariantId, assign } from \"./core\";\nimport { t } from \"./i18n\";\n\nexport const PAYWALL_EVENT = \"$paywall\";\n\n/** One page of a paywall. Plans pages list the plans and buy; the others say why and go on. */\nexport interface PaywallPage {\n    id: string;\n    /** \"benefits\": a list of what the person gets; \"proof\": quotes of happy customers; \"plans\": the plans and the buy button. */\n    kind: \"benefits\" | \"proof\" | \"plans\";\n    title: string;\n    body?: string;\n    /** Benefits: one line each. */\n    items?: string[];\n    /** Proof: what customers said, and who. */\n    quotes?: { text: string; by?: string }[];\n    /** The button: \"Continue\" on the way, the buy button on the plans page (\"Start free trial\"). */\n    button?: string;\n}\n\n/** A plan the paywall offers. `id` is what the app buys: the store product id or the Stripe price, as set in MRRocket. */\nexport interface PaywallPlan {\n    id: string;\n    name: string;\n    /** As shown (\"€59.99 / year\"). The app's own store prices win when it passes `plans`. */\n    price: string;\n    /** A line under it (\"€5 a month\", \"7 days free\"). */\n    note?: string;\n}\n\n/** A published paywall as the config serves it. */\nexport interface PaywallConfig {\n    id: string;\n    /** The placement's key (`onboarding_end`), what the app opens: `paywall.open(\"onboarding_end\")`. */\n    placement: string;\n    /** The running test on it, a key of `experiments`; each of its variants has pages under `variants`. */\n    experiment?: string;\n    /** Control (the live paywall) first. */\n    variants: { id: VariantId; pages: PaywallPage[] }[];\n    plans: PaywallPlan[];\n    /** The plan picked before the person picks one. */\n    highlight?: string;\n}\n\nexport interface PaywallResult {\n    /**\n     * \"purchased\": `onPurchase` went through; \"chosen\": the person picked a plan and there is no `onPurchase`, so the app\n     * buys it now (the store's purchase still counts for a test through RevenueCat or Adapty); \"closed\": the person\n     * closed it (or there was no paywall).\n     */\n    outcome: \"purchased\" | \"chosen\" | \"closed\";\n    plan?: PaywallPlan;\n    paywall?: string;\n    variant?: VariantId;\n    /** The page the person was on, from 0. */\n    index: number;\n}\n\nexport interface PaywallOptions {\n    /**\n     * Buy the plan in your code (RevenueCat `purchasePackage`, Adapty `makePurchase`, Stripe Checkout). Throwing keeps\n     * the paywall open with an error; `false` keeps it open without one (the person cancelled the store sheet).\n     */\n    onPurchase?: (plan: PaywallPlan) => unknown;\n    /** Your store's plans with their local prices, by the same ids; they replace what MRRocket has for them. */\n    plans?: PaywallPlan[];\n    onClose?: (result: PaywallResult) => void;\n}\n\nexport interface PaywallView {\n    paywall: PaywallConfig;\n    variant: VariantId;\n    page: PaywallPage;\n    index: number;\n    total: number;\n    last: boolean;\n    plans: PaywallPlan[];\n    /** The picked plan's id. */\n    plan?: string;\n    busy: boolean;\n    error?: string;\n}\n\nexport interface PaywallEnv {\n    config: () => CockpitConfig | null;\n    distinctId: () => string;\n    /** Records an event under the SDK's consent. */\n    track: (event: string, props?: Record<string, unknown>) => void;\n}\n\nexport interface PaywallHost {\n    /** Opens the paywall of a placement; resolves when it is bought or closed (at once with \"closed\" when there is none). */\n    open(placement: string, options?: PaywallOptions): Promise<PaywallResult>;\n    view(): PaywallView | null;\n    subscribe(listener: () => void): () => void;\n    next(): void;\n    back(): void;\n    pick(planId: string): void;\n    close(): void;\n}\n\n/** The pages of a person's variant: the test's when it runs (or shipped), else control's. */\nexport const paywallPages = (config: CockpitConfig | null, w: PaywallConfig, distinctId: string) => {\n    const e = w.experiment ? config?.experiments.find((x) => x.key === w.experiment) : undefined;\n    const id = e ? assign(e, distinctId) : w.variants[0]?.id;\n    const v = w.variants.find((x) => x.id === id) ?? w.variants[0];\n    return v ? { variant: v.id, pages: v.pages, test: e?.status === \"running\" && !e.winner ? e.key : undefined } : null;\n};\n\nexport const createPaywallHost = (env: PaywallEnv): PaywallHost => {\n    let run: {\n        w: PaywallConfig;\n        variant: VariantId;\n        pages: PaywallPage[];\n        plans: PaywallPlan[];\n        index: number;\n        plan?: string;\n        busy: boolean;\n        error?: string;\n        seen: Set<number>;\n        options: PaywallOptions;\n        resolve: (r: PaywallResult) => void;\n        promise: Promise<PaywallResult>;\n    } | null = null;\n    const listeners = new Set<() => void>();\n    const emit = () => {\n        for (const l of [...listeners]) {\n            try {\n                l();\n            } catch {\n                // One renderer must not stop another.\n            }\n        }\n    };\n    const base = () => (run ? { paywall: run.w.id, placement: run.w.placement, variant: run.variant } : {});\n    const show = () => {\n        if (run && !run.seen.has(run.index)) {\n            run.seen.add(run.index);\n            env.track(PAYWALL_EVENT, { ...base(), page: run.pages[run.index].id, index: run.index, action: \"page\" });\n        }\n        emit();\n    };\n    const end = (r: PaywallResult) => {\n        const c = run;\n        if (!c) return;\n        run = null;\n        if (r.outcome === \"closed\") c.options.onClose?.(r);\n        c.resolve(r);\n        emit();\n    };\n    const result = (outcome: PaywallResult[\"outcome\"]): PaywallResult => ({\n        outcome,\n        index: run?.index ?? 0,\n        ...(run ? { paywall: run.w.id, variant: run.variant } : {}),\n        ...(outcome !== \"closed\" && run ? { plan: run.plans.find((p) => p.id === run!.plan) } : {}),\n    });\n\n    const buy = () => {\n        const c = run;\n        const plan = c?.plans.find((p) => p.id === c.plan);\n        if (!c || !plan || c.busy) return;\n        if (!c.options.onPurchase) return end(result(\"chosen\"));\n        c.busy = true;\n        c.error = undefined;\n        emit();\n        Promise.resolve()\n            .then(() => c.options.onPurchase?.(plan))\n            .then(\n                (ok) => {\n                    c.busy = false;\n                    if (run !== c) return;\n                    if (ok === false) return emit();\n                    env.track(PAYWALL_EVENT, { ...base(), page: c.pages[c.index].id, index: c.index, plan: plan.id, action: \"purchased\" });\n                    end(result(\"purchased\"));\n                },\n                () => {\n                    c.busy = false;\n                    c.error = t(\"The purchase did not go through. Please try again.\");\n                    emit();\n                },\n            );\n    };\n\n    return {\n        open: (placement, options = {}) => {\n            if (run) return run.promise;\n            const config = env.config();\n            const w = config?.paywalls?.find((x) => x.placement === placement);\n            const picked = w ? paywallPages(config, w, env.distinctId()) : null;\n            if (!w || !picked?.pages.length) return Promise.resolve({ outcome: \"closed\", index: 0 });\n            // The app's store prices replace MRRocket's for the same plans.\n            const own = new Map((options.plans ?? []).map((p) => [p.id, p]));\n            const plans = w.plans.map((p) => own.get(p.id) ?? p);\n            let resolve: (r: PaywallResult) => void = () => {};\n            const promise = new Promise<PaywallResult>((r) => (resolve = r));\n            const plan = plans.some((p) => p.id === w.highlight) ? w.highlight : plans[0]?.id;\n            run = { w, variant: picked.variant, pages: picked.pages, plans, index: 0, plan, busy: false, seen: new Set(), options, resolve, promise };\n            if (picked.test) env.track(\"$exposure\", { experiment: picked.test, variant: picked.variant });\n            show();\n            return promise;\n        },\n        view: () =>\n            run\n                ? {\n                      paywall: run.w,\n                      variant: run.variant,\n                      page: run.pages[run.index],\n                      index: run.index,\n                      total: run.pages.length,\n                      last: run.index === run.pages.length - 1,\n                      plans: run.plans,\n                      plan: run.plan,\n                      busy: run.busy,\n                      error: run.error,\n                  }\n                : null,\n        subscribe: (l) => {\n            listeners.add(l);\n            return () => listeners.delete(l);\n        },\n        next: () => {\n            if (!run || run.busy) return;\n            // A plans page or the last page buys; any other page goes on.\n            if (run.pages[run.index].kind === \"plans\" || run.index === run.pages.length - 1) return buy();\n            run.index++;\n            run.error = undefined;\n            show();\n        },\n        back: () => {\n            if (!run || run.busy || !run.index) return;\n            run.index--;\n            run.error = undefined;\n            emit();\n        },\n        pick: (id) => {\n            if (!run || run.busy || !run.plans.some((p) => p.id === id)) return;\n            run.plan = id;\n            run.error = undefined;\n            emit();\n        },\n        close: () => {\n            if (!run || run.busy) return;\n            env.track(PAYWALL_EVENT, { ...base(), index: run.index, action: \"closed\" });\n            end(result(\"closed\"));\n        },\n    };\n};\n"],"mappings":"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","names":[]}

package/dist/react-native/index.d.cts

@@ -61,6 +61,11 @@ interface SurveyQuestion {
     description?: string;
     required: boolean;
     options?: string[];
+    /**
+     * 0.21.0: what each option says in the visitor's language, parallel to `options`. An answer is still recorded as the
+     * `options` value, so rules and numbers do not split by language.
+     */
+    labels?: string[];
     scale?: number;
     low?: string;
     high?: string;
@@ -165,6 +170,8 @@ interface MessengerLook {
     /** A round chat button in the app (React Native) too. */
     appLauncher?: boolean;
     help: boolean;
+    /** The Updates tab with the published changelog (MRRocket from 0.22; older servers leave it out). */
+    updates?: boolean;
     sound: boolean;
     preview: boolean;
     askEmail: boolean;
@@ -185,13 +192,24 @@ interface MessengerLook {
     /** The AI agent's picture beside its answers (from 0.17). */
     agentPhoto?: string;
 }
-/** The visitor's newest chat (open or closed) and its messages. */
+/** One of the visitor's conversations in their list (0.19). */
+interface ChatSummary {
+    id: string;
+    status: "open" | "solved";
+    /** The visitor's first words. */
+    subject: string;
+    /** The newest message, its body cut to a preview. */
+    last: ChatMessage | null;
+}
+/** One chat (the one asked for, else the visitor's newest, open or closed) and its messages. */
 interface ChatThread {
     conversation: {
         id: string;
         status: "open" | "solved";
     } | null;
     messages: ChatMessage[];
+    /** All the visitor's conversations, the latest activity first (0.19). */
+    conversations?: ChatSummary[];
     /** The visitor gave an email already: the messenger stops asking. */
     hasEmail: boolean;
 }
@@ -243,10 +261,15 @@ declare const createApi: (c: Conn) => {
         completed: boolean;
         seconds: number;
     }) => Promise<unknown>;
-    chat: (signal?: AbortSignal) => Promise<ChatThread>;
-    /** A message; `attachments` are upload ids from `uploadChatFile` (then the body may be empty). */
+    /** One chat by id, else the visitor's newest; `conversations` lists them all. */
+    chat: (signal?: AbortSignal, conversation?: string) => Promise<ChatThread>;
+    /**
+     * A message; `attachments` are upload ids from `uploadChatFile` (then the body may be empty). `conversation` is
+     * the chat it answers, or "new" to start one; without it, the running chat or else a new one.
+     */
     sendChat: (m: {
         body: string;
+        conversation?: string;
         email?: string;
         url?: string;
         attachments?: string[];
@@ -303,8 +326,10 @@ interface CancelOffer {
 /** 0.15.0: a second question after an answer ("What would be a fair price?"); no answers means a free text. */
 interface CancelFollowUp {
     question: string;
-    /** The choices, in order; empty for a free text. */
+    /** The choices, in order; empty for a free text. What is recorded and what rules compare, whatever the language. */
     answers: string[];
+    /** 0.21.0: what each choice says in the visitor's language, parallel to `answers`; shown instead of them. */
+    answerLabels?: string[];
 }
 /**
  * 0.15.0: a different offer for some customers of one answer. Every condition that is set must hold; the first rule
@@ -387,11 +412,15 @@ type FlowIcon = {
 };
 /** 0.18.0: what plays when someone finishes a checklist, a tour or the questions. */
 type FinishAnimation = "none" | "confetti" | "fireworks" | "stars";
-/** 0.18.0: one question of a Questions item: one choice of 2 to 6 options, or a short text. */
+/**
+ * 0.18.0: one question of a Questions item: one choice of 2 to 6 options, or a short text. 0.21.0: a number scale, an
+ * "Other" with the person's own words, and a Skip button. An older app shows a scale as a text field, leaves "Other"
+ * out, and offers no Skip (its close button still ends the window).
+ */
 interface OnboardingQuestion {
     /** The answer's name on the contact (`onboarding.<key>`) and in "People who answered …". */
     key: string;
-    type: "choice" | "text";
+    type: "choice" | "text" | "scale";
     /** Choice: the options, in order; `id` is what is stored, `label` what people read. */
     options?: {
         id: string;
@@ -399,6 +428,19 @@ interface OnboardingQuestion {
     }[];
     /** Text: the field's hint. */
     placeholder?: string;
+    /** 0.21.0, choice: one more option where people type their own words, stored as `other:<words>`. */
+    other?: boolean;
+    /** 0.21.0: the words of that option; "Other" when unset. */
+    otherLabel?: string;
+    /** 0.21.0, scale: the lowest and highest number, and the words under both ends. */
+    min?: number;
+    max?: number;
+    lowLabel?: string;
+    highLabel?: string;
+    /** 0.21.0: people may go on without answering. */
+    optional?: boolean;
+    /** 0.21.0: the words of that button; "Skip" when unset. */
+    skipLabel?: string;
 }
 /** 0.17.0: where a tour bubble sits next to its element; "auto" (and no value) puts it below, else above, as before. */
 type TourPlacement = "auto" | "top" | "bottom" | "left" | "right";
@@ -628,6 +670,8 @@ interface FlowsController {
         startTour(stepId: string): boolean;
         open(stepId: string): boolean;
         answer(value: string): void;
+        /** 0.21.0: goes on from an optional question without an answer. */
+        skip(): void;
         back(): void;
         item(id: string): OnboardingItemState | null;
         seen(id: string): void;
@@ -782,7 +826,7 @@ interface PaywallHost {
 
 type VariantId = string;
 /** This build of the SDK. Sent with the config request so MRRocket knows what the site runs (error tracking, flags). */
-declare const SDK_VERSION = "0.18.0";
+declare const SDK_VERSION = "0.22.0";
 /** One variant of an experiment. `changes` replaces texts that the page marks with `<Text id>`. */
 interface VariantConfig {
     id: VariantId;
@@ -816,6 +860,10 @@ interface RedirectConfig {
 interface CockpitConfig {
     /** The product the public key belongs to. */
     project: string;
+    /** The language the server chose for the words below, like "de" (`lang` on the request). SDK 0.21.0+. */
+    lang?: string;
+    /** The SDK's own words: English source word to translation (see words.ts). Absent for English. SDK 0.21.0+. */
+    words?: Record<string, string>;
     experiments: ExperimentConfig[];
     /** The product's affiliate program: how many days a partner's referral is kept. Missing without a program. */
     referral?: {
@@ -983,6 +1031,11 @@ interface MRRocketOptions {
     maxQueue?: number;
     /** Log what the SDK does to the console. */
     debug?: boolean;
+    /**
+     * 0.21.0: the language of the SDK's words and of what the server answers, like "de-AT", for an app with its own
+     * language switch. Default: the phone's. `setLocale` does the same from anywhere.
+     */
+    locale?: string;
     /** Onboarding flows start on their own when the person does their trigger (default true). False: only `startOnboarding()`. */
     onboarding?: boolean;
     /**
@@ -1137,6 +1190,24 @@ interface MRRocketClient {
 /** The name of the screen a React Navigation state shows: the focused route, followed into nested navigators. */
 declare const activeRouteName: (state: unknown) => string | undefined;
 
+type OnboardingReportType = "questions" | "checklist" | "tour";
+interface OnboardingReportOptions {
+    /** Every step's id in the order people meet them, so a step only some people see keeps its place. */
+    order?: string[];
+    /** "questions" (the default), a "checklist" or a "tour". */
+    type?: OnboardingReportType;
+}
+interface OnboardingReport {
+    /** The person sees this step; `title` is its name in MRRocket. Sent once per step and page. */
+    saw(step: string, title: string): void;
+    /** The person answered a question with one of its options: its id, and its words in MRRocket. */
+    answered(question: string, answer: string, label?: string): void;
+    /** The person did this task or tour step. */
+    done(step: string): void;
+    /** The person closed it or skipped the rest, at this step if you name one. */
+    closed(step?: string): void;
+}
+
 interface UseOnboarding {
     /** The item as MRRocket published it, or null while the config is loading, or when it is not live. */
     item: OnboardingFlow | null;
@@ -1251,6 +1322,11 @@ declare const MRRocketMessenger: ({ client, appearance, options: given }: {
     options?: NativeMessengerOptions;
 }) => react.FunctionComponentElement<Record<string, unknown>> | null;
 
+/** An app with its own language switch says the language here; undefined goes back to the device's. Re-reads the config. */
+declare const setLocale: (locale?: string) => void;
+/** The app's choice, else the phone's (React Native), else the browser's. */
+declare const currentLocale: () => string | undefined;
+
 /**
  * Hides what it wraps in session recordings: its area is painted black on every frame before the frame is stored. Use
  * it for anything private on screen (balances, addresses, messages). Text fields need no wrapper: nothing is recorded
@@ -1375,6 +1451,15 @@ declare const useReview: () => {
  *     if (!item || done) return null;
  */
 declare const useOnboarding: (id?: string) => UseOnboarding;
+/**
+ * 0.22.0: for an onboarding that lives in your own code. Nothing to set up in MRRocket: the first report makes the item
+ * under Onboarding, and MRRocket shows who saw each step and what they answered. It follows the person's consent.
+ *
+ *     const report = useOnboardingReport("Welcome questions", { order: ["goal", "role"] });
+ *     report.saw("goal", "What brings you here?");
+ *     report.answered("goal", "dream", "Dream game");
+ */
+declare const useOnboardingReport: (name: string, options?: OnboardingReportOptions) => OnboardingReport;
 /** A feature flag from MRRocket › Build › Feature flags: true while it is on for this person; false while off, unknown or loading. */
 declare const useFlag: (key: string) => boolean;
 /** The variant of a multivariate flag ("control", "test" …), or null while it is off. */
@@ -1409,4 +1494,4 @@ declare const useExpoRouterTracking: () => void;
  */
 declare const useNavigationTracking: () => (state: unknown) => void;
 
-export { type AppContext, type CancelFlowConfig, type CancelFlowOptions, type CancelFlowResult, type CancelOffer, type ChatMessage, type ChatThread, type CockpitConfig, type FeedbackPost, type FinishAnimation, type FlagConfig, type FlowIcon, type FlowMedia, type FlowView, type IdentifyOptions, type InAppMessage, type KeyValueStorage, type MRRocketClient, MRRocketFeedback, MRRocketFlows, MRRocketMask, MRRocketMessenger, type MRRocketOptions, MRRocketProvider, type MRRocketProviderProps, MRRocketSurveys, type NativeAppearance, type NativeConsent, type NativeFeedbackOptions, type NativeMessengerOptions, type NativePushResult, type NativePushStatus, type NativeReviewResult, type OnboardingFlow, type OnboardingItemState, type OnboardingQuestion, type OnboardingStep, type PaywallConfig, type PaywallOptions, type PaywallPage, type PaywallPlan, type PaywallResult, type RegisterForPushOptions, SDK_VERSION, type SurveyDefinition, type TaskOpens, type TourPlacement, type UseOnboarding, type VariantId, activeRouteName, createMRRocket, getMRRocket, useCancelFlow, useExpoRouterTracking, useFeedback, useFlag, useFlagVariant, useMRRocket, useMessenger, useNavigationTracking, useOnboarding, usePaywall, usePush, useReview, useText, useVariant };
+export { type AppContext, type CancelFlowConfig, type CancelFlowOptions, type CancelFlowResult, type CancelOffer, type ChatMessage, type ChatThread, type CockpitConfig, type FeedbackPost, type FinishAnimation, type FlagConfig, type FlowIcon, type FlowMedia, type FlowView, type IdentifyOptions, type InAppMessage, type KeyValueStorage, type MRRocketClient, MRRocketFeedback, MRRocketFlows, MRRocketMask, MRRocketMessenger, type MRRocketOptions, MRRocketProvider, type MRRocketProviderProps, MRRocketSurveys, type NativeAppearance, type NativeConsent, type NativeFeedbackOptions, type NativeMessengerOptions, type NativePushResult, type NativePushStatus, type NativeReviewResult, type OnboardingFlow, type OnboardingItemState, type OnboardingQuestion, type OnboardingReport, type OnboardingReportOptions, type OnboardingReportType, type OnboardingStep, type PaywallConfig, type PaywallOptions, type PaywallPage, type PaywallPlan, type PaywallResult, type RegisterForPushOptions, SDK_VERSION, type SurveyDefinition, type TaskOpens, type TourPlacement, type UseOnboarding, type VariantId, activeRouteName, createMRRocket, currentLocale, getMRRocket, setLocale, useCancelFlow, useExpoRouterTracking, useFeedback, useFlag, useFlagVariant, useMRRocket, useMessenger, useNavigationTracking, useOnboarding, useOnboardingReport, usePaywall, usePush, useReview, useText, useVariant };