@mushi-mushi/core 1.32.2 → 1.33.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { M as MushiApiClient, a as MushiConfig, b as MushiPreFilterConfig, c as MushiReport, d as MushiOfflineConfig, e as MushiEnvironment, f as MushiAnalyticsConfig, g as MushiPropertyValue, h as MushiBreadcrumb } from './types-CWa7T4bx.cjs';
-export { i as MushiActivityEvent, j as MushiApiCascadeConfig, k as MushiApiResponse, l as MushiAssistantConfig, m as MushiAssistantReply, n as MushiAssistantStep, o as MushiBannerConfig, p as MushiBannerLink, q as MushiBetaChangelogEntry, r as MushiBetaModeConfig, s as MushiCaptureConfig, t as MushiCaptureEventInput, u as MushiCaptureExceptionOptions, v as MushiConsoleEntry, w as MushiCooldownConfig, x as MushiCrossAppReport, y as MushiCustomCategory, z as MushiDiagnosticsResult, A as MushiDiscoverInventoryConfig, B as MushiDiscoveryEventPayload, C as MushiEventHandler, D as MushiEventType, E as MushiHallOfFameEntry, F as MushiIntegrationsConfig, G as MushiLeaderboardEntry, H as MushiNetworkEntry, I as MushiNotificationsConfig, J as MushiOnDeviceClassifier, K as MushiOnDeviceClassifierInput, L as MushiOnDeviceClassifierResult, N as MushiPageContext, O as MushiPerformanceMetrics, P as MushiPreset, Q as MushiPrivacyConfig, R as MushiProactiveConfig, S as MushiProductEventPayload, T as MushiPushSubscriptionJSON, U as MushiReportBuilder, V as MushiReportCategory, W as MushiReportStatus, X as MushiReporterChannelUnavailable, Y as MushiReporterComment, Z as MushiReporterNotificationPrefs, _ as MushiReporterPrefsUpdate, $ as MushiReporterReport, a0 as MushiReporterReportDetail, a1 as MushiReporterTimelineItem, a2 as MushiReporterUpdates, a3 as MushiReputationResult, a4 as MushiRewardsConfig, a5 as MushiRuntimeSdkConfig, a6 as MushiSDKInstance, a7 as MushiSdkVersionInfo, a8 as MushiSelectedElement, a9 as MushiSentryConfig, aa as MushiSentryContext, ab as MushiSessionEventPayload, ac as MushiTesterReputation, ad as MushiTierResult, ae as MushiTimelineEntry, af as MushiTimelineKind, ag as MushiTracePropagationConfig, ah as MushiUrlMatcher, ai as MushiWidgetAnchor, aj as MushiWidgetConfig } from './types-CWa7T4bx.cjs';
+import { M as MushiApiClient, a as MushiConfig, b as MushiPreFilterConfig, c as MushiReport, d as MushiOfflineConfig, e as MushiEnvironment, f as MushiAnalyticsConfig, g as MushiPropertyValue, h as MushiBreadcrumb } from './types-DkC08B8U.cjs';
+export { i as MushiActivityEvent, j as MushiApiCascadeConfig, k as MushiApiResponse, l as MushiAssistantConfig, m as MushiAssistantReply, n as MushiAssistantStep, o as MushiBannerConfig, p as MushiBannerLink, q as MushiBetaChangelogEntry, r as MushiBetaModeConfig, s as MushiCaptureConfig, t as MushiCaptureEventInput, u as MushiCaptureExceptionOptions, v as MushiConsoleEntry, w as MushiCooldownConfig, x as MushiCrossAppReport, y as MushiCustomCategory, z as MushiDiagnosticsResult, A as MushiDiscoverInventoryConfig, B as MushiDiscoveryEventPayload, C as MushiEventHandler, D as MushiEventType, E as MushiHallOfFameEntry, F as MushiInitConfig, G as MushiIntegrationsConfig, H as MushiLeaderboardEntry, I as MushiNetworkEntry, J as MushiNotificationsConfig, K as MushiOnDeviceClassifier, L as MushiOnDeviceClassifierInput, N as MushiOnDeviceClassifierResult, O as MushiPageContext, P as MushiPerformanceMetrics, Q as MushiPreset, R as MushiPrivacyConfig, S as MushiProactiveConfig, T as MushiProductEventPayload, U as MushiPushSubscriptionJSON, V as MushiReportBuilder, W as MushiReportCategory, X as MushiReportStatus, Y as MushiReporterChannelUnavailable, Z as MushiReporterComment, _ as MushiReporterNotificationPrefs, $ as MushiReporterPrefsUpdate, a0 as MushiReporterReport, a1 as MushiReporterReportDetail, a2 as MushiReporterTimelineItem, a3 as MushiReporterUpdates, a4 as MushiReputationResult, a5 as MushiRewardsConfig, a6 as MushiRuntimeSdkConfig, a7 as MushiRuntimeWidgetConfig, a8 as MushiSDKInstance, a9 as MushiSdkVersionInfo, aa as MushiSelectedElement, ab as MushiSentryConfig, ac as MushiSentryContext, ad as MushiSessionEventPayload, ae as MushiTesterReputation, af as MushiTierResult, ag as MushiTimelineEntry, ah as MushiTimelineKind, ai as MushiTracePropagationConfig, aj as MushiUrlMatcher, ak as MushiWidgetAnchor, al as MushiWidgetConfig } from './types-DkC08B8U.cjs';
 
 /** Replay the in-flight POST via keepalive/beacon during pagehide. */
 declare function flushLastOutboundOnUnload(): boolean;
@@ -463,19 +463,21 @@ interface SessionTrackerOptions {
  * Initialise the session tracker. Call once at SDK init for web environments.
  * Subsequent calls on the same page are no-ops (idempotent).
  *
- * Emits, once the analytics gate allows it: session_start, heartbeats every
- * minute, session_end on visibilitychange/pagehide, and page_view on history
- * API navigation. Under `consent: 'required'` nothing is sent until
- * setConsent('granted').
+ * Emits, once the analytics gate allows it: session_start, a heartbeat after
+ * each minute without another request while the tab is visible, one
+ * session_end per hide (visibilitychange/pagehide), and page_view when a
+ * history API navigation changes the pathname. Under `consent: 'required'`
+ * nothing is sent until setConsent('granted').
  */
 declare function initSessionTracker(opts: SessionTrackerOptions): void;
 /**
  * Record a page view manually — call from framework router hooks where the
  * history patch may fire too early (e.g. React Router v7 loader transitions),
- * or from a host that initialised with `patchHistory: false`.
+ * or from a host that initialised with `patchHistory: false`. A call whose
+ * pathname matches the last page view is ignored: it is the same page.
  */
 declare function trackPageView(route?: string): void;
-/** Update the user identity after a Mushi.identify() call. */
+/** Set the identity heartbeats carry: a SHA-256 hex of the host user id, never the raw id. */
 declare function updateSessionIdentity(userIdHash: string | null): void;
 /** Tear down timers (e.g. in tests or SSR environments). */
 declare function destroySessionTracker(): void;
@@ -1190,8 +1192,8 @@ declare const MUSHI_LETTER_SPACING: {
 declare const MUSHI_GEOMETRY: {
     readonly bannerHeight: 36;
     readonly fabSize: 52;
-    /** edge-tab launcher width (px) */
-    readonly edgeTabWidth: 32;
+    /** edge-tab launcher drawn width (px) */
+    readonly edgeTabWidth: 22;
     /** default gutter from the screen edge (added on top of safe-area insets) */
     readonly gutter: 24;
     /** Web panel width (px) — matches shipped Shadow DOM widget */
@@ -1217,7 +1219,7 @@ declare function resolveWidgetAccent(mode: MushiThemeMode, accent?: string, acce
  * label / CTA wording (seen as inconsistent across the four host apps).
  */
 declare const MUSHI_COPY: {
-    readonly bannerLabel: "Beta";
+    readonly bannerLabel: "Feedback";
     readonly bannerMessage: "Found a bug? Tap to report it.";
     readonly bugCta: "Report a bug";
     readonly featureCta: "Feature request";

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { M as MushiApiClient, a as MushiConfig, b as MushiPreFilterConfig, c as MushiReport, d as MushiOfflineConfig, e as MushiEnvironment, f as MushiAnalyticsConfig, g as MushiPropertyValue, h as MushiBreadcrumb } from './types-CWa7T4bx.js';
-export { i as MushiActivityEvent, j as MushiApiCascadeConfig, k as MushiApiResponse, l as MushiAssistantConfig, m as MushiAssistantReply, n as MushiAssistantStep, o as MushiBannerConfig, p as MushiBannerLink, q as MushiBetaChangelogEntry, r as MushiBetaModeConfig, s as MushiCaptureConfig, t as MushiCaptureEventInput, u as MushiCaptureExceptionOptions, v as MushiConsoleEntry, w as MushiCooldownConfig, x as MushiCrossAppReport, y as MushiCustomCategory, z as MushiDiagnosticsResult, A as MushiDiscoverInventoryConfig, B as MushiDiscoveryEventPayload, C as MushiEventHandler, D as MushiEventType, E as MushiHallOfFameEntry, F as MushiIntegrationsConfig, G as MushiLeaderboardEntry, H as MushiNetworkEntry, I as MushiNotificationsConfig, J as MushiOnDeviceClassifier, K as MushiOnDeviceClassifierInput, L as MushiOnDeviceClassifierResult, N as MushiPageContext, O as MushiPerformanceMetrics, P as MushiPreset, Q as MushiPrivacyConfig, R as MushiProactiveConfig, S as MushiProductEventPayload, T as MushiPushSubscriptionJSON, U as MushiReportBuilder, V as MushiReportCategory, W as MushiReportStatus, X as MushiReporterChannelUnavailable, Y as MushiReporterComment, Z as MushiReporterNotificationPrefs, _ as MushiReporterPrefsUpdate, $ as MushiReporterReport, a0 as MushiReporterReportDetail, a1 as MushiReporterTimelineItem, a2 as MushiReporterUpdates, a3 as MushiReputationResult, a4 as MushiRewardsConfig, a5 as MushiRuntimeSdkConfig, a6 as MushiSDKInstance, a7 as MushiSdkVersionInfo, a8 as MushiSelectedElement, a9 as MushiSentryConfig, aa as MushiSentryContext, ab as MushiSessionEventPayload, ac as MushiTesterReputation, ad as MushiTierResult, ae as MushiTimelineEntry, af as MushiTimelineKind, ag as MushiTracePropagationConfig, ah as MushiUrlMatcher, ai as MushiWidgetAnchor, aj as MushiWidgetConfig } from './types-CWa7T4bx.js';
+import { M as MushiApiClient, a as MushiConfig, b as MushiPreFilterConfig, c as MushiReport, d as MushiOfflineConfig, e as MushiEnvironment, f as MushiAnalyticsConfig, g as MushiPropertyValue, h as MushiBreadcrumb } from './types-DkC08B8U.js';
+export { i as MushiActivityEvent, j as MushiApiCascadeConfig, k as MushiApiResponse, l as MushiAssistantConfig, m as MushiAssistantReply, n as MushiAssistantStep, o as MushiBannerConfig, p as MushiBannerLink, q as MushiBetaChangelogEntry, r as MushiBetaModeConfig, s as MushiCaptureConfig, t as MushiCaptureEventInput, u as MushiCaptureExceptionOptions, v as MushiConsoleEntry, w as MushiCooldownConfig, x as MushiCrossAppReport, y as MushiCustomCategory, z as MushiDiagnosticsResult, A as MushiDiscoverInventoryConfig, B as MushiDiscoveryEventPayload, C as MushiEventHandler, D as MushiEventType, E as MushiHallOfFameEntry, F as MushiInitConfig, G as MushiIntegrationsConfig, H as MushiLeaderboardEntry, I as MushiNetworkEntry, J as MushiNotificationsConfig, K as MushiOnDeviceClassifier, L as MushiOnDeviceClassifierInput, N as MushiOnDeviceClassifierResult, O as MushiPageContext, P as MushiPerformanceMetrics, Q as MushiPreset, R as MushiPrivacyConfig, S as MushiProactiveConfig, T as MushiProductEventPayload, U as MushiPushSubscriptionJSON, V as MushiReportBuilder, W as MushiReportCategory, X as MushiReportStatus, Y as MushiReporterChannelUnavailable, Z as MushiReporterComment, _ as MushiReporterNotificationPrefs, $ as MushiReporterPrefsUpdate, a0 as MushiReporterReport, a1 as MushiReporterReportDetail, a2 as MushiReporterTimelineItem, a3 as MushiReporterUpdates, a4 as MushiReputationResult, a5 as MushiRewardsConfig, a6 as MushiRuntimeSdkConfig, a7 as MushiRuntimeWidgetConfig, a8 as MushiSDKInstance, a9 as MushiSdkVersionInfo, aa as MushiSelectedElement, ab as MushiSentryConfig, ac as MushiSentryContext, ad as MushiSessionEventPayload, ae as MushiTesterReputation, af as MushiTierResult, ag as MushiTimelineEntry, ah as MushiTimelineKind, ai as MushiTracePropagationConfig, aj as MushiUrlMatcher, ak as MushiWidgetAnchor, al as MushiWidgetConfig } from './types-DkC08B8U.js';
 
 /** Replay the in-flight POST via keepalive/beacon during pagehide. */
 declare function flushLastOutboundOnUnload(): boolean;
@@ -463,19 +463,21 @@ interface SessionTrackerOptions {
  * Initialise the session tracker. Call once at SDK init for web environments.
  * Subsequent calls on the same page are no-ops (idempotent).
  *
- * Emits, once the analytics gate allows it: session_start, heartbeats every
- * minute, session_end on visibilitychange/pagehide, and page_view on history
- * API navigation. Under `consent: 'required'` nothing is sent until
- * setConsent('granted').
+ * Emits, once the analytics gate allows it: session_start, a heartbeat after
+ * each minute without another request while the tab is visible, one
+ * session_end per hide (visibilitychange/pagehide), and page_view when a
+ * history API navigation changes the pathname. Under `consent: 'required'`
+ * nothing is sent until setConsent('granted').
  */
 declare function initSessionTracker(opts: SessionTrackerOptions): void;
 /**
  * Record a page view manually — call from framework router hooks where the
  * history patch may fire too early (e.g. React Router v7 loader transitions),
- * or from a host that initialised with `patchHistory: false`.
+ * or from a host that initialised with `patchHistory: false`. A call whose
+ * pathname matches the last page view is ignored: it is the same page.
  */
 declare function trackPageView(route?: string): void;
-/** Update the user identity after a Mushi.identify() call. */
+/** Set the identity heartbeats carry: a SHA-256 hex of the host user id, never the raw id. */
 declare function updateSessionIdentity(userIdHash: string | null): void;
 /** Tear down timers (e.g. in tests or SSR environments). */
 declare function destroySessionTracker(): void;
@@ -1190,8 +1192,8 @@ declare const MUSHI_LETTER_SPACING: {
 declare const MUSHI_GEOMETRY: {
     readonly bannerHeight: 36;
     readonly fabSize: 52;
-    /** edge-tab launcher width (px) */
-    readonly edgeTabWidth: 32;
+    /** edge-tab launcher drawn width (px) */
+    readonly edgeTabWidth: 22;
     /** default gutter from the screen edge (added on top of safe-area insets) */
     readonly gutter: 24;
     /** Web panel width (px) — matches shipped Shadow DOM widget */
@@ -1217,7 +1219,7 @@ declare function resolveWidgetAccent(mode: MushiThemeMode, accent?: string, acce
  * label / CTA wording (seen as inconsistent across the four host apps).
  */
 declare const MUSHI_COPY: {
-    readonly bannerLabel: "Beta";
+    readonly bannerLabel: "Feedback";
     readonly bannerMessage: "Found a bug? Tap to report it.";
     readonly bugCta: "Report a bug";
     readonly featureCta: "Feature request";

package/dist/index.js

@@ -1594,14 +1594,10 @@ function createOfflineQueue(config = {}) {
         });
         break;
       }
-      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;
-      // retrying re-serialises the multi-MB body every sync tick and wedges
-      // the queue (it matches neither permanent nor transient otherwise).
-      // SERIALIZE_FAILED (circular ref) is likewise unrecoverable on retry.
-      result.error?.code === "PAYLOAD_TOO_LARGE" || result.error?.code === "SERIALIZE_FAILED" || typeof result.error?.message === "string" && /invalid payload|description must be at least|validation/i.test(
+      const permanent = result.error?.code === "HTTP_400" || result.error?.status === 401 || result.error?.status === 403 || result.error?.code === "HTTP_401" || result.error?.code === "HTTP_403" || result.error?.code === "HTTP_413" || result.error?.code === "HTTP_422" || result.error?.code === "INGEST_ERROR" || result.error?.code === "VALIDATION_ERROR" || result.error?.code === "PAYLOAD_TOO_LARGE" || result.error?.code === "SERIALIZE_FAILED" || typeof result.error?.message === "string" && /invalid payload|description must be at least|validation/i.test(
         result.error.message
       );
-      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"));
+      const transient = !permanent && (result.error?.code === "NETWORK_ERROR" || 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) {
         await removeRow(backend, rowId);
       } else {
@@ -2046,7 +2042,7 @@ function randomSuffix() {
   }
   let n = 0;
   for (const b of bytes) n = n * 256 + b >>> 0;
-  return n.toString(36).padStart(6, "0").slice(0, 6);
+  return (n % 36 ** 6).toString(36).padStart(6, "0");
 }
 
 // src/analytics-gate.ts
@@ -2118,7 +2114,9 @@ var _sdkVersion;
 var _userIdHash = null;
 var _reporterToken = null;
 var _pageViewCount = 0;
-var _heartbeatTimer = null;
+var _heartbeatTimer;
+var _lastRoute = null;
+var _endSent = false;
 var _initialized = false;
 var _active = false;
 var _started = false;
@@ -2160,30 +2158,62 @@ function send(payload) {
   if (!_client || !_active) return;
   _client.postSessionEvent(payload).catch(() => {
   });
+  scheduleHeartbeat();
+}
+function clearHeartbeat() {
+  clearTimeout(_heartbeatTimer);
+}
+function scheduleHeartbeat() {
+  clearHeartbeat();
+  if (!_active || globalThis.document?.visibilityState === "hidden") return;
+  _heartbeatTimer = setTimeout(() => {
+    send(buildPayload("session_heartbeat", { route: currentRoute() }));
+  }, HEARTBEAT_INTERVAL_MS);
 }
 function recordPageView(route) {
   if (!_active) return;
+  if (route === _lastRoute) return;
+  _lastRoute = route;
   _pageViewCount += 1;
   send(buildPayload("page_view", { route }));
 }
+function sendSessionEnd() {
+  if (_endSent || !_active) return;
+  _endSent = true;
+  send(buildPayload("session_end", { route: currentRoute() }));
+  clearHeartbeat();
+}
 function activate() {
   if (_active || !_initialized) return;
   _active = true;
   if (!_started) {
     _started = true;
     _pageViewCount = 1;
-    send(buildPayload("session_start", { route: currentRoute(), referrer: referrerOrigin() }));
+    _lastRoute = currentRoute();
+    send(buildPayload("session_start", { route: _lastRoute, referrer: referrerOrigin() }));
+  } else {
+    scheduleHeartbeat();
   }
-  _heartbeatTimer = setInterval(() => {
-    send(buildPayload("session_heartbeat", { route: currentRoute() }));
-  }, HEARTBEAT_INTERVAL_MS);
+}
+function onHide() {
+  if (document.visibilityState === "hidden") {
+    sendSessionEnd();
+  } else {
+    _endSent = false;
+    scheduleHeartbeat();
+  }
+}
+function onPagehide() {
+  sendSessionEnd();
+}
+function onPageshow(event) {
+  if (!event.persisted) return;
+  _endSent = false;
+  scheduleHeartbeat();
 }
 function deactivate() {
   _active = false;
-  if (_heartbeatTimer != null) {
-    clearInterval(_heartbeatTimer);
-    _heartbeatTimer = null;
-  }
+  clearHeartbeat();
 }
 function initSessionTracker(opts) {
   if (_initialized || typeof window === "undefined") return;
@@ -2193,17 +2223,11 @@ function initSessionTracker(opts) {
   _sdkVersion = opts.sdkVersion;
   _reporterToken = opts.reporterToken ?? opts.reporterTokenHash ?? null;
   _userIdHash = opts.userIdHash ?? null;
-  const onHide = () => {
-    if (typeof document !== "undefined" && document.visibilityState === "hidden") {
-      send(buildPayload("session_end", { route: currentRoute() }));
-    }
-  };
   if (typeof document !== "undefined") {
     document.addEventListener("visibilitychange", onHide, { passive: true });
   }
-  window.addEventListener("pagehide", () => {
-    send(buildPayload("session_end", { route: currentRoute() }));
-  }, { passive: true });
+  window.addEventListener("pagehide", onPagehide, { passive: true });
+  window.addEventListener("pageshow", onPageshow, { passive: true });
   if (opts.patchHistory !== false) {
     patchHistoryForPageViews();
   }
@@ -2218,6 +2242,7 @@ function trackPageView(route) {
   recordPageView(route ?? currentRoute());
 }
 function updateSessionIdentity(userIdHash) {
+  if (userIdHash && userIdHash !== _userIdHash) _lastRoute = null;
   _userIdHash = userIdHash;
 }
 function destroySessionTracker() {
@@ -2226,6 +2251,8 @@ function destroySessionTracker() {
   _unsubscribeConsent = null;
   _initialized = false;
   _started = false;
+  _lastRoute = null;
+  _endSent = false;
   _client = null;
 }
 var _historyPatched = false;
@@ -2547,10 +2574,10 @@ function initEventTracker(opts) {
   _flushTimer = setInterval(() => {
     void flushNow();
   }, interval);
-  const onHide = () => {
+  const onHide2 = () => {
     if (typeof document !== "undefined" && document.visibilityState === "hidden") void flushNow();
   };
-  if (typeof document !== "undefined") document.addEventListener("visibilitychange", onHide, { passive: true });
+  if (typeof document !== "undefined") document.addEventListener("visibilitychange", onHide2, { passive: true });
   window.addEventListener("pagehide", () => {
     void flushNow();
   }, { passive: true });
@@ -2990,8 +3017,8 @@ var MUSHI_LETTER_SPACING = {
 var MUSHI_GEOMETRY = {
   bannerHeight: 36,
   fabSize: 52,
-  /** edge-tab launcher width (px) */
-  edgeTabWidth: 32,
+  /** edge-tab launcher drawn width (px) */
+  edgeTabWidth: 22,
   /** default gutter from the screen edge (added on top of safe-area insets) */
   gutter: 24,
   /** Web panel width (px) — matches shipped Shadow DOM widget */
@@ -3014,7 +3041,7 @@ function resolveWidgetAccent(mode, accent = "", accentText = "") {
   return { accent: resolvedAccent, accentWash, accentInk };
 }
 var MUSHI_COPY = {
-  bannerLabel: "Beta",
+  bannerLabel: "Feedback",
   bannerMessage: "Found a bug? Tap to report it.",
   bugCta: "Report a bug",
   featureCta: "Feature request",