@mushi-mushi/core 1.20.2 → 1.22.0

package/README.md

@@ -1,6 +1,8 @@
 # @mushi-mushi/core
 
-Core types, API client, and utilities for the Mushi Mushi SDK.
+> **Your AI wrote it. Mushi tells you why it broke.**
+
+Core types, API client, and shared utilities for every Mushi SDK package.
 
 > **You almost certainly don't need to install this directly.** Run `npx mushi-mushi` and the wizard will pick the right framework SDK ([`@mushi-mushi/react`](https://npmjs.com/package/@mushi-mushi/react), [`@mushi-mushi/vue`](https://npmjs.com/package/@mushi-mushi/vue), [`@mushi-mushi/svelte`](https://npmjs.com/package/@mushi-mushi/svelte), [`@mushi-mushi/angular`](https://npmjs.com/package/@mushi-mushi/angular), [`@mushi-mushi/react-native`](https://npmjs.com/package/@mushi-mushi/react-native), [`@mushi-mushi/capacitor`](https://npmjs.com/package/@mushi-mushi/capacitor), or [`@mushi-mushi/web`](https://npmjs.com/package/@mushi-mushi/web)) which depends on this package.
 
@@ -70,4 +72,4 @@ MIT
 <!-- mushi-readme-stats-footer -->
 ---
 
-<sub>Monorepo scale (June 2026): 47 edge functions · 256 SQL migrations · 13 outbound plugins · 11 inbound adapters · 18 pipeline agents. Canonical counts: <a href="https://github.com/kensaurus/mushi-mushi/blob/master/docs/stats.md">docs/stats.md</a> · <code>pnpm docs-stats</code></sub>
+<sub>Monorepo scale (June 2026): 51 edge functions · 298 SQL migrations · 13 outbound plugins · 11 inbound adapters · 19 pipeline agents. Canonical counts: <a href="https://github.com/kensaurus/mushi-mushi/blob/master/docs/stats.md">docs/stats.md</a> · <code>pnpm docs-stats</code></sub>

package/dist/index.cjs

@@ -106,6 +106,8 @@ var MUSHI_INTERNAL_HEADER = "X-Mushi-Internal";
 var MUSHI_INTERNAL_INIT_MARKER = "__mushiInternal";
 var DEFAULT_TIMEOUT = 1e4;
 var DEFAULT_MAX_RETRIES = 2;
+var DEFAULT_CIRCUIT_THRESHOLD = 4;
+var DEFAULT_CIRCUIT_COOLDOWN_MS = 3e4;
 function createApiClient(options) {
   const {
     projectId,
@@ -115,10 +117,29 @@ function createApiClient(options) {
     maxRetries = DEFAULT_MAX_RETRIES,
     getUserToken,
     sdkPackage,
-    sdkVersion
+    sdkVersion,
+    circuitBreaker
   } = options;
   let baseUrl = apiEndpoint.replace(/\/$/, "");
+  const cbEnabled = circuitBreaker?.enabled !== false;
+  const cbThreshold = Math.max(1, circuitBreaker?.threshold ?? DEFAULT_CIRCUIT_THRESHOLD);
+  const cbCooldownMs = Math.max(1e3, circuitBreaker?.cooldownMs ?? DEFAULT_CIRCUIT_COOLDOWN_MS);
+  let cbFailures = 0;
+  let cbOpenUntil = 0;
+  const cbIsOpen = () => cbEnabled && cbOpenUntil > Date.now();
+  const cbRecordReachable = () => {
+    cbFailures = 0;
+    cbOpenUntil = 0;
+  };
+  const cbRecordUnreachable = () => {
+    if (!cbEnabled) return;
+    cbFailures += 1;
+    if (cbFailures >= cbThreshold) cbOpenUntil = Date.now() + cbCooldownMs;
+  };
   async function request(method, path, body, retries = maxRetries, internalKind, extraHeaders) {
+    if (cbIsOpen()) {
+      return { ok: false, error: { code: "CIRCUIT_OPEN", message: "Endpoint temporarily unavailable; retrying later." } };
+    }
     const url = `${baseUrl}${path}`;
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeout);
@@ -165,6 +186,8 @@ function createApiClient(options) {
           await sleep(getBackoffDelay(maxRetries - retries));
           return request(method, path, body, retries - 1, internalKind, extraHeaders);
         }
+        if (response.status >= 500) cbRecordUnreachable();
+        else cbRecordReachable();
         return {
           ok: false,
           error: {
@@ -175,6 +198,7 @@ function createApiClient(options) {
       }
       const payload = await response.json();
       const data = payload && typeof payload === "object" && "ok" in payload && "data" in payload ? payload.data : payload;
+      cbRecordReachable();
       return { ok: true, data };
     } catch (error) {
       clearTimeout(timer);
@@ -182,6 +206,7 @@ function createApiClient(options) {
         await sleep(getBackoffDelay(maxRetries - retries));
         return request(method, path, body, retries - 1, internalKind);
       }
+      cbRecordUnreachable();
       return {
         ok: false,
         error: {
@@ -466,9 +491,9 @@ function isRetryable(error) {
 
 // src/region.ts
 var REGION_ENDPOINTS = {
-  us: "https://api.us.mushimushi.dev/functions/v1/api",
-  eu: "https://api.eu.mushimushi.dev/functions/v1/api",
-  jp: "https://api.jp.mushimushi.dev/functions/v1/api"
+  us: "https://dxptnwrhwsqckaftyymj.supabase.co/functions/v1/api",
+  eu: "https://dxptnwrhwsqckaftyymj.supabase.co/functions/v1/api",
+  jp: "https://dxptnwrhwsqckaftyymj.supabase.co/functions/v1/api"
 };
 var ROUTING_CACHE_KEY = "mushi_region_v1";
 var ROUTING_CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
@@ -1214,7 +1239,8 @@ function createOfflineQueue(config = {}) {
     if (!enabled || !syncOnReconnect || typeof window === "undefined") return;
     const tryFlush = () => {
       if (navigator.onLine) {
-        flush(client).catch(() => {
+        flush(client).catch((err) => {
+          queueLog.warn("Offline queue auto-flush failed", { err: String(err) });
         });
       }
     };
@@ -1247,6 +1273,15 @@ function captureEnvironment() {
   const scr = typeof screen !== "undefined" ? screen : void 0;
   void kickOffUserAgentData(nav);
   const connection = nav && "connection" in nav ? nav.connection : void 0;
+  const w = win;
+  const isCapacitor = !!w?.Capacitor;
+  const isCordova = !!w?.cordova;
+  const isReactNative = nav?.product === "ReactNative" || typeof globalThis.HermesInternal !== "undefined";
+  const native = isCapacitor || isCordova || isReactNative ? {
+    ...isCapacitor ? { capacitor: true } : {},
+    ...isCordova ? { cordova: true } : {},
+    ...isReactNative ? { reactNative: true } : {}
+  } : void 0;
   return {
     userAgent: nav?.userAgent ?? "unknown",
     platform: nav?.platform ?? "unknown",
@@ -1279,7 +1314,8 @@ function captureEnvironment() {
     displayMode: matchDisplayMode(win),
     documentTitle: doc?.title?.slice(0, 200),
     buildId: readBuildIdMeta(doc),
-    pageLoadTiming: capturePageLoadTiming(win)
+    pageLoadTiming: capturePageLoadTiming(win),
+    ...native ? { native } : {}
   };
 }
 function findNearestTestidFromActive(doc) {
@@ -1407,20 +1443,9 @@ function capturePageLoadTiming(win) {
 }
 
 // src/reporter-token.ts
-var STORAGE_KEY = "mushi_reporter_token";
-function getReporterToken() {
-  if (typeof localStorage !== "undefined") {
-    const existing = localStorage.getItem(STORAGE_KEY);
-    if (existing) return existing;
-  }
-  const token = generateToken();
-  if (typeof localStorage !== "undefined") {
-    try {
-      localStorage.setItem(STORAGE_KEY, token);
-    } catch {
-    }
-  }
-  return token;
+var LEGACY_STORAGE_KEY = "mushi_reporter_token";
+function storageKey(projectId) {
+  return `mushi:reporter-token:${projectId}`;
 }
 function generateToken() {
   if (typeof crypto !== "undefined" && crypto.randomUUID) {
@@ -1437,6 +1462,38 @@ function generateToken() {
   const hex = Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
   return `mushi_${hex}`;
 }
+function readStoredToken(key) {
+  if (typeof localStorage === "undefined") return null;
+  try {
+    const existing = localStorage.getItem(key);
+    return existing && existing.length > 0 ? existing : null;
+  } catch {
+    return null;
+  }
+}
+function writeStoredToken(key, token) {
+  if (typeof localStorage === "undefined") return;
+  try {
+    localStorage.setItem(key, token);
+  } catch {
+  }
+}
+function getReporterToken(projectId) {
+  if (!projectId) {
+    const legacy2 = readStoredToken(LEGACY_STORAGE_KEY);
+    if (legacy2) return legacy2;
+    const token2 = generateToken();
+    writeStoredToken(LEGACY_STORAGE_KEY, token2);
+    return token2;
+  }
+  const key = storageKey(projectId);
+  const scoped = readStoredToken(key);
+  if (scoped) return scoped;
+  const legacy = readStoredToken(LEGACY_STORAGE_KEY);
+  const token = legacy ?? generateToken();
+  writeStoredToken(key, token);
+  return token;
+}
 
 // src/uuid.ts
 function newUuid() {
@@ -1732,6 +1789,42 @@ var MUSHI_COLORS_DARK = {
   ok: "#4ADE80",
   danger: "#F87171"
 };
+var MUSHI_TIER_COLORS = {
+  free: MUSHI_COLORS_LIGHT.inkMuted,
+  explorer: "#2563EB",
+  contributor: "#7C3AED",
+  champion: "#D97706",
+  default: MUSHI_COLORS_LIGHT.accent
+};
+var MUSHI_BANNER_NEON = {
+  bg: "#0FFF50",
+  fg: "#0a1a0a",
+  border: "#00C43A"
+};
+var MUSHI_ON_ACCENT = "#FAF7F0";
+var MUSHI_INVERSE = "#ffffff";
+var MUSHI_ACCENT_SHADOW = {
+  light: "#9A2A1E",
+  dark: "#7A1F15"
+};
+var MUSHI_BANNER_BRAND_BORDER = {
+  light: "#B52F1F",
+  dark: "#C4321E"
+};
+var MUSHI_REPORTER_STATUS = {
+  light: {
+    sent: { fg: "#1E4A8C", bg: "rgba(30,74,140,0.08)", border: "rgba(30,74,140,0.16)" },
+    review: { fg: "#8A5A00", bg: "rgba(180,120,0,0.10)", border: "rgba(180,120,0,0.18)" },
+    fixing: { fg: "#9A3D12", bg: "rgba(224,60,44,0.10)", border: "rgba(224,60,44,0.18)" },
+    fixed: { fg: "#1F6B3A", bg: "rgba(31,107,58,0.10)", border: "rgba(31,107,58,0.18)" }
+  },
+  dark: {
+    sent: { fg: "#A8C4FF", bg: "rgba(120,160,255,0.12)", border: "rgba(120,160,255,0.22)" },
+    review: { fg: "#FFD27A", bg: "rgba(255,190,90,0.12)", border: "rgba(255,190,90,0.22)" },
+    fixing: { fg: "#FFB899", bg: "rgba(255,120,60,0.12)", border: "rgba(255,120,60,0.24)" },
+    fixed: { fg: "#8FE3B0", bg: "rgba(80,200,130,0.12)", border: "rgba(80,200,130,0.22)" }
+  }
+};
 function mushiPalette(mode) {
   return mode === "dark" ? MUSHI_COLORS_DARK : MUSHI_COLORS_LIGHT;
 }
@@ -1778,16 +1871,32 @@ var MUSHI_MOTION = {
 var MUSHI_GEOMETRY = {
   bannerHeight: 36,
   fabSize: 52,
-  edgeTabWidth: 28,
+  /** edge-tab launcher width (px) */
+  edgeTabWidth: 32,
   /** default gutter from the screen edge (added on top of safe-area insets) */
   gutter: 24,
-  panelWidth: 384,
+  /** Web panel width (px) — matches shipped Shadow DOM widget */
+  panelWidth: 360,
+  /** max panel height before keyboard inset (px) */
+  panelMaxHeight: 480,
   /** below this viewport width the panel becomes a full-width bottom sheet */
   panelSheetBreakpoint: 480
 };
+function safeWidgetHex(v) {
+  return /^#[0-9a-fA-F]{3,8}$/.test(v) ? v : "";
+}
+function resolveWidgetAccent(mode, accent = "", accentText = "") {
+  const pal = mushiPalette(mode);
+  const safeAccent = safeWidgetHex(accent);
+  const safeAccentText = safeWidgetHex(accentText);
+  const resolvedAccent = safeAccent || pal.accent;
+  const accentWash = safeAccent ? mode === "dark" ? `${resolvedAccent}1F` : `${resolvedAccent}14` : pal.accentWash;
+  const accentInk = safeAccentText || pal.accentInk;
+  return { accent: resolvedAccent, accentWash, accentInk };
+}
 var MUSHI_COPY = {
   bannerLabel: "Beta",
-  bannerMessage: "Help us improve \u2014 your feedback shapes what we ship.",
+  bannerMessage: "Found a bug? Tap to report it.",
   bugCta: "Report a bug",
   featureCta: "Feature request",
   triggerText: "\u{1F41B}",
@@ -1860,7 +1969,7 @@ var SLUG_DOMAIN_HINTS = {
   "glot-it": "glot.it",
   glotit: "glot.it",
   "solo-boss-cloud": "sbc-front.vercel.app",
-  "mushi-mushi": "mushimushi.dev"
+  "mushi-mushi": "kensaur.us"
 };
 var SLUG_ICON_URL_HINTS = {
   "mushi-mushi": "https://kensaur.us/mushi-mushi/admin/favicon.svg",
@@ -2039,8 +2148,13 @@ function isSafeFaviconHref(href) {
 }
 
 exports.DEFAULT_API_ENDPOINT = DEFAULT_API_ENDPOINT;
+exports.DEFAULT_MAX_RETRIES = DEFAULT_MAX_RETRIES;
+exports.DEFAULT_TIMEOUT = DEFAULT_TIMEOUT;
 exports.MAX_REPORT_PAYLOAD_BYTES = MAX_REPORT_PAYLOAD_BYTES;
 exports.MAX_SCREENSHOT_DATA_URL_BYTES = MAX_SCREENSHOT_DATA_URL_BYTES;
+exports.MUSHI_ACCENT_SHADOW = MUSHI_ACCENT_SHADOW;
+exports.MUSHI_BANNER_BRAND_BORDER = MUSHI_BANNER_BRAND_BORDER;
+exports.MUSHI_BANNER_NEON = MUSHI_BANNER_NEON;
 exports.MUSHI_COLORS_DARK = MUSHI_COLORS_DARK;
 exports.MUSHI_COLORS_LIGHT = MUSHI_COLORS_LIGHT;
 exports.MUSHI_COPY = MUSHI_COPY;
@@ -2048,12 +2162,16 @@ exports.MUSHI_GEOMETRY = MUSHI_GEOMETRY;
 exports.MUSHI_IDENTITY_TOKEN_PREFIX = MUSHI_IDENTITY_TOKEN_PREFIX;
 exports.MUSHI_INTERNAL_HEADER = MUSHI_INTERNAL_HEADER;
 exports.MUSHI_INTERNAL_INIT_MARKER = MUSHI_INTERNAL_INIT_MARKER;
+exports.MUSHI_INVERSE = MUSHI_INVERSE;
 exports.MUSHI_MOTION = MUSHI_MOTION;
+exports.MUSHI_ON_ACCENT = MUSHI_ON_ACCENT;
 exports.MUSHI_PROJECT_HEADER = MUSHI_PROJECT_HEADER;
 exports.MUSHI_RADIUS = MUSHI_RADIUS;
+exports.MUSHI_REPORTER_STATUS = MUSHI_REPORTER_STATUS;
 exports.MUSHI_SDK_PACKAGE_HEADER = MUSHI_SDK_PACKAGE_HEADER;
 exports.MUSHI_SDK_VERSION_HEADER = MUSHI_SDK_VERSION_HEADER;
 exports.MUSHI_SPACING = MUSHI_SPACING;
+exports.MUSHI_TIER_COLORS = MUSHI_TIER_COLORS;
 exports.MUSHI_TYPE = MUSHI_TYPE;
 exports.MUSHI_USER_TOKEN_HEADER = MUSHI_USER_TOKEN_HEADER;
 exports.MUSHI_Z = MUSHI_Z;
@@ -2076,6 +2194,7 @@ exports.getDeviceFingerprintHash = getDeviceFingerprintHash;
 exports.getReporterToken = getReporterToken;
 exports.getSessionId = getSessionId;
 exports.githubRepoDomainHint = githubRepoDomainHint;
+exports.hmacSha256Hex = hmacSha256Hex;
 exports.isLikelyGenericFavicon = isLikelyGenericFavicon;
 exports.isUntrustedFaviconUrl = isUntrustedFaviconUrl;
 exports.mushiPalette = mushiPalette;
@@ -2093,6 +2212,9 @@ exports.resolveEnvConfig = resolveEnvConfig;
 exports.resolveProjectDomain = resolveProjectDomain;
 exports.resolveProjectFaviconDomains = resolveProjectFaviconDomains;
 exports.resolveRegionEndpoint = resolveRegionEndpoint;
+exports.resolveWidgetAccent = resolveWidgetAccent;
+exports.safeWidgetHex = safeWidgetHex;
 exports.scrubPii = scrubPii;
+exports.sha256Hex = sha256Hex;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map