@mrrocket/sdk 0.15.0 → 0.17.0

package/dist/react-native/index.js

@@ -43,6 +43,7 @@ __export(native_exports, {
   useOnboarding: () => useOnboarding,
   usePaywall: () => usePaywall,
   usePush: () => usePush,
+  useReview: () => useReview,
   useText: () => useText,
   useVariant: () => useVariant
 });
@@ -50,7 +51,7 @@ module.exports = __toCommonJS(native_exports);
 var import_react3 = require("react");
 
 // src/core.ts
-var SDK_VERSION = "0.15.0";
+var SDK_VERSION = "0.17.0";
 var propOf = (person, name) => {
   const want = name.trim().toLowerCase();
   for (const [k, v] of Object.entries(person)) if (k.toLowerCase() === want) return v;
@@ -172,6 +173,23 @@ var textChanges = (config, distinctId, preview) => {
 };
 var newDistinctId = () => typeof crypto !== "undefined" && "randomUUID" in crypto ? crypto.randomUUID() : `ck_${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
 
+// src/identity.ts
+var UNSIGNED_HELP = "401: sign the user id on your server with userHash(id) from @mrrocket/sdk/next/server and pass identify(id, props, { hash }).";
+var warnUnsigned = (status, log = (m) => console.warn(m)) => {
+  const g = globalThis;
+  if (status !== 401 || g.__mrrocketUnsigned) return;
+  g.__mrrocketUnsigned = true;
+  log(`[MRRocket] ${UNSIGNED_HELP}`);
+};
+var nextSigned = (signed, id, hash, log = (m) => console.warn(m)) => {
+  const h3 = typeof hash === "string" ? hash.trim().toLowerCase() : "";
+  if (/^[0-9a-f]{64}$/.test(h3)) return { id, hash: h3 };
+  if (h3) log("[MRRocket] identify: that hash is no userHash(id); not sent.");
+  return signed && signed.id === id ? signed : null;
+};
+var hashFor = (signed, id) => signed && id && signed.id === id ? signed.hash : void 0;
+var hashForAll = (signed, ids) => signed && ids.some((id) => id === signed.id) && ids.every((id) => !id || id === signed.id) ? signed.hash : void 0;
+
 // src/api-client.ts
 var CHAT_FILE_MAX_BYTES = 10 * 1024 * 1024;
 var CHAT_FILES_PER_MESSAGE = 4;
@@ -212,6 +230,7 @@ var call = async (url, init, signal) => {
     throw new ApiError("Could not reach the server. Check your connection and try again.", 0);
   }
   if (!res.ok) {
+    warnUnsigned(res.status);
     let detail = "";
     try {
       detail = (await res.json()).error ?? "";
@@ -223,21 +242,22 @@ var call = async (url, init, signal) => {
 };
 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);
+  const who2 = { key: c.apiKey, distinctId: c.distinctId, user: c.user, userHash: c.userHash };
+  const me = { key: c.apiKey, distinctId: c.distinctId, userHash: c.userHash };
+  const post = (path, body, signal) => call(`${base}${path}`, { method: "POST", body: JSON.stringify({ ...who2, ...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),
+    list: (o, signal) => call(`${base}/feedback?${qs({ ...me, board: o.board, sort: o.sort, q: o.q })}`, void 0, signal),
+    post: (id, signal) => call(`${base}/feedback/${encodeURIComponent(id)}?${qs(me)}`, void 0, signal),
+    roadmap: (signal) => call(`${base}/feedback/roadmap?${qs(me)}`, 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),
+    survey: (url, signal) => call(`${base}/surveys?${qs({ ...me, 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),
+    chat: (signal) => call(`${base}/messages?${qs(me)}`, void 0, signal),
     /** A message; `attachments` are upload ids from `uploadChatFile` (then the body may be empty). */
     sendChat: (m) => post("/messages", m),
     /** Uploads one picked file for the next message (pictures and PDFs, at most 10 MB); answers its upload id. */
@@ -245,14 +265,15 @@ var createApi = (c) => {
       const form = new FormData();
       form.append("key", c.apiKey);
       form.append("distinctId", c.distinctId);
+      if (c.userHash) form.append("userHash", c.userHash);
       if ("uri" in file) form.append("file", file);
       else form.append("file", file, file.name || "file");
       return call(`${base}/messages/attachments`, { method: "POST", body: form }, signal);
     },
     /** Where a sent file of this visitor's chat is read (an image's src, a PDF's link). */
-    attachmentUrl: (id) => `${base}/messages/attachments/${encodeURIComponent(id)}?${qs({ key: c.apiKey, distinctId: c.distinctId })}`,
+    attachmentUrl: (id) => `${base}/messages/attachments/${encodeURIComponent(id)}?${qs(me)}`,
     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),
+    article: (id, signal) => call(`${base}/articles/${encodeURIComponent(id)}?${qs(me)}`, void 0, signal),
     messengerLook: (signal) => call(`${base}/messenger?${qs({ key: c.apiKey })}`, void 0, signal),
     rateArticle: (id, helpful) => post(`/articles/${encodeURIComponent(id)}/rate`, { helpful })
   };
@@ -274,8 +295,8 @@ var byteLength = (s) => {
   }
   return n;
 };
-var batchRequests = (key, events, sdk) => {
-  const head = `{"key":${JSON.stringify(key)},"sdk":${JSON.stringify(sdk)},"events":[`;
+var batchRequests = (key, events, sdk, userHash) => {
+  const head = `{"key":${JSON.stringify(key)},${userHash ? `"userHash":${JSON.stringify(userHash)},` : ""}"sdk":${JSON.stringify(sdk)},"events":[`;
   const empty = byteLength(head) + 2;
   const out = [];
   let chunk = [];
@@ -317,6 +338,7 @@ var describeError = (error) => {
 var CANCEL_EVENT = "$cancel_flow";
 var ONBOARDING_EVENT = "$onboarding";
 var INAPP_EVENT = "$inapp";
+var REVIEW_EVENT = "$review_prompt";
 var PLAIN_CANCEL = {
   version: 0,
   question: "",
@@ -336,6 +358,25 @@ var matchesTrigger = (trigger, event) => {
   return t === e || SIGNUP.has(t) && SIGNUP.has(e);
 };
 var startsOnLoad = (trigger) => /^(first (launch|visit|open|session|login|sign ?in|app open)|app (opened|launched)|on load|every visit|always)?$/i.test(trigger.trim());
+var isPageTrigger = (trigger) => trigger.trim().startsWith("/");
+var manual = (trigger) => eventSlug(trigger) === "from_a_checklist";
+var videoEmbed = (url) => {
+  const u = (url ?? "").trim();
+  if (!/^https?:\/\//i.test(u)) return null;
+  let m = u.match(/^https?:\/\/(?:www\.|m\.)?(?:youtube\.com\/(?:watch\?(?:.*&)?v=|embed\/|shorts\/|live\/)|youtu\.be\/|youtube-nocookie\.com\/embed\/)([\w-]{6,20})/i);
+  if (m) return { kind: "iframe", src: `https://www.youtube-nocookie.com/embed/${m[1]}?rel=0` };
+  m = u.match(/^https?:\/\/(?:www\.|player\.)?vimeo\.com\/(?:video\/)?(\d{4,12})/i);
+  if (m) return { kind: "iframe", src: `https://player.vimeo.com/video/${m[1]}?dnt=1` };
+  m = u.match(/^https?:\/\/(?:www\.)?loom\.com\/(?:share|embed)\/([\w-]{8,64})/i);
+  if (m) return { kind: "iframe", src: `https://www.loom.com/embed/${m[1]}` };
+  if (/\.(mp4|webm|mov|m4v)(\?|#|$)/i.test(u) || /\/media\/uploads\//.test(u)) return { kind: "file", src: u };
+  return null;
+};
+var mediaOf = (step) => {
+  const m = step.media;
+  if (!m || m.kind !== "image" && m.kind !== "video" || !/^https?:\/\//i.test(m.url ?? "")) return void 0;
+  return m.kind === "video" && !videoEmbed(m.url) ? void 0 : m;
+};
 var runId = () => `cf_${Math.random().toString(36).slice(2, 10)}${Date.now().toString(36)}`;
 var discounted = (amount, percent) => Math.round(amount * (1 - percent / 100) * 100) / 100;
 var money = (amount, currency) => {
@@ -383,6 +424,7 @@ var createFlows = (env) => {
   const seenEvents = /* @__PURE__ */ new Set();
   const now = () => env.now?.() ?? Date.now();
   let timer = null;
+  let returnTo = null;
   const flows = () => config?.onboarding ?? [];
   const flowById = (id) => id ? flows().find((f) => f.id === id) : void 0;
   const prog = (id) => {
@@ -520,7 +562,14 @@ var createFlows = (env) => {
           shown.add(`s:${i.id}`);
           env.track(ONBOARDING_EVENT, { flow: flow.id, step: i.id, kind: "checklist", action: "shown" });
         }
-      return { type: "checklist", flow, items: items.map((s) => ({ step: s, done: p.done.has(s.id) })) };
+      return {
+        type: "checklist",
+        flow,
+        items: items.map((s) => {
+          const tour = s.startsTour && s.startsTour !== flow.id ? flowById(s.startsTour) : void 0;
+          return { step: s, done: p.done.has(s.id), ...tour && nodesOf(tour).length ? { tour } : {} };
+        })
+      };
     }
     if (!shown.has(`s:${step.id}`)) {
       shown.add(`s:${step.id}`);
@@ -554,7 +603,28 @@ var createFlows = (env) => {
     }
     const ob = onboardingView();
     if (ob) return ob;
-    if (active && !holding) active = null;
+    if (active && !holding) {
+      const back = returnTo;
+      const ended = active;
+      returnTo = null;
+      active = null;
+      const list = back ? flowById(back.flow) : void 0;
+      if (back && list) {
+        const item = stepsIn(nodesOf(list)).find((s) => s.id === back.step);
+        const p = prog(list.id);
+        if (item && !item.event && !progress.get(ended)?.dismissed && !p.done.has(item.id)) {
+          markDone(p, item.id);
+          record({ flow: list.id, step: item.id, kind: "checklist", action: "completed" });
+        }
+        active = list.id;
+        const again = onboardingView();
+        if (again) return again;
+        if (!holding) active = null;
+      } else if (known) {
+        const after = flowById(ended)?.trigger;
+        Promise.resolve().then(() => autoStart(after));
+      }
+    }
     const m = messages.find((x) => !handled.has(x.id));
     return m ? { type: "message", message: m } : null;
   };
@@ -579,10 +649,15 @@ var createFlows = (env) => {
     emit();
     return true;
   };
-  const autoStart = () => {
+  const allowed = (f) => f.audience !== "signed_in" || !!env.personId();
+  const autoStart = (after) => {
     if (!auto || active || !known) return;
     if (!env.personId() && !env.storage?.()) return;
-    const next = flows().find((f) => startsOnLoad(f.trigger) && nodesOf(f).length && !finished(f));
+    const path = env.path?.();
+    const same2 = after && !manual(after) ? eventSlug(after) : "";
+    const next = flows().find(
+      (f) => (isPageTrigger(f.trigger) ? path !== void 0 && pageMatches(f.trigger, path) : startsOnLoad(f.trigger) || !!same2 && eventSlug(f.trigger) === same2) && allowed(f) && nodesOf(f).length && !finished(f)
+    );
     if (next) start(next);
   };
   const refresh = () => {
@@ -592,6 +667,7 @@ var createFlows = (env) => {
       seenEvents.clear();
       handled.clear();
       active = null;
+      returnTo = null;
       loadedFor = void 0;
     }
     progressFor = pid;
@@ -630,9 +706,9 @@ var createFlows = (env) => {
   };
   const offerAt = (c) => c.round > 1 ? { round: 2 } : c.rule >= 0 ? { rule: c.rule } : {};
   const toOffer = (c) => {
-    const who = { answer: c.answer, plan: c.options.plan, months: monthsSince(c.options.customerSince, env.now?.()) };
+    const who2 = { answer: c.answer, plan: c.options.plan, months: monthsSince(c.options.customerSince, env.now?.()) };
     const rules = c.flow.rules?.[c.reason] ?? [];
-    c.rule = rules.findIndex((r) => ruleMatches(r, who));
+    c.rule = rules.findIndex((r) => ruleMatches(r, who2));
     c.offer = c.rule < 0 ? c.flow.offers[c.reason] : rules[c.rule].offer ?? void 0;
     c.round = 1;
     c.screen = c.offer ? "offer" : "confirm";
@@ -701,6 +777,7 @@ var createFlows = (env) => {
     },
     refresh,
     onEvent: (name) => {
+      if (name === "$pageview") autoStart();
       if (!name || name.startsWith("$")) return;
       const slug = eventSlug(name);
       const fresh = !!slug && !seenEvents.has(slug);
@@ -721,12 +798,12 @@ var createFlows = (env) => {
         emit();
       } else if (fresh) save();
       if (!auto || !env.personId() && !env.storage?.()) return;
-      const next = flows().find((f) => nodesOf(f).length && matchesTrigger(f.trigger, name) && !finished(f));
+      const next = flows().find((f) => nodesOf(f).length && !manual(f.trigger) && matchesTrigger(f.trigger, name) && allowed(f) && !finished(f));
       if (next) start(next);
     },
     openCancelFlow,
     startOnboarding: (id) => {
-      const f = id ? flowById(id) : flows().find((x) => nodesOf(x).length && !finished(x));
+      const f = id ? flowById(id) : flows().find((x) => nodesOf(x).length && !manual(x.trigger) && !finished(x));
       if (!f || !nodesOf(f).length) return false;
       const p = prog(f.id);
       p.dismissed = false;
@@ -822,6 +899,8 @@ var createFlows = (env) => {
         env.track(ONBOARDING_EVENT, { flow: v.flow.id, step: v.step.id, kind: v.step.kind, action: "completed" });
         save();
         emit();
+        const url = v.step.kind === "modal" ? safeUrl(v.step.url) : void 0;
+        if (url) env.openUrl?.(url);
       },
       check: (stepId) => {
         const v = onboardingView();
@@ -838,9 +917,26 @@ var createFlows = (env) => {
         if (!v || v.type !== "step" && v.type !== "checklist") return;
         prog(v.flow.id).dismissed = true;
         env.track(ONBOARDING_EVENT, { flow: v.flow.id, ...v.type === "step" ? { step: v.step.id } : {}, action: "dismissed" });
-        active = null;
+        active = returnTo && returnTo.flow !== v.flow.id && flowById(returnTo.flow) ? returnTo.flow : null;
+        returnTo = null;
         save();
         emit();
+      },
+      startTour: (stepId) => {
+        const v = onboardingView();
+        if (v?.type !== "checklist") return false;
+        const tour = v.items.find((i) => i.step.id === stepId)?.tour;
+        if (!tour) return false;
+        const p = prog(tour.id);
+        p.done.clear();
+        p.at.clear();
+        p.dismissed = false;
+        returnTo = { flow: v.flow.id, step: stepId };
+        active = tour.id;
+        env.track(ONBOARDING_EVENT, { flow: tour.id, action: "started", from: v.flow.id });
+        save();
+        emit();
+        return true;
       }
     },
     message: {
@@ -1047,7 +1143,7 @@ var createRecorder = (deps, st) => {
     const batch = frames.splice(0, frames.length);
     const ms = marks.splice(0, marks.length);
     const size = deps.screen();
-    const { distinctId, identified } = st.who();
+    const { distinctId, identified, userHash } = st.who();
     const body = JSON.stringify({
       key: st.apiKey,
       consent: { replay: true },
@@ -1059,11 +1155,12 @@ var createRecorder = (deps, st) => {
       meta: { first: batch[0].t, last: batch[batch.length - 1].t, vw: size ? Math.round(size.w) : null, vh: size ? Math.round(size.h) : null, marks: ms },
       distinctId,
       identified,
+      ...userHash ? { userHash } : {},
       trigger: r.trigger,
       app: st.app
     });
     const status = await deps.send(body);
-    if (status === 403 || status === 409 || status === 413) r.stopped = true;
+    if (status === 401 || status === 403 || status === 409 || status === 413) r.stopped = true;
   };
   const tick = async () => {
     if (busy || !st.allowed() || !st.config()) return;
@@ -1223,6 +1320,7 @@ var createClient = (options, deps) => {
   let installId = null;
   let memoryId = newDistinctId();
   let identified;
+  let signed = null;
   let person;
   let config = null;
   let queue = [];
@@ -1257,6 +1355,13 @@ var createClient = (options, deps) => {
   const errorQueue = [];
   const errorsSeen = /* @__PURE__ */ new Set();
   let errorsSent = 0;
+  const fetchInApp = async (id) => {
+    if (!apiKey) return null;
+    const hash = hashOf(id);
+    const r = await deps.fetch(`${host}/api/sdk/inapp?key=${encodeURIComponent(apiKey)}&distinctId=${encodeURIComponent(id)}${hash ? `&userHash=${hash}` : ""}`, { method: "GET" });
+    warnUnsigned(r.status, deps.log);
+    return r.ok ? await r.json() : null;
+  };
   const paywall = createPaywallHost({ config: () => config, distinctId: () => distinctId(), track: (event, props) => record(event, props) });
   const flows = createFlows({
     track: (event, props) => record(event, props),
@@ -1267,11 +1372,7 @@ var createClient = (options, deps) => {
       set: (k, v) => void set(k, v)
     } : null,
     openUrl: deps.openUrl,
-    fetchInApp: async (id) => {
-      if (!apiKey) return null;
-      const r = await deps.fetch(`${host}/api/sdk/inapp?key=${encodeURIComponent(apiKey)}&distinctId=${encodeURIComponent(id)}`, { method: "GET" });
-      return r.ok ? await r.json() : null;
-    }
+    fetchInApp: (id) => fetchInApp(id)
   });
   const refreshFlows = () => {
     if (!isReady || closed) return;
@@ -1334,6 +1435,7 @@ var createClient = (options, deps) => {
   };
   const distinctId = () => identified ?? (consent === "persistent" && installId ? installId : memoryId);
   const sendId = () => consent === "persistent" ? distinctId() : identified;
+  const hashOf = (id) => hashFor(signed, id);
   const touchSession = () => {
     const t = now();
     if (!session || t - session.last >= SESSION_TIMEOUT_MS) session = { id: newDistinctId(), last: t };
@@ -1371,6 +1473,7 @@ var createClient = (options, deps) => {
     const timer = ctl ? setTimeoutFn(() => ctl.abort(), REQUEST_TIMEOUT_MS) : null;
     try {
       const r = await deps.fetch(`${host}${path}`, { method: "POST", headers: { "content-type": "application/json" }, body, signal: ctl?.signal });
+      warnUnsigned(r.status, deps.log);
       return r.status;
     } catch {
       return 0;
@@ -1382,7 +1485,7 @@ var createClient = (options, deps) => {
     if (!queue.length || consent === "off" || !apiKey) return;
     if (now() < backoffUntil) return;
     const snapshot = queue.slice();
-    const requests = batchRequests(apiKey, snapshot, sdk);
+    const requests = batchRequests(apiKey, snapshot, sdk, hashOf(sendId()));
     const included = new Set(requests.flatMap((r) => r.events));
     const done = /* @__PURE__ */ new Set();
     for (const r of requests) {
@@ -1393,7 +1496,7 @@ var createClient = (options, deps) => {
         backoffUntil = 0;
       } else if (status >= 400 && status < 500 && status !== 408 && status !== 429) {
         r.events.forEach((e) => done.add(e));
-        warn(`Events were rejected with ${status}. Check the public key (MRRocket \u203A Settings \u203A Products) and the host.`);
+        if (status !== 401) warn(`Events were rejected with ${status}. Check the public key (MRRocket \u203A Settings \u203A Products) and the host.`);
       } else {
         failures++;
         backoffUntil = now() + Math.min(MAX_BACKOFF_MS, 1e3 * 2 ** failures);
@@ -1432,8 +1535,9 @@ var createClient = (options, deps) => {
     }
     while (errorQueue.length) {
       const batch = errorQueue.splice(0, 4);
-      const status = await post("/api/sdk/errors", JSON.stringify({ key: apiKey, sdk, errors: batch }));
-      if (status >= 400 && status < 500 && status !== 429) warn(`Error reports were rejected with ${status}. Check the public key and the host.`);
+      const userHash = hashForAll(signed, batch.map((r) => r.distinctId));
+      const status = await post("/api/sdk/errors", JSON.stringify({ key: apiKey, ...userHash ? { userHash } : {}, sdk, errors: batch }));
+      if (status >= 400 && status < 500 && status !== 429 && status !== 401) warn(`Error reports were rejected with ${status}. Check the public key and the host.`);
     }
   };
   const capture = (error, mechanism, fatal = false) => {
@@ -1444,7 +1548,7 @@ var createClient = (options, deps) => {
     if (errorsSeen.has(mark)) return;
     errorsSeen.add(mark);
     errorsSent++;
-    const who = sendId();
+    const who2 = sendId();
     errorQueue.push({
       ...d,
       mechanism,
@@ -1453,7 +1557,7 @@ var createClient = (options, deps) => {
       ts: now(),
       crumbs: crumbs.slice(),
       ...release ? { release } : {},
-      ...who ? { distinctId: who } : {},
+      ...who2 ? { distinctId: who2 } : {},
       ...session ? { sessionId: session.id } : {}
     });
     recorder?.mark({ kind: "error", path: currentScreen ?? "/", label: clip2(d.message, 120) });
@@ -1491,7 +1595,7 @@ var createClient = (options, deps) => {
       allowed: () => replayOn && loaded && !closed && consent !== "off" && !!apiKey,
       config: () => config?.replay,
       session: () => session?.id ?? touchSession(),
-      who: () => ({ distinctId: sendId(), identified: !!identified }),
+      who: () => ({ distinctId: sendId(), identified: !!identified, userHash: hashOf(sendId()) }),
       apiKey,
       app: context
     }
@@ -1541,6 +1645,7 @@ var createClient = (options, deps) => {
   };
   let pushToken = null;
   let pushFor;
+  let pushHash;
   let pushOff = null;
   const opened = /* @__PURE__ */ new Set();
   const onPushOpen = (data) => {
@@ -1567,19 +1672,21 @@ var createClient = (options, deps) => {
     await loadedNow();
     if (!apiKey || consent === "off") return { status: "error", reason: !apiKey ? "No public key." : "The consent is off." };
     if (!identified) return { status: "not-signed-in" };
-    const who = identified;
+    const who2 = identified;
+    const userHash = hashOf(who2);
     try {
       const permission = await deps.push.permission(o.ask !== false);
       if (permission !== "granted") return { status: permission === "denied" ? "denied" : "not-asked" };
       const token = await deps.push.token(o.projectId);
       if (!token) return { status: "unavailable", reason: "This device has no push token (a simulator, or no EAS project id)." };
-      const status = await post("/api/sdk/push", JSON.stringify({ key: apiKey, distinctId: who, platform: "expo", token, app: context }));
+      const status = await post("/api/sdk/push", JSON.stringify({ key: apiKey, distinctId: who2, userHash, platform: "expo", token, app: context }));
       if (status < 200 || status >= 300) {
         warn(`Push registration was rejected with ${status || "no answer"}. Check the public key and the host.`);
         return { status: "error", reason: `MRRocket answered ${status || "nothing"}.` };
       }
       pushToken = token;
-      pushFor = who;
+      pushFor = who2;
+      pushHash = userHash;
       listenForOpens();
       debug("Registered for push.");
       return { status: "registered", token };
@@ -1591,9 +1698,28 @@ var createClient = (options, deps) => {
     const token = pushToken;
     if (!token || !apiKey) return false;
     pushToken = null;
-    const status = await post("/api/sdk/push", JSON.stringify({ key: apiKey, distinctId: pushFor, platform: "expo", token, remove: true }));
+    const status = await post("/api/sdk/push", JSON.stringify({ key: apiKey, distinctId: pushFor, userHash: pushHash, platform: "expo", token, remove: true }));
     return status >= 200 && status < 300;
   };
+  let reviewing = false;
+  const requestReview = async () => {
+    if (!deps.storeReview) return "unavailable";
+    await loadedNow();
+    if (!apiKey || consent === "off") return "not-now";
+    if (!identified) return "not-signed-in";
+    if (reviewing) return "not-now";
+    reviewing = true;
+    try {
+      const ask = (await fetchInApp(identified).catch(() => null))?.review;
+      if (!ask) return "not-now";
+      const asked = await deps.storeReview.request().catch(() => false);
+      record(REVIEW_EVENT, { campaign: ask.campaign, store: ask.store, action: asked ? "requested" : "unavailable" });
+      void flush();
+      return asked ? "requested" : "unavailable";
+    } finally {
+      reviewing = false;
+    }
+  };
   let resolveReady = () => {
   };
   const ready = new Promise((r) => {
@@ -1723,13 +1849,14 @@ var createClient = (options, deps) => {
       record("$screen", { ...props, path, screen: name, ...previous ? { previous } : {} });
       recorder?.mark({ kind: "pageview", path });
     },
-    identify: (id, props) => {
+    identify: (id, props, options2) => {
       if (typeof id !== "string" || !id) return;
       if (!loaded) {
-        early.push(() => client.identify(id, props));
+        early.push(() => client.identify(id, props, options2));
         return;
       }
       const previous = sendId();
+      signed = nextSigned(signed, id, options2?.hash, deps.log);
       identified = id;
       person = { ...props, id };
       record("$identify", { ...props, id, ...previous && previous !== id ? { previousId: previous } : {} });
@@ -1743,7 +1870,9 @@ var createClient = (options, deps) => {
         return;
       }
       if (pushToken) void unregisterForPush();
+      void flush();
       identified = void 0;
+      signed = null;
       person = void 0;
       session = null;
       utm = null;
@@ -1822,6 +1951,7 @@ var createClient = (options, deps) => {
     paywall,
     registerForPush,
     unregisterForPush,
+    requestReview,
     flows,
     flush,
     ready,
@@ -1837,7 +1967,7 @@ var createClient = (options, deps) => {
       if (!apiKey || consent === "off") return null;
       const known = client.getUser();
       const user = as?.name || as?.email ? { ...known, ...as.name ? { name: as.name } : {}, ...as.email ? { email: as.email } : {} } : known;
-      return createApi({ host, apiKey, distinctId: distinctId(), user });
+      return createApi({ host, apiKey, distinctId: distinctId(), user, userHash: hashOf(distinctId()) });
     },
     isSurveyDone: (id) => surveysDone.has(id),
     markSurveyDone: (id) => {
@@ -2109,6 +2239,22 @@ var MRRocketFlows = ({ flows, paywall, appearance = {} }) => {
       ];
     return sheet([top, ...body, error], flows.cancel.close);
   }
+  const media = (s) => {
+    const m2 = mediaOf(s);
+    if (!m2) return null;
+    if (m2.kind === "image")
+      return RN.Image ? (0, import_react.createElement)(RN.Image, {
+        key: "media",
+        source: { uri: m2.url },
+        accessibilityLabel: m2.alt,
+        resizeMode: "cover",
+        style: { width: "100%", aspectRatio: 16 / 9, borderRadius: 10, backgroundColor: p.soft }
+      }) : null;
+    const v2 = videoEmbed(m2.url);
+    const open = v2?.kind === "file" ? v2.src : m2.url;
+    return RN.Linking ? btn("\u25B6 Watch the video", "secondary", () => void RN.Linking?.openURL(open).catch(() => {
+    })) : null;
+  };
   if (v.type === "step")
     return sheet(
       [
@@ -2118,6 +2264,7 @@ var MRRocketFlows = ({ flows, paywall, appearance = {} }) => {
           v.total > 1 ? muted(`Step ${v.index + 1} of ${v.total}`) : null,
           close("Close the tour", flows.onboarding.dismiss)
         ),
+        media(v.step),
         title(v.step.title),
         v.step.body ? muted(v.step.body, { fontSize: 15 }) : null,
         btn(v.step.button || (v.last ? "Done" : "Next"), "primary", flows.onboarding.next)
@@ -2138,13 +2285,14 @@ var MRRocketFlows = ({ flows, paywall, appearance = {} }) => {
         ),
         muted(`${done} of ${v.items.length} done`),
         ...v.items.map(
-          ({ step, done: d }) => (0, import_react.createElement)(
+          ({ step, done: d, tour }) => (0, import_react.createElement)(
             RN.Pressable,
             {
               key: step.id,
-              disabled: d || !!step.event,
-              onPress: () => flows.onboarding.check(step.id),
-              accessibilityRole: "checkbox",
+              // 0.17.0: an item that starts a tour opens it; finishing the tour ticks it.
+              disabled: d || !!step.event && !tour,
+              onPress: () => tour ? flows.onboarding.startTour(step.id) : flows.onboarding.check(step.id),
+              accessibilityRole: tour && !d ? "button" : "checkbox",
               accessibilityState: { checked: d },
               style: { flexDirection: "row", gap: 10, alignItems: "flex-start", paddingVertical: 6 }
             },
@@ -2227,6 +2375,12 @@ try {
 } catch {
   expoLocalization = null;
 }
+var expoStoreReview = null;
+try {
+  expoStoreReview = require("expo-store-review");
+} catch {
+  expoStoreReview = null;
+}
 var viewShot = null;
 try {
   viewShot = require("react-native-view-shot");
@@ -2330,6 +2484,17 @@ var recorderDeps = () => {
     masks: measureMasks
   };
 };
+var storeReview = () => {
+  const m = expoStoreReview;
+  if (!m?.requestReview) return null;
+  return {
+    request: async () => {
+      if (m.isAvailableAsync && !await m.isAvailableAsync()) return false;
+      await m.requestReview();
+      return true;
+    }
+  };
+};
 var nativeDeps = (overrides = {}) => ({
   storage: overrides.storage !== void 0 ? overrides.storage : asyncStorage(),
   fetch: ((url, init) => fetch(url, init)),
@@ -2344,6 +2509,7 @@ var nativeDeps = (overrides = {}) => ({
   initialUrl: () => RN2.Linking.getInitialURL(),
   openUrl: (url) => void RN2.Linking.openURL(url).catch(() => void 0),
   push: expoPush(),
+  storeReview: storeReview(),
   recorder: recorderDeps()
 });
 var optionalModules = () => ({
@@ -2352,6 +2518,7 @@ var optionalModules = () => ({
   expoApplication: !!expoApplication,
   expoLocalization: !!expoLocalization,
   expoNotifications: !!expoNotifications,
+  expoStoreReview: !!expoStoreReview?.requestReview,
   viewShot: !!viewShot?.captureScreen
 });
 
@@ -2597,7 +2764,7 @@ var SurveySheet = ({ survey, api, p, onDone }) => {
 var MRRocketSurveys = ({ client, appearance }) => {
   const p = usePalette(appearance);
   const [survey, setSurvey] = (0, import_react2.useState)(null);
-  const [who, setWho] = (0, import_react2.useState)(() => client.getDistinctId());
+  const [who2, setWho] = (0, import_react2.useState)(() => client.getDistinctId());
   (0, import_react2.useEffect)(() => client.subscribe(() => setWho(client.getDistinctId())), [client]);
   (0, import_react2.useEffect)(() => {
     let stop = false;
@@ -2618,7 +2785,7 @@ var MRRocketSurveys = ({ client, appearance }) => {
       clearTimeout(timer);
       ctrl.abort();
     };
-  }, [client, who]);
+  }, [client, who2]);
   const done = (0, import_react2.useCallback)(() => {
     setSurvey((cur) => {
       if (cur) client.markSurveyDone(cur.s.id);
@@ -2740,6 +2907,7 @@ var POLL_IDLE_MS = 3e4;
 var WAITING_FOR_MS = 10 * 6e4;
 var EMAIL = /^[^\s@]+@[^\s@]+\.[^\s@]{2,}$/;
 var whoLabel = { visitor: "You", team: "Team", ai: "AI agent", auto: "Team" };
+var who = (from, agentName) => from === "ai" && agentName?.trim() || whoLabel[from];
 var msgView = "home";
 var messengerOpen = opener();
 var openAt = (v = "home") => {
@@ -3124,7 +3292,7 @@ var MessengerSheet = ({
           k.text(`\u{1F4C4} ${a.title}`, { fontSize: 13 })
         )
       ),
-      m.at ? k.muted(`${mine ? "" : `${whoLabel[m.from]} \xB7 `}${isPending ? "Sending\u2026" : timeAgo(m.at)}`, { fontSize: 11, textAlign: mine ? "right" : "left", paddingHorizontal: 6 }) : null
+      m.at ? k.muted(`${mine ? "" : `${who(m.from, o.agentName)} \xB7 `}${isPending ? "Sending\u2026" : timeAgo(m.at)}`, { fontSize: 11, textAlign: mine ? "right" : "left", paddingHorizontal: 6 }) : null
     );
   };
   const row = (a) => (0, import_react2.createElement)(
@@ -3182,7 +3350,7 @@ var MessengerSheet = ({
             RN3.View,
             { key: "r", style: { flexDirection: "row", alignItems: "center", gap: 10 } },
             title ? teamMark(title, alpha(p.accent, 0.16), p.accent, 26) : null,
-            (0, import_react2.createElement)(RN3.View, { style: { flex: 1, gap: 1 } }, (0, import_react2.createElement)(RN3.Text, { numberOfLines: 1, style: { color: hu.fg, fontSize: 14, fontWeight: "500" } }, last.body || (last.attachments?.length ? `Sent ${last.attachments.length === 1 ? last.attachments[0].name : `${last.attachments.length} files`}` : "")), k.muted(`${last.from === "visitor" ? "You" : whoLabel[last.from]} \xB7 ${timeAgo(last.at)}`, { fontSize: 11.5 })),
+            (0, import_react2.createElement)(RN3.View, { style: { flex: 1, gap: 1 } }, (0, import_react2.createElement)(RN3.Text, { numberOfLines: 1, style: { color: hu.fg, fontSize: 14, fontWeight: "500" } }, last.body || (last.attachments?.length ? `Sent ${last.attachments.length === 1 ? last.attachments[0].name : `${last.attachments.length} files`}` : "")), k.muted(`${last.from === "visitor" ? "You" : who(last.from, o.agentName)} \xB7 ${timeAgo(last.at)}`, { fontSize: 11.5 })),
             chat.unseen.length ? (0, import_react2.createElement)(RN3.View, { style: { width: 8, height: 8, borderRadius: 4, backgroundColor: p.danger } }) : glyph("next", p.muted, 14)
           )
         ], { paddingVertical: 10, paddingHorizontal: 12 })
@@ -3217,7 +3385,6 @@ var MessengerSheet = ({
         RN3.View,
         { style: { paddingHorizontal: 12, paddingTop: 8, paddingBottom: 6, gap: 8 } },
         chat.error ? k.text(chat.error, { color: p.danger, fontSize: 12 }) : null,
-        needEmail ? k.field({ value: email, onChange: setEmail, placeholder: "Your email (optional), so we can follow up", email: true, max: 200, style: { borderWidth: emailOk ? 0 : 1, borderColor: p.danger, borderRadius: r.field, paddingHorizontal: 16, backgroundColor: hu.surface, ...surf } }) : null,
         // Photos picked for the next message, each with a way to take it out again.
         photos.length ? (0, import_react2.createElement)(
           RN3.View,
@@ -3245,6 +3412,15 @@ var MessengerSheet = ({
         (0, import_react2.createElement)(
           RN3.View,
           { style: { gap: 2, borderRadius: 20, paddingTop: 10, paddingBottom: 6, paddingRight: 6, paddingLeft: 16, backgroundColor: hu.surface, ...surf } },
+          // The optional email: the box's first line, under a hairline the message follows.
+          needEmail ? k.field({
+            value: email,
+            onChange: setEmail,
+            placeholder: "Email for our reply (optional)",
+            email: true,
+            max: 200,
+            style: { minHeight: 0, marginRight: 10, marginBottom: 4, paddingHorizontal: 0, paddingTop: 0, paddingBottom: 8, borderWidth: 0, borderRadius: 0, borderBottomWidth: 1, borderBottomColor: emailOk ? p.line : p.danger, backgroundColor: "transparent", fontSize: 13.5 }
+          }) : null,
           k.field({ value: body, onChange: setBody, placeholder: "Write a message\u2026", multiline: true, max: 4e3, style: { minHeight: 28, maxHeight: 120, borderWidth: 0, paddingHorizontal: 0, paddingVertical: 4, backgroundColor: "transparent" } }),
           (0, import_react2.createElement)(
             RN3.View,
@@ -3296,11 +3472,13 @@ var MessengerSheet = ({
         key: v,
         onPress: () => setView(v),
         accessibilityRole: "tab",
+        accessibilityLabel: name,
         accessibilityState: { selected: on },
-        style: { flex: 1, flexDirection: "row", alignItems: "center", justifyContent: "center", gap: 6, height: 36, borderRadius: 18, ...on ? { backgroundColor: hu.segment, ...segLift } : {} }
+        // Only the open tab carries its name; the others are icons, so the bar fits a narrow phone.
+        style: { ...on ? { flex: 1 } : { width: 48 }, flexDirection: "row", alignItems: "center", justifyContent: "center", gap: 6, height: 36, borderRadius: 18, ...on ? { backgroundColor: hu.segment, ...segLift } : {} }
       },
       glyph(icon, on ? hu.fg : hu.muted, 17),
-      k.text(name, { fontSize: 13.5, fontWeight: "500", color: on ? hu.fg : hu.muted }),
+      on ? k.text(name, { fontSize: 13.5, fontWeight: "500", color: hu.fg }) : null,
       badge ? (0, import_react2.createElement)(RN3.View, { style: { position: "absolute", top: 7, right: 12, width: 8, height: 8, borderRadius: 4, backgroundColor: p.danger } }) : null
     );
   };
@@ -3314,7 +3492,7 @@ var MessengerSheet = ({
   const head = (0, import_react2.createElement)(
     RN3.View,
     { key: "head", style: { flexDirection: "row", alignItems: "center", gap: 8, paddingLeft: 12, paddingRight: 12, paddingTop: 12, paddingBottom: 6, backgroundColor: ground } },
-    typeof view !== "string" ? back("help", "All articles") : view === "messages" ? back("home", "Back to home") : view === "home" && (o.logo || title) ? o.logo ? (0, import_react2.createElement)(RN3.Image, { key: "logo", source: { uri: o.logo }, accessibilityIgnoresInvertColors: true, style: { width: 28, height: 28, borderRadius: 8, marginLeft: 4 } }) : teamMark(title, alpha(p.accent, 0.16), p.accent, 28) : null,
+    typeof view !== "string" ? back("help", "All articles") : view === "messages" ? back("home", "Back to home") : view === "home" && (o.logo || title) ? o.logo ? (0, import_react2.createElement)(RN3.Image, { key: "logo", source: { uri: o.logo }, accessibilityIgnoresInvertColors: true, resizeMode: "contain", style: { height: 28, aspectRatio: 1, maxWidth: 132, borderRadius: 8, marginLeft: 4 } }) : teamMark(title, alpha(p.accent, 0.16), p.accent, 28) : null,
     // In the chat: who answers, in the middle.
     view === "messages" && title ? (0, import_react2.createElement)(
       RN3.View,
@@ -3378,6 +3556,7 @@ var MRRocketMessenger = ({ client, appearance, options: given = {} }) => {
     corners: look.corners,
     header: look.header,
     logo: look.logo,
+    agentName: look.agentName,
     ...defined
   } : given;
   const p = usePalette({ theme: appearance?.theme ?? look?.theme, accent: appearance?.accent ?? look?.accent });
@@ -3467,7 +3646,7 @@ var MRRocketMessenger = ({ client, appearance, options: given = {} }) => {
         elevation: 6
       }
     },
-    k.muted(`${whoLabel[banner.from]}${unseen > 1 ? ` \xB7 ${unseen} new` : ""}`, { fontWeight: "600", fontSize: 12 }),
+    k.muted(`${who(banner.from, options.agentName)}${unseen > 1 ? ` \xB7 ${unseen} new` : ""}`, { fontWeight: "600", fontSize: 12 }),
     (0, import_react2.createElement)(RN3.Text, { numberOfLines: 3, style: { color: p.fg, fontSize: 15, lineHeight: 20 } }, banner.body)
   ) : null;
   if (!launcher && !toast && !open) return null;
@@ -3570,6 +3749,10 @@ var usePaywall = () => {
   const client = useClient();
   return { open: client.openPaywall };
 };
+var useReview = () => {
+  const client = useClient();
+  return { request: client.requestReview };
+};
 var useOnboarding = () => {
   const client = useClient();
   return { start: client.startOnboarding };