@mushi-mushi/core 1.16.0 → 1.18.0

package/dist/index.d.cts

@@ -1115,6 +1115,8 @@ interface MushiSDKInstance {
     hide(): void;
     attachTo(selectorOrElement: string | Element, options?: MushiWidgetConfig): () => void;
     setTrigger(trigger: NonNullable<MushiWidgetConfig['trigger']>): void;
+    /** Open the widget directly to the reporter's "My reports" history view. */
+    openReporter(): void;
     close(): void;
     destroy(): void;
     updateConfig(config: MushiRuntimeSdkConfig): void;
@@ -1551,6 +1553,9 @@ interface ApiClientOptions {
     apiEndpoint?: string;
     timeout?: number;
     maxRetries?: number;
+    /** When set, sent on every request so heartbeats record the running SDK version. */
+    sdkPackage?: string;
+    sdkVersion?: string;
     /**
      * Returns the current signed end-user identity JWT, or null when the user is
      * anonymous. When present it is sent on the X-Mushi-User-Token header so the

package/dist/index.d.ts

@@ -1115,6 +1115,8 @@ interface MushiSDKInstance {
     hide(): void;
     attachTo(selectorOrElement: string | Element, options?: MushiWidgetConfig): () => void;
     setTrigger(trigger: NonNullable<MushiWidgetConfig['trigger']>): void;
+    /** Open the widget directly to the reporter's "My reports" history view. */
+    openReporter(): void;
     close(): void;
     destroy(): void;
     updateConfig(config: MushiRuntimeSdkConfig): void;
@@ -1551,6 +1553,9 @@ interface ApiClientOptions {
     apiEndpoint?: string;
     timeout?: number;
     maxRetries?: number;
+    /** When set, sent on every request so heartbeats record the running SDK version. */
+    sdkPackage?: string;
+    sdkVersion?: string;
     /**
      * Returns the current signed end-user identity JWT, or null when the user is
      * anonymous. When present it is sent on the X-Mushi-User-Token header so the

package/dist/index.js

@@ -42,6 +42,8 @@ function formatBytes(n) {
 
 // src/api-client.ts
 var MUSHI_USER_TOKEN_HEADER = "X-Mushi-User-Token";
+var MUSHI_SDK_PACKAGE_HEADER = "X-Mushi-SDK-Package";
+var MUSHI_SDK_VERSION_HEADER = "X-Mushi-SDK-Version";
 var DEFAULT_API_ENDPOINT = "https://dxptnwrhwsqckaftyymj.supabase.co/functions/v1/api";
 var MUSHI_INTERNAL_HEADER = "X-Mushi-Internal";
 var MUSHI_INTERNAL_INIT_MARKER = "__mushiInternal";
@@ -54,7 +56,9 @@ function createApiClient(options) {
     apiEndpoint = DEFAULT_API_ENDPOINT,
     timeout = DEFAULT_TIMEOUT,
     maxRetries = DEFAULT_MAX_RETRIES,
-    getUserToken
+    getUserToken,
+    sdkPackage,
+    sdkVersion
   } = options;
   let baseUrl = apiEndpoint.replace(/\/$/, "");
   async function request(method, path, body, retries = maxRetries, internalKind, extraHeaders) {
@@ -69,6 +73,8 @@ function createApiClient(options) {
           "Content-Type": "application/json",
           "X-Mushi-Api-Key": apiKey,
           "X-Mushi-Project": projectId,
+          ...sdkPackage ? { [MUSHI_SDK_PACKAGE_HEADER]: sdkPackage } : {},
+          ...sdkVersion ? { [MUSHI_SDK_VERSION_HEADER]: sdkVersion } : {},
           ...userToken ? { [MUSHI_USER_TOKEN_HEADER]: userToken } : {},
           ...internalKind ? { [MUSHI_INTERNAL_HEADER]: internalKind } : {},
           ...extraHeaders
@@ -131,6 +137,8 @@ function createApiClient(options) {
         "Content-Type": "application/json",
         "X-Mushi-Api-Key": apiKey,
         "X-Mushi-Project": projectId,
+        ...sdkPackage ? { [MUSHI_SDK_PACKAGE_HEADER]: sdkPackage } : {},
+        ...sdkVersion ? { [MUSHI_SDK_VERSION_HEADER]: sdkVersion } : {},
         [MUSHI_INTERNAL_HEADER]: "reporter-poll",
         "X-Reporter-Token-Hash": tokenHash,
         "X-Reporter-Ts": ts,
@@ -832,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;
@@ -864,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") {
@@ -919,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) => {
@@ -960,6 +990,14 @@ 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 enqueue(report) {
     if (!enabled) return;
     const currentSize = await size();
@@ -1000,6 +1038,23 @@ 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;
+        try {
+          if (backend === "indexeddb") await idbDelete(rowId);
+          else lsDelete(rowId);
+        } catch {
+          lsDelete(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;
@@ -1043,10 +1098,33 @@ function createOfflineQueue(config = {}) {
             lsDelete(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) {
+            try {
+              if (backend === "indexeddb") await idbDelete(rowId);
+              else lsDelete(rowId);
+            } catch {
+              lsDelete(rowId);
+            }
+            queueLog.warn("Offline queue: giving up on report after repeated failures", {
+              id: rowId,
+              attempts: nextAttempts,
+              code: result.error?.code
+            });
+          } else {
+            row.attempts = nextAttempts;
+            try {
+              if (backend === "indexeddb") await idbPutRow(row);
+              else lsUpdateRow(row);
+            } catch {
+              lsUpdateRow(row);
+            }
+            queueLog.debug("Offline queue: transient failure, will retry", {
+              id: rowId,
+              attempts: nextAttempts,
+              code: result.error?.code
+            });
+          }
         }
         failed++;
         if (i < batch.length - 1) {