@mushi-mushi/core 1.17.0 → 1.19.0

package/dist/index.d.cts

@@ -102,6 +102,20 @@ interface MushiWidgetConfig {
     brandFooter?: boolean;
     /** How the widget should surface SDK freshness warnings. Defaults to auto. */
     outdatedBanner?: 'auto' | 'banner' | 'console-only' | 'off';
+    /**
+     * Privacy nudge shown beside an attached screenshot preview, reminding the
+     * reporter to remove anything sensitive (balances, PII, tokens) before they
+     * submit. The widget always renders the captured image as a visible preview
+     * so the user can see exactly what will be sent and remove it if needed; this
+     * flag only controls the accompanying caption.
+     * - `true`  (default) — show the localized default caption.
+     * - string  — show this custom caption verbatim.
+     * - `false` — hide the caption (the preview + remove control still show).
+     *
+     * Settable per-host via the SDK config and remotely via the Mushi console
+     * runtime config (it travels in the `widget` block of `GET /v1/sdk/config`).
+     */
+    screenshotSensitiveHint?: boolean | string;
     /**
      * Beta mode: injects discreet "early access" messaging into the widget panel.
      * Shows a beta strip on the category step and a contact footer on the success

package/dist/index.d.ts

@@ -102,6 +102,20 @@ interface MushiWidgetConfig {
     brandFooter?: boolean;
     /** How the widget should surface SDK freshness warnings. Defaults to auto. */
     outdatedBanner?: 'auto' | 'banner' | 'console-only' | 'off';
+    /**
+     * Privacy nudge shown beside an attached screenshot preview, reminding the
+     * reporter to remove anything sensitive (balances, PII, tokens) before they
+     * submit. The widget always renders the captured image as a visible preview
+     * so the user can see exactly what will be sent and remove it if needed; this
+     * flag only controls the accompanying caption.
+     * - `true`  (default) — show the localized default caption.
+     * - string  — show this custom caption verbatim.
+     * - `false` — hide the caption (the preview + remove control still show).
+     *
+     * Settable per-host via the SDK config and remotely via the Mushi console
+     * runtime config (it travels in the `widget` block of `GET /v1/sdk/config`).
+     */
+    screenshotSensitiveHint?: boolean | string;
     /**
      * Beta mode: injects discreet "early access" messaging into the widget panel.
      * Shows a beta strip on the category step and a contact footer on the success

package/dist/index.js

@@ -840,6 +840,8 @@ var LS_KEY = "mushi_offline_queue";
 var BATCH_SIZE = 10;
 var MAX_BACKOFF_MS = 6e4;
 var AUTO_FLUSH_INTERVAL_MS = 3e4;
+var MAX_DELIVERY_ATTEMPTS = 8;
+var MAX_QUEUE_AGE_MS = 24 * 60 * 60 * 1e3;
 function createOfflineQueue(config = {}) {
   const { enabled = true, maxQueueSize = 50, syncOnReconnect = true, encryptAtRest = true } = config;
   let syncCleanup = null;
@@ -872,6 +874,17 @@ function createOfflineQueue(config = {}) {
   function isEncryptedRecord(row) {
     return !!row.payload && isEncryptedPayload(row.payload);
   }
+  function rowAttempts(row) {
+    const n = row.attempts;
+    return typeof n === "number" && Number.isFinite(n) ? n : 0;
+  }
+  function isExpired(row, now) {
+    const queuedAt = row.queuedAt;
+    if (!queuedAt) return false;
+    const ts = Date.parse(queuedAt);
+    if (Number.isNaN(ts)) return false;
+    return now - ts > MAX_QUEUE_AGE_MS;
+  }
   function detectBackend() {
     if (backendType) return backendType;
     if (typeof indexedDB !== "undefined") {
@@ -927,6 +940,15 @@ function createOfflineQueue(config = {}) {
       tx.onerror = () => reject(tx.error);
     });
   }
+  async function idbPutRow(row) {
+    const db = await openDb();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(STORE_NAME, "readwrite");
+      tx.objectStore(STORE_NAME).put(row);
+      tx.oncomplete = () => resolve();
+      tx.onerror = () => reject(tx.error);
+    });
+  }
   async function idbSize() {
     const db = await openDb();
     return new Promise((resolve, reject) => {
@@ -968,6 +990,38 @@ function createOfflineQueue(config = {}) {
     const rows = lsRead().filter((r) => r.id !== id);
     lsWrite(rows);
   }
+  function lsUpdateRow(row) {
+    const rows = lsRead();
+    const idx = rows.findIndex((r) => r.id === row.id);
+    if (idx >= 0) {
+      rows[idx] = row;
+      lsWrite(rows);
+    }
+  }
+  async function removeRow(backend, rowId) {
+    try {
+      if (backend === "indexeddb") await idbDelete(rowId);
+      else lsDelete(rowId);
+    } catch (err) {
+      queueLog.debug("Offline queue: row removal failed (will age out)", {
+        id: rowId,
+        err: String(err)
+      });
+    }
+  }
+  async function persistRow(backend, row) {
+    try {
+      if (backend === "indexeddb") await idbPutRow(row);
+      else lsUpdateRow(row);
+      return true;
+    } catch (err) {
+      queueLog.debug("Offline queue: row persist failed", {
+        id: row.id,
+        err: String(err)
+      });
+      return false;
+    }
+  }
   async function enqueue(report) {
     if (!enabled) return;
     const currentSize = await size();
@@ -1008,6 +1062,18 @@ function createOfflineQueue(config = {}) {
     } else {
       rows = lsRead();
     }
+    const now = Date.now();
+    const fresh = [];
+    for (const row of rows) {
+      if (isExpired(row, now)) {
+        const rowId = row.id;
+        await removeRow(backend, rowId);
+        queueLog.debug("Offline queue: evicting stale report", { id: rowId });
+      } else {
+        fresh.push(row);
+      }
+    }
+    rows = fresh;
     const batch = rows.slice(0, BATCH_SIZE);
     let sent = 0;
     let failed = 0;
@@ -1016,23 +1082,13 @@ function createOfflineQueue(config = {}) {
       const rowId = row.id;
       const report = await unwrapForSend(row);
       if (!report) {
-        try {
-          if (backend === "indexeddb") await idbDelete(rowId);
-          else lsDelete(rowId);
-        } catch {
-          lsDelete(rowId);
-        }
+        await removeRow(backend, rowId);
         failed++;
         continue;
       }
       const result = await client.submitReport(report);
       if (result.ok) {
-        try {
-          if (backend === "indexeddb") await idbDelete(rowId);
-          else lsDelete(rowId);
-        } catch {
-          lsDelete(rowId);
-        }
+        await removeRow(backend, rowId);
         sent++;
       } else {
         const permanent = result.error?.code === "HTTP_400" || result.error?.code === "HTTP_413" || result.error?.code === "HTTP_422" || result.error?.code === "INGEST_ERROR" || result.error?.code === "VALIDATION_ERROR" || // A payload that exceeds the size guard will never shrink on its own;
@@ -1044,17 +1100,33 @@ function createOfflineQueue(config = {}) {
         );
         const transient = !permanent && (result.error?.code === "NETWORK_ERROR" || result.error?.code === "HTTP_403" || result.error?.code === "HTTP_429" || result.error?.code === "HTTP_502" || result.error?.code === "HTTP_503" || result.error?.code === "HTTP_504" || typeof result.error?.code === "string" && result.error.code.startsWith("HTTP_5"));
         if (permanent) {
-          try {
-            if (backend === "indexeddb") await idbDelete(rowId);
-            else lsDelete(rowId);
-          } catch {
-            lsDelete(rowId);
-          }
+          await removeRow(backend, rowId);
         } else if (transient) {
-          queueLog.debug("Offline queue: transient failure, will retry", {
-            id: rowId,
-            code: result.error?.code
-          });
+          const nextAttempts = rowAttempts(row) + 1;
+          if (nextAttempts >= MAX_DELIVERY_ATTEMPTS) {
+            await removeRow(backend, rowId);
+            queueLog.warn("Offline queue: giving up on report after repeated failures", {
+              id: rowId,
+              attempts: nextAttempts,
+              code: result.error?.code
+            });
+          } else {
+            row.attempts = nextAttempts;
+            const persisted = await persistRow(backend, row);
+            if (persisted) {
+              queueLog.debug("Offline queue: transient failure, will retry", {
+                id: rowId,
+                attempts: nextAttempts,
+                code: result.error?.code
+              });
+            } else {
+              await removeRow(backend, rowId);
+              queueLog.warn("Offline queue: dropping report (attempt counter unpersistable)", {
+                id: rowId,
+                code: result.error?.code
+              });
+            }
+          }
         }
         failed++;
         if (i < batch.length - 1) {