@mushi-mushi/react-native 0.20.1 → 0.22.0

package/dist/index.js

@@ -15,11 +15,12 @@ import {
   useCallback as useCallback4,
   useMemo
 } from "react";
+import { AppState, Platform as Platform5 } from "react-native";
 import {
   createApiClient,
   createBreadcrumbBuffer,
   DEFAULT_API_ENDPOINT,
-  newUuid,
+  newUuid as newUuid2,
   parseIdentityToken,
   scrubPii as scrubPii3
 } from "@mushi-mushi/core";
@@ -474,7 +475,17 @@ import {
   ScrollView,
   useColorScheme
 } from "react-native";
-import { mushiPalette, MUSHI_BANNER_NEON, MUSHI_COPY } from "@mushi-mushi/core";
+import {
+  mushiPalette,
+  MUSHI_BANNER_NEON,
+  MUSHI_COPY,
+  MUSHI_CONTROL_DISABLED,
+  MUSHI_INVERSE,
+  MUSHI_RADIUS,
+  MUSHI_SHADOW_INK,
+  MUSHI_SPACING,
+  MUSHI_TYPE
+} from "@mushi-mushi/core";
 import { getLocale } from "@mushi-mushi/web/i18n";
 
 // src/reporter-status.ts
@@ -540,6 +551,7 @@ var MushiBottomSheet = ({
   const [category, setCategory] = useState(null);
   const [description, setDescription] = useState("");
   const [phase, setPhase] = useState("form");
+  const [submitError, setSubmitError] = useState(null);
   const [sheetTab, setSheetTab] = useState("report");
   const [inboxReports, setInboxReports] = useState([]);
   const [inboxLoading, setInboxLoading] = useState(false);
@@ -613,6 +625,8 @@ var MushiBottomSheet = ({
         ...prev,
         { role: "bot", text: botText, options: reply.options }
       ]);
+    } catch {
+      setAssistantError("Could not reach the assistant. Try again.");
     } finally {
       setAssistantSending(false);
     }
@@ -686,24 +700,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 = mushiPalette(dark ? "dark" : "light");
-  const colors = dark ? { bg: pal.paper, text: pal.ink, sub: pal.inkMuted, card: pal.paperRaised, accent: MUSHI_BANNER_NEON.bg, accentInk: 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: MUSHI_BANNER_NEON.bg, accentInk: 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: MUSHI_BANNER_NEON.bg, accentInk: MUSHI_BANNER_NEON.fg, border: pal.ruleStrong, backdrop: "rgba(0,0,0,0.6)", disabled: MUSHI_CONTROL_DISABLED.dark, disabledText: pal.inkFaint } : { bg: pal.paperRaised, text: pal.ink, sub: pal.inkMuted, card: pal.paper, accent: MUSHI_BANNER_NEON.bg, accentInk: MUSHI_BANNER_NEON.fg, border: pal.ruleStrong, backdrop: "rgba(0,0,0,0.35)", disabled: 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__ */ jsx(Modal, { visible, transparent: true, animationType: "none", statusBarTranslucent: true, children: /* @__PURE__ */ jsxs(
     KeyboardAvoidingView,
     {
@@ -731,7 +767,7 @@ var MushiBottomSheet = ({
                 /* @__PURE__ */ jsx(Text, { style: [s.brandEyebrow, { color: MUSHI_BANNER_NEON.fg }], children: "MUSHI \xB7 BETA" }),
                 /* @__PURE__ */ jsx(Text, { style: [s.brandTitle, { color: MUSHI_BANNER_NEON.fg }], children: sheetTab === "assistant" ? assistantLabel : sheetTab === "inbox" ? t.flows.reports.title : t.widget.title })
               ] }),
-              /* @__PURE__ */ jsx(View, { style: s.tabRow, children: sheetTabs.map((tab) => /* @__PURE__ */ jsx(
+              /* @__PURE__ */ jsx(View, { style: [s.tabRow, { borderBottomColor: colors.border }], children: sheetTabs.map((tab) => /* @__PURE__ */ jsx(
                 TouchableOpacity,
                 {
                   onPress: () => {
@@ -884,16 +920,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__ */ jsx(Text, { style: { color: colors.accent, marginTop: 6, fontSize: 12 }, children: submitError }) : null,
                     activeScreenshot ? /* @__PURE__ */ jsxs(View, { style: s.screenshotRow, children: [
                       /* @__PURE__ */ jsx(
                         Image,
                         {
                           source: { uri: activeScreenshot },
-                          style: s.screenshotThumb,
+                          style: [s.screenshotThumb, { backgroundColor: colors.text }],
                           accessibilityLabel: t.step3.screenshotPreviewAlt
                         }
                       ),
@@ -954,10 +996,10 @@ var s = StyleSheet.create({
     left: 0,
     right: 0,
     minHeight: SHEET_HEIGHT,
-    borderTopLeftRadius: 20,
-    borderTopRightRadius: 20,
-    paddingBottom: Platform2.OS === "ios" ? 34 : 16,
-    shadowColor: "#000",
+    borderTopLeftRadius: MUSHI_RADIUS.sheet,
+    borderTopRightRadius: MUSHI_RADIUS.sheet,
+    paddingBottom: Platform2.OS === "ios" ? 34 : MUSHI_SPACING.roomy,
+    shadowColor: MUSHI_SHADOW_INK,
     shadowOffset: { width: 0, height: -3 },
     shadowOpacity: 0.12,
     shadowRadius: 8,
@@ -965,22 +1007,22 @@ var s = StyleSheet.create({
   },
   handleArea: {
     alignItems: "center",
-    paddingVertical: 10
+    paddingVertical: MUSHI_SPACING.comfy
   },
   handle: {
     width: 40,
     height: 5,
-    borderRadius: 3,
+    borderRadius: MUSHI_RADIUS.control,
     opacity: 0.5
   },
   brandHeader: {
-    paddingHorizontal: 20,
-    paddingTop: 10,
-    paddingBottom: 12,
+    paddingHorizontal: MUSHI_SPACING.lounge,
+    paddingTop: MUSHI_SPACING.comfy,
+    paddingBottom: MUSHI_SPACING.comfy,
     borderBottomWidth: 1.5
   },
   brandEyebrow: {
-    fontSize: 10,
+    fontSize: MUSHI_TYPE.sizeLabel,
     fontWeight: "700",
     letterSpacing: 1.2,
     marginBottom: 2,
@@ -992,59 +1034,61 @@ var s = StyleSheet.create({
     letterSpacing: -0.2
   },
   body: {
-    paddingHorizontal: 20,
-    paddingTop: 4
+    paddingHorizontal: MUSHI_SPACING.lounge,
+    paddingTop: MUSHI_SPACING.tight
   },
   title: {
     fontSize: 20,
     fontWeight: "700",
-    marginBottom: 16
+    marginBottom: MUSHI_SPACING.roomy
   },
   stepLabel: {
-    fontSize: 12,
+    fontSize: MUSHI_TYPE.sizeLabel,
     fontWeight: "600",
     letterSpacing: 0.2,
-    marginTop: 8,
-    marginBottom: 10,
+    marginTop: MUSHI_SPACING.snug,
+    marginBottom: MUSHI_SPACING.comfy,
     textTransform: "uppercase"
   },
   catRow: {
     flexDirection: "row",
     justifyContent: "space-between",
-    marginBottom: 16
+    marginBottom: MUSHI_SPACING.roomy
   },
   catBtn: {
     alignItems: "center",
-    paddingVertical: 10,
+    paddingVertical: MUSHI_SPACING.comfy,
     paddingHorizontal: 6,
-    borderRadius: 12,
+    borderRadius: MUSHI_RADIUS.card,
     borderWidth: 1,
     flex: 1,
-    marginHorizontal: 3
+    marginHorizontal: 3,
+    minHeight: 44
   },
   catEmoji: {
     fontSize: 22,
-    marginBottom: 4
+    marginBottom: MUSHI_SPACING.tight
   },
   catLabel: {
-    fontSize: 11,
+    fontSize: MUSHI_TYPE.sizeLabel,
     fontWeight: "600"
   },
   input: {
     borderWidth: 1,
-    borderRadius: 12,
+    borderRadius: MUSHI_RADIUS.card,
     padding: 14,
     fontSize: 15,
     minHeight: 100,
-    marginBottom: 16
+    marginBottom: MUSHI_SPACING.roomy
   },
   submitBtn: {
-    borderRadius: 12,
+    borderRadius: MUSHI_RADIUS.card,
     paddingVertical: 14,
-    alignItems: "center"
+    alignItems: "center",
+    minHeight: 44
   },
   submitText: {
-    color: "#fff",
+    color: MUSHI_INVERSE,
     fontSize: 16,
     fontWeight: "700"
   },
@@ -1075,7 +1119,6 @@ var s = StyleSheet.create({
     width: 48,
     height: 36,
     borderRadius: 4,
-    backgroundColor: "#000",
     flexShrink: 0
   },
   screenshotMeta: {
@@ -1097,7 +1140,6 @@ var s = StyleSheet.create({
   tabRow: {
     flexDirection: "row",
     borderBottomWidth: StyleSheet.hairlineWidth,
-    borderBottomColor: "#ccc",
     marginBottom: 8
   },
   tabBtn: {
@@ -1216,7 +1258,8 @@ var MushiFloatingButton = ({
   const currentX = useRef2(baseX);
   const currentY = useRef2(0);
   const isDragging = useRef2(false);
-  const accentColor = accent ?? mushiPalette2(dark ? "dark" : "light").accent;
+  const pal = mushiPalette2(dark ? "dark" : "light");
+  const accentColor = accent ?? pal.accent;
   useEffect2(() => {
     if (!persist) return;
     void loadStoredPos().then((pos) => {
@@ -1319,7 +1362,7 @@ var MushiFloatingButton = ({
           left: posX,
           bottom: Animated2.add(new Animated2.Value(baseBottom), Animated2.multiply(posY, -1)),
           backgroundColor: accentColor,
-          shadowColor: dark ? accentColor : "#000",
+          shadowColor: dark ? accentColor : pal.ink,
           transform: [{ scale }]
         }
       ],
@@ -1358,7 +1401,7 @@ import {
   StyleSheet as StyleSheet3,
   Platform as Platform4
 } from "react-native";
-import { MUSHI_BANNER_NEON as MUSHI_BANNER_NEON2, MUSHI_COPY as MUSHI_COPY3, MUSHI_GEOMETRY as MUSHI_GEOMETRY2 } from "@mushi-mushi/core";
+import { MUSHI_BANNER_NEON as MUSHI_BANNER_NEON2, MUSHI_COPY as MUSHI_COPY3, MUSHI_GEOMETRY as MUSHI_GEOMETRY2, MUSHI_SPACING as MUSHI_SPACING2, MUSHI_TYPE as MUSHI_TYPE2, MUSHI_Z } from "@mushi-mushi/core";
 import { jsx as jsx3, jsxs as jsxs2 } from "react/jsx-runtime";
 var MUSHI_BANNER_DEFAULT_HEIGHT = MUSHI_GEOMETRY2.bannerHeight;
 var MushiBanner = ({
@@ -1414,7 +1457,7 @@ var s3 = StyleSheet3.create({
     backgroundColor: MUSHI_BANNER_NEON2.bg,
     borderTopWidth: 1,
     borderTopColor: MUSHI_BANNER_NEON2.border,
-    zIndex: 99998,
+    zIndex: MUSHI_Z.banner,
     elevation: 8,
     paddingBottom: Platform4.OS === "ios" ? 0 : 0
   },
@@ -1422,12 +1465,13 @@ var s3 = StyleSheet3.create({
     flex: 1,
     flexDirection: "row",
     alignItems: "center",
-    gap: 8,
-    paddingHorizontal: 12,
-    paddingVertical: 8
+    gap: MUSHI_SPACING2.snug,
+    paddingHorizontal: MUSHI_SPACING2.comfy,
+    paddingVertical: MUSHI_SPACING2.snug,
+    minHeight: 44
   },
   eyebrow: {
-    fontSize: 10,
+    fontSize: MUSHI_TYPE2.sizeLabel,
     fontWeight: "700",
     letterSpacing: 1.2,
     color: MUSHI_BANNER_NEON2.fg
@@ -1456,13 +1500,341 @@ var s3 = StyleSheet3.create({
   }
 });
 
+// src/analytics/event-tracker.ts
+import {
+  EVENT_PROPERTY_LIMITS,
+  isValidEventName,
+  propertiesWithinByteLimit,
+  sanitizeEventProperties
+} from "@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, 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 >= 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 >= 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 (!isValidEventName(name)) return false;
+      const { properties: props } = sanitizeEventProperties(properties, { allowlist, scrub: opts.scrub });
+      let merged = props;
+      if (trackOpts?.reserved) {
+        const { properties: res } = 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 (!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
+import { newUuid } from "@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_${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_${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
 import { jsx as jsx4, jsxs as jsxs3 } from "react/jsx-runtime";
 var MushiContext = createContext(null);
+function nativeUserAgent() {
+  const os = Platform5?.OS ?? "native";
+  const version = Platform5?.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;
@@ -1505,7 +1877,7 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
   const networkRef = useRef3(null);
   const queueRef = useRef3(null);
   const apiClientRef = useRef3(null);
-  const sessionIdRef = useRef3(`sess_${newUuid()}`);
+  const sessionIdRef = useRef3(`sess_${newUuid2()}`);
   const breadcrumbsRef = useRef3(
     createBreadcrumbBuffer({ max: config.capture?.maxBreadcrumbs ?? 50 })
   );
@@ -1577,14 +1949,14 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
         if (existing && existing.startsWith("mushi_")) {
           reporterTokenRef.current = existing;
         } else {
-          const fresh = `mushi_${newUuid()}`;
+          const fresh = `mushi_${newUuid2()}`;
           reporterTokenRef.current = fresh;
           await saveReporterToken(fresh, secureStorage);
         }
         resolveReporterTokenReady();
       } catch {
         if (reporterTokenRef.current === `rn-${config.projectId}-anon`) {
-          reporterTokenRef.current = `mushi_${newUuid()}`;
+          reporterTokenRef.current = `mushi_${newUuid2()}`;
         }
         resolveReporterTokenReady();
       }
@@ -1713,7 +2085,7 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
       }));
       const fingerprintHash = getDeviceFingerprintHash(deviceInfo);
       const report = {
-        id: newUuid(),
+        id: newUuid2(),
         projectId: config.projectId,
         category: data.category,
         description: scrubPii3(data.description),
@@ -1748,21 +2120,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(/\/$/, "") === 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]
@@ -1792,6 +2177,63 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
       if (rewardsFlushRef.current) clearInterval(rewardsFlushRef.current);
     };
   }, [config.rewards?.enabled, config.rewards?.trackActivity, config.rewards?.flushIntervalMs]);
+  const eventTrackerRef = useRef3(null);
+  const sessionTrackerRef = useRef3(null);
+  useEffect3(() => {
+    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: scrubPii3
+    });
+    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 AppState?.addEventListener === "function") {
+        sub = 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 = useMemo(
     () => ({
       open,
@@ -1809,6 +2251,7 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
           name: traits?.name,
           provider: traits?.provider
         };
+        eventTrackerRef.current?.setIdentity(userId, traits ?? null);
       },
       setUser(user) {
         userRef.current = {
@@ -1817,6 +2260,7 @@ 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;
@@ -1828,7 +2272,10 @@ function MushiProvider({ children, config: configProp, ...barePropConfig }) {
               ...claims.email ? { email: claims.email } : {},
               ...claims.name ? { name: claims.name } : {}
             };
+            eventTrackerRef.current?.setIdentity(claims.sub, null);
           }
+        } else {
+          eventTrackerRef.current?.setIdentity(null, null);
         }
       },
       publishPageContext(context) {
@@ -1841,6 +2288,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",
@@ -1902,6 +2350,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;