@mrrocket/sdk 0.17.0 → 0.21.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-state.d.ts

@@ -0,0 +1,23 @@
+import type { FlowsController, OnboardingFlow, OnboardingItemState } from "./flows.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;
+    /** Its steps (a tour's steps, a checklist's tasks, the questions), each with `done` (and a question's `answer`). */
+    steps: OnboardingItemState["steps"];
+    /** Every step is done. */
+    done: boolean;
+    /** The person closed it. */
+    dismissed: boolean;
+    /** Its moment has come for this person (the trigger MRRocket set, and who it is for). */
+    eligible: boolean;
+    /** Marks a step done (a tour step, a task). */
+    complete(stepId: string): void;
+    /** The person closed it; the item after it follows. */
+    dismiss(): void;
+    /** Answers a question (its step id or its key) with an option's id or a text; it is kept on the contact. */
+    answer(question: string, value: string): void;
+    /** Starts an item the SDK draws (the first live one without an id). */
+    start(id?: string): boolean;
+}
+/** The hook behind `useOnboarding` on both platforms. */
+export declare const useOnboardingItem: (flows: FlowsController | null | undefined, id: string | undefined, start: (id?: string) => boolean) => UseOnboarding;

package/dist/onboarding-state.js

@@ -0,0 +1,43 @@
+// src/onboarding-state.ts
+import { useEffect, useMemo, useState } from "react";
+var none = [];
+var useOnboardingItem = (flows, id, start) => {
+  const [state, setState] = useState(() => flows && id ? flows.onboarding.item(id) : null);
+  useEffect(() => {
+    if (!flows || !id) {
+      setState(null);
+      return;
+    }
+    const up = () => {
+      const s = flows.onboarding.item(id);
+      setState(s);
+      if (s && !s.done && !s.dismissed) flows.onboarding.seen(id);
+    };
+    up();
+    return flows.subscribe(up);
+  }, [flows, id]);
+  return useMemo(
+    () => ({
+      item: state?.item ?? null,
+      steps: state?.steps ?? none,
+      done: !!state?.done,
+      dismissed: !!state?.dismissed,
+      eligible: !!state?.eligible,
+      complete: (stepId) => {
+        if (flows && id) flows.onboarding.complete(id, stepId);
+      },
+      dismiss: () => {
+        if (flows && id) flows.onboarding.dismissItem(id);
+      },
+      answer: (question, value) => {
+        if (flows && id) flows.onboarding.answerItem(id, question, value);
+      },
+      start
+    }),
+    [state, flows, id, start]
+  );
+};
+export {
+  useOnboardingItem
+};
+//# sourceMappingURL=onboarding-state.js.map

package/dist/onboarding-state.js.map

@@ -0,0 +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":[]}

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":";AAoBA,SAA6C,cAAc;AAC3D,SAAS,SAAS;AAEX,IAAM,gBAAgB;AAmGtB,IAAM,eAAe,CAAC,QAA8B,GAAkB,eAAuB;AAChG,QAAM,IAAI,EAAE,aAAa,QAAQ,YAAY,KAAK,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,IAAI;AACnF,QAAM,KAAK,IAAI,OAAO,GAAG,UAAU,IAAI,EAAE,SAAS,CAAC,GAAG;AACtD,QAAM,IAAI,EAAE,SAAS,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC;AAC7D,SAAO,IAAI,EAAE,SAAS,EAAE,IAAI,OAAO,EAAE,OAAO,MAAM,GAAG,WAAW,aAAa,CAAC,EAAE,SAAS,EAAE,MAAM,OAAU,IAAI;AACnH;AAEO,IAAM,oBAAoB,CAAC,QAAiC;AAC/D,MAAI,MAaO;AACX,QAAM,YAAY,oBAAI,IAAgB;AACtC,QAAM,OAAO,MAAM;AACf,eAAW,KAAK,CAAC,GAAG,SAAS,GAAG;AAC5B,UAAI;AACA,UAAE;AAAA,MACN,QAAQ;AAAA,MAER;AAAA,IACJ;AAAA,EACJ;AACA,QAAM,OAAO,MAAO,MAAM,EAAE,SAAS,IAAI,EAAE,IAAI,WAAW,IAAI,EAAE,WAAW,SAAS,IAAI,QAAQ,IAAI,CAAC;AACrG,QAAM,OAAO,MAAM;AACf,QAAI,OAAO,CAAC,IAAI,KAAK,IAAI,IAAI,KAAK,GAAG;AACjC,UAAI,KAAK,IAAI,IAAI,KAAK;AACtB,UAAI,MAAM,eAAe,EAAE,GAAG,KAAK,GAAG,MAAM,IAAI,MAAM,IAAI,KAAK,EAAE,IAAI,OAAO,IAAI,OAAO,QAAQ,OAAO,CAAC;AAAA,IAC3G;AACA,SAAK;AAAA,EACT;AACA,QAAM,MAAM,CAAC,MAAqB;AAC9B,UAAM,IAAI;AACV,QAAI,CAAC,EAAG;AACR,UAAM;AACN,QAAI,EAAE,YAAY,SAAU,GAAE,QAAQ,UAAU,CAAC;AACjD,MAAE,QAAQ,CAAC;AACX,SAAK;AAAA,EACT;AACA,QAAM,SAAS,CAAC,aAAsD;AAAA,IAClE;AAAA,IACA,OAAO,KAAK,SAAS;AAAA,IACrB,GAAI,MAAM,EAAE,SAAS,IAAI,EAAE,IAAI,SAAS,IAAI,QAAQ,IAAI,CAAC;AAAA,IACzD,GAAI,YAAY,YAAY,MAAM,EAAE,MAAM,IAAI,MAAM,KAAK,CAAC,MAAM,EAAE,OAAO,IAAK,IAAI,EAAE,IAAI,CAAC;AAAA,EAC7F;AAEA,QAAM,MAAM,MAAM;AACd,UAAM,IAAI;AACV,UAAM,OAAO,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI;AACjD,QAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAM;AAC3B,QAAI,CAAC,EAAE,QAAQ,WAAY,QAAO,IAAI,OAAO,QAAQ,CAAC;AACtD,MAAE,OAAO;AACT,MAAE,QAAQ;AACV,SAAK;AACL,YAAQ,QAAQ,EACX,KAAK,MAAM,EAAE,QAAQ,aAAa,IAAI,CAAC,EACvC;AAAA,MACG,CAAC,OAAO;AACJ,UAAE,OAAO;AACT,YAAI,QAAQ,EAAG;AACf,YAAI,OAAO,MAAO,QAAO,KAAK;AAC9B,YAAI,MAAM,eAAe,EAAE,GAAG,KAAK,GAAG,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,OAAO,MAAM,KAAK,IAAI,QAAQ,YAAY,CAAC;AACrH,YAAI,OAAO,WAAW,CAAC;AAAA,MAC3B;AAAA,MACA,MAAM;AACF,UAAE,OAAO;AACT,UAAE,QAAQ,EAAE,oDAAoD;AAChE,aAAK;AAAA,MACT;AAAA,IACJ;AAAA,EACR;AAEA,SAAO;AAAA,IACH,MAAM,CAAC,WAAW,UAAU,CAAC,MAAM;AAC/B,UAAI,IAAK,QAAO,IAAI;AACpB,YAAM,SAAS,IAAI,OAAO;AAC1B,YAAM,IAAI,QAAQ,UAAU,KAAK,CAAC,MAAM,EAAE,cAAc,SAAS;AACjE,YAAM,SAAS,IAAI,aAAa,QAAQ,GAAG,IAAI,WAAW,CAAC,IAAI;AAC/D,UAAI,CAAC,KAAK,CAAC,QAAQ,MAAM,OAAQ,QAAO,QAAQ,QAAQ,EAAE,SAAS,UAAU,OAAO,EAAE,CAAC;AAEvF,YAAM,MAAM,IAAI,KAAK,QAAQ,SAAS,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC;AAC/D,YAAM,QAAQ,EAAE,MAAM,IAAI,CAAC,MAAM,IAAI,IAAI,EAAE,EAAE,KAAK,CAAC;AACnD,UAAI,UAAsC,MAAM;AAAA,MAAC;AACjD,YAAM,UAAU,IAAI,QAAuB,CAAC,MAAO,UAAU,CAAE;AAC/D,YAAM,OAAO,MAAM,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE,YAAY,MAAM,CAAC,GAAG;AAC/E,YAAM,EAAE,GAAG,SAAS,OAAO,SAAS,OAAO,OAAO,OAAO,OAAO,OAAO,GAAG,MAAM,MAAM,OAAO,MAAM,oBAAI,IAAI,GAAG,SAAS,SAAS,QAAQ;AACxI,UAAI,OAAO,KAAM,KAAI,MAAM,aAAa,EAAE,YAAY,OAAO,MAAM,SAAS,OAAO,QAAQ,CAAC;AAC5F,WAAK;AACL,aAAO;AAAA,IACX;AAAA,IACA,MAAM,MACF,MACM;AAAA,MACI,SAAS,IAAI;AAAA,MACb,SAAS,IAAI;AAAA,MACb,MAAM,IAAI,MAAM,IAAI,KAAK;AAAA,MACzB,OAAO,IAAI;AAAA,MACX,OAAO,IAAI,MAAM;AAAA,MACjB,MAAM,IAAI,UAAU,IAAI,MAAM,SAAS;AAAA,MACvC,OAAO,IAAI;AAAA,MACX,MAAM,IAAI;AAAA,MACV,MAAM,IAAI;AAAA,MACV,OAAO,IAAI;AAAA,IACf,IACA;AAAA,IACV,WAAW,CAAC,MAAM;AACd,gBAAU,IAAI,CAAC;AACf,aAAO,MAAM,UAAU,OAAO,CAAC;AAAA,IACnC;AAAA,IACA,MAAM,MAAM;AACR,UAAI,CAAC,OAAO,IAAI,KAAM;AAEtB,UAAI,IAAI,MAAM,IAAI,KAAK,EAAE,SAAS,WAAW,IAAI,UAAU,IAAI,MAAM,SAAS,EAAG,QAAO,IAAI;AAC5F,UAAI;AACJ,UAAI,QAAQ;AACZ,WAAK;AAAA,IACT;AAAA,IACA,MAAM,MAAM;AACR,UAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,MAAO;AACpC,UAAI;AACJ,UAAI,QAAQ;AACZ,WAAK;AAAA,IACT;AAAA,IACA,MAAM,CAAC,OAAO;AACV,UAAI,CAAC,OAAO,IAAI,QAAQ,CAAC,IAAI,MAAM,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,EAAG;AAC7D,UAAI,OAAO;AACX,UAAI,QAAQ;AACZ,WAAK;AAAA,IACT;AAAA,IACA,OAAO,MAAM;AACT,UAAI,CAAC,OAAO,IAAI,KAAM;AACtB,UAAI,MAAM,eAAe,EAAE,GAAG,KAAK,GAAG,OAAO,IAAI,OAAO,QAAQ,SAAS,CAAC;AAC1E,UAAI,OAAO,QAAQ,CAAC;AAAA,IACxB;AAAA,EACJ;AACJ;","names":[]}