@mrrocket/sdk 0.4.0 → 0.9.0

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 All notable changes to this package. It follows semantic versioning; before 1.0 a minor version may change an API.
 
+## 0.9.0
+
+- **Messenger, after Featurebase's:** `<Messenger />` (Next.js / React), the script tag (`data-messenger="true"`) and React Native (`<MRRocketProvider messenger={{ launcher: true }}>`, `useMessenger()`) show a chat bubble with three tabs: **Home** (greeting, the latest chat, help search, top articles), **Messages** (the chat with your team; it lands in MRRocket › Support, answered by you or the Customer experience agent) and **Help** (your published help articles from Support › Help center, by collection, searchable, read in the panel with "Did this answer your question?"). An answer that drew on an article links it.
+- **New answers while closed:** a short sound (web, Web Audio; `sound={false}`), a count on the bubble and a preview card above it (`preview={false}`); in apps a banner at the top and a light haptic with the optional `expo-haptics`. While the visitor waits for an answer the messenger checks every 8 seconds for ten minutes, then every 30 seconds; with the panel open every 4 seconds.
+- One messenger for the web: plain DOM in `messenger-ui.ts`, loaded with a dynamic import by `<Messenger />` and as a fifth file `sdk-messenger.js` by the script tag (`data-messenger-title`, `-greeting`, `-label`, `-position`, and "false" for `-help`, `-sound`, `-preview`, `-ask-email`; `mrrocket.messenger.open()` / `close()` / `toggle()`). `open()` takes `"home"`, `"messages"`, `"help"` or `{ article: id }`. New props `launcher`, `help`, `sound`, `preview`.
+- **React Native:** the survey (shown a few seconds after start; `surveys={false}`), the feedback sheet (`useFeedback().open()`: top requests with votes, suggest one) and the messenger, drawn by `MRRocketProvider` like the flows. New on the client: `api()`, `getUser()`, `isSurveyDone()` / `markSurveyDone()` (kept on the device with "persistent" consent). Optional peer `expo-haptics`.
+- API: `GET /api/sdk/articles?key&q`, `GET /api/sdk/articles/:id` (blocks, never HTML), `POST /api/sdk/articles/:id/rate`; `GET` / `POST /api/sdk/messages`. `createApi(...)` gained `articles(q)`, `article(id)`, `rateArticle(id, helpful)`, `chat()`, `sendChat({ body, email })`; chat messages may carry `articles`. The fetch client (`api-client`) and the stylesheet (`styles-css`) no longer import React.
+- **Look from MRRocket:** color, light or dark, side, title, greeting, button text and which parts show come from MRRocket › Support › Messenger (`GET /api/sdk/messenger`), so they change without new code; what the site's code passes still wins. The launcher waits up to 2.5 seconds for them.
+- **Tap heatmaps in apps:** `MRRocketProvider` sends taps as `$click` on the current screen (and `$rageclick` on three quick taps on one spot), so app screens show in Heatmaps like pages; the provider then wraps the app in one `View` with `flex: 1` (`heatmaps={false}` leaves it as it is). New `client.tap(x, y)` and option `heatmaps`.
+- **Session recordings in apps:** with the person's consent (`replay` on `MRRocketProvider`, `setReplay(true)`) and the product's recordings on, the app sends a small JPEG of the screen about once a second while it changes (optional peer `react-native-view-shot`), with screens, taps, rage taps and errors on the timeline; MRRocket plays them in Sessions. No frame while the keyboard is open; views wrapped in `<MRRocketMask>` are painted black on the server before a frame is stored, and a frame whose masks cannot be measured is not taken. Sampled like the web; other sessions keep the last minute in memory and upload it on a rage tap or an error. At most 30 minutes per recording.
+- `RageDetector` moved to its own module (`rage.ts`) so the apps share it.
+- Version reported in event batches: `0.9.0`.
+
+## 0.8.0
+
+- **Texts in React Native:** `useText(id, fallback)` and `client.getText(id, fallback)` / `client.peekText(id)` / `client.exposeText(id)` return the copy published in MRRocket for `id` with the person's variant of a running text test on top, the same rules as `<Text id>` on the web (`textChanges`). Paywall copy (`paywall.<placement>.headline`, `.body`, `.cta`) and text A/B tests now work in apps; showing a text records `$exposure` for every test that changes it, once per screen. Works from the cached config on a cold start.
+- Version reported in event batches: `0.8.0`.
+
+## 0.7.0
+
+- **Cancel flow:** `useCancelFlow().open({ customer, price, onCancel, onSave, onClose })` (Next.js and React Native), `mrrocket.cancelFlow.open(…)` (script tag) show the flow built in MRRocket › Churn › Cancel flow from the config's new `cancelFlow`: business customers get the survey and the offer for their answer (discount, pause, downgrade, talk to us), anyone else the plain confirmation (§ 312k BGB); without a live flow the plain confirmation, so the Cancel button always works. Resolves with `{ outcome: "cancelled" | "saved" | "kept", reason, offer, comment, run }`. MRRocket never changes a subscription: your `onCancel` / `onSave` do, and only after they succeed is the outcome recorded (`$cancel_flow`); MRRocket shows it under Churn as a cancellation or a save.
+- **Onboarding:** the tour, checklist and modal steps of live onboarding flows (config `onboarding`) start on their own when the signed-in person (or a visitor with `consent="cookies"`) does the trigger (`track("Signed up")`, the first page for "First launch"), once per person; `startOnboarding()` starts one by hand, `onboarding={false}` switches the automatic start off. Tour steps point at `data-ck-target` elements on the web; checklist items tick themselves on their event. Progress comes back from MRRocket for signed-in people (`GET /api/sdk/inapp`) and records as `$onboarding`.
+- **In-app messages:** journey steps of the kind "In-app message" show to the signed-in person as a banner or a dialog (`$inapp` shown, clicked, dismissed); the journey moves them on.
+- **Look:** `appearance={{ theme, accent, className }}`, CSS variables `--ckf-*` on `.ckf-root`; script tag `data-theme`, `data-accent`. The web dialogs load lazily (a dynamic import; `sdk-flows.js` for the script tag).
+- React Native: `MRRocketProvider` draws them (`flows={false}` to opt out), new `useCancelFlow`, `useOnboarding`, `MRRocketFlows`, `client.openCancelFlow`, `client.startOnboarding`, `client.flows`.
+- **Push notifications** for Lifecycle journeys' push steps. React Native and Expo: `usePush().register()` / `client.registerForPush({ ask, projectId })` after `identify` asks the permission, gets the Expo push token (`expo-notifications`, new optional peer dependency with `expo-constants`) and sends it to `POST /api/sdk/push`; `reset()` takes the token back; opens of MRRocket notifications record `$push {action: "opened"}` and open the step's link when it has a scheme. Web: `usePush().subscribe()` (Next.js), `mrrocket.push.subscribe()` (script tag) asks the permission from the click, registers the service worker the site hosts (`/mrrocket-sw.js`, built as `dist/browser/mrrocket-sw.js`; `serviceWorker: false` for sites that import it into their own) and sends the subscription made with the workspace's VAPID key (`GET /api/sdk/push`); `unsubscribe()` on sign-out. The sign-up code loads lazily (a dynamic import; `sdk-push.js` for the script tag).
+- **Redirects:** the config's `redirects` (page redirects) and redirect tests (an experiment with `path`, variants with `url`) send the visitor on before the page shows, keeping the query and hash; a running test adds `ck_x=<test>:<variant>`, and the page it lands on records the exposure and drops the parameter. New `redirectFor`, `exposureFrom`, `EXPOSURE_PARAM`; `experimentRedirect(request, config, { distinctId })` and a re-exported `getCockpitConfig` in `@mrrocket/sdk/next/proxy` redirect in `proxy.ts` before the page renders. The script tag removes the `ck-hide` class from `<html>` once it decided (the optional anti-flicker snippet).
+- Version reported in event batches: `0.7.0`.
+
+## 0.6.0
+
+- **Feedback board after Featurebase:** `<FeedbackBoard>` gets a top bar with your product's logo and name (from MRRocket), Feedback · Roadmap · Changelog, search, a light/dark toggle and "Submit feedback"; post cards with type chip, excerpt, author and votes; the Roadmap has four columns, Backlog (under consideration), Next up, In progress and Done; a post page with comments, upvote and status; Changelog with dates beside the entries; the submit form and dialogs rise as a sheet on phones, the roadmap scrolls column by column. New props `header` (default true; `false` keeps the old plain heading), `syncUrl` (`?view=` and `?post=` in the address, so a post can be linked), `fullPage` and `initialTab`.
+- **Who posts:** a visitor gives a name and email once before posting, voting or commenting; the board keeps them for this site in localStorage (`ckw-board-who:<key>`) so their votes stay theirs. A visitor your app called `identify()` for with a name or email is not asked. Others see "First L.". The floating widget asks the same way.
+- API: posts carry `author`; the list carries `product` ({ name, logo }); the roadmap carries a `review` column; `createApi(...).post(id)` reads one post. Older servers still work (the new fields are optional).
+- Fix: primary buttons, the floating button and tabs keep their own colors on pages whose CSS styles every `button` (the widget's reset no longer outranks its own classes).
+
+## 0.5.0
+
+- **Published texts:** the config carries `texts`, the copy published in MRRocket for texts the site marks: a landing page's headline, subheadline and button (`<Text id="pricing.headline">`, `data-ck-text="pricing.headline"`; `/` is `home`, `/features/ai` is `features-ai`) and a paywall's (`paywall.<placement>.headline`, `.body`, `.cta`). `textChanges` (and with it `<Text>`, `getTexts` and the script tag) applies them first and a running test's variant on top; without them the page keeps its own words. Older versions ignore the field.
+- **Experiments are served:** MRRocket's config now lists the product's running tests with their variants (`control`, `a`, `b` …) and splits, and a shipped winner for everyone; nothing changes in how a visitor is assigned (a stable hash of test and visitor id).
+- `<Text id>` records the exposure of every running test that changes that text, as the script tag already did, so a test that only swaps texts is counted without `useVariant`. New export `experimentsOfText`.
+- Version reported in event batches: `0.5.0`.
+
 ## 0.4.0
 
 - **React Native and Expo:** new entry `@mrrocket/sdk/react-native` (one CommonJS file for Metro, no DOM, no `"use client"`, no rrweb). `MRRocketProvider`, `useMRRocket`, `useFlag`, `useFlagVariant`, `useVariant`, `createMRRocket` / `getMRRocket` outside React; `track`, `identify`, `reset`, `screen`, `setConsent`, `captureError`, `flush`. Screen views through `useExpoRouterTracking()` (Expo Router) or `useNavigationTracking()` (React Navigation `onStateChange`). Lifecycle events `$app_open` (with `cold`) and `$app_background`; a new session after 30 minutes in the background. Events are batched, sent every 10 s and when the app goes to the background, and kept on the device while offline (AsyncStorage when installed, else memory; at most 1,000, oldest dropped; retries with backoff). Consent `"anonymous"` (default: no id stored), `"persistent"` (a random install id stored on the device) or `"off"` (nothing sent, stored data deleted). Every event carries the app and device (`platform`, `appVersion`, `build`, `osVersion`, `deviceModel`, `deviceType`, `locale`) from `expo-application`, `expo-device` and `expo-localization` when installed. Uncaught JavaScript errors (through `ErrorUtils`, the app's own handler still runs) and `captureError` go to Build › Errors with the app version as release. The config for flags and experiments is cached, so a cold start shows the same variant as the last run. Install attribution: UTM and referral parameters of the deep link that opened the app the first time, sent once with `$install`; no IDFA, no MMP.

package/README.md

@@ -10,7 +10,7 @@ The MRRocket SDK, one package with three ways in:
 
 One provider in your layout (or one script tag) gives MRRocket page views, your events, A/B tests, feature flags and errors that the agents can run and read. MRRocket shows every variant of your real pages, because the SDK can render any variant on request.
 
-Status: 0.4.0, MIT licensed, compiled to ESM JavaScript with type declarations (no `transpilePackages`); the React Native entry is CommonJS for Metro. Works with Next.js 15 and 16, React 18 and 19, on Node and on Cloudflare Workers (OpenNext), and with React Native 0.72+ / Expo. The source lives in the MRRocket repo (`prototype/web/packages/cockpit-next`).
+Status: 0.8.0, MIT licensed, compiled to ESM JavaScript with type declarations (no `transpilePackages`); the React Native entry is CommonJS for Metro. Works with Next.js 15 and 16, React 18 and 19, on Node and on Cloudflare Workers (OpenNext), and with React Native 0.72+ / Expo. The source lives in the MRRocket repo (`prototype/web/packages/cockpit-next`).
 
 ## Install
 
@@ -141,18 +141,18 @@ MRRocket shows each variant of your page by loading it with `?ck_preview=<experi
 
 ## 7. Feedback board
 
-A Canny-style board for your own `/feedback` page: requests with votes and comments, a roadmap and a changelog. Visitors vote once; a duplicate hint shows similar requests while they type.
+A Featurebase-style board for your own `/feedback` page: your product's logo and name, requests with votes and comments, a roadmap (Backlog, Next up, In progress, Done), a changelog, search and a light/dark toggle. A duplicate hint shows similar requests while visitors type.
 
 ```tsx
 // app/feedback/page.tsx
 import { FeedbackBoard } from "@mrrocket/sdk/next";
 
 export default function Page() {
-    return <FeedbackBoard title="Feedback" theme="auto" accent="#3f76ff" />;
+    return <FeedbackBoard theme="auto" accent="#3f76ff" syncUrl />;
 }
 ```
 
-It must sit inside `CockpitProvider`. Call `identify(user.id, { name, email })` and comments and requests carry the user. MRRocket also hosts the same board at `/b/<productId>`.
+It must sit inside `CockpitProvider`. Visitors give a name and email once before they post, vote or comment (kept in their browser); call `identify(user.id, { name, email })` and signed-in users are not asked. `syncUrl` keeps the tab and the open post in the address (`?view=roadmap`, `?post=…`), `fullPage` fills the window, `header={false}` shows a plain heading instead of the top bar. MRRocket also hosts the same board at `/b/<productId>` (Feedback › Public board).
 
 ## 8. Feedback widget
 
@@ -267,7 +267,7 @@ mrrocket.ready(function (m) {
 To call it before the file has loaded, put this stub above the script tag; the calls wait in a queue and run once it has:
 
 ```html
-<script>!function(w,m){w[m]=w[m]||{q:[]};"track identify reset captureError setConsent ready".split(" ").forEach(function(k){w[m][k]=w[m][k]||function(){w[m].q.push([k,arguments])}})}(window,"mrrocket");</script>
+<script>!function(w,m){w[m]=w[m]||{q:[]};"track identify reset captureError setConsent ready openCancelFlow startOnboarding".split(" ").forEach(function(k){w[m][k]=w[m][k]||function(){w[m].q.push([k,arguments])}})}(window,"mrrocket");</script>
 ```
 
 Settings are data attributes on the script tag:
@@ -283,11 +283,13 @@ Settings are data attributes on the script tag:
 | `data-release` | Your release, for Build › Errors | none |
 | `data-attribution` / `data-referral-param` | Affiliate referrals: `consent`, `always`, `off`; the direct-link parameter | `consent`, `ref` |
 
-**Experiments on texts:** mark an element `data-ck-text="hero-title"` and MRRocket's variant texts replace its text; the original text is the control. `<Text>` and `<Experiment>` (React components) are Next.js-only.
+**Experiments on texts:** mark an element `data-ck-text="hero-title"` and MRRocket's variant texts replace its text; the original text is the control. `<Text>` and `<Experiment>` (React components) are Next.js-only; React Native reads texts with `useText`.
 
 **Session recordings:** when the product records and the visitor's replay consent is given (`data-replay="true"` or `setConsent({ replay: true })`), the recorder loads from `sdk-replay.js` (about 26 KB gzip) next to `sdk.js`; pages that do not record never load it. Same privacy defaults as 12.
 
-`sdk.js` is about 8 KB gzip. MRRocket serves it with open CORS and a short cache (browsers 5 minutes, CDN 1 hour), so a new release reaches every site within the hour.
+**Cancel flow, onboarding, in-app messages (0.7.0):** `mrrocket.cancelFlow.open({ … })` and `mrrocket.onboarding.start()` (see 15); `data-onboarding="false"` keeps flows from starting on their own, `data-theme` and `data-accent` style the dialogs. The dialogs load from `sdk-flows.js` (about 5 KB gzip) only when one shows.
+
+`sdk.js` is about 11 KB gzip. MRRocket serves it with open CORS and a short cache (browsers 5 minutes, CDN 1 hour), so a new release reaches every site within the hour.
 
 ## 14. React Native and Expo
 
@@ -331,6 +333,25 @@ const { track, identify, reset, screen, setConsent, captureError, flush, ready }
 const newCheckout = useFlag("new-checkout"); // false until the config is known
 const plan = useFlagVariant("plan-picker"); // string | null
 const variant = useVariant("paywall"); // "control" until known; records the exposure once per screen
+const headline = useText("paywall.onboarding.headline", "Unlock everything"); // your words until MRRocket has some
+```
+
+**Texts (paywall copy, text tests):** `useText(id, fallback)` is the app's `<Text id>`. It returns the copy published in MRRocket for `id` (a paywall's `paywall.<placement>.headline`, `.body` and `.cta`, as Conversion › Paywalls shows them), with this person's variant of a running text test on top, the same rules as the website: control keeps the published words, and your `fallback` shows while nothing is published (or on the very first start before the config arrives; later starts use the cached config). Showing the text records `$exposure` for every test that changes `id`, once per screen, so a test that only swaps copy needs no `useVariant`. Outside React: `client.getText(id, fallback)` (records the exposure), or `client.peekText(id)` with `client.exposeText(id)` when you render it later.
+
+```tsx
+const PLACEMENT = "onboarding";
+function Paywall() {
+    const headline = useText(`paywall.${PLACEMENT}.headline`, "Unlock everything");
+    const body = useText(`paywall.${PLACEMENT}.body`, "All features, cancel anytime.");
+    const cta = useText(`paywall.${PLACEMENT}.cta`, "Start free trial");
+    return (
+        <View>
+            <Text style={styles.title}>{headline}</Text>
+            <Text>{body}</Text>
+            <Button title={cta} onPress={buy} />
+        </View>
+    );
+}
 ```
 
 Outside React (a store, a background task): `createMRRocket({ apiKey })` returns the one client the provider would use; `getMRRocket()` returns the running one.
@@ -368,7 +389,115 @@ Consent:
 
 The SDK does not remember the choice: pass it on every start from your consent screen's stored answer, or call `setConsent()`.
 
-Not in this version (coming later): session recordings and heatmaps, the feedback and survey UI, store install referrer and SKAdNetwork.
+Not in this version (coming later): session recordings and heatmaps, store install referrer and SKAdNetwork. Surveys, the feedback sheet and the messenger: see Messenger below.
+
+## 15. Cancel flow, onboarding and in-app messages (0.7.0)
+
+What you build in MRRocket shows inside your app; the config carries it, and the dialogs load only when one shows.
+
+**Cancel flow** (Churn › Cancel flow): call it from your Cancel button. Business customers get the survey ("Why are you leaving?") and the offer you set for their answer; anyone else gets the plain confirmation, so a consumer can always cancel in one step (§ 312k BGB). Without a live flow it shows the plain confirmation too, so the button always works.
+
+```tsx
+import { useCancelFlow } from "@mrrocket/sdk/next"; // React Native: from "@mrrocket/sdk/react-native"
+
+const cancelFlow = useCancelFlow();
+<button
+    onClick={async () => {
+        const result = await cancelFlow.open({
+            customer: account.isBusiness ? "business" : "consumer",
+            price: { amount: 29, currency: "EUR" }, // optional: shows what the discount costs
+            onCancel: (r) => api.cancelSubscription({ reason: r.reason, comment: r.comment }),
+            onSave: (r) => api.applyOffer(r.offer), // { kind: "discount", percent, months } | { kind: "pause", months } | { kind: "downgrade", plan } | { kind: "contact" }
+        });
+        // result.outcome: "cancelled" | "saved" | "kept"
+    }}
+>
+    Cancel subscription
+</button>;
+```
+
+MRRocket never changes a subscription (its payment key is read-only): `onCancel` and `onSave` are your code. Only after they succeed is the outcome recorded, and MRRocket shows it under Churn as a cancellation or a save with the customer's plan and monthly revenue (matched by your `identify()` id, or the email you passed with it). If one throws, the dialog stays open with "Something went wrong. Please try again." Script tag: `mrrocket.cancelFlow.open({ … })`.
+
+**Onboarding** (Conversion › Onboarding): the tour, checklist and modal steps of a live flow. A flow starts on its own when the person does its trigger: `track("Signed up")` (or `signup`, `sign_up`) for "Signed up", `track("first_export")` for "First export", and the first page or screen for "First launch" / "First visit", once per person. Automatic starts need a signed-in person (`identify`) or stored progress (`consent="cookies"` / `"persistent"`), so nobody gets the same tour on every page. `useCockpit().startOnboarding()` (script tag `mrrocket.onboarding.start()`, React Native `useOnboarding().start()`) starts one whenever you want; `onboarding={false}` on the provider switches the automatic start off. A tour step points at the element marked `data-ck-target="…"` (web); a checklist item with an event ticks itself when you track it. Emails of the flow go out from MRRocket.
+
+**In-app messages** (Lifecycle › Journeys, an "In-app message" step): a signed-in person's pending messages load after `identify()` and show as a banner or a dialog. Clicking or closing it moves the person on in the journey; after 7 days without an answer they go on anyway.
+
+**Look:** `appearance={{ theme: "dark", accent: "#0f766e", className: "my-dialogs" }}` on `CockpitProvider` (React Native: `{ theme, accent }`; script tag: `data-theme`, `data-accent`). On the web the dialogs read CSS variables on `.ckf-root`: `--ckf-accent`, `--ckf-bg`, `--ckf-fg`, `--ckf-muted`, `--ckf-line`, `--ckf-radius`, `--ckf-font`. React Native draws them next to your app through `MRRocketProvider` (`flows={false}` to draw `client.flows` yourself with `<MRRocketFlows flows={client.flows} />`); tour steps show as a card there.
+
+**Events** (under your analytics consent): `$cancel_flow` `{ action: "shown" | "answered" | "offer" | "finished", run, version, reason?, offer?, outcome?, comment? }`, `$onboarding` `{ flow, step?, action: "started" | "shown" | "completed" | "dismissed" }`, `$inapp` `{ message, journey, action: "shown" | "clicked" | "dismissed" }`. With consent `"off"` the cancel flow still works, but nothing is recorded, and no onboarding or messages show.
+
+## 16. Push notifications (0.7.0)
+
+A Lifecycle journey's Push step goes to the phones and browsers where the signed-in person turned notifications on.
+
+```tsx
+// Expo (needs expo-notifications; expo-constants for the EAS project id). After identify():
+import { usePush } from "@mrrocket/sdk/react-native";
+const push = usePush();
+await push.register(); // { status: "registered" | "denied" | "not-asked" | "unavailable" | "not-signed-in" | "error" }
+
+// Next.js, from a click, after identify(). Your site serves /mrrocket-sw.js (a copy of dist/browser/mrrocket-sw.js):
+import { usePush as useWebPush } from "@mrrocket/sdk/next";
+const webPush = useWebPush();
+<button onClick={() => webPush.subscribe()}>Turn on notifications</button>;
+
+// Script tag
+mrrocket.push.subscribe();
+```
+
+`register({ ask: false })` / `subscribe({ ask: false })` only send an existing token or subscription again. `reset()` on React Native takes the token back; on the web call `push.unsubscribe()` before `reset()`. A site with its own service worker adds `importScripts("/mrrocket-sw.js")` to it and calls `subscribe({ serviceWorker: false })`. Opening a MRRocket notification records `$push { action: "opened", message }`.
+
+## 17. Redirects and redirect tests (0.7.0)
+
+Page redirects (Landing pages › Redirect) and redirect tests ("Whole page" in Experiments) come with the config: the SDK sends the visitor on before the page shows, keeping the query and hash, and the page a test's variant lands on records the exposure (`ck_x=<test>:<variant>`, removed from the address). Nothing to add for the script tag (the optional `ck-hide` snippet stops a flash of the old page). In Next.js `<CockpitProvider>` redirects after the first paint; to answer before rendering, use the proxy helper:
+
+```ts
+// proxy.ts
+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"] };
+```
+
+A running test needs a stable id on the server (the `ck_id` cookie with `consent="cookies"`, or `{ distinctId }`); without one it is left to the provider.
+
+## 18. Messenger (0.9.0)
+
+A chat bubble like Featurebase's or Intercom's messenger, with three tabs: **Home** (greeting, the latest chat, help search, top articles), **Messages** (the chat with your team) and **Help** (your published help articles from Support › Help center, searchable, read in the panel). Every chat is a Support conversation (channel "Chat") in MRRocket's inbox: you answer there, or the Customer experience agent does (Support › Automation › AI answers). A new answer while the panel is closed plays a short sound, shows a count on the bubble and a preview card above it.
+
+```tsx
+import { Messenger, useMessenger } from "@mrrocket/sdk/next";
+
+// Once, inside <CockpitProvider>:
+<Messenger title="Acme" greeting="Hi! How can we help?" />;
+
+// From your own button ("home", "messages", "help" or { article: id }):
+const messenger = useMessenger();
+<button onClick={() => messenger.open("help")}>Help</button>;
+
+// Or with no code at all:
+<a data-ck-messenger>Chat with us</a>;
+```
+
+The look and texts (color, light or dark, side, title, greeting, button text, Help tab, sound, preview, asking for an email) are set per product in MRRocket › Support › Messenger and read by the messenger itself (`GET /api/sdk/messenger`), so they change without a deploy. What you pass in code wins.
+
+Props: `title`, `greeting`, `launcher` (default true), `help` (the Help tab, default true; hidden while there is no published article), `sound` (default true), `preview` (default true), `askEmail` (default true), `position` ("bottom-right", "bottom-left"), `label`, `theme`, `accent`. The panel is plain DOM, loaded with a dynamic import after the page rendered.
+
+Call `identify(user.id, { name, email })` and chats carry the person's name and email (they are not asked). While the panel is open it reads `GET /api/sdk/messages` every 4 seconds; while a visitor waits for an answer every 8 seconds for ten minutes, then every 30. Articles come from `GET /api/sdk/articles` as blocks, written with textContent, never HTML.
+
+On sites with the script tag (Webflow, Framer, WordPress …) add `data-messenger="true"`; the messenger loads as a fifth file, `sdk-messenger.js`, only on pages that use it:
+
+```html
+<script async src="https://app.mrrocket.dev/sdk.js" data-key="mrr_pub_…" data-messenger="true" data-messenger-title="Acme"></script>
+```
+
+Also `data-messenger-greeting`, `-label`, `-position="bottom-left"`, and "false" for `-help`, `-sound`, `-preview`, `-ask-email`. `mrrocket.messenger.open()` opens it from your code.
+
+In React Native, `<MRRocketProvider messenger={{ launcher: true }}>` adds the bubble, `useMessenger().open()` opens it from your own button; a new answer shows as a banner at the top, with a light haptic when `expo-haptics` is installed. The provider also shows your live in-app survey (`surveys={false}` to switch off) and the feedback sheet (`useFeedback().open()`). With the person's consent (`replay`) and `react-native-view-shot` installed, the app also records sessions as screen pictures for Sessions: none while the keyboard is open, and `<MRRocketMask>` areas are painted black on the server before storing. Taps go to Heatmaps as clicks on the current screen; the provider then wraps the app in one `View` with `flex: 1` (`heatmaps={false}` to switch off).
 
 ## Privacy and consent
 

package/dist/api-client.d.ts

@@ -0,0 +1,213 @@
+/**
+ * The SDK's fetch client and the shapes it reads, without React, so the script tag's widgets (src/script) use it too.
+ * `./api` re-exports all of it with the `useApi` hook.
+ */
+export type PostStatus = "review" | "planned" | "progress" | "shipped";
+export declare const STATUS_LABEL: Record<PostStatus, string>;
+export interface FeedbackBoardInfo {
+    id: string;
+    label: string;
+}
+export interface FeedbackPost {
+    id: string;
+    title: string;
+    body: string;
+    board: string;
+    status: PostStatus;
+    votes: number;
+    comments: number;
+    voted: boolean;
+    createdAt: string;
+    /** "Lena K.", "Anonymous" or "Team". Missing from servers before SDK 0.6. */
+    author?: string;
+}
+/** The product's public face for the board's header. */
+export interface FeedbackProduct {
+    name: string;
+    logo: string | null;
+    /** The domain's favicon, tried when `logo` does not load. Older servers leave it out. */
+    logoFallback?: string | null;
+}
+export interface FeedbackList {
+    boards: FeedbackBoardInfo[];
+    posts: FeedbackPost[];
+    product?: FeedbackProduct;
+}
+export interface FeedbackRoadmap {
+    /** `review` (Backlog) comes from servers of SDK 0.6 on. */
+    columns: {
+        review?: FeedbackPost[];
+        planned: FeedbackPost[];
+        progress: FeedbackPost[];
+        shipped: FeedbackPost[];
+    };
+}
+export interface ChangelogEntry {
+    id: string;
+    title: string;
+    body: string;
+    publishedAt: string;
+}
+export interface FeedbackComment {
+    id: string;
+    body: string;
+    author: string;
+    isTeam: boolean;
+    postedAt: string;
+}
+export type SurveyQuestionKind = "nps" | "rating" | "single" | "multi" | "text";
+export interface SurveyQuestion {
+    key: string;
+    kind: SurveyQuestionKind;
+    title: string;
+    description?: string;
+    required: boolean;
+    options?: string[];
+    scale?: number;
+    low?: string;
+    high?: string;
+    placeholder?: string;
+}
+export interface SurveyDefinition {
+    id: string;
+    name: string;
+    type: string;
+    thanks: string;
+    questions: SurveyQuestion[];
+}
+export type SurveyAnswer = number | string | string[];
+/** One message of the messenger's chat. "visitor" is the person on the site; the rest come from the product's team. */
+export interface ChatMessage {
+    id: string;
+    from: "visitor" | "team" | "ai" | "auto";
+    body: string;
+    at: string;
+    /** Help articles an answer drew on (servers from SDK 0.9 on). */
+    articles?: {
+        id: string;
+        title: string;
+    }[];
+}
+/** A published help article in a list (the messenger's Help tab). */
+export interface ArticleSummary {
+    id: string;
+    title: string;
+    collection: string;
+    excerpt: string;
+    updatedAt: string;
+}
+/** A run of text inside an article block. Links are http(s), mailto or tel only. */
+export interface ArticleSpan {
+    text: string;
+    href?: string;
+    bold?: boolean;
+    italic?: boolean;
+    code?: boolean;
+}
+/** An article's content as blocks, written with textContent (never parsed as HTML). */
+export type ArticleBlock = {
+    type: "h2" | "h3" | "p" | "quote";
+    spans: ArticleSpan[];
+} | {
+    type: "ul" | "ol";
+    items: ArticleSpan[][];
+} | {
+    type: "code";
+    text: string;
+} | {
+    type: "hr";
+};
+export interface Article {
+    id: string;
+    title: string;
+    collection: string;
+    updatedAt: string;
+    blocks: ArticleBlock[];
+}
+/** The messenger's look and texts as set in MRRocket › Support › Messenger (servers from SDK 0.9 on). */
+export interface MessengerLook {
+    accent: string;
+    theme: "light" | "dark" | "auto";
+    position: "bottom-right" | "bottom-left";
+    title: string;
+    greeting: string;
+    label: string;
+    help: boolean;
+    sound: boolean;
+    preview: boolean;
+    askEmail: boolean;
+}
+/** The visitor's newest chat (open or closed) and its messages. */
+export interface ChatThread {
+    conversation: {
+        id: string;
+        status: "open" | "solved";
+    } | null;
+    messages: ChatMessage[];
+    /** The visitor gave an email already: the messenger stops asking. */
+    hasEmail: boolean;
+}
+export declare class ApiError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+interface Conn {
+    host: string;
+    apiKey: string;
+    distinctId: string;
+    user?: {
+        id?: string;
+        [key: string]: unknown;
+    };
+}
+/** The small fetch client behind the widgets. Every read takes an AbortSignal so unmounting cancels it. */
+export declare const createApi: (c: Conn) => {
+    list: (o: {
+        board?: string;
+        sort?: "top" | "new";
+        q?: string;
+    }, signal?: AbortSignal) => Promise<FeedbackList>;
+    post: (id: string, signal?: AbortSignal) => Promise<FeedbackPost>;
+    roadmap: (signal?: AbortSignal) => Promise<FeedbackRoadmap>;
+    changelog: (signal?: AbortSignal) => Promise<{
+        entries: ChangelogEntry[];
+    }>;
+    submit: (p: {
+        title: string;
+        body?: string;
+        board: string;
+    }) => Promise<FeedbackPost>;
+    vote: (id: string) => Promise<{
+        voted: boolean;
+        votes: number;
+    }>;
+    comments: (id: string, signal?: AbortSignal) => Promise<{
+        comments: FeedbackComment[];
+    }>;
+    comment: (id: string, body: string) => Promise<FeedbackComment>;
+    survey: (url: string, signal?: AbortSignal) => Promise<{
+        survey: SurveyDefinition | null;
+    }>;
+    seen: (id: string) => Promise<unknown>;
+    respond: (id: string, r: {
+        answers: Record<string, SurveyAnswer>;
+        completed: boolean;
+        seconds: number;
+    }) => Promise<unknown>;
+    chat: (signal?: AbortSignal) => Promise<ChatThread>;
+    sendChat: (m: {
+        body: string;
+        email?: string;
+        url?: string;
+    }) => Promise<ChatThread>;
+    articles: (q?: string, signal?: AbortSignal) => Promise<{
+        articles: ArticleSummary[];
+    }>;
+    article: (id: string, signal?: AbortSignal) => Promise<Article>;
+    messengerLook: (signal?: AbortSignal) => Promise<MessengerLook>;
+    rateArticle: (id: string, helpful: boolean) => Promise<{
+        counted: boolean;
+    }>;
+};
+export type Api = ReturnType<typeof createApi>;
+export {};

package/dist/api-client.js

@@ -0,0 +1,67 @@
+// src/api-client.ts
+var STATUS_LABEL = {
+  review: "Under review",
+  planned: "Planned",
+  progress: "In progress",
+  shipped: "Shipped"
+};
+var ApiError = class extends Error {
+  status;
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+  }
+};
+var qs = (params) => Object.entries(params).filter((e) => !!e[1]).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join("&");
+var call = async (url, init, signal) => {
+  let res;
+  try {
+    res = await fetch(url, {
+      ...init,
+      signal,
+      headers: init?.body ? { "content-type": "application/json" } : void 0
+    });
+  } catch (e) {
+    if (e.name === "AbortError") throw e;
+    throw new ApiError("Could not reach the server. Check your connection and try again.", 0);
+  }
+  if (!res.ok) {
+    let detail = "";
+    try {
+      detail = (await res.json()).error ?? "";
+    } catch {
+    }
+    throw new ApiError(detail || (res.status === 429 ? "Too many requests. Try again in a minute." : "Something went wrong. Please try again."), res.status);
+  }
+  return await res.json();
+};
+var createApi = (c) => {
+  const base = `${c.host}/api/sdk`;
+  const who = { key: c.apiKey, distinctId: c.distinctId, user: c.user };
+  const post = (path, body, signal) => call(`${base}${path}`, { method: "POST", body: JSON.stringify({ ...who, ...body }) }, signal);
+  return {
+    list: (o, signal) => call(`${base}/feedback?${qs({ key: c.apiKey, distinctId: c.distinctId, board: o.board, sort: o.sort, q: o.q })}`, void 0, signal),
+    post: (id, signal) => call(`${base}/feedback/${encodeURIComponent(id)}?${qs({ key: c.apiKey, distinctId: c.distinctId })}`, void 0, signal),
+    roadmap: (signal) => call(`${base}/feedback/roadmap?${qs({ key: c.apiKey, distinctId: c.distinctId })}`, void 0, signal),
+    changelog: (signal) => call(`${base}/feedback/changelog?${qs({ key: c.apiKey })}`, void 0, signal),
+    submit: (p) => post("/feedback", p),
+    vote: (id) => post(`/feedback/${encodeURIComponent(id)}/vote`, {}),
+    comments: (id, signal) => call(`${base}/feedback/${encodeURIComponent(id)}/comments?${qs({ key: c.apiKey })}`, void 0, signal),
+    comment: (id, body) => post(`/feedback/${encodeURIComponent(id)}/comments`, { body }),
+    survey: (url, signal) => call(`${base}/surveys?${qs({ key: c.apiKey, distinctId: c.distinctId, url })}`, void 0, signal),
+    seen: (id) => post(`/surveys/${encodeURIComponent(id)}/seen`, { user: void 0 }),
+    respond: (id, r) => post(`/surveys/${encodeURIComponent(id)}/respond`, r),
+    chat: (signal) => call(`${base}/messages?${qs({ key: c.apiKey, distinctId: c.distinctId })}`, void 0, signal),
+    sendChat: (m) => post("/messages", m),
+    articles: (q, signal) => call(`${base}/articles?${qs({ key: c.apiKey, q })}`, void 0, signal),
+    article: (id, signal) => call(`${base}/articles/${encodeURIComponent(id)}?${qs({ key: c.apiKey, distinctId: c.distinctId })}`, void 0, signal),
+    messengerLook: (signal) => call(`${base}/messenger?${qs({ key: c.apiKey })}`, void 0, signal),
+    rateArticle: (id, helpful) => post(`/articles/${encodeURIComponent(id)}/rate`, { helpful })
+  };
+};
+export {
+  ApiError,
+  STATUS_LABEL,
+  createApi
+};
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/api-client.ts"],"sourcesContent":["/**\n * The SDK's fetch client and the shapes it reads, without React, so the script tag's widgets (src/script) use it too.\n * `./api` re-exports all of it with the `useApi` hook.\n */\nexport type PostStatus = \"review\" | \"planned\" | \"progress\" | \"shipped\";\n\nexport const STATUS_LABEL: Record<PostStatus, string> = {\n    review: \"Under review\",\n    planned: \"Planned\",\n    progress: \"In progress\",\n    shipped: \"Shipped\",\n};\n\nexport interface FeedbackBoardInfo {\n    id: string;\n    label: string;\n}\n\nexport interface FeedbackPost {\n    id: string;\n    title: string;\n    body: string;\n    board: string;\n    status: PostStatus;\n    votes: number;\n    comments: number;\n    voted: boolean;\n    createdAt: string;\n    /** \"Lena K.\", \"Anonymous\" or \"Team\". Missing from servers before SDK 0.6. */\n    author?: string;\n}\n\n/** The product's public face for the board's header. */\nexport interface FeedbackProduct {\n    name: string;\n    logo: string | null;\n    /** The domain's favicon, tried when `logo` does not load. Older servers leave it out. */\n    logoFallback?: string | null;\n}\n\nexport interface FeedbackList {\n    boards: FeedbackBoardInfo[];\n    posts: FeedbackPost[];\n    product?: FeedbackProduct;\n}\n\nexport interface FeedbackRoadmap {\n    /** `review` (Backlog) comes from servers of SDK 0.6 on. */\n    columns: { review?: FeedbackPost[]; planned: FeedbackPost[]; progress: FeedbackPost[]; shipped: FeedbackPost[] };\n}\n\nexport interface ChangelogEntry {\n    id: string;\n    title: string;\n    body: string;\n    publishedAt: string;\n}\n\nexport interface FeedbackComment {\n    id: string;\n    body: string;\n    author: string;\n    isTeam: boolean;\n    postedAt: string;\n}\n\nexport type SurveyQuestionKind = \"nps\" | \"rating\" | \"single\" | \"multi\" | \"text\";\n\nexport interface SurveyQuestion {\n    key: string;\n    kind: SurveyQuestionKind;\n    title: string;\n    description?: string;\n    required: boolean;\n    options?: string[];\n    scale?: number;\n    low?: string;\n    high?: string;\n    placeholder?: string;\n}\n\nexport interface SurveyDefinition {\n    id: string;\n    name: string;\n    type: string;\n    thanks: string;\n    questions: SurveyQuestion[];\n}\n\nexport type SurveyAnswer = number | string | string[];\n\n/** One message of the messenger's chat. \"visitor\" is the person on the site; the rest come from the product's team. */\nexport interface ChatMessage {\n    id: string;\n    from: \"visitor\" | \"team\" | \"ai\" | \"auto\";\n    body: string;\n    at: string;\n    /** Help articles an answer drew on (servers from SDK 0.9 on). */\n    articles?: { id: string; title: string }[];\n}\n\n/** A published help article in a list (the messenger's Help tab). */\nexport interface ArticleSummary {\n    id: string;\n    title: string;\n    collection: string;\n    excerpt: string;\n    updatedAt: string;\n}\n\n/** A run of text inside an article block. Links are http(s), mailto or tel only. */\nexport interface ArticleSpan {\n    text: string;\n    href?: string;\n    bold?: boolean;\n    italic?: boolean;\n    code?: boolean;\n}\n\n/** An article's content as blocks, written with textContent (never parsed as HTML). */\nexport type ArticleBlock =\n    | { type: \"h2\" | \"h3\" | \"p\" | \"quote\"; spans: ArticleSpan[] }\n    | { type: \"ul\" | \"ol\"; items: ArticleSpan[][] }\n    | { type: \"code\"; text: string }\n    | { type: \"hr\" };\n\nexport interface Article {\n    id: string;\n    title: string;\n    collection: string;\n    updatedAt: string;\n    blocks: ArticleBlock[];\n}\n\n/** The messenger's look and texts as set in MRRocket › Support › Messenger (servers from SDK 0.9 on). */\nexport interface MessengerLook {\n    accent: string;\n    theme: \"light\" | \"dark\" | \"auto\";\n    position: \"bottom-right\" | \"bottom-left\";\n    title: string;\n    greeting: string;\n    label: string;\n    help: boolean;\n    sound: boolean;\n    preview: boolean;\n    askEmail: boolean;\n}\n\n/** The visitor's newest chat (open or closed) and its messages. */\nexport interface ChatThread {\n    conversation: { id: string; status: \"open\" | \"solved\" } | null;\n    messages: ChatMessage[];\n    /** The visitor gave an email already: the messenger stops asking. */\n    hasEmail: boolean;\n}\n\nexport class ApiError extends Error {\n    status: number;\n    constructor(message: string, status: number) {\n        super(message);\n        this.status = status;\n    }\n}\n\ninterface Conn {\n    host: string;\n    apiKey: string;\n    distinctId: string;\n    user?: { id?: string; [key: string]: unknown };\n}\n\n// Not URLSearchParams: React Native's lacks `set` in older versions, and the apps use this client too.\nconst qs = (params: Record<string, string | undefined>) =>\n    Object.entries(params)\n        .filter((e): e is [string, string] => !!e[1])\n        .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`)\n        .join(\"&\");\n\nconst call = async <T>(url: string, init: RequestInit | undefined, signal?: AbortSignal): Promise<T> => {\n    let res: Response;\n    try {\n        res = await fetch(url, {\n            ...init,\n            signal,\n            headers: init?.body ? { \"content-type\": \"application/json\" } : undefined,\n        });\n    } catch (e) {\n        if ((e as Error).name === \"AbortError\") throw e;\n        throw new ApiError(\"Could not reach the server. Check your connection and try again.\", 0);\n    }\n    if (!res.ok) {\n        let detail = \"\";\n        try {\n            detail = ((await res.json()) as { error?: string }).error ?? \"\";\n        } catch {\n            // Not JSON; the status is enough.\n        }\n        throw new ApiError(detail || (res.status === 429 ? \"Too many requests. Try again in a minute.\" : \"Something went wrong. Please try again.\"), res.status);\n    }\n    return (await res.json()) as T;\n};\n\n/** The small fetch client behind the widgets. Every read takes an AbortSignal so unmounting cancels it. */\nexport const createApi = (c: Conn) => {\n    const base = `${c.host}/api/sdk`;\n    const who = { key: c.apiKey, distinctId: c.distinctId, user: c.user };\n    const post = <T>(path: string, body: Record<string, unknown>, signal?: AbortSignal) =>\n        call<T>(`${base}${path}`, { method: \"POST\", body: JSON.stringify({ ...who, ...body }) }, signal);\n    return {\n        list: (o: { board?: string; sort?: \"top\" | \"new\"; q?: string }, signal?: AbortSignal) =>\n            call<FeedbackList>(`${base}/feedback?${qs({ key: c.apiKey, distinctId: c.distinctId, board: o.board, sort: o.sort, q: o.q })}`, undefined, signal),\n        post: (id: string, signal?: AbortSignal) =>\n            call<FeedbackPost>(`${base}/feedback/${encodeURIComponent(id)}?${qs({ key: c.apiKey, distinctId: c.distinctId })}`, undefined, signal),\n        roadmap: (signal?: AbortSignal) => call<FeedbackRoadmap>(`${base}/feedback/roadmap?${qs({ key: c.apiKey, distinctId: c.distinctId })}`, undefined, signal),\n        changelog: (signal?: AbortSignal) => call<{ entries: ChangelogEntry[] }>(`${base}/feedback/changelog?${qs({ key: c.apiKey })}`, undefined, signal),\n        submit: (p: { title: string; body?: string; board: string }) => post<FeedbackPost>(\"/feedback\", p),\n        vote: (id: string) => post<{ voted: boolean; votes: number }>(`/feedback/${encodeURIComponent(id)}/vote`, {}),\n        comments: (id: string, signal?: AbortSignal) =>\n            call<{ comments: FeedbackComment[] }>(`${base}/feedback/${encodeURIComponent(id)}/comments?${qs({ key: c.apiKey })}`, undefined, signal),\n        comment: (id: string, body: string) => post<FeedbackComment>(`/feedback/${encodeURIComponent(id)}/comments`, { body }),\n        survey: (url: string, signal?: AbortSignal) =>\n            call<{ survey: SurveyDefinition | null }>(`${base}/surveys?${qs({ key: c.apiKey, distinctId: c.distinctId, url })}`, undefined, signal),\n        seen: (id: string) => post<unknown>(`/surveys/${encodeURIComponent(id)}/seen`, { user: undefined }),\n        respond: (id: string, r: { answers: Record<string, SurveyAnswer>; completed: boolean; seconds: number }) =>\n            post<unknown>(`/surveys/${encodeURIComponent(id)}/respond`, r),\n        chat: (signal?: AbortSignal) => call<ChatThread>(`${base}/messages?${qs({ key: c.apiKey, distinctId: c.distinctId })}`, undefined, signal),\n        sendChat: (m: { body: string; email?: string; url?: string }) => post<ChatThread>(\"/messages\", m),\n        articles: (q?: string, signal?: AbortSignal) => call<{ articles: ArticleSummary[] }>(`${base}/articles?${qs({ key: c.apiKey, q })}`, undefined, signal),\n        article: (id: string, signal?: AbortSignal) =>\n            call<Article>(`${base}/articles/${encodeURIComponent(id)}?${qs({ key: c.apiKey, distinctId: c.distinctId })}`, undefined, signal),\n        messengerLook: (signal?: AbortSignal) => call<MessengerLook>(`${base}/messenger?${qs({ key: c.apiKey })}`, undefined, signal),\n        rateArticle: (id: string, helpful: boolean) => post<{ counted: boolean }>(`/articles/${encodeURIComponent(id)}/rate`, { helpful }),\n    };\n};\n\nexport type Api = ReturnType<typeof createApi>;\n"],"mappings":"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","names":[]}