@mushi-mushi/core 1.22.5 → 1.25.0

package/dist/index.js

@@ -358,6 +358,17 @@ function createApiClient(options) {
       );
     },
     // ─── Rewards program (P1) ──────────────────────────────────
+    /** POST /v1/sdk/session — lightweight session lifecycle events.
+     *  Best-effort (1 retry, no offline queue) — mirrors postDiscoveryEvent. */
+    async postSessionEvent(payload) {
+      return request(
+        "POST",
+        "/v1/sdk/session",
+        payload,
+        1,
+        "discovery"
+      );
+    },
     async submitActivity(userId, events, opts) {
       return request(
         "POST",
@@ -599,6 +610,219 @@ function resolveEnvConfig() {
   if (apiEndpoint) result.apiEndpoint = apiEndpoint;
   return result;
 }
+var ENV_PREFIXES = ["VITE_", "NEXT_PUBLIC_", "NUXT_PUBLIC_", "EXPO_PUBLIC_", ""];
+var FIELD_SUFFIX = {
+  projectId: "MUSHI_PROJECT_ID",
+  apiKey: "MUSHI_API_KEY"
+};
+function diagnoseEnvConfig() {
+  const resolved = resolveEnvConfig();
+  const missing = [];
+  if (!resolved.projectId) missing.push("projectId");
+  if (!resolved.apiKey) missing.push("apiKey");
+  if (missing.length === 0) {
+    return { resolved, missing, nearMisses: [], message: null };
+  }
+  const importMetaEnv = (() => {
+    try {
+      const env = import.meta.env;
+      return typeof env === "object" && env !== null ? env : null;
+    } catch {
+      return null;
+    }
+  })();
+  const processEnv = (() => {
+    try {
+      return typeof process !== "undefined" && process.env ? process.env : null;
+    } catch {
+      return null;
+    }
+  })();
+  const nearMisses = [];
+  for (const field of missing) {
+    for (const prefix of ENV_PREFIXES) {
+      const key = `${prefix}${FIELD_SUFFIX[field]}`;
+      if (importMetaEnv && importMetaEnv[key]) {
+        nearMisses.push({ field, key, via: "import.meta.env" });
+      } else if (processEnv && processEnv[key]) {
+        nearMisses.push({ field, key, via: "process.env" });
+      }
+    }
+  }
+  const expectedPrefix = importMetaEnv ? "VITE_MUSHI_*" : "NEXT_PUBLIC_MUSHI_* (Next.js), EXPO_PUBLIC_MUSHI_* (Expo), or MUSHI_* (Node / React Native)";
+  const lines = [`[mushi] Missing ${missing.join(" and ")} \u2014 the SDK will not initialize.`];
+  for (const m of nearMisses) {
+    lines.push(
+      `[mushi] Found ${m.key} in ${m.via}, but this runtime did not resolve it \u2014 it is either the wrong prefix for your bundler or not exposed to the client bundle.`
+    );
+  }
+  lines.push(`[mushi] This runtime reads: ${expectedPrefix}. Set the matching variable(s) and restart your dev server.`);
+  if (nearMisses.length === 0) {
+    lines.push(
+      `[mushi] If you already set the variable, check the prefix: a mis-prefixed var is stripped from client bundles and resolves to undefined with no error.`
+    );
+  }
+  return { resolved, missing, nearMisses, message: lines.join("\n") };
+}
+
+// src/presets.ts
+var KNOWN_PRESETS = [
+  "production-calm",
+  "beta-loud",
+  "internal-debug",
+  "manual-only",
+  "minimal",
+  "standard",
+  "full"
+];
+var KNOWN_CONFIG_KEYS = [
+  "projectId",
+  "apiKey",
+  "apiEndpoint",
+  "timeout",
+  "maxRetries",
+  "circuitBreaker",
+  "preset",
+  "runtimeConfig",
+  "sentry",
+  "widget",
+  "capture",
+  "privacy",
+  "proactive",
+  "preFilter",
+  "integrations",
+  "offline",
+  "rewards",
+  "assistant",
+  "debug",
+  "enabled",
+  "appVersion",
+  "beforeSendFeedback",
+  "onCrashedLastRun"
+];
+function presetDefaults(preset) {
+  switch (preset) {
+    case "manual-only":
+      return {
+        widget: { trigger: "manual", outdatedBanner: "console-only" },
+        capture: { console: true, network: true, performance: false, screenshot: "on-report", elementSelector: false },
+        proactive: { rageClick: false, longTask: false, apiCascade: false, errorBoundary: false }
+      };
+    case "beta-loud":
+      return {
+        widget: { trigger: "auto", outdatedBanner: "banner" },
+        capture: { console: true, network: true, performance: true, screenshot: "auto", elementSelector: true },
+        proactive: { rageClick: true, longTask: true, apiCascade: true, errorBoundary: true }
+      };
+    case "internal-debug":
+      return {
+        widget: { trigger: "auto", outdatedBanner: "banner", brandFooter: true },
+        capture: { console: true, network: true, performance: true, screenshot: "auto", elementSelector: true },
+        proactive: {
+          rageClick: true,
+          longTask: true,
+          apiCascade: true,
+          errorBoundary: true,
+          cooldown: { maxProactivePerSession: 10, dismissCooldownHours: 0, suppressAfterDismissals: 99 }
+        }
+      };
+    case "production-calm":
+      return {
+        widget: { trigger: "auto", outdatedBanner: "console-only" },
+        capture: { console: true, network: true, performance: false, screenshot: "on-report", elementSelector: false },
+        proactive: { rageClick: false, longTask: false, apiCascade: false, errorBoundary: false }
+      };
+    // Lean posture: widget on, console capture only, screenshot on-report,
+    // no network/performance/replay, no proactive nudges.
+    case "minimal":
+      return {
+        widget: { trigger: "auto" },
+        capture: {
+          console: true,
+          network: false,
+          performance: false,
+          screenshot: "on-report",
+          replay: "off",
+          elementSelector: false
+        },
+        proactive: { rageClick: false, longTask: false, apiCascade: false, errorBoundary: false }
+      };
+    // Everything-on posture: full capture (incl. self-contained `lite` replay)
+    // and every proactive trigger.
+    case "full":
+      return {
+        widget: { trigger: "auto" },
+        capture: {
+          console: true,
+          network: true,
+          performance: true,
+          screenshot: "auto",
+          replay: "lite",
+          elementSelector: true
+        },
+        proactive: { rageClick: true, longTask: true, apiCascade: true, errorBoundary: true }
+      };
+    // 'standard' and anything unrecognised → no expansion.
+    default:
+      return void 0;
+  }
+}
+function expandPreset(config) {
+  const defaults = presetDefaults(config.preset);
+  if (!defaults) return config;
+  return {
+    ...config,
+    widget: {
+      ...defaults.widget,
+      ...config.widget
+    },
+    capture: {
+      ...defaults.capture,
+      ...config.capture
+    },
+    proactive: {
+      ...defaults.proactive,
+      ...config.proactive,
+      cooldown: {
+        ...defaults.proactive?.cooldown,
+        ...config.proactive?.cooldown
+      }
+    }
+  };
+}
+function isSilenced() {
+  const truthy = (v) => v === "1" || v === "true";
+  try {
+    if (typeof process !== "undefined" && process.env && truthy(process.env.MUSHI_SILENT)) return true;
+  } catch {
+  }
+  try {
+    const env = import.meta.env;
+    if (env && typeof env === "object" && (truthy(env.MUSHI_SILENT) || truthy(env.VITE_MUSHI_SILENT))) return true;
+  } catch {
+  }
+  return false;
+}
+function validateConfig(config) {
+  try {
+    if (isSilenced()) return;
+    if (!config || typeof config !== "object") return;
+    const unknownKeys = Object.keys(config).filter((key) => !KNOWN_CONFIG_KEYS.includes(key));
+    if (unknownKeys.length > 0) {
+      console.error(
+        `[mushi] Unknown config key${unknownKeys.length > 1 ? "s" : ""}: ${unknownKeys.map((k) => `\`${k}\``).join(", ")} \u2014 check for typos (see MushiConfig). Ignored.`
+      );
+    }
+    if (config.preset !== void 0 && !KNOWN_PRESETS.includes(config.preset)) {
+      console.error(
+        `[mushi] Unknown preset \`${String(config.preset)}\` \u2014 expected one of ${KNOWN_PRESETS.map(
+          (p) => `'${p}'`
+        ).join(", ")}. Preset ignored.`
+      );
+    }
+  } catch {
+  }
+}
 
 // src/pre-filter.ts
 var DEFAULT_MIN_LENGTH = 10;
@@ -954,12 +1178,12 @@ function createOfflineQueue(config = {}) {
     const n = row.attempts;
     return typeof n === "number" && Number.isFinite(n) ? n : 0;
   }
-  function isExpired(row, now) {
+  function isExpired(row, now2) {
     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;
+    return now2 - ts > MAX_QUEUE_AGE_MS;
   }
   function detectBackend() {
     if (backendType) return backendType;
@@ -1138,10 +1362,10 @@ function createOfflineQueue(config = {}) {
     } else {
       rows = lsRead();
     }
-    const now = Date.now();
+    const now2 = Date.now();
     const fresh = [];
     for (const row of rows) {
-      if (isExpired(row, now)) {
+      if (isExpired(row, now2)) {
         const rowId = row.id;
         await removeRow(backend, rowId);
         queueLog.debug("Offline queue: evicting stale report", { id: rowId });
@@ -1606,6 +1830,111 @@ function randomSuffix() {
   return n.toString(36).padStart(6, "0").slice(0, 6);
 }
 
+// src/session-tracker.ts
+var HEARTBEAT_INTERVAL_MS = 6e4;
+var _client = null;
+var _sdkVersion;
+var _userIdHash = null;
+var _reporterTokenHash = null;
+var _pageViewCount = 0;
+var _heartbeatTimer = null;
+var _initialized = false;
+function now() {
+  return (/* @__PURE__ */ new Date()).toISOString();
+}
+function currentRoute() {
+  if (typeof window === "undefined") return "";
+  return window.location.pathname + window.location.search;
+}
+function userAgent() {
+  if (typeof navigator === "undefined") return null;
+  return navigator.userAgent ?? null;
+}
+function buildPayload(kind, extra) {
+  return {
+    kind,
+    session_id: getSessionId(),
+    ts: now(),
+    page_view_count: _pageViewCount,
+    reporter_token_hash: _reporterTokenHash,
+    user_id_hash: _userIdHash,
+    user_agent: userAgent(),
+    sdk_version: _sdkVersion,
+    ...extra
+  };
+}
+function send(payload) {
+  if (!_client) return;
+  _client.postSessionEvent(payload).catch(() => {
+  });
+}
+function initSessionTracker(opts) {
+  if (_initialized || typeof window === "undefined") return;
+  _initialized = true;
+  _client = opts.client;
+  _sdkVersion = opts.sdkVersion;
+  _reporterTokenHash = opts.reporterTokenHash ?? null;
+  _userIdHash = opts.userIdHash ?? null;
+  const entryRoute = currentRoute();
+  _pageViewCount = 1;
+  send(buildPayload("session_start", {
+    route: entryRoute,
+    referrer: typeof document !== "undefined" ? document.referrer ?? null : null
+  }));
+  _heartbeatTimer = setInterval(() => {
+    send(buildPayload("session_heartbeat", { route: currentRoute() }));
+  }, HEARTBEAT_INTERVAL_MS);
+  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 });
+  }
+  if (typeof window !== "undefined") {
+    window.addEventListener("pagehide", () => {
+      send(buildPayload("session_end", { route: currentRoute() }));
+    }, { passive: true });
+  }
+  patchHistoryForPageViews();
+}
+function trackPageView(route) {
+  if (!_initialized || !_client) return;
+  _pageViewCount += 1;
+  send(buildPayload("page_view", { route: route ?? currentRoute() }));
+}
+function updateSessionIdentity(userIdHash) {
+  _userIdHash = userIdHash;
+}
+function destroySessionTracker() {
+  if (_heartbeatTimer != null) {
+    clearInterval(_heartbeatTimer);
+    _heartbeatTimer = null;
+  }
+  _initialized = false;
+  _client = null;
+}
+var _historyPatched = false;
+function patchHistoryForPageViews() {
+  if (_historyPatched || typeof history === "undefined") return;
+  _historyPatched = true;
+  const wrap = (original) => function(...args) {
+    const result = original.apply(this, args);
+    if (original === history.pushState) {
+      _pageViewCount += 1;
+      send(buildPayload("page_view", { route: currentRoute() }));
+    }
+    return result;
+  };
+  history.pushState = wrap(history.pushState);
+  history.replaceState = wrap(history.replaceState);
+  window.addEventListener("popstate", () => {
+    _pageViewCount += 1;
+    send(buildPayload("page_view", { route: currentRoute() }));
+  }, { passive: true });
+}
+
 // src/rate-limiter.ts
 var DEFAULT_MAX_BURST = 10;
 var DEFAULT_REFILL_RATE = 1;
@@ -1619,12 +1948,12 @@ function createRateLimiter(config = {}) {
   let tokens = maxBurst;
   let lastRefill = Date.now();
   function refill() {
-    const now = Date.now();
-    const elapsed = now - lastRefill;
+    const now2 = Date.now();
+    const elapsed = now2 - lastRefill;
     const refills = Math.floor(elapsed / refillIntervalMs);
     if (refills > 0) {
       tokens = Math.min(maxBurst, tokens + refills * refillRate);
-      lastRefill = now;
+      lastRefill = now2;
     }
   }
   function tryConsume() {
@@ -1938,15 +2267,15 @@ function mushiTokens(mode) {
 // src/identity.ts
 var MUSHI_IDENTITY_TOKEN_PREFIX = "mushi.identity";
 function buildIdentityClaims(input) {
-  const now = Math.floor(Date.now() / 1e3);
+  const now2 = Math.floor(Date.now() / 1e3);
   const ttl = input.ttlSeconds && input.ttlSeconds > 0 ? Math.min(input.ttlSeconds, 3600) : 600;
   return {
     projectId: input.projectId,
     sub: input.userId,
     ...input.email ? { email: input.email } : {},
     ...input.name ? { name: input.name } : {},
-    iat: now,
-    exp: now + ttl
+    iat: now2,
+    exp: now2 + ttl
   };
 }
 function base64UrlDecode(segment) {
@@ -1985,12 +2314,12 @@ var MULTI_TENANT_PARENT_HOSTS = /* @__PURE__ */ new Set(["kensaur.us", "www.kens
 var SLUG_DOMAIN_HINTS = {
   "glot-it": "glot.it",
   glotit: "glot.it",
-  "solo-boss-cloud": "sbc-front.vercel.app",
+  "solo-boss-cloud": "solo-boss.kensaur.us",
   "mushi-mushi": "kensaur.us"
 };
 var SLUG_ICON_URL_HINTS = {
   "mushi-mushi": "https://kensaur.us/mushi-mushi/admin/favicon.svg",
-  "solo-boss-cloud": "https://sbc-front.vercel.app/favicon.svg",
+  "solo-boss-cloud": "https://solo-boss.kensaur.us/favicon.svg",
   "glot-it": "https://kensaur.us/glot-it/apple-touch-icon.png",
   glotit: "https://kensaur.us/glot-it/apple-touch-icon.png"
 };
@@ -2164,6 +2493,6 @@ function isSafeFaviconHref(href) {
   }
 }
 
-export { DEFAULT_API_ENDPOINT, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, MAX_REPORT_PAYLOAD_BYTES, MAX_SCREENSHOT_DATA_URL_BYTES, MUSHI_ACCENT_SHADOW, MUSHI_BANNER_BRAND_BORDER, MUSHI_BANNER_NEON, MUSHI_COLORS_DARK, MUSHI_COLORS_LIGHT, MUSHI_COPY, MUSHI_GEOMETRY, MUSHI_IDENTITY_TOKEN_PREFIX, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, MUSHI_INVERSE, MUSHI_MOTION, MUSHI_ON_ACCENT, MUSHI_PROJECT_HEADER, MUSHI_RADIUS, MUSHI_REPORTER_STATUS, MUSHI_SDK_PACKAGE_HEADER, MUSHI_SDK_VERSION_HEADER, MUSHI_SPACING, MUSHI_TIER_COLORS, MUSHI_TYPE, MUSHI_USER_TOKEN_HEADER, MUSHI_Z, REGION_ENDPOINTS, buildIdentityClaims, buildSdkIngestHeaders, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, estimateJsonBytes, faviconUrlCandidates, formatBytes, getDeviceFingerprintHash, getReporterToken, getSessionId, githubRepoDomainHint, hmacSha256Hex, isLikelyGenericFavicon, isUntrustedFaviconUrl, mushiPalette, mushiTokens, newUuid, noopLogger, normaliseThrown, originToDomain, parseIdentityToken, projectFaviconUrlCandidates, projectInitials, projectInitialsThemeIndex, readPageFaviconHref, resolveEnvConfig, resolveProjectDomain, resolveProjectFaviconDomains, resolveRegionEndpoint, resolveWidgetAccent, safeWidgetHex, scrubPii, sha256Hex };
+export { DEFAULT_API_ENDPOINT, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, MAX_REPORT_PAYLOAD_BYTES, MAX_SCREENSHOT_DATA_URL_BYTES, MUSHI_ACCENT_SHADOW, MUSHI_BANNER_BRAND_BORDER, MUSHI_BANNER_NEON, MUSHI_COLORS_DARK, MUSHI_COLORS_LIGHT, MUSHI_COPY, MUSHI_GEOMETRY, MUSHI_IDENTITY_TOKEN_PREFIX, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, MUSHI_INVERSE, MUSHI_MOTION, MUSHI_ON_ACCENT, MUSHI_PROJECT_HEADER, MUSHI_RADIUS, MUSHI_REPORTER_STATUS, MUSHI_SDK_PACKAGE_HEADER, MUSHI_SDK_VERSION_HEADER, MUSHI_SPACING, MUSHI_TIER_COLORS, MUSHI_TYPE, MUSHI_USER_TOKEN_HEADER, MUSHI_Z, REGION_ENDPOINTS, buildIdentityClaims, buildSdkIngestHeaders, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, destroySessionTracker, diagnoseEnvConfig, estimateJsonBytes, expandPreset, faviconUrlCandidates, formatBytes, getDeviceFingerprintHash, getReporterToken, getSessionId, githubRepoDomainHint, hmacSha256Hex, initSessionTracker, isLikelyGenericFavicon, isUntrustedFaviconUrl, mushiPalette, mushiTokens, newUuid, noopLogger, normaliseThrown, originToDomain, parseIdentityToken, projectFaviconUrlCandidates, projectInitials, projectInitialsThemeIndex, readPageFaviconHref, resolveEnvConfig, resolveProjectDomain, resolveProjectFaviconDomains, resolveRegionEndpoint, resolveWidgetAccent, safeWidgetHex, scrubPii, sha256Hex, trackPageView, updateSessionIdentity, validateConfig };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map