@mushi-mushi/react-native 0.20.1 → 0.22.0

package/dist/index.cjs

@@ -49,7 +49,8 @@ module.exports = __toCommonJS(index_exports);
 
 // src/provider.tsx
 var import_react4 = require("react");
-var import_core6 = require("@mushi-mushi/core");
+var import_react_native5 = require("react-native");
+var import_core8 = require("@mushi-mushi/core");
 
 // src/capture/console-capture.ts
 var import_core = require("@mushi-mushi/core");
@@ -543,6 +544,7 @@ var MushiBottomSheet = ({
   const [category, setCategory] = (0, import_react.useState)(null);
   const [description, setDescription] = (0, import_react.useState)("");
   const [phase, setPhase] = (0, import_react.useState)("form");
+  const [submitError, setSubmitError] = (0, import_react.useState)(null);
   const [sheetTab, setSheetTab] = (0, import_react.useState)("report");
   const [inboxReports, setInboxReports] = (0, import_react.useState)([]);
   const [inboxLoading, setInboxLoading] = (0, import_react.useState)(false);
@@ -616,6 +618,8 @@ var MushiBottomSheet = ({
         ...prev,
         { role: "bot", text: botText, options: reply.options }
       ]);
+    } catch {
+      setAssistantError("Could not reach the assistant. Try again.");
     } finally {
       setAssistantSending(false);
     }
@@ -689,24 +693,46 @@ var MushiBottomSheet = ({
   ).current;
   const handleSubmit = async () => {
     if (!category || !description.trim() || !mushi) return;
+    const trimmed = description.trim();
+    if (trimmed.length < 20) {
+      setSubmitError("Please write at least 20 characters so we can understand the issue.");
+      return;
+    }
+    setSubmitError(null);
     setPhase("sending");
     try {
-      await mushi.submitReport({
+      const outcome = await mushi.submitReport({
         category,
-        description: description.trim(),
+        description: trimmed,
         screenshotDataUrl: screenshotDataUrl && screenshotAttached ? screenshotDataUrl : void 0
       });
+      if (!outcome.ok) {
+        if (outcome.failureKind === "credentials" || outcome.failureKind === "quota") {
+          setSubmitError("Could not send \u2014 check the project API key or plan quota.");
+          setPhase("error");
+          return;
+        }
+        if (outcome.failureKind === "rate_limited") {
+          setSubmitError("Sending too fast \u2014 we queued this and will retry shortly.");
+          setPhase("error");
+          return;
+        }
+        setSubmitError("Queued for retry \u2014 we will send it when the connection is back.");
+        setPhase("error");
+        return;
+      }
       setPhase("sent");
       setTimeout(handleClose, 1400);
     } catch {
-      setPhase("form");
+      setSubmitError("Something went wrong. Please try again.");
+      setPhase("error");
     }
   };
   const activeScreenshot = screenshotDataUrl && screenshotAttached ? screenshotDataUrl : null;
   const pal = (0, import_core3.mushiPalette)(dark ? "dark" : "light");
-  const colors = dark ? { bg: pal.paper, text: pal.ink, sub: pal.inkMuted, card: pal.paperRaised, accent: import_core3.MUSHI_BANNER_NEON.bg, accentInk: import_core3.MUSHI_BANNER_NEON.fg, border: pal.ruleStrong, backdrop: "rgba(0,0,0,0.6)", disabled: "#3a3a3c", disabledText: pal.inkFaint } : { bg: pal.paperRaised, text: pal.ink, sub: pal.inkMuted, card: pal.paper, accent: import_core3.MUSHI_BANNER_NEON.bg, accentInk: import_core3.MUSHI_BANNER_NEON.fg, border: pal.ruleStrong, backdrop: "rgba(0,0,0,0.35)", disabled: "#d1d1d6", disabledText: pal.inkFaint };
+  const colors = dark ? { bg: pal.paper, text: pal.ink, sub: pal.inkMuted, card: pal.paperRaised, accent: import_core3.MUSHI_BANNER_NEON.bg, accentInk: import_core3.MUSHI_BANNER_NEON.fg, border: pal.ruleStrong, backdrop: "rgba(0,0,0,0.6)", disabled: import_core3.MUSHI_CONTROL_DISABLED.dark, disabledText: pal.inkFaint } : { bg: pal.paperRaised, text: pal.ink, sub: pal.inkMuted, card: pal.paper, accent: import_core3.MUSHI_BANNER_NEON.bg, accentInk: import_core3.MUSHI_BANNER_NEON.fg, border: pal.ruleStrong, backdrop: "rgba(0,0,0,0.35)", disabled: import_core3.MUSHI_CONTROL_DISABLED.light, disabledText: pal.inkFaint };
   const sheetTabs = ["report", "inbox", ...assistantEnabled ? ["assistant"] : []];
-  const canSubmit = !!category && description.trim().length > 0 && phase === "form";
+  const canSubmit = !!category && description.trim().length >= 20 && (phase === "form" || phase === "error");
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Modal, { visible, transparent: true, animationType: "none", statusBarTranslucent: true, children: /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(
     import_react_native2.KeyboardAvoidingView,
     {
@@ -734,7 +760,7 @@ var MushiBottomSheet = ({
                 /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: [s.brandEyebrow, { color: import_core3.MUSHI_BANNER_NEON.fg }], children: "MUSHI \xB7 BETA" }),
                 /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: [s.brandTitle, { color: import_core3.MUSHI_BANNER_NEON.fg }], children: sheetTab === "assistant" ? assistantLabel : sheetTab === "inbox" ? t.flows.reports.title : t.widget.title })
               ] }),
-              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.View, { style: s.tabRow, children: sheetTabs.map((tab) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
+              /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.View, { style: [s.tabRow, { borderBottomColor: colors.border }], children: sheetTabs.map((tab) => /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                 import_react_native2.TouchableOpacity,
                 {
                   onPress: () => {
@@ -887,16 +913,22 @@ var MushiBottomSheet = ({
                         multiline: true,
                         textAlignVertical: "top",
                         value: description,
-                        onChangeText: setDescription,
-                        editable: phase === "form"
+                        onChangeText: (text) => {
+                          setDescription(text.slice(0, 4e3));
+                          if (submitError) setSubmitError(null);
+                          if (phase === "error") setPhase("form");
+                        },
+                        editable: phase === "form" || phase === "error",
+                        maxLength: 4e3
                       }
                     ),
+                    submitError ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native2.Text, { style: { color: colors.accent, marginTop: 6, fontSize: 12 }, children: submitError }) : null,
                     activeScreenshot ? /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native2.View, { style: s.screenshotRow, children: [
                       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
                         import_react_native2.Image,
                         {
                           source: { uri: activeScreenshot },
-                          style: s.screenshotThumb,
+                          style: [s.screenshotThumb, { backgroundColor: colors.text }],
                           accessibilityLabel: t.step3.screenshotPreviewAlt
                         }
                       ),
@@ -957,10 +989,10 @@ var s = import_react_native2.StyleSheet.create({
     left: 0,
     right: 0,
     minHeight: SHEET_HEIGHT,
-    borderTopLeftRadius: 20,
-    borderTopRightRadius: 20,
-    paddingBottom: import_react_native2.Platform.OS === "ios" ? 34 : 16,
-    shadowColor: "#000",
+    borderTopLeftRadius: import_core3.MUSHI_RADIUS.sheet,
+    borderTopRightRadius: import_core3.MUSHI_RADIUS.sheet,
+    paddingBottom: import_react_native2.Platform.OS === "ios" ? 34 : import_core3.MUSHI_SPACING.roomy,
+    shadowColor: import_core3.MUSHI_SHADOW_INK,
     shadowOffset: { width: 0, height: -3 },
     shadowOpacity: 0.12,
     shadowRadius: 8,
@@ -968,22 +1000,22 @@ var s = import_react_native2.StyleSheet.create({
   },
   handleArea: {
     alignItems: "center",
-    paddingVertical: 10
+    paddingVertical: import_core3.MUSHI_SPACING.comfy
   },
   handle: {
     width: 40,
     height: 5,
-    borderRadius: 3,
+    borderRadius: import_core3.MUSHI_RADIUS.control,
     opacity: 0.5
   },
   brandHeader: {
-    paddingHorizontal: 20,
-    paddingTop: 10,
-    paddingBottom: 12,
+    paddingHorizontal: import_core3.MUSHI_SPACING.lounge,
+    paddingTop: import_core3.MUSHI_SPACING.comfy,
+    paddingBottom: import_core3.MUSHI_SPACING.comfy,
     borderBottomWidth: 1.5
   },
   brandEyebrow: {
-    fontSize: 10,
+    fontSize: import_core3.MUSHI_TYPE.sizeLabel,
     fontWeight: "700",
     letterSpacing: 1.2,
     marginBottom: 2,
@@ -995,59 +1027,61 @@ var s = import_react_native2.StyleSheet.create({
     letterSpacing: -0.2
   },
   body: {
-    paddingHorizontal: 20,
-    paddingTop: 4
+    paddingHorizontal: import_core3.MUSHI_SPACING.lounge,
+    paddingTop: import_core3.MUSHI_SPACING.tight
   },
   title: {
     fontSize: 20,
     fontWeight: "700",
-    marginBottom: 16
+    marginBottom: import_core3.MUSHI_SPACING.roomy
   },
   stepLabel: {
-    fontSize: 12,
+    fontSize: import_core3.MUSHI_TYPE.sizeLabel,
     fontWeight: "600",
     letterSpacing: 0.2,
-    marginTop: 8,
-    marginBottom: 10,
+    marginTop: import_core3.MUSHI_SPACING.snug,
+    marginBottom: import_core3.MUSHI_SPACING.comfy,
     textTransform: "uppercase"
   },
   catRow: {
     flexDirection: "row",
     justifyContent: "space-between",
-    marginBottom: 16
+    marginBottom: import_core3.MUSHI_SPACING.roomy
   },
   catBtn: {
     alignItems: "center",
-    paddingVertical: 10,
+    paddingVertical: import_core3.MUSHI_SPACING.comfy,
     paddingHorizontal: 6,
-    borderRadius: 12,
+    borderRadius: import_core3.MUSHI_RADIUS.card,
     borderWidth: 1,
     flex: 1,
-    marginHorizontal: 3
+    marginHorizontal: 3,
+    minHeight: 44
   },
   catEmoji: {
     fontSize: 22,
-    marginBottom: 4
+    marginBottom: import_core3.MUSHI_SPACING.tight
   },
   catLabel: {
-    fontSize: 11,
+    fontSize: import_core3.MUSHI_TYPE.sizeLabel,
     fontWeight: "600"
   },
   input: {
     borderWidth: 1,
-    borderRadius: 12,
+    borderRadius: import_core3.MUSHI_RADIUS.card,
     padding: 14,
     fontSize: 15,
     minHeight: 100,
-    marginBottom: 16
+    marginBottom: import_core3.MUSHI_SPACING.roomy
   },
   submitBtn: {
-    borderRadius: 12,
+    borderRadius: import_core3.MUSHI_RADIUS.card,
     paddingVertical: 14,
-    alignItems: "center"
+    alignItems: "center",
+    minHeight: 44
   },
   submitText: {
-    color: "#fff",
+    color: import_core3.MUSHI_INVERSE,
     fontSize: 16,
     fontWeight: "700"
   },
@@ -1078,7 +1112,6 @@ var s = import_react_native2.StyleSheet.create({
     width: 48,
     height: 36,
     borderRadius: 4,
-    backgroundColor: "#000",
     flexShrink: 0
   },
   screenshotMeta: {
@@ -1100,7 +1133,6 @@ var s = import_react_native2.StyleSheet.create({
   tabRow: {
     flexDirection: "row",
     borderBottomWidth: import_react_native2.StyleSheet.hairlineWidth,
-    borderBottomColor: "#ccc",
     marginBottom: 8
   },
   tabBtn: {
@@ -1212,7 +1244,8 @@ var MushiFloatingButton = ({
   const currentX = (0, import_react2.useRef)(baseX);
   const currentY = (0, import_react2.useRef)(0);
   const isDragging = (0, import_react2.useRef)(false);
-  const accentColor = accent ?? (0, import_core4.mushiPalette)(dark ? "dark" : "light").accent;
+  const pal = (0, import_core4.mushiPalette)(dark ? "dark" : "light");
+  const accentColor = accent ?? pal.accent;
   (0, import_react2.useEffect)(() => {
     if (!persist) return;
     void loadStoredPos().then((pos) => {
@@ -1315,7 +1348,7 @@ var MushiFloatingButton = ({
           left: posX,
           bottom: import_react_native3.Animated.add(new import_react_native3.Animated.Value(baseBottom), import_react_native3.Animated.multiply(posY, -1)),
           backgroundColor: accentColor,
-          shadowColor: dark ? accentColor : "#000",
+          shadowColor: dark ? accentColor : pal.ink,
           transform: [{ scale }]
         }
       ],
@@ -1404,7 +1437,7 @@ var s3 = import_react_native4.StyleSheet.create({
     backgroundColor: import_core5.MUSHI_BANNER_NEON.bg,
     borderTopWidth: 1,
     borderTopColor: import_core5.MUSHI_BANNER_NEON.border,
-    zIndex: 99998,
+    zIndex: import_core5.MUSHI_Z.banner,
     elevation: 8,
     paddingBottom: import_react_native4.Platform.OS === "ios" ? 0 : 0
   },
@@ -1412,12 +1445,13 @@ var s3 = import_react_native4.StyleSheet.create({
     flex: 1,
     flexDirection: "row",
     alignItems: "center",
-    gap: 8,
-    paddingHorizontal: 12,
-    paddingVertical: 8
+    gap: import_core5.MUSHI_SPACING.snug,
+    paddingHorizontal: import_core5.MUSHI_SPACING.comfy,
+    paddingVertical: import_core5.MUSHI_SPACING.snug,
+    minHeight: 44
   },
   eyebrow: {
-    fontSize: 10,
+    fontSize: import_core5.MUSHI_TYPE.sizeLabel,
     fontWeight: "700",
     letterSpacing: 1.2,
     color: import_core5.MUSHI_BANNER_NEON.fg
@@ -1446,13 +1480,336 @@ var s3 = import_react_native4.StyleSheet.create({
   }
 });
 
+// src/analytics/event-tracker.ts
+var import_core6 = require("@mushi-mushi/core");
+var CONSENT_BUFFER_MAX = 50;
+var SPILL_MAX = 200;
+var SPILL_TTL_MS = 24 * 60 * 60 * 1e3;
+var SURFACE = "mobile";
+async function defaultStorage() {
+  try {
+    const mod = await import("@react-native-async-storage/async-storage");
+    return mod.default;
+  } catch {
+    return null;
+  }
+}
+function createRNEventTracker(opts) {
+  const cfg = opts.config ?? {};
+  const enabled = cfg.enabled !== false;
+  const consentMode = cfg.consent ?? "implied";
+  const allowlist = cfg.propertyAllowlist ?? [];
+  const spillKey = `@mushi:events_spill_${opts.projectId}`;
+  const consentKey = `@mushi:analytics_consent_${opts.projectId}`;
+  let buffer = [];
+  let consentBuffer = [];
+  let consent = consentMode === "required" ? "pending" : "granted";
+  let userId = null;
+  let userTraits = null;
+  let pendingIdentify = false;
+  let flushing = false;
+  let destroyed = false;
+  let timer = null;
+  let storage = null;
+  const consentListeners = /* @__PURE__ */ new Set();
+  const loadStorage = opts.storage ?? defaultStorage;
+  const resolveClient = () => typeof opts.client === "function" ? opts.client() : opts.client;
+  async function readSpill() {
+    if (!storage) return [];
+    try {
+      const raw = await storage.getItem(spillKey);
+      if (!raw) return [];
+      const parsed = JSON.parse(raw);
+      if (!parsed || Date.now() - parsed.at > SPILL_TTL_MS) {
+        await storage.removeItem(spillKey);
+        return [];
+      }
+      return Array.isArray(parsed.events) ? parsed.events.slice(0, SPILL_MAX) : [];
+    } catch {
+      return [];
+    }
+  }
+  async function writeSpill(events) {
+    if (!storage) return;
+    try {
+      if (events.length === 0) await storage.removeItem(spillKey);
+      else await storage.setItem(spillKey, JSON.stringify({ at: Date.now(), events: events.slice(-SPILL_MAX) }));
+    } catch {
+    }
+  }
+  async function flushNow() {
+    if (destroyed && buffer.length === 0) return;
+    await ready;
+    if (flushing || consent !== "granted") return;
+    if (buffer.length === 0 && !pendingIdentify) return;
+    const client = resolveClient();
+    if (!client) return;
+    flushing = true;
+    const batch = buffer.splice(0, import_core6.EVENT_PROPERTY_LIMITS.maxServerBatch);
+    if (pendingIdentify) {
+      batch.unshift({ name: "identify", ts: (/* @__PURE__ */ new Date()).toISOString(), properties: {} });
+      pendingIdentify = false;
+    }
+    try {
+      const anonId = await Promise.resolve(opts.getAnonId());
+      const payload = {
+        anon_id: anonId,
+        user_id: userId ?? opts.getUserId?.() ?? null,
+        user_traits: userTraits ?? opts.getUserTraits?.() ?? null,
+        session_id: null,
+        sdk_version: opts.sdkVersion ?? null,
+        surface: SURFACE,
+        events: batch
+      };
+      const res = await client.postProductEvents(payload);
+      if (!res.ok) await writeSpill([...await readSpill(), ...batch.filter((e) => e.name !== "identify")]);
+      else await writeSpill([]);
+    } catch {
+      await writeSpill([...await readSpill(), ...batch.filter((e) => e.name !== "identify")]);
+    } finally {
+      flushing = false;
+    }
+    if (buffer.length >= import_core6.EVENT_PROPERTY_LIMITS.maxClientBatch) void flushNow();
+  }
+  function enqueue(ev) {
+    if (consent === "denied") return;
+    if (consent === "pending") {
+      if (consentBuffer.length < CONSENT_BUFFER_MAX) consentBuffer.push(ev);
+      return;
+    }
+    buffer.push(ev);
+    if (buffer.length >= import_core6.EVENT_PROPERTY_LIMITS.maxClientBatch) void flushNow();
+  }
+  const ready = enabled ? (async () => {
+    storage = await loadStorage();
+    if (destroyed) return;
+    let stored = null;
+    try {
+      stored = storage ? await storage.getItem(consentKey) : null;
+    } catch {
+      stored = null;
+    }
+    if (stored === "denied") {
+      consent = "denied";
+      buffer = [];
+      consentBuffer = [];
+      pendingIdentify = false;
+      await writeSpill([]);
+      return;
+    }
+    if (stored === "granted" && consent === "pending") {
+      consent = "granted";
+      buffer.push(...consentBuffer);
+      consentBuffer = [];
+    }
+    const spill = await readSpill();
+    if (spill.length > 0) {
+      buffer.unshift(...spill);
+      await writeSpill([]);
+    }
+  })().catch(() => void 0) : Promise.resolve();
+  if (enabled) {
+    const interval = Math.max(1e3, cfg.flushIntervalMs ?? 5e3);
+    timer = setInterval(() => {
+      void flushNow();
+    }, interval);
+  }
+  return {
+    ready,
+    track(name, properties, trackOpts) {
+      if (!enabled || destroyed) return false;
+      if (!(0, import_core6.isValidEventName)(name)) return false;
+      const { properties: props } = (0, import_core6.sanitizeEventProperties)(properties, { allowlist, scrub: opts.scrub });
+      let merged = props;
+      if (trackOpts?.reserved) {
+        const { properties: res } = (0, import_core6.sanitizeEventProperties)(trackOpts.reserved, { allowReserved: true, scrub: opts.scrub });
+        merged = { ...props, ...res };
+      }
+      merged.$surface = SURFACE;
+      const route = opts.getRoute?.();
+      if (route && merged.$route === void 0) merged.$route = route;
+      if (!(0, import_core6.propertiesWithinByteLimit)(merged)) return false;
+      enqueue({
+        name,
+        ts: (/* @__PURE__ */ new Date()).toISOString(),
+        properties: merged,
+        ...trackOpts?.dedupKey ? { dedup_key: trackOpts.dedupKey } : {}
+      });
+      return true;
+    },
+    setConsent(state) {
+      void ready.then(() => storage?.setItem(consentKey, state)).catch(() => void 0);
+      if (state === "denied") {
+        consent = "denied";
+        buffer = [];
+        consentBuffer = [];
+        pendingIdentify = false;
+        void writeSpill([]);
+      } else {
+        const wasPending = consent === "pending";
+        consent = "granted";
+        if (wasPending && consentBuffer.length > 0) {
+          buffer.push(...consentBuffer);
+          consentBuffer = [];
+        }
+        if (buffer.length > 0 || pendingIdentify) void flushNow();
+      }
+      for (const listener of [...consentListeners]) {
+        try {
+          listener(state);
+        } catch {
+        }
+      }
+    },
+    setIdentity(id, traits) {
+      userId = id;
+      userTraits = traits ?? null;
+      if (id && enabled && consent !== "denied") {
+        pendingIdentify = true;
+        void flushNow();
+      }
+    },
+    consentState() {
+      return enabled ? consent : "denied";
+    },
+    onConsentChange(listener) {
+      consentListeners.add(listener);
+      return () => {
+        consentListeners.delete(listener);
+      };
+    },
+    async flush() {
+      await ready;
+      await flushNow();
+    },
+    async destroy() {
+      if (timer != null) {
+        clearInterval(timer);
+        timer = null;
+      }
+      await flushNow().catch(() => void 0);
+      destroyed = true;
+      buffer = [];
+      consentBuffer = [];
+      pendingIdentify = false;
+    }
+  };
+}
+
+// src/analytics/session-tracker.ts
+var import_core7 = require("@mushi-mushi/core");
+var HEARTBEAT_INTERVAL_MS = 6e4;
+var RESUME_WINDOW_MS = 30 * 6e4;
+function createRNSessionTracker(opts) {
+  const clock = opts.now ?? Date.now;
+  const resolveClient = () => typeof opts.client === "function" ? opts.client() : opts.client;
+  let sessionId = opts.sessionId ?? `sess_${(0, import_core7.newUuid)()}`;
+  let pageViewCount = 0;
+  let started = false;
+  let allowed = false;
+  let foreground = true;
+  let destroyed = false;
+  let backgroundedAt = null;
+  let heartbeat = null;
+  function route() {
+    return opts.getRoute?.() ?? null;
+  }
+  function send(kind, extra) {
+    const client = resolveClient();
+    if (!client || !allowed || destroyed) return;
+    const base = {
+      kind,
+      session_id: sessionId,
+      ts: new Date(clock()).toISOString(),
+      page_view_count: pageViewCount,
+      user_agent: opts.userAgent ?? null,
+      sdk_version: opts.sdkVersion
+    };
+    void Promise.resolve(opts.getReporterToken()).then((token) => client.postSessionEvent({ ...base, reporter_token_hash: token, ...extra })).catch(() => void 0);
+  }
+  function stopHeartbeat() {
+    if (heartbeat != null) {
+      clearInterval(heartbeat);
+      heartbeat = null;
+    }
+  }
+  function startHeartbeat() {
+    stopHeartbeat();
+    heartbeat = setInterval(() => send("session_heartbeat", { route: route() }), HEARTBEAT_INTERVAL_MS);
+  }
+  function startSession() {
+    started = true;
+    pageViewCount = 1;
+    send("session_start", { route: route() });
+    startHeartbeat();
+  }
+  function activate() {
+    if (allowed || destroyed) return;
+    allowed = true;
+    if (!foreground) return;
+    if (!started) startSession();
+    else startHeartbeat();
+  }
+  function deactivate() {
+    allowed = false;
+    stopHeartbeat();
+  }
+  const unsubscribe = opts.consent.onConsentChange(() => {
+    if (opts.consent.consentState() === "granted") activate();
+    else deactivate();
+  });
+  void opts.consent.ready.then(() => {
+    if (opts.consent.consentState() === "granted") activate();
+  }).catch(() => void 0);
+  return {
+    onAppStateChange(state) {
+      if (destroyed) return;
+      if (state === "active") {
+        if (foreground) return;
+        foreground = true;
+        const away = backgroundedAt == null ? 0 : clock() - backgroundedAt;
+        backgroundedAt = null;
+        if (!allowed) return;
+        if (!started || away >= RESUME_WINDOW_MS) {
+          sessionId = `sess_${(0, import_core7.newUuid)()}`;
+          startSession();
+        } else {
+          send("session_heartbeat", { route: route() });
+          startHeartbeat();
+        }
+        return;
+      }
+      if (state !== "background" || !foreground) return;
+      foreground = false;
+      backgroundedAt = clock();
+      stopHeartbeat();
+      if (started) send("session_end", { route: route() });
+    },
+    pageView(next) {
+      if (!allowed || !started || !foreground) return;
+      pageViewCount += 1;
+      send("page_view", { route: next });
+    },
+    destroy() {
+      destroyed = true;
+      deactivate();
+      unsubscribe();
+    }
+  };
+}
+
 // src/version.ts
 var MUSHI_SDK_PACKAGE = "@mushi-mushi/react-native";
-var MUSHI_SDK_VERSION = "0.20.1" ? "0.20.1" : "0.17.0";
+var MUSHI_SDK_VERSION = "0.22.0" ? "0.22.0" : "0.17.0";
 
 // src/provider.tsx
 var import_jsx_runtime4 = require("react/jsx-runtime");
 var MushiContext = (0, import_react4.createContext)(null);
+function nativeUserAgent() {
+  const os = import_react_native5.Platform?.OS ?? "native";
+  const version = import_react_native5.Platform?.Version;
+  return `${MUSHI_SDK_PACKAGE}/${MUSHI_SDK_VERSION} (${version != null ? `${os} ${String(version)}` : os})`;
+}
 var DEFAULT_SCREENSHOT_HINT = "Check the preview \u2014 remove it if any private info (balances, personal details) is visible.";
 function resolveScreenshotHint(v) {
   if (v === false) return null;
@@ -1495,9 +1852,9 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
   const networkRef = (0, import_react4.useRef)(null);
   const queueRef = (0, import_react4.useRef)(null);
   const apiClientRef = (0, import_react4.useRef)(null);
-  const sessionIdRef = (0, import_react4.useRef)(`sess_${(0, import_core6.newUuid)()}`);
+  const sessionIdRef = (0, import_react4.useRef)(`sess_${(0, import_core8.newUuid)()}`);
   const breadcrumbsRef = (0, import_react4.useRef)(
-    (0, import_core6.createBreadcrumbBuffer)({ max: config.capture?.maxBreadcrumbs ?? 50 })
+    (0, import_core8.createBreadcrumbBuffer)({ max: config.capture?.maxBreadcrumbs ?? 50 })
   );
   const [sheetVisible, setSheetVisible] = (0, import_react4.useState)(false);
   const [sheetPreferredTab, setSheetPreferredTab] = (0, import_react4.useState)("report");
@@ -1522,7 +1879,7 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
   if (config.endpoint && !config.apiEndpoint && __DEV__) {
     console.warn("[MushiProvider] `endpoint` is deprecated \u2014 use `apiEndpoint` instead.");
   }
-  const apiEndpoint = rawEndpoint ?? import_core6.DEFAULT_API_ENDPOINT;
+  const apiEndpoint = rawEndpoint ?? import_core8.DEFAULT_API_ENDPOINT;
   (0, import_react4.useEffect)(() => {
     if (config.capture?.console !== false) {
       consoleRef.current = setupConsoleCapture(config.capture?.maxConsoleEntries);
@@ -1530,7 +1887,7 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
     if (config.capture?.network !== false) {
       networkRef.current = setupNetworkCapture(config.capture?.maxNetworkEntries, apiEndpoint);
     }
-    apiClientRef.current = (0, import_core6.createApiClient)({
+    apiClientRef.current = (0, import_core8.createApiClient)({
       projectId: config.projectId,
       apiKey: config.apiKey,
       apiEndpoint,
@@ -1567,14 +1924,14 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
         if (existing && existing.startsWith("mushi_")) {
           reporterTokenRef.current = existing;
         } else {
-          const fresh = `mushi_${(0, import_core6.newUuid)()}`;
+          const fresh = `mushi_${(0, import_core8.newUuid)()}`;
           reporterTokenRef.current = fresh;
           await saveReporterToken(fresh, secureStorage);
         }
         resolveReporterTokenReady();
       } catch {
         if (reporterTokenRef.current === `rn-${config.projectId}-anon`) {
-          reporterTokenRef.current = `mushi_${(0, import_core6.newUuid)()}`;
+          reporterTokenRef.current = `mushi_${(0, import_core8.newUuid)()}`;
         }
         resolveReporterTokenReady();
       }
@@ -1694,7 +2051,7 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
       const merged = Object.keys(metadataRef.current).length > 0 ? { ...contextMeta, ...metadataRef.current } : Object.keys(contextMeta).length > 0 ? contextMeta : void 0;
       const breadcrumbs = breadcrumbsRef.current.getAll().map((c) => ({
         ...c,
-        message: (0, import_core6.scrubPii)(c.message)
+        message: (0, import_core8.scrubPii)(c.message)
       }));
       const timeline = breadcrumbs.map((c) => ({
         ts: c.timestamp,
@@ -1703,10 +2060,10 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
       }));
       const fingerprintHash = getDeviceFingerprintHash(deviceInfo);
       const report = {
-        id: (0, import_core6.newUuid)(),
+        id: (0, import_core8.newUuid)(),
         projectId: config.projectId,
         category: data.category,
-        description: (0, import_core6.scrubPii)(data.description),
+        description: (0, import_core8.scrubPii)(data.description),
         environment: {
           userAgent: deviceInfo.systemName ?? "ReactNative",
           platform: deviceInfo.platform ?? "mobile",
@@ -1719,7 +2076,7 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
         },
         consoleLogs: (consoleRef.current?.getEntries() ?? []).map((entry) => ({
           ...entry,
-          message: (0, import_core6.scrubPii)(entry.message)
+          message: (0, import_core8.scrubPii)(entry.message)
         })),
         networkLogs: networkRef.current?.getEntries().map((entry) => ({
           ...entry,
@@ -1738,21 +2095,34 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
         createdAt: (/* @__PURE__ */ new Date()).toISOString()
       };
       const client = apiClientRef.current;
-      if (!client) return;
+      if (!client) {
+        console.error(
+          "[Mushi] submitReport called before the SDK finished initializing. Ensure <MushiProvider> is mounted with a valid projectId and apiKey."
+        );
+        return { ok: false, failureKind: "permanent" };
+      }
       const result = await client.submitReport(report);
       if (!result.ok) {
-        const isCredentialError = result.error?.code === "HTTP_401" || result.error?.code === "HTTP_403" || result.error?.code?.includes("UNAUTHORIZED") || result.error?.code?.includes("FORBIDDEN");
+        const code = result.error?.code ?? "";
+        const isCredentialError = code === "HTTP_401" || code === "HTTP_403" || code.includes("UNAUTHORIZED") || code.includes("FORBIDDEN") || code.includes("INVALID_API_KEY");
         if (isCredentialError) {
-          const where = apiEndpoint.replace(/\/$/, "") === import_core6.DEFAULT_API_ENDPOINT ? "Get the correct values at: https://kensaur.us/mushi-mushi/admin/projects" : "Get the correct values from your Mushi console's Projects page.";
+          const where = apiEndpoint.replace(/\/$/, "") === import_core8.DEFAULT_API_ENDPOINT ? "Get the correct values at: https://kensaur.us/mushi-mushi/admin/projects" : "Get the correct values from your Mushi console's Projects page.";
           console.error(
             '[Mushi] Credentials rejected. Check your projectId and apiKey (must have "report:write" scope). ' + where
           );
-          return;
+          return { ok: false, failureKind: "credentials" };
         }
+        const isRateLimited = code === "HTTP_429" || code.includes("RATE_LIMIT");
         await queueRef.current?.enqueue(report);
         config.callbacks?.onReportQueued?.(report.id);
+        return {
+          ok: false,
+          queued: true,
+          failureKind: isRateLimited ? "rate_limited" : "retrying"
+        };
       } else {
         config.callbacks?.onReportSubmitted?.(report.id);
+        return { ok: true };
       }
     },
     [config.projectId, config.callbacks, apiEndpoint]
@@ -1782,6 +2152,63 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
       if (rewardsFlushRef.current) clearInterval(rewardsFlushRef.current);
     };
   }, [config.rewards?.enabled, config.rewards?.trackActivity, config.rewards?.flushIntervalMs]);
+  const eventTrackerRef = (0, import_react4.useRef)(null);
+  const sessionTrackerRef = (0, import_react4.useRef)(null);
+  (0, import_react4.useEffect)(() => {
+    const getRoute = () => screenRef.current?.route ?? screenRef.current?.name ?? null;
+    const tracker = createRNEventTracker({
+      projectId: config.projectId,
+      client: () => apiClientRef.current,
+      getAnonId: async () => {
+        await reporterTokenReadyRef.current;
+        return reporterTokenRef.current;
+      },
+      getUserId: () => userRef.current?.id ?? null,
+      getRoute,
+      sdkVersion: MUSHI_SDK_VERSION,
+      config: config.analytics,
+      scrub: import_core8.scrubPii
+    });
+    eventTrackerRef.current = tracker;
+    const sessions = config.trackSessions === false ? null : createRNSessionTracker({
+      client: () => apiClientRef.current,
+      getReporterToken: async () => {
+        await reporterTokenReadyRef.current;
+        return reporterTokenRef.current;
+      },
+      getRoute,
+      consent: tracker,
+      sessionId: sessionIdRef.current,
+      sdkVersion: MUSHI_SDK_VERSION,
+      userAgent: nativeUserAgent()
+    });
+    sessionTrackerRef.current = sessions;
+    let sub;
+    try {
+      if (typeof import_react_native5.AppState?.addEventListener === "function") {
+        sub = import_react_native5.AppState.addEventListener("change", (state) => {
+          sessions?.onAppStateChange(state);
+          if (state !== "active") tracker.flush().catch(() => {
+          });
+        });
+      }
+    } catch {
+    }
+    return () => {
+      sub?.remove();
+      sessions?.destroy();
+      sessionTrackerRef.current = null;
+      eventTrackerRef.current = null;
+      tracker.destroy().catch(() => {
+      });
+    };
+  }, [
+    config.projectId,
+    config.analytics?.enabled,
+    config.analytics?.consent,
+    config.analytics?.flushIntervalMs,
+    config.trackSessions
+  ]);
   const instance = (0, import_react4.useMemo)(
     () => ({
       open,
@@ -1799,6 +2226,7 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
           name: traits?.name,
           provider: traits?.provider
         };
+        eventTrackerRef.current?.setIdentity(userId, traits ?? null);
       },
       setUser(user) {
         userRef.current = {
@@ -1807,18 +2235,22 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
           name: user.name,
           provider: user.provider
         };
+        eventTrackerRef.current?.setIdentity(user.id, { email: user.email, name: user.name, provider: user.provider });
       },
       identifyWithToken(token) {
         userTokenRef.current = token && typeof token === "string" ? token : null;
         if (userTokenRef.current) {
-          const claims = (0, import_core6.parseIdentityToken)(userTokenRef.current);
+          const claims = (0, import_core8.parseIdentityToken)(userTokenRef.current);
           if (claims?.sub) {
             userRef.current = {
               id: claims.sub,
               ...claims.email ? { email: claims.email } : {},
               ...claims.name ? { name: claims.name } : {}
             };
+            eventTrackerRef.current?.setIdentity(claims.sub, null);
           }
+        } else {
+          eventTrackerRef.current?.setIdentity(null, null);
         }
       },
       publishPageContext(context) {
@@ -1831,6 +2263,7 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
         const prev = screenRef.current?.name;
         screenRef.current = screen;
         if (screen.name && screen.name !== prev) {
+          sessionTrackerRef.current?.pageView(screen.route ?? screen.name);
           breadcrumbsRef.current.add({
             category: "navigation",
             level: "info",
@@ -1892,6 +2325,13 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
         if (!config.rewards?.enabled) return;
         activityQueueRef.current.push({ action, metadata });
       },
+      // Product analytics (Users & Funnels)
+      track(event, properties) {
+        return eventTrackerRef.current?.track(event, properties) ?? false;
+      },
+      setConsent(state) {
+        eventTrackerRef.current?.setConsent(state);
+      },
       async getTier() {
         const userId = userRef.current?.id;
         const client = apiClientRef.current;