@mrrocket/sdk 0.8.0 → 0.10.0

package/CHANGELOG.md

@@ -2,6 +2,26 @@
 
 All notable changes to this package. It follows semantic versioning; before 1.0 a minor version may change an API.
 
+## 0.10.0
+
+- **Messenger, new look (web and apps):** Home opens under a head in your color with the greeting large on it, then cards: the recent chat with the team's mark, "Send us a message" with how soon you reply, and help search with the top articles. The chat has a round send button in one rounded field, softer bubbles and the reply time in its head; the launcher is larger, turns into a cross when open and takes a dark text on a light color. React Native draws the same: line icons with the optional `react-native-svg` (text glyphs without it).
+- **More from MRRocket › Support › Messenger:** `replyTime` ("minutes", "hours", "day") and, for apps, `appLauncher` (a chat button in the app) plus the side, the button text and Sound (a light haptic in apps), which React Native now reads too. What the code passes still wins.
+- New in `api-client`: `replyLine(replyTime)` and `inkOn(color)`.
+- Version reported in event batches: `0.10.0`.
+
+## 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.

package/README.md

@@ -389,7 +389,7 @@ 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)
 
@@ -465,6 +465,40 @@ 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
 
 ```tsx

package/dist/api-client.d.ts

@@ -0,0 +1,221 @@
+/**
+ * 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;
+    /** How soon the team usually answers (MRRocket from 0.10; older servers leave it out). */
+    replyTime?: "minutes" | "hours" | "day";
+    /** A round chat button in the app (React Native) too. */
+    appLauncher?: boolean;
+    help: boolean;
+    sound: boolean;
+    preview: boolean;
+    askEmail: boolean;
+}
+/** The line under "Send us a message" and in the chat's head. */
+export declare const replyLine: (t: MessengerLook["replyTime"]) => "We usually reply in a few minutes" | "We usually reply within a day" | "We usually reply in a few hours";
+/** Black or white, whichever reads better on the accent (a light custom color gets dark text). */
+export declare const inkOn: (hex: string) => "#ffffff" | "#111214";
+/** 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,79 @@
+// src/api-client.ts
+var STATUS_LABEL = {
+  review: "Under review",
+  planned: "Planned",
+  progress: "In progress",
+  shipped: "Shipped"
+};
+var replyLine = (t) => t === "minutes" ? "We usually reply in a few minutes" : t === "day" ? "We usually reply within a day" : "We usually reply in a few hours";
+var inkOn = (hex) => {
+  const m = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(hex);
+  if (!m) return "#ffffff";
+  const [r, g, b] = [m[1], m[2], m[3]].map((x) => {
+    const c = parseInt(x, 16) / 255;
+    return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;
+  });
+  return 0.2126 * r + 0.7152 * g + 0.0722 * b > 0.45 ? "#111214" : "#ffffff";
+};
+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,
+  inkOn,
+  replyLine
+};
+//# 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    /** How soon the team usually answers (MRRocket from 0.10; older servers leave it out). */\n    replyTime?: \"minutes\" | \"hours\" | \"day\";\n    /** A round chat button in the app (React Native) too. */\n    appLauncher?: boolean;\n    help: boolean;\n    sound: boolean;\n    preview: boolean;\n    askEmail: boolean;\n}\n\n/** The line under \"Send us a message\" and in the chat's head. */\nexport const replyLine = (t: MessengerLook[\"replyTime\"]) =>\n    t === \"minutes\" ? \"We usually reply in a few minutes\" : t === \"day\" ? \"We usually reply within a day\" : \"We usually reply in a few hours\";\n\n/** Black or white, whichever reads better on the accent (a light custom color gets dark text). */\nexport const inkOn = (hex: string) => {\n    const m = /^#([0-9a-f]{2})([0-9a-f]{2})([0-9a-f]{2})$/i.exec(hex);\n    if (!m) return \"#ffffff\";\n    const [r, g, b] = [m[1], m[2], m[3]].map((x) => {\n        const c = parseInt(x, 16) / 255;\n        return c <= 0.03928 ? c / 12.92 : ((c + 0.055) / 1.055) ** 2.4;\n    });\n    return 0.2126 * r + 0.7152 * g + 0.0722 * b > 0.45 ? \"#111214\" : \"#ffffff\";\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":[]}

package/dist/api.d.ts

@@ -1,124 +1,5 @@
-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;
-}
-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[];
-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>;
-};
-export type Api = ReturnType<typeof createApi>;
+import { type Api } from "./api-client.js";
+export * from "./api-client.js";
 /** Who writes: the provider's visitor, or the name and email a visitor gave the board (see useBoardIdentity). */
 export interface Writer {
     distinctId: string;
@@ -130,4 +11,3 @@ export interface Writer {
 }
 /** The client for the provider's key, host and visitor, or for `as` when given. */
 export declare const useApi: (as?: Writer | null) => Api;
-export {};

package/dist/api.js

@@ -1,64 +1,8 @@
 // src/api.ts
 import { useMemo } from "react";
+import { createApi } from "./api-client.js";
 import { useCtx } from "./context.js";
-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) => {
-  const p = new URLSearchParams();
-  for (const [k, v] of Object.entries(params)) if (v) p.set(k, v);
-  return p.toString();
-};
-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)
-  };
-};
+export * from "./api-client.js";
 var useApi = (as) => {
   const ctx = useCtx();
   const distinctId = as?.distinctId ?? ctx.distinctId;
@@ -67,9 +11,6 @@ var useApi = (as) => {
   return useMemo(() => createApi({ apiKey, host, distinctId, user }), [apiKey, host, distinctId, user]);
 };
 export {
-  ApiError,
-  STATUS_LABEL,
-  createApi,
   useApi
 };
 //# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/api.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { useCtx } from \"./context\";\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}\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\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\nconst qs = (params: Record<string, string | undefined>) => {\n    const p = new URLSearchParams();\n    for (const [k, v] of Object.entries(params)) if (v) p.set(k, v);\n    return p.toString();\n};\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    };\n};\n\nexport type Api = ReturnType<typeof createApi>;\n\n/** Who writes: the provider's visitor, or the name and email a visitor gave the board (see useBoardIdentity). */\nexport interface Writer {\n    distinctId: string;\n    user?: { id?: string; name?: string; email?: string };\n}\n\n/** The client for the provider's key, host and visitor, or for `as` when given. */\nexport const useApi = (as?: Writer | null): Api => {\n    const ctx = useCtx();\n    const distinctId = as?.distinctId ?? ctx.distinctId;\n    const user = as ? as.user : ctx.user;\n    const { apiKey, host } = ctx;\n    return useMemo(() => createApi({ apiKey, host, distinctId, user }), [apiKey, host, distinctId, user]);\n};\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/api.ts"],"sourcesContent":["import { useMemo } from \"react\";\nimport { type Api, createApi } from \"./api-client\";\nimport { useCtx } from \"./context\";\n\nexport * from \"./api-client\";\n\n/** Who writes: the provider's visitor, or the name and email a visitor gave the board (see useBoardIdentity). */\nexport interface Writer {\n    distinctId: string;\n    user?: { id?: string; name?: string; email?: string };\n}\n\n/** The client for the provider's key, host and visitor, or for `as` when given. */\nexport const useApi = (as?: Writer | null): Api => {\n    const ctx = useCtx();\n    const distinctId = as?.distinctId ?? ctx.distinctId;\n    const user = as ? as.user : ctx.user;\n    const { apiKey, host } = ctx;\n    return useMemo(() => createApi({ apiKey, host, distinctId, user }), [apiKey, host, distinctId, user]);\n};\n"],"mappings":";AAAA,SAAS,eAAe;AACxB,SAAmB,iBAAiB;AACpC,SAAS,cAAc;AAEvB,cAAc;AASP,IAAM,SAAS,CAAC,OAA4B;AAC/C,QAAM,MAAM,OAAO;AACnB,QAAM,aAAa,IAAI,cAAc,IAAI;AACzC,QAAM,OAAO,KAAK,GAAG,OAAO,IAAI;AAChC,QAAM,EAAE,QAAQ,KAAK,IAAI;AACzB,SAAO,QAAQ,MAAM,UAAU,EAAE,QAAQ,MAAM,YAAY,KAAK,CAAC,GAAG,CAAC,QAAQ,MAAM,YAAY,IAAI,CAAC;AACxG;","names":[]}