@mushi-mushi/core 1.18.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

@@ -998,6 +998,30 @@ function createOfflineQueue(config = {}) {
       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();
@@ -1043,12 +1067,7 @@ function createOfflineQueue(config = {}) {
     for (const row of rows) {
       if (isExpired(row, now)) {
         const rowId = row.id;
-        try {
-          if (backend === "indexeddb") await idbDelete(rowId);
-          else lsDelete(rowId);
-        } catch {
-          lsDelete(rowId);
-        }
+        await removeRow(backend, rowId);
         queueLog.debug("Offline queue: evicting stale report", { id: rowId });
       } else {
         fresh.push(row);
@@ -1063,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;
@@ -1091,21 +1100,11 @@ 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) {
           const nextAttempts = rowAttempts(row) + 1;
           if (nextAttempts >= MAX_DELIVERY_ATTEMPTS) {
-            try {
-              if (backend === "indexeddb") await idbDelete(rowId);
-              else lsDelete(rowId);
-            } catch {
-              lsDelete(rowId);
-            }
+            await removeRow(backend, rowId);
             queueLog.warn("Offline queue: giving up on report after repeated failures", {
               id: rowId,
               attempts: nextAttempts,
@@ -1113,17 +1112,20 @@ function createOfflineQueue(config = {}) {
             });
           } else {
             row.attempts = nextAttempts;
-            try {
-              if (backend === "indexeddb") await idbPutRow(row);
-              else lsUpdateRow(row);
-            } catch {
-              lsUpdateRow(row);
+            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
+              });
             }
-            queueLog.debug("Offline queue: transient failure, will retry", {
-              id: rowId,
-              attempts: nextAttempts,
-              code: result.error?.code
-            });
           }
         }
         failed++;