@mrrocket/sdk 0.4.0 → 0.8.0

package/dist/flows.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/flows.ts"],"sourcesContent":["/**\n * The cancel flow, onboarding and in-app messages (SDK 0.7.0): what MRRocket's config and `GET /api/sdk/inapp` serve,\n * and one controller that decides what shows when and records what the person did. No DOM and no React: the web\n * renderer (flows-ui.ts, loaded only when something shows) and the React Native one (native/flows-view.ts) draw\n * `view()` and call the actions.\n *\n * What it records, as normal events under the SDK's analytics consent (nothing with consent \"off\"):\n * - `$cancel_flow` `{action: \"shown\" | \"answered\" | \"offer\" | \"finished\", run, version, …}`. MRRocket turns a\n *   `finished` with `outcome: \"saved\"` into a save and with `outcome: \"cancelled\"` into a cancellation on the Churn page.\n *   MRRocket never changes a subscription: an accepted offer goes to the app's `onSave`, a confirmed cancel to its\n *   `onCancel`, and only after they succeed is the outcome recorded.\n * - `$onboarding` `{flow, step?, action: \"started\" | \"shown\" | \"completed\" | \"dismissed\"}`.\n * - `$inapp` `{message, journey, action: \"shown\" | \"clicked\" | \"dismissed\"}`; the journey moves the person on.\n */\nimport type { CockpitConfig } from \"./core\";\n\nexport const CANCEL_EVENT = \"$cancel_flow\";\nexport const ONBOARDING_EVENT = \"$onboarding\";\nexport const INAPP_EVENT = \"$inapp\";\n\nexport type CancelOfferKind = \"discount\" | \"pause\" | \"downgrade\" | \"contact\";\n\n/** What one answer of the survey offers before the confirmation. An answer without one goes straight to it. */\nexport interface CancelOffer {\n    kind: CancelOfferKind;\n    headline: string;\n    /** Discount: percent off. */\n    percent?: number;\n    /** Discount: for how many months; pause: up to how many months. */\n    months?: number;\n    /** Downgrade: the plan to switch to, as MRRocket knows it from the payment provider. */\n    plan?: string;\n    planName?: string;\n}\n\n/** The product's live cancel flow (MRRocket › Churn › Cancel flow). */\nexport interface CancelFlowConfig {\n    /** Grows with every publish. */\n    version: number;\n    question: string;\n    /** The survey's answers, in order. */\n    reasons: { id: string; label: string }[];\n    /** The offer per answer id. */\n    offers: Record<string, CancelOffer>;\n    confirm: { title: string; body: string; button: string };\n    /**\n     * Who gets the survey and the offers: business customers only. Anyone else (a consumer, or a customer the app does\n     * not say) gets the plain confirmation, with nothing in the way of cancelling (§ 312k BGB).\n     */\n    offersFor: \"business\";\n}\n\nexport type OnboardingStepKind = \"tour\" | \"checklist\" | \"modal\";\n\nexport interface OnboardingStep {\n    id: string;\n    kind: OnboardingStepKind;\n    title: string;\n    body?: string;\n    button?: string;\n    /** Tour steps: the element they point at, marked `data-ck-target=\"<target>\"` in the app. Without it: a card. */\n    target?: string;\n    /** Checklist items: the event that ticks them (`track(\"<event>\")`). Without it the person ticks it themselves. */\n    event?: string;\n}\n\n/** A live onboarding flow's in-app steps (MRRocket › Conversion › Onboarding); its emails go out from MRRocket. */\nexport interface OnboardingFlow {\n    id: string;\n    name: string;\n    /** When it starts: an event's words (\"Signed up\", \"First export\"), or \"First launch\" / \"First visit\". */\n    trigger: string;\n    steps: OnboardingStep[];\n}\n\n/** An in-app message a Lifecycle journey has for this person. */\nexport interface InAppMessage {\n    id: string;\n    journey?: string;\n    title: string;\n    body?: string;\n    button?: string;\n    /** Where the button goes (http(s) or a path of the app). */\n    url?: string;\n    style: \"banner\" | \"modal\";\n}\n\n/** What `GET /api/sdk/inapp` answers for one signed-in person. */\nexport interface InAppState {\n    /** Progress per onboarding flow: the steps done and whether the person closed it. */\n    onboarding: Record<string, { done: string[]; dismissed?: boolean }>;\n    messages: InAppMessage[];\n}\n\nexport interface CancelFlowResult {\n    /** \"cancelled\": confirmed; \"saved\": took the offer; \"kept\": closed the dialog without cancelling. */\n    outcome: \"cancelled\" | \"saved\" | \"kept\";\n    reason?: string;\n    reasonLabel?: string;\n    offer?: CancelOffer;\n    /** What the customer wrote on the confirmation, if anything. */\n    comment?: string;\n    /** This run's id, the same as in the events. */\n    run: string;\n}\n\nexport interface CancelFlowOptions {\n    /**\n     * \"business\" shows the survey and the offers; anything else (the default) only the plain confirmation, so a\n     * consumer can always cancel in one step (§ 312k BGB).\n     */\n    customer?: \"business\" | \"consumer\";\n    /** The customer's current price, to show what a discount costs (`{ amount: 29, currency: \"EUR\" }`). */\n    price?: { amount: number; currency: string; interval?: \"month\" | \"year\" };\n    /** The customer confirmed: cancel the subscription in your code. Throwing keeps the dialog open with an error. */\n    onCancel?: (result: CancelFlowResult) => unknown;\n    /** The customer took an offer: apply it in your code (coupon, pause, plan change). Throwing keeps the dialog open. */\n    onSave?: (result: CancelFlowResult) => unknown;\n    /** Closed without cancelling or taking an offer. */\n    onClose?: (result: CancelFlowResult) => void;\n}\n\n/** What a renderer draws. */\nexport type FlowView =\n    | {\n          type: \"cancel\";\n          screen: \"survey\" | \"offer\" | \"confirm\";\n          flow: CancelFlowConfig;\n          /** The answer picked on the survey. */\n          reason?: string;\n          offer?: CancelOffer;\n          price?: CancelFlowOptions[\"price\"];\n          busy: boolean;\n          error?: string;\n          /** The step for the dots, 1 to `steps`. */\n          step: number;\n          steps: number;\n      }\n    | { type: \"step\"; flow: OnboardingFlow; step: OnboardingStep; index: number; total: number; last: boolean }\n    | { type: \"checklist\"; flow: OnboardingFlow; items: { step: OnboardingStep; done: boolean }[] }\n    | { type: \"message\"; message: InAppMessage };\n\nexport interface FlowsEnv {\n    /** Records an event under the SDK's consent (the normal queue). */\n    track(event: string, props?: Record<string, unknown>): void;\n    /** Whose messages and progress these are: the identify() id; undefined while nobody is signed in. */\n    personId(): string | undefined;\n    /** `GET /api/sdk/inapp` for that person; null when it fails. */\n    fetchInApp(personId: string): Promise<InAppState | null>;\n    /** Keeps onboarding progress on the device; only while the consent lets the SDK store something. */\n    storage?: () => { get(key: string): string | null | Promise<string | null>; set(key: string, value: string): void } | null;\n    /** Opens a message's link. */\n    openUrl?: (url: string) => void;\n    /** Start onboarding flows by their trigger on its own (default true). */\n    auto?: boolean;\n}\n\nexport interface FlowsController {\n    setConfig(config: CockpitConfig | null): void;\n    /** The person changed (identify, reset, consent): loads their messages and onboarding progress. */\n    refresh(): Promise<void>;\n    /** An event the app recorded: starts flows whose trigger it is and ticks checklist items. */\n    onEvent(name: string): void;\n    openCancelFlow(options?: CancelFlowOptions): Promise<CancelFlowResult>;\n    /** Starts an onboarding flow now (the first live one without an id). False when there is none to start. */\n    startOnboarding(id?: string): boolean;\n    view(): FlowView | null;\n    subscribe(listener: () => void): () => void;\n    /** `accept(comment)`: a \"Talk to us\" offer sends what the customer wrote with it. */\n    cancel: { pick(reason: string): void; next(): void; accept(comment?: string): void; decline(): void; confirm(comment?: string): void; close(): void };\n    onboarding: { next(): void; check(stepId: string): void; dismiss(): void };\n    message: { click(): void; dismiss(): void };\n}\n\n/** The plain confirmation, when the product has no live cancel flow (or MRRocket was not reachable). */\nexport const PLAIN_CANCEL: CancelFlowConfig = {\n    version: 0,\n    question: \"\",\n    reasons: [],\n    offers: {},\n    confirm: { title: \"Cancel your subscription?\", body: \"You keep access until the end of the billing period.\", button: \"Cancel subscription\" },\n    offersFor: \"business\",\n};\n\nconst FAILED = \"Something went wrong. Please try again.\";\nconst PROGRESS_KEY = \"mrrocket:onboarding\";\n\n/** `\"Signed up\"` → `signed_up`, the way MRRocket names events from words. */\nexport const eventSlug = (s: string) =>\n    s\n        .trim()\n        .toLowerCase()\n        .replace(/[^a-z0-9]+/g, \"_\")\n        .replace(/^_+|_+$/g, \"\");\n\nconst SIGNUP = new Set([\"signed_up\", \"signup\", \"sign_up\", \"registered\", \"account_created\", \"user_signed_up\"]);\n\n/** Whether recording `event` is the trigger's moment (\"Signed up\" is any of the usual signup event names). */\nexport const matchesTrigger = (trigger: string, event: string) => {\n    const t = eventSlug(trigger);\n    const e = eventSlug(event);\n    if (!t || !e) return false;\n    return t === e || (SIGNUP.has(t) && SIGNUP.has(e));\n};\n\n/** Triggers that mean \"the first time the person opens the app\": the flow starts on load until it is done. */\nexport const startsOnLoad = (trigger: string) =>\n    /^(first (launch|visit|open|session|login|sign ?in|app open)|app (opened|launched)|on load|every visit|always)?$/i.test(trigger.trim());\n\n/** A random id for one cancel flow run. */\nexport const runId = () => `cf_${Math.random().toString(36).slice(2, 10)}${Date.now().toString(36)}`;\n\n/** The money a discount leaves: `29 EUR` at 30 % → `20.30`. */\nexport const discounted = (amount: number, percent: number) => Math.round(amount * (1 - percent / 100) * 100) / 100;\n\n/** \"€20.30\" in the customer's own currency, without a library. */\nexport const money = (amount: number, currency: string) => {\n    try {\n        return new Intl.NumberFormat(undefined, { style: \"currency\", currency }).format(amount);\n    } catch {\n        return `${amount.toFixed(2)} ${currency}`;\n    }\n};\n\n/** The button of an offer. */\nexport const offerButton = (o: CancelOffer) =>\n    o.kind === \"contact\" ? \"Send to the team\" : o.kind === \"pause\" ? \"Pause instead\" : o.kind === \"downgrade\" ? \"Switch plan\" : \"Accept offer\";\n\n/** A link a message may open: http(s), or a path of the app. Nothing else (no `javascript:`). */\nexport const safeUrl = (url: string | undefined) => {\n    const u = (url ?? \"\").trim();\n    return /^https?:\\/\\//i.test(u) || /^\\/(?!\\/)/.test(u) ? u : undefined;\n};\n\ninterface Progress {\n    done: Set<string>;\n    dismissed: boolean;\n}\n\ninterface CancelRun {\n    flow: CancelFlowConfig;\n    options: CancelFlowOptions;\n    plain: boolean;\n    screen: \"survey\" | \"offer\" | \"confirm\";\n    reason?: string;\n    run: string;\n    busy: boolean;\n    error?: string;\n    resolve: (r: CancelFlowResult) => void;\n    promise: Promise<CancelFlowResult>;\n}\n\nexport const createFlows = (env: FlowsEnv): FlowsController => {\n    let config: CockpitConfig | null = null;\n    let cancel: CancelRun | null = null;\n    let active: string | null = null;\n    let messages: InAppMessage[] = [];\n    let known = false;\n    let loading: Promise<void> | null = null;\n    let loadedFor: string | undefined;\n    let progressFor: string | undefined | null = null;\n    const progress = new Map<string, Progress>();\n    const handled = new Set<string>();\n    const shown = new Set<string>();\n    const listeners = new Set<() => void>();\n    const auto = env.auto !== false;\n\n    const flows = () => config?.onboarding ?? [];\n    const flowById = (id: string | null) => (id ? flows().find((f) => f.id === id) : undefined);\n    const prog = (id: string) => {\n        let p = progress.get(id);\n        if (!p) progress.set(id, (p = { done: new Set(), dismissed: false }));\n        return p;\n    };\n    const finished = (f: OnboardingFlow) => {\n        const p = progress.get(f.id);\n        return !!p && (p.dismissed || f.steps.every((s) => p.done.has(s.id)));\n    };\n\n    const keyOf = (pid: string | undefined) => `${PROGRESS_KEY}:${pid ?? \"visitor\"}`;\n\n    const save = () => {\n        const store = env.storage?.();\n        if (!store) return;\n        const out: Record<string, { done: string[]; dismissed?: boolean }> = {};\n        for (const [id, p] of progress) out[id] = { done: [...p.done], ...(p.dismissed ? { dismissed: true } : {}) };\n        try {\n            store.set(keyOf(env.personId()), JSON.stringify(out));\n        } catch {\n            // Storage full or gone: progress stays in memory.\n        }\n    };\n\n    const merge = (state: InAppState[\"onboarding\"] | undefined) => {\n        for (const [id, s] of Object.entries(state ?? {})) {\n            const p = prog(id);\n            for (const d of s.done ?? []) p.done.add(d);\n            if (s.dismissed) p.dismissed = true;\n        }\n    };\n\n    // ---------- What shows ----------\n\n    const onboardingView = (): FlowView | null => {\n        const flow = flowById(active);\n        if (!flow) return null;\n        const p = prog(flow.id);\n        const at = flow.steps.findIndex((s) => !p.done.has(s.id));\n        if (at < 0 || p.dismissed) return null;\n        const step = flow.steps[at];\n        if (step.kind === \"checklist\") {\n            let from = at;\n            while (from > 0 && flow.steps[from - 1].kind === \"checklist\") from--;\n            let to = at;\n            while (to + 1 < flow.steps.length && flow.steps[to + 1].kind === \"checklist\") to++;\n            return { type: \"checklist\", flow, items: flow.steps.slice(from, to + 1).map((s) => ({ step: s, done: p.done.has(s.id) })) };\n        }\n        return { type: \"step\", flow, step, index: at, total: flow.steps.length, last: at === flow.steps.length - 1 };\n    };\n\n    const view = (): FlowView | null => {\n        if (cancel) {\n            const offer = cancel.reason ? cancel.flow.offers[cancel.reason] : undefined;\n            return {\n                type: \"cancel\",\n                screen: cancel.screen,\n                flow: cancel.flow,\n                reason: cancel.reason,\n                offer: cancel.screen === \"offer\" ? offer : undefined,\n                price: cancel.options.price,\n                busy: cancel.busy,\n                error: cancel.error,\n                step: cancel.plain ? 1 : cancel.screen === \"survey\" ? 1 : cancel.screen === \"offer\" ? 2 : 3,\n                steps: cancel.plain ? 1 : 3,\n            };\n        }\n        const ob = onboardingView();\n        if (ob) return ob;\n        // A flow that just ended lets the next thing show.\n        if (active) active = null;\n        const m = messages.find((x) => !handled.has(x.id));\n        return m ? { type: \"message\", message: m } : null;\n    };\n\n    /** Tells the renderers, and records what became visible (once per step or message per page load). */\n    const emit = () => {\n        const v = view();\n        if (v?.type === \"step\" && !shown.has(`s:${v.step.id}`)) {\n            shown.add(`s:${v.step.id}`);\n            env.track(ONBOARDING_EVENT, { flow: v.flow.id, step: v.step.id, kind: v.step.kind, action: \"shown\" });\n        } else if (v?.type === \"checklist\") {\n            for (const i of v.items)\n                if (!i.done && !shown.has(`s:${i.step.id}`)) {\n                    shown.add(`s:${i.step.id}`);\n                    env.track(ONBOARDING_EVENT, { flow: v.flow.id, step: i.step.id, kind: \"checklist\", action: \"shown\" });\n                }\n        } else if (v?.type === \"message\" && !shown.has(`m:${v.message.id}`)) {\n            shown.add(`m:${v.message.id}`);\n            env.track(INAPP_EVENT, { message: v.message.id, journey: v.message.journey, action: \"shown\" });\n        }\n        for (const l of [...listeners]) {\n            try {\n                l();\n            } catch {\n                // One renderer must not stop another.\n            }\n        }\n    };\n\n    const start = (flow: OnboardingFlow) => {\n        if (active === flow.id) return true;\n        if (active && flowById(active) && !finished(flowById(active)!)) return false;\n        active = flow.id;\n        env.track(ONBOARDING_EVENT, { flow: flow.id, action: \"started\" });\n        emit();\n        return true;\n    };\n\n    /** Flows whose trigger is \"the first launch\" start once their progress is known (never twice for a done flow). */\n    const autoStart = () => {\n        if (!auto || active || !known) return;\n        // Without an id or storage a \"first launch\" could not be told from any other: no automatic start then.\n        if (!env.personId() && !env.storage?.()) return;\n        const next = flows().find((f) => startsOnLoad(f.trigger) && f.steps.length && !finished(f));\n        if (next) start(next);\n    };\n\n    const refresh = () => {\n        const pid = env.personId();\n        // Another person on this device: nothing of the one before carries over.\n        if (progressFor !== null && progressFor !== pid) {\n            progress.clear();\n            handled.clear();\n            active = null;\n            loadedFor = undefined;\n        }\n        progressFor = pid;\n        const run = (async () => {\n            const store = env.storage?.();\n            if (store) {\n                try {\n                    const raw = await store.get(keyOf(pid));\n                    if (raw) merge(JSON.parse(raw) as InAppState[\"onboarding\"]);\n                } catch {\n                    // A damaged entry is ignored.\n                }\n            }\n            const wants = flows().length > 0 || !!config?.messages;\n            if (pid && wants && loadedFor !== pid) {\n                loadedFor = pid;\n                const state = await env.fetchInApp(pid).catch(() => null);\n                if (state && env.personId() === pid) {\n                    merge(state.onboarding);\n                    messages = (state.messages ?? []).filter((m) => m && m.id && m.title);\n                }\n            }\n            if (!pid) messages = [];\n            known = true;\n            autoStart();\n            emit();\n        })();\n        loading = run.finally(() => {\n            if (loading === run) loading = null;\n        });\n        return loading;\n    };\n\n    // ---------- Cancel flow ----------\n\n    const result = (c: CancelRun, outcome: CancelFlowResult[\"outcome\"], comment?: string): CancelFlowResult => {\n        const offer = c.reason ? c.flow.offers[c.reason] : undefined;\n        return {\n            outcome,\n            run: c.run,\n            ...(c.reason ? { reason: c.reason, reasonLabel: c.flow.reasons.find((r) => r.id === c.reason)?.label } : {}),\n            ...(outcome === \"saved\" && offer ? { offer } : {}),\n            ...(comment?.trim() ? { comment: comment.trim().slice(0, 500) } : {}),\n        };\n    };\n\n    const finish = (c: CancelRun, r: CancelFlowResult) => {\n        env.track(CANCEL_EVENT, {\n            action: \"finished\",\n            run: c.run,\n            version: c.flow.version,\n            outcome: r.outcome,\n            customer: c.options.customer ?? \"consumer\",\n            ...(r.reason ? { reason: r.reason } : {}),\n            ...(r.offer ? { offer: r.offer.kind } : {}),\n            ...(r.comment ? { comment: r.comment } : {}),\n        });\n        if (cancel === c) cancel = null;\n        c.resolve(r);\n        emit();\n    };\n\n    /** Runs the app's callback; the outcome is recorded only once it went through. */\n    const settle = (c: CancelRun, outcome: \"saved\" | \"cancelled\", comment?: string) => {\n        if (c.busy) return;\n        const r = result(c, outcome, comment);\n        const fn = outcome === \"saved\" ? c.options.onSave : c.options.onCancel;\n        c.busy = true;\n        c.error = undefined;\n        emit();\n        Promise.resolve()\n            .then(() => fn?.(r))\n            .then(\n                () => finish(c, r),\n                () => {\n                    c.busy = false;\n                    c.error = FAILED;\n                    emit();\n                },\n            );\n    };\n\n    const openCancelFlow = (options: CancelFlowOptions = {}) => {\n        if (cancel) return cancel.promise;\n        const flow = config?.cancelFlow ?? PLAIN_CANCEL;\n        const plain = options.customer !== \"business\" || flow.reasons.length < 2;\n        let resolve: (r: CancelFlowResult) => void = () => {};\n        const promise = new Promise<CancelFlowResult>((r) => (resolve = r));\n        const c: CancelRun = { flow, options, plain, screen: plain ? \"confirm\" : \"survey\", run: runId(), busy: false, resolve, promise };\n        cancel = c;\n        env.track(CANCEL_EVENT, { action: \"shown\", run: c.run, version: flow.version, customer: options.customer ?? \"consumer\", plain });\n        emit();\n        return promise;\n    };\n\n    const controller: FlowsController = {\n        setConfig: (c) => {\n            config = c;\n            if (active && !flowById(active)) active = null;\n            emit();\n        },\n        refresh,\n        onEvent: (name) => {\n            if (!name || name.startsWith(\"$\")) return;\n            const flow = flowById(active);\n            let ticked = false;\n            if (flow) {\n                const p = prog(flow.id);\n                for (const s of flow.steps)\n                    if (s.kind === \"checklist\" && s.event && !p.done.has(s.id) && matchesTrigger(s.event, name)) {\n                        p.done.add(s.id);\n                        ticked = true;\n                        env.track(ONBOARDING_EVENT, { flow: flow.id, step: s.id, kind: s.kind, action: \"completed\" });\n                    }\n            }\n            if (ticked) {\n                save();\n                emit();\n            }\n            // Like the first-launch start: only for someone whose progress is kept, so nobody gets a flow twice.\n            if (!auto || (!env.personId() && !env.storage?.())) return;\n            const next = flows().find((f) => f.steps.length && matchesTrigger(f.trigger, name) && !finished(f));\n            if (next) start(next);\n        },\n        openCancelFlow,\n        startOnboarding: (id) => {\n            const f = id ? flowById(id) : flows().find((x) => x.steps.length && !finished(x));\n            if (!f || !f.steps.length) return false;\n            const p = prog(f.id);\n            // Started by hand: a flow the person closed before shows again.\n            p.dismissed = false;\n            return start(f);\n        },\n        view,\n        subscribe: (l) => {\n            listeners.add(l);\n            return () => listeners.delete(l);\n        },\n        cancel: {\n            pick: (reason) => {\n                if (!cancel || cancel.busy || !cancel.flow.reasons.some((r) => r.id === reason)) return;\n                cancel.reason = reason;\n                cancel.error = undefined;\n                emit();\n            },\n            next: () => {\n                const c = cancel;\n                if (!c || c.screen !== \"survey\" || !c.reason) return;\n                env.track(CANCEL_EVENT, { action: \"answered\", run: c.run, version: c.flow.version, reason: c.reason });\n                c.screen = c.flow.offers[c.reason] ? \"offer\" : \"confirm\";\n                emit();\n            },\n            accept: (comment) => {\n                const c = cancel;\n                if (!c || c.screen !== \"offer\" || !c.reason) return;\n                const offer = c.flow.offers[c.reason];\n                if (!c.busy)\n                    env.track(CANCEL_EVENT, {\n                        action: \"offer\",\n                        run: c.run,\n                        version: c.flow.version,\n                        reason: c.reason,\n                        offer: offer?.kind,\n                        outcome: \"accepted\",\n                    });\n                settle(c, \"saved\", comment);\n            },\n            decline: () => {\n                const c = cancel;\n                if (!c || c.screen !== \"offer\" || c.busy) return;\n                env.track(CANCEL_EVENT, {\n                    action: \"offer\",\n                    run: c.run,\n                    version: c.flow.version,\n                    reason: c.reason,\n                    offer: c.reason ? c.flow.offers[c.reason]?.kind : undefined,\n                    outcome: \"declined\",\n                });\n                c.screen = \"confirm\";\n                c.error = undefined;\n                emit();\n            },\n            confirm: (comment) => {\n                const c = cancel;\n                if (!c || c.screen !== \"confirm\") return;\n                settle(c, \"cancelled\", comment);\n            },\n            close: () => {\n                const c = cancel;\n                if (!c || c.busy) return;\n                const r = result(c, \"kept\");\n                c.options.onClose?.(r);\n                finish(c, r);\n            },\n        },\n        onboarding: {\n            next: () => {\n                const v = onboardingView();\n                if (v?.type !== \"step\") return;\n                prog(v.flow.id).done.add(v.step.id);\n                env.track(ONBOARDING_EVENT, { flow: v.flow.id, step: v.step.id, kind: v.step.kind, action: \"completed\" });\n                save();\n                emit();\n            },\n            check: (stepId) => {\n                const v = onboardingView();\n                if (v?.type !== \"checklist\") return;\n                const item = v.items.find((i) => i.step.id === stepId);\n                if (!item || item.done) return;\n                prog(v.flow.id).done.add(stepId);\n                env.track(ONBOARDING_EVENT, { flow: v.flow.id, step: stepId, kind: \"checklist\", action: \"completed\" });\n                save();\n                emit();\n            },\n            dismiss: () => {\n                const v = onboardingView();\n                if (!v || (v.type !== \"step\" && v.type !== \"checklist\")) return;\n                prog(v.flow.id).dismissed = true;\n                env.track(ONBOARDING_EVENT, { flow: v.flow.id, ...(v.type === \"step\" ? { step: v.step.id } : {}), action: \"dismissed\" });\n                active = null;\n                save();\n                emit();\n            },\n        },\n        message: {\n            click: () => {\n                const v = view();\n                if (v?.type !== \"message\") return;\n                handled.add(v.message.id);\n                env.track(INAPP_EVENT, { message: v.message.id, journey: v.message.journey, action: \"clicked\" });\n                const url = safeUrl(v.message.url);\n                emit();\n                if (url) env.openUrl?.(url);\n            },\n            dismiss: () => {\n                const v = view();\n                if (v?.type !== \"message\") return;\n                handled.add(v.message.id);\n                env.track(INAPP_EVENT, { message: v.message.id, journey: v.message.journey, action: \"dismissed\" });\n                emit();\n            },\n        },\n    };\n    return controller;\n};\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -1,3 +1,6 @@
-export { type ChangelogEntry, type CockpitProviderProps, type CockpitUser, type FeedbackBoardInfo, type FeedbackBoardProps, type FeedbackComment, type FeedbackList, type FeedbackPost, type FeedbackRoadmap, type FeedbackWidgetProps, type PostStatus, type SurveyAnswer, type SurveyDefinition, type SurveyQuestion, type SurveyQuestionKind, CockpitProvider, Experiment, FeedbackBoard, FeedbackWidget, Survey, Text, WIDGET_CSS, createApi, useCockpit, useFeedback, useFlag, useFlagVariant, useStyles, useVariant, } from "./browser.js";
-export { type CockpitConfig, type CockpitEvent, type ConsentChoice, type ConsentMode, type ReplayConfig, type ErrorReport, type ExperimentConfig, type FlagCondition, type FlagConditionSet, type FlagConfig, type FlagPerson, type VariantConfig, type VariantId, EMBED_PARAM, SDK_VERSION, ID_COOKIE, PREVIEW_PARAM, SESSION_COOKIE, assign, evaluateFlag, parsePreview, previewHref, } from "./core.js";
+export { type ChangelogEntry, type CockpitProviderProps, type CockpitUser, type FeedbackBoardInfo, type FeedbackBoardProps, type FeedbackComment, type FeedbackList, type FeedbackPost, type FeedbackRoadmap, type FeedbackWidgetProps, type PostStatus, type SurveyAnswer, type SurveyDefinition, type SurveyQuestion, type SurveyQuestionKind, CockpitProvider, Experiment, FeedbackBoard, FeedbackWidget, Survey, Text, WIDGET_CSS, createApi, useCancelFlow, useCockpit, useFeedback, useFlag, useFlagVariant, usePush, useStyles, useVariant, } from "./browser.js";
+export type { PushResult, PushStatus, WebPushOptions } from "./push-web.js";
+export { type CockpitConfig, type CockpitEvent, type ConsentChoice, type ConsentMode, type ReplayConfig, type ErrorReport, type ExperimentConfig, type FlagCondition, type FlagConditionSet, type FlagConfig, type FlagPerson, type RedirectConfig, type RedirectDecision, type VariantConfig, type VariantId, EMBED_PARAM, EXPOSURE_PARAM, SDK_VERSION, ID_COOKIE, PREVIEW_PARAM, SESSION_COOKIE, assign, evaluateFlag, parsePreview, previewHref, redirectFor, } from "./core.js";
+export { type CancelFlowConfig, type CancelFlowOptions, type CancelFlowResult, type CancelOffer, type InAppMessage, type OnboardingFlow, type OnboardingStep, } from "./flows.js";
+export type { FlowsTheme } from "./flows-ui.js";
 export { type AttributionMode, type CheckoutReferral, type Referral, REFERRAL_COOKIE, getReferral, readReferralCookie, referralForCheckout, referralLink, } from "./referral.js";

package/dist/index.js

@@ -8,15 +8,18 @@ import {
   Text,
   WIDGET_CSS,
   createApi,
+  useCancelFlow,
   useCockpit,
   useFeedback,
   useFlag,
   useFlagVariant,
+  usePush,
   useStyles,
   useVariant
 } from "./browser.js";
 import {
   EMBED_PARAM,
+  EXPOSURE_PARAM,
   SDK_VERSION,
   ID_COOKIE,
   PREVIEW_PARAM,
@@ -24,7 +27,8 @@ import {
   assign,
   evaluateFlag,
   parsePreview,
-  previewHref
+  previewHref,
+  redirectFor
 } from "./core.js";
 import {
   REFERRAL_COOKIE,
@@ -36,6 +40,7 @@ import {
 export {
   CockpitProvider,
   EMBED_PARAM,
+  EXPOSURE_PARAM,
   Experiment,
   FeedbackBoard,
   FeedbackWidget,
@@ -54,12 +59,15 @@ export {
   parsePreview,
   previewHref,
   readReferralCookie,
+  redirectFor,
   referralForCheckout,
   referralLink,
+  useCancelFlow,
   useCockpit,
   useFeedback,
   useFlag,
   useFlagVariant,
+  usePush,
   useStyles,
   useVariant
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {\n    type ChangelogEntry,\n    type CockpitProviderProps,\n    type CockpitUser,\n    type FeedbackBoardInfo,\n    type FeedbackBoardProps,\n    type FeedbackComment,\n    type FeedbackList,\n    type FeedbackPost,\n    type FeedbackRoadmap,\n    type FeedbackWidgetProps,\n    type PostStatus,\n    type SurveyAnswer,\n    type SurveyDefinition,\n    type SurveyQuestion,\n    type SurveyQuestionKind,\n    CockpitProvider,\n    Experiment,\n    FeedbackBoard,\n    FeedbackWidget,\n    Survey,\n    Text,\n    WIDGET_CSS,\n    createApi,\n    useCockpit,\n    useFeedback,\n    useFlag,\n    useFlagVariant,\n    useStyles,\n    useVariant,\n} from \"./browser\";\nexport {\n    type CockpitConfig,\n    type CockpitEvent,\n    type ConsentChoice,\n    type ConsentMode,\n    type ReplayConfig,\n    type ErrorReport,\n    type ExperimentConfig,\n    type FlagCondition,\n    type FlagConditionSet,\n    type FlagConfig,\n    type FlagPerson,\n    type VariantConfig,\n    type VariantId,\n    EMBED_PARAM,\n    SDK_VERSION,\n    ID_COOKIE,\n    PREVIEW_PARAM,\n    SESSION_COOKIE,\n    assign,\n    evaluateFlag,\n    parsePreview,\n    previewHref,\n} from \"./core\";\nexport {\n    type AttributionMode,\n    type CheckoutReferral,\n    type Referral,\n    REFERRAL_COOKIE,\n    getReferral,\n    readReferralCookie,\n    referralForCheckout,\n    referralLink,\n} from \"./referral\";\n"],"mappings":";AAAA;AAAA,EAgBI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP;AAAA,EAcI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AACP;AAAA,EAII;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {\n    type ChangelogEntry,\n    type CockpitProviderProps,\n    type CockpitUser,\n    type FeedbackBoardInfo,\n    type FeedbackBoardProps,\n    type FeedbackComment,\n    type FeedbackList,\n    type FeedbackPost,\n    type FeedbackRoadmap,\n    type FeedbackWidgetProps,\n    type PostStatus,\n    type SurveyAnswer,\n    type SurveyDefinition,\n    type SurveyQuestion,\n    type SurveyQuestionKind,\n    CockpitProvider,\n    Experiment,\n    FeedbackBoard,\n    FeedbackWidget,\n    Survey,\n    Text,\n    WIDGET_CSS,\n    createApi,\n    useCancelFlow,\n    useCockpit,\n    useFeedback,\n    useFlag,\n    useFlagVariant,\n    usePush,\n    useStyles,\n    useVariant,\n} from \"./browser\";\nexport type { PushResult, PushStatus, WebPushOptions } from \"./push-web\";\nexport {\n    type CockpitConfig,\n    type CockpitEvent,\n    type ConsentChoice,\n    type ConsentMode,\n    type ReplayConfig,\n    type ErrorReport,\n    type ExperimentConfig,\n    type FlagCondition,\n    type FlagConditionSet,\n    type FlagConfig,\n    type FlagPerson,\n    type RedirectConfig,\n    type RedirectDecision,\n    type VariantConfig,\n    type VariantId,\n    EMBED_PARAM,\n    EXPOSURE_PARAM,\n    SDK_VERSION,\n    ID_COOKIE,\n    PREVIEW_PARAM,\n    SESSION_COOKIE,\n    assign,\n    evaluateFlag,\n    parsePreview,\n    previewHref,\n    redirectFor,\n} from \"./core\";\nexport {\n    type CancelFlowConfig,\n    type CancelFlowOptions,\n    type CancelFlowResult,\n    type CancelOffer,\n    type InAppMessage,\n    type OnboardingFlow,\n    type OnboardingStep,\n} from \"./flows\";\nexport type { FlowsTheme } from \"./flows-ui\";\nexport {\n    type AttributionMode,\n    type CheckoutReferral,\n    type Referral,\n    REFERRAL_COOKIE,\n    getReferral,\n    readReferralCookie,\n    referralForCheckout,\n    referralLink,\n} from \"./referral\";\n"],"mappings":";AAAA;AAAA,EAgBI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AAEP;AAAA,EAgBI;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;AAWP;AAAA,EAII;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACG;","names":[]}

package/dist/proxy.d.ts

@@ -1,3 +1,5 @@
+import { type CockpitConfig } from "./core.js";
+export { getCockpitConfig } from "./server.js";
 /** What `request.cookies` (Next's `RequestCookies`) offers: read, and set so that the page of this request sees the id. */
 interface IncomingCookies {
     get(name: string): {
@@ -25,4 +27,35 @@ interface OutgoingCookies {
  *   }
  */
 export declare const withCockpitId: (incoming: IncomingCookies, outgoing: OutgoingCookies) => void;
-export {};
+/**
+ * For `proxy.ts`: where to send this request, or null to render it. Page redirects set in MRRocket (Landing pages ›
+ * Redirect) and redirect tests (Experiments) answer before the page renders, so nobody sees the old page flash. The
+ * page the visitor lands on records the test's exposure (`<CockpitProvider>` reads `ck_x` there); control renders as
+ * usual and the provider records it.
+ *
+ * A running test needs a stable visitor id to keep each person in one variant: the `ck_id` cookie (consent "cookies",
+ * with `withCockpitId` before this), or your signed-in user id as `distinctId`. Without either, the test is left to the
+ * browser (the provider redirects after the first paint); page redirects and shipped winners still answer here.
+ *
+ *   import { NextResponse, type NextRequest } from "next/server";
+ *   import { experimentRedirect, getCockpitConfig } from "@mrrocket/sdk/next/proxy";
+ *
+ *   export async function proxy(request: NextRequest) {
+ *       const to = experimentRedirect(request, await getCockpitConfig({ timeoutMs: 800 }));
+ *       return to ? NextResponse.redirect(to, 307) : NextResponse.next();
+ *   }
+ *   export const config = { matcher: ["/pricing", "/old-pricing"] };
+ *
+ * Keep the matcher to the pages with a redirect or a test: each matched request waits for the config (at most
+ * `timeoutMs`; MRRocket unreachable means no redirect).
+ */
+export declare const experimentRedirect: (request: {
+    url: string;
+    cookies?: {
+        get(name: string): {
+            value: string;
+        } | undefined;
+    };
+}, config: CockpitConfig | null, options?: {
+    distinctId?: string;
+}) => string | null;

package/dist/proxy.js

@@ -1,12 +1,25 @@
 // src/proxy.ts
-import { ID_COOKIE, newDistinctId } from "./core.js";
+import { ID_COOKIE, PREVIEW_PARAM, newDistinctId, parsePreview, redirectFor } from "./core.js";
+import { getCockpitConfig } from "./server.js";
 var withCockpitId = (incoming, outgoing) => {
   if (incoming.get(ID_COOKIE)) return;
   const id = newDistinctId();
   incoming.set(ID_COOKIE, id);
   outgoing.set(ID_COOKIE, id, { path: "/", maxAge: 60 * 60 * 24 * 365, sameSite: "lax" });
 };
+var experimentRedirect = (request, config, options = {}) => {
+  const id = options.distinctId ?? request.cookies?.get(ID_COOKIE)?.value ?? null;
+  let preview = {};
+  try {
+    preview = parsePreview(new URL(request.url).searchParams.get(PREVIEW_PARAM));
+  } catch {
+    return null;
+  }
+  return redirectFor(config, request.url, id, preview)?.to ?? null;
+};
 export {
+  experimentRedirect,
+  getCockpitConfig,
   withCockpitId
 };
 //# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/proxy.ts"],"sourcesContent":["import { ID_COOKIE, newDistinctId } from \"./core\";\n\n/** What `request.cookies` (Next's `RequestCookies`) offers: read, and set so that the page of this request sees the id. */\ninterface IncomingCookies {\n    get(name: string): { value: string } | undefined;\n    set(name: string, value: string): unknown;\n}\n\n/** What `response.cookies` (Next's `ResponseCookies`) offers: set with options. */\ninterface OutgoingCookies {\n    set(name: string, value: string, options?: { path?: string; maxAge?: number; sameSite?: \"lax\" | \"strict\" | \"none\" }): unknown;\n}\n\n/**\n * For `proxy.ts`: gives a first-time visitor their `ck_id` before the page renders, so the server already assigns\n * the variant they will keep. It writes a cookie, so only use it with `consent=\"cookies\"` and only once the visitor\n * agreed; in the default cookieless mode leave it out.\n *\n *   export function proxy(request: NextRequest) {\n *       const response = NextResponse.next();\n *       withCockpitId(request.cookies, response.cookies);\n *       return response;\n *   }\n */\nexport const withCockpitId = (incoming: IncomingCookies, outgoing: OutgoingCookies) => {\n    if (incoming.get(ID_COOKIE)) return;\n    const id = newDistinctId();\n    incoming.set(ID_COOKIE, id);\n    outgoing.set(ID_COOKIE, id, { path: \"/\", maxAge: 60 * 60 * 24 * 365, sameSite: \"lax\" });\n};\n"],"mappings":";AAAA,SAAS,WAAW,qBAAqB;AAwBlC,IAAM,gBAAgB,CAAC,UAA2B,aAA8B;AACnF,MAAI,SAAS,IAAI,SAAS,EAAG;AAC7B,QAAM,KAAK,cAAc;AACzB,WAAS,IAAI,WAAW,EAAE;AAC1B,WAAS,IAAI,WAAW,IAAI,EAAE,MAAM,KAAK,QAAQ,KAAK,KAAK,KAAK,KAAK,UAAU,MAAM,CAAC;AAC1F;","names":[]}
+{"version":3,"sources":["../src/proxy.ts"],"sourcesContent":["import { type CockpitConfig, ID_COOKIE, PREVIEW_PARAM, newDistinctId, parsePreview, redirectFor } from \"./core\";\n\nexport { getCockpitConfig } from \"./server\";\n\n/** What `request.cookies` (Next's `RequestCookies`) offers: read, and set so that the page of this request sees the id. */\ninterface IncomingCookies {\n    get(name: string): { value: string } | undefined;\n    set(name: string, value: string): unknown;\n}\n\n/** What `response.cookies` (Next's `ResponseCookies`) offers: set with options. */\ninterface OutgoingCookies {\n    set(name: string, value: string, options?: { path?: string; maxAge?: number; sameSite?: \"lax\" | \"strict\" | \"none\" }): unknown;\n}\n\n/**\n * For `proxy.ts`: gives a first-time visitor their `ck_id` before the page renders, so the server already assigns\n * the variant they will keep. It writes a cookie, so only use it with `consent=\"cookies\"` and only once the visitor\n * agreed; in the default cookieless mode leave it out.\n *\n *   export function proxy(request: NextRequest) {\n *       const response = NextResponse.next();\n *       withCockpitId(request.cookies, response.cookies);\n *       return response;\n *   }\n */\nexport const withCockpitId = (incoming: IncomingCookies, outgoing: OutgoingCookies) => {\n    if (incoming.get(ID_COOKIE)) return;\n    const id = newDistinctId();\n    incoming.set(ID_COOKIE, id);\n    outgoing.set(ID_COOKIE, id, { path: \"/\", maxAge: 60 * 60 * 24 * 365, sameSite: \"lax\" });\n};\n\n/**\n * For `proxy.ts`: where to send this request, or null to render it. Page redirects set in MRRocket (Landing pages ›\n * Redirect) and redirect tests (Experiments) answer before the page renders, so nobody sees the old page flash. The\n * page the visitor lands on records the test's exposure (`<CockpitProvider>` reads `ck_x` there); control renders as\n * usual and the provider records it.\n *\n * A running test needs a stable visitor id to keep each person in one variant: the `ck_id` cookie (consent \"cookies\",\n * with `withCockpitId` before this), or your signed-in user id as `distinctId`. Without either, the test is left to the\n * browser (the provider redirects after the first paint); page redirects and shipped winners still answer here.\n *\n *   import { NextResponse, type NextRequest } from \"next/server\";\n *   import { experimentRedirect, getCockpitConfig } from \"@mrrocket/sdk/next/proxy\";\n *\n *   export async function proxy(request: NextRequest) {\n *       const to = experimentRedirect(request, await getCockpitConfig({ timeoutMs: 800 }));\n *       return to ? NextResponse.redirect(to, 307) : NextResponse.next();\n *   }\n *   export const config = { matcher: [\"/pricing\", \"/old-pricing\"] };\n *\n * Keep the matcher to the pages with a redirect or a test: each matched request waits for the config (at most\n * `timeoutMs`; MRRocket unreachable means no redirect).\n */\nexport const experimentRedirect = (\n    request: { url: string; cookies?: { get(name: string): { value: string } | undefined } },\n    config: CockpitConfig | null,\n    options: { distinctId?: string } = {},\n): string | null => {\n    const id = options.distinctId ?? request.cookies?.get(ID_COOKIE)?.value ?? null;\n    let preview = {};\n    try {\n        preview = parsePreview(new URL(request.url).searchParams.get(PREVIEW_PARAM));\n    } catch {\n        return null;\n    }\n    return redirectFor(config, request.url, id, preview)?.to ?? null;\n};\n"],"mappings":";AAAA,SAA6B,WAAW,eAAe,eAAe,cAAc,mBAAmB;AAEvG,SAAS,wBAAwB;AAwB1B,IAAM,gBAAgB,CAAC,UAA2B,aAA8B;AACnF,MAAI,SAAS,IAAI,SAAS,EAAG;AAC7B,QAAM,KAAK,cAAc;AACzB,WAAS,IAAI,WAAW,EAAE;AAC1B,WAAS,IAAI,WAAW,IAAI,EAAE,MAAM,KAAK,QAAQ,KAAK,KAAK,KAAK,KAAK,UAAU,MAAM,CAAC;AAC1F;AAwBO,IAAM,qBAAqB,CAC9B,SACA,QACA,UAAmC,CAAC,MACpB;AAChB,QAAM,KAAK,QAAQ,cAAc,QAAQ,SAAS,IAAI,SAAS,GAAG,SAAS;AAC3E,MAAI,UAAU,CAAC;AACf,MAAI;AACA,cAAU,aAAa,IAAI,IAAI,QAAQ,GAAG,EAAE,aAAa,IAAI,aAAa,CAAC;AAAA,EAC/E,QAAQ;AACJ,WAAO;AAAA,EACX;AACA,SAAO,YAAY,QAAQ,QAAQ,KAAK,IAAI,OAAO,GAAG,MAAM;AAChE;","names":[]}

package/dist/push-web.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Web push in the browser (SDK 0.7.0): signs the signed-in person up for push notifications from the product's Lifecycle
+ * journeys. Loaded only when the site calls `push.subscribe()` (a dynamic import in Next.js, `sdk-push.js` for the script
+ * tag), so pages that never ask carry none of it.
+ *
+ * 1. The browser's permission (asked only from a click, and only when the site says so; `ask: false` only re-sends an
+ *    existing subscription).
+ * 2. The service worker the site hosts (`/mrrocket-sw.js`, a copy of the file MRRocket serves), registered with the
+ *    public key and MRRocket's address in its URL, so it can report opened notifications. A site with its own service
+ *    worker imports ours there and passes `serviceWorker: false`.
+ * 3. The workspace's VAPID key from `GET /api/sdk/push`, the browser's subscription with it, and the subscription sent to
+ *    `POST /api/sdk/push` for this person. A subscription made with another key is replaced.
+ */
+export type PushStatus = "subscribed" | "denied" | "not-asked" | "unsupported" | "not-signed-in" | "error";
+export interface PushResult {
+    status: PushStatus;
+    /** What went wrong, for "error" and "unsupported". */
+    reason?: string;
+}
+export interface WebPushOptions {
+    /**
+     * The service worker's path on your site (default "/mrrocket-sw.js"), or false when your site already has one that
+     * imports ours (`importScripts("/mrrocket-sw.js")`): the SDK then uses the one that is active.
+     */
+    serviceWorker?: string | false;
+    /** Ask for the permission when it was not given yet (default true). False: only re-send an existing subscription. */
+    ask?: boolean;
+}
+export interface WebPushContext {
+    host: string;
+    apiKey: string;
+    /** The identify() id; push needs a signed-in person. */
+    distinctId: string | undefined;
+    /** The permission, asked synchronously by the caller inside the click (Safari needs that), or the current one. */
+    permission?: Promise<NotificationPermission>;
+}
+/** True where the browser can receive web push (Safari 16.4+ only for sites added to the Home Screen on iOS). */
+export declare const webPushSupported: () => boolean;
+/** The permission, asked right away when `ask` and not given yet. Call it synchronously in the click handler. */
+export declare const askPermission: (ask?: boolean) => Promise<NotificationPermission>;
+export declare const subscribeWebPush: (ctx: WebPushContext, options?: WebPushOptions) => Promise<PushResult>;
+/** Ends this browser's subscription and tells MRRocket (sign-out, or the person turned push off). */
+export declare const unsubscribeWebPush: (ctx: WebPushContext) => Promise<boolean>;

package/dist/push-web.js

@@ -0,0 +1,81 @@
+// src/push-web.ts
+var b64urlBytes = (s) => {
+  const bin = atob(s.replace(/-/g, "+").replace(/_/g, "/").padEnd(Math.ceil(s.length / 4) * 4, "="));
+  const out = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
+  return out;
+};
+var sameKey = (a, b) => {
+  if (!a) return false;
+  const x = new Uint8Array(a);
+  return x.length === b.length && x.every((v, i) => v === b[i]);
+};
+var webPushSupported = () => typeof window !== "undefined" && "serviceWorker" in navigator && "PushManager" in window && "Notification" in window;
+var askPermission = (ask = true) => {
+  if (!webPushSupported()) return Promise.resolve("denied");
+  if (Notification.permission !== "default" || !ask) return Promise.resolve(Notification.permission);
+  try {
+    return Promise.resolve(Notification.requestPermission());
+  } catch {
+    return Promise.resolve("denied");
+  }
+};
+var registration = async (host, apiKey, sw) => {
+  if (sw !== false) {
+    const url = `${sw}?key=${encodeURIComponent(apiKey)}&host=${encodeURIComponent(host)}`;
+    await navigator.serviceWorker.register(url);
+  }
+  return navigator.serviceWorker.ready;
+};
+var subscribeWebPush = async (ctx, options = {}) => {
+  if (!webPushSupported()) return { status: "unsupported", reason: "This browser has no web push." };
+  if (!ctx.distinctId) return { status: "not-signed-in" };
+  const ask = options.ask !== false;
+  const permission = await (ctx.permission ?? askPermission(ask));
+  if (permission === "denied") return { status: "denied" };
+  if (permission !== "granted") return { status: ask ? "denied" : "not-asked" };
+  try {
+    const r = await fetch(`${ctx.host}/api/sdk/push?key=${encodeURIComponent(ctx.apiKey)}`);
+    const vapid = r.ok ? (await r.json()).web?.vapidKey : void 0;
+    if (!vapid) return { status: "error", reason: `MRRocket answered ${r.status} for the push key.` };
+    const key = b64urlBytes(vapid);
+    const reg = await registration(ctx.host, ctx.apiKey, options.serviceWorker ?? "/mrrocket-sw.js");
+    let sub = await reg.pushManager.getSubscription();
+    if (sub && !sameKey(sub.options?.applicationServerKey, key)) {
+      await sub.unsubscribe().catch(() => false);
+      sub = null;
+    }
+    sub ??= await reg.pushManager.subscribe({ userVisibleOnly: true, applicationServerKey: key });
+    const saved = await fetch(`${ctx.host}/api/sdk/push`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ key: ctx.apiKey, distinctId: ctx.distinctId, platform: "web", subscription: sub.toJSON(), host: ctx.host })
+    });
+    return saved.ok ? { status: "subscribed" } : { status: "error", reason: `MRRocket answered ${saved.status}.` };
+  } catch (e) {
+    return { status: "error", reason: e instanceof Error ? e.message : String(e) };
+  }
+};
+var unsubscribeWebPush = async (ctx) => {
+  if (!webPushSupported()) return false;
+  try {
+    const reg = await navigator.serviceWorker.getRegistration();
+    const sub = await reg?.pushManager.getSubscription();
+    if (!sub) return false;
+    await fetch(`${ctx.host}/api/sdk/push`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ key: ctx.apiKey, distinctId: ctx.distinctId, platform: "web", remove: true, endpoint: sub.endpoint })
+    }).catch(() => null);
+    return await sub.unsubscribe();
+  } catch {
+    return false;
+  }
+};
+export {
+  askPermission,
+  subscribeWebPush,
+  unsubscribeWebPush,
+  webPushSupported
+};
+//# sourceMappingURL=push-web.js.map

package/dist/push-web.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/push-web.ts"],"sourcesContent":["/**\n * Web push in the browser (SDK 0.7.0): signs the signed-in person up for push notifications from the product's Lifecycle\n * journeys. Loaded only when the site calls `push.subscribe()` (a dynamic import in Next.js, `sdk-push.js` for the script\n * tag), so pages that never ask carry none of it.\n *\n * 1. The browser's permission (asked only from a click, and only when the site says so; `ask: false` only re-sends an\n *    existing subscription).\n * 2. The service worker the site hosts (`/mrrocket-sw.js`, a copy of the file MRRocket serves), registered with the\n *    public key and MRRocket's address in its URL, so it can report opened notifications. A site with its own service\n *    worker imports ours there and passes `serviceWorker: false`.\n * 3. The workspace's VAPID key from `GET /api/sdk/push`, the browser's subscription with it, and the subscription sent to\n *    `POST /api/sdk/push` for this person. A subscription made with another key is replaced.\n */\nexport type PushStatus = \"subscribed\" | \"denied\" | \"not-asked\" | \"unsupported\" | \"not-signed-in\" | \"error\";\n\nexport interface PushResult {\n    status: PushStatus;\n    /** What went wrong, for \"error\" and \"unsupported\". */\n    reason?: string;\n}\n\nexport interface WebPushOptions {\n    /**\n     * The service worker's path on your site (default \"/mrrocket-sw.js\"), or false when your site already has one that\n     * imports ours (`importScripts(\"/mrrocket-sw.js\")`): the SDK then uses the one that is active.\n     */\n    serviceWorker?: string | false;\n    /** Ask for the permission when it was not given yet (default true). False: only re-send an existing subscription. */\n    ask?: boolean;\n}\n\nexport interface WebPushContext {\n    host: string;\n    apiKey: string;\n    /** The identify() id; push needs a signed-in person. */\n    distinctId: string | undefined;\n    /** The permission, asked synchronously by the caller inside the click (Safari needs that), or the current one. */\n    permission?: Promise<NotificationPermission>;\n}\n\nconst b64urlBytes = (s: string) => {\n    const bin = atob(s.replace(/-/g, \"+\").replace(/_/g, \"/\").padEnd(Math.ceil(s.length / 4) * 4, \"=\"));\n    const out = new Uint8Array(bin.length);\n    for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);\n    return out;\n};\n\nconst sameKey = (a: ArrayBuffer | null | undefined, b: Uint8Array) => {\n    if (!a) return false;\n    const x = new Uint8Array(a);\n    return x.length === b.length && x.every((v, i) => v === b[i]);\n};\n\n/** True where the browser can receive web push (Safari 16.4+ only for sites added to the Home Screen on iOS). */\nexport const webPushSupported = () =>\n    typeof window !== \"undefined\" && \"serviceWorker\" in navigator && \"PushManager\" in window && \"Notification\" in window;\n\n/** The permission, asked right away when `ask` and not given yet. Call it synchronously in the click handler. */\nexport const askPermission = (ask = true): Promise<NotificationPermission> => {\n    if (!webPushSupported()) return Promise.resolve(\"denied\");\n    if (Notification.permission !== \"default\" || !ask) return Promise.resolve(Notification.permission);\n    try {\n        return Promise.resolve(Notification.requestPermission());\n    } catch {\n        return Promise.resolve(\"denied\");\n    }\n};\n\nconst registration = async (host: string, apiKey: string, sw: string | false) => {\n    if (sw !== false) {\n        const url = `${sw}?key=${encodeURIComponent(apiKey)}&host=${encodeURIComponent(host)}`;\n        await navigator.serviceWorker.register(url);\n    }\n    return navigator.serviceWorker.ready;\n};\n\nexport const subscribeWebPush = async (ctx: WebPushContext, options: WebPushOptions = {}): Promise<PushResult> => {\n    if (!webPushSupported()) return { status: \"unsupported\", reason: \"This browser has no web push.\" };\n    if (!ctx.distinctId) return { status: \"not-signed-in\" };\n    const ask = options.ask !== false;\n    const permission = await (ctx.permission ?? askPermission(ask));\n    if (permission === \"denied\") return { status: \"denied\" };\n    if (permission !== \"granted\") return { status: ask ? \"denied\" : \"not-asked\" };\n    try {\n        const r = await fetch(`${ctx.host}/api/sdk/push?key=${encodeURIComponent(ctx.apiKey)}`);\n        const vapid = r.ok ? ((await r.json()) as { web?: { vapidKey?: string } }).web?.vapidKey : undefined;\n        if (!vapid) return { status: \"error\", reason: `MRRocket answered ${r.status} for the push key.` };\n        const key = b64urlBytes(vapid);\n        const reg = await registration(ctx.host, ctx.apiKey, options.serviceWorker ?? \"/mrrocket-sw.js\");\n        let sub = await reg.pushManager.getSubscription();\n        if (sub && !sameKey(sub.options?.applicationServerKey, key)) {\n            await sub.unsubscribe().catch(() => false);\n            sub = null;\n        }\n        sub ??= await reg.pushManager.subscribe({ userVisibleOnly: true, applicationServerKey: key });\n        const saved = await fetch(`${ctx.host}/api/sdk/push`, {\n            method: \"POST\",\n            headers: { \"content-type\": \"application/json\" },\n            body: JSON.stringify({ key: ctx.apiKey, distinctId: ctx.distinctId, platform: \"web\", subscription: sub.toJSON(), host: ctx.host }),\n        });\n        return saved.ok ? { status: \"subscribed\" } : { status: \"error\", reason: `MRRocket answered ${saved.status}.` };\n    } catch (e) {\n        return { status: \"error\", reason: e instanceof Error ? e.message : String(e) };\n    }\n};\n\n/** Ends this browser's subscription and tells MRRocket (sign-out, or the person turned push off). */\nexport const unsubscribeWebPush = async (ctx: WebPushContext): Promise<boolean> => {\n    if (!webPushSupported()) return false;\n    try {\n        const reg = await navigator.serviceWorker.getRegistration();\n        const sub = await reg?.pushManager.getSubscription();\n        if (!sub) return false;\n        await fetch(`${ctx.host}/api/sdk/push`, {\n            method: \"POST\",\n            headers: { \"content-type\": \"application/json\" },\n            body: JSON.stringify({ key: ctx.apiKey, distinctId: ctx.distinctId, platform: \"web\", remove: true, endpoint: sub.endpoint }),\n        }).catch(() => null);\n        return await sub.unsubscribe();\n    } catch {\n        return false;\n    }\n};\n"],"mappings":"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","names":[]}