@mushi-mushi/core 1.22.4 → 1.23.0

package/dist/index.d.cts

@@ -322,7 +322,7 @@ interface MushiWidgetAnchor {
     bottom?: string;
     left?: string;
 }
-type MushiPreset = 'production-calm' | 'beta-loud' | 'internal-debug' | 'manual-only';
+type MushiPreset = 'production-calm' | 'beta-loud' | 'internal-debug' | 'manual-only' | 'minimal' | 'standard' | 'full';
 interface MushiWidgetSmartHideConfig {
     onMobile?: 'edge-tab' | 'hide' | false;
     onScroll?: 'shrink' | 'hide' | false;
@@ -1740,6 +1740,56 @@ interface ResolvedEnvConfig {
  * can cleanly spread: `{ ...resolveEnvConfig(), ...explicitConfig }`.
  */
 declare function resolveEnvConfig(): ResolvedEnvConfig;
+interface EnvNearMiss {
+    field: 'projectId' | 'apiKey';
+    /** The variable that IS set, e.g. `VITE_MUSHI_API_KEY`. */
+    key: string;
+    /** Where it was found. */
+    via: 'import.meta.env' | 'process.env';
+}
+interface EnvConfigDiagnostics {
+    resolved: ResolvedEnvConfig;
+    /** Required fields that did not resolve. */
+    missing: Array<'projectId' | 'apiKey'>;
+    /**
+     * Variables that exist under a prefix this runtime does not read (e.g.
+     * `VITE_MUSHI_API_KEY` set but only `process.env` is available). The #1
+     * cause of "I set the env var but Mushi silently does nothing".
+     */
+    nearMisses: EnvNearMiss[];
+    /** Ready-to-print explanation, or null when nothing is wrong. */
+    message: string | null;
+}
+/**
+ * Explains WHY zero-config resolution failed instead of failing silently.
+ *
+ * Dynamic env access is fine here: this runs only on the diagnostic path
+ * (after resolution already failed), where we scan whatever env object the
+ * runtime actually exposes — in dev/SSR that is the full `process.env`, which
+ * is exactly where mis-prefixed variables are still visible. In a production
+ * client bundle a mis-prefixed var is simply absent, so we fall back to
+ * naming the expected variable for the detected runtime.
+ */
+declare function diagnoseEnvConfig(): EnvConfigDiagnostics;
+
+/**
+ * Expand `config.preset` into the nested option objects, with the user's
+ * explicit config winning on every key. Pure — returns a new object when a
+ * preset applies, or the input untouched for `standard` / no preset / an
+ * unknown value.
+ *
+ * The merge is deliberately per-sub-object (not a generic recursive deep
+ * merge) to avoid corrupting array/RegExp fields such as `capture.ignoreUrls`;
+ * only `proactive.cooldown` needs a second nested spread.
+ */
+declare function expandPreset(config: MushiConfig): MushiConfig;
+/**
+ * Runtime config sanity check that fails LOUD but never throws — a
+ * mis-configured host should see a `console.error` at init, not a crash. Warns
+ * on unknown top-level keys (usually a typo or a stale option name) and on an
+ * invalid `preset` value. Honours `MUSHI_SILENT`.
+ */
+declare function validateConfig(config: MushiConfig): void;
 
 interface PreFilterResult {
     passed: boolean;
@@ -2385,4 +2435,4 @@ declare function projectInitialsThemeIndex(projectId: string): number;
  */
 declare function readPageFaviconHref(): string | null;
 
-export { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, 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, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, type MushiAssistantConfig, type MushiAssistantReply, type MushiAssistantStep, type MushiBannerConfig, type MushiBannerLink, type MushiBetaChangelogEntry, type MushiBetaModeConfig, type MushiBreadcrumb, type MushiCaptureConfig, type MushiCaptureEventInput, type MushiCaptureExceptionOptions, type MushiColorPalette, type MushiConfig, type MushiConsoleEntry, type MushiCooldownConfig, type MushiCrossAppReport, type MushiCustomCategory, type MushiDiagnosticsResult, type MushiDiscoverInventoryConfig, type MushiDiscoveryEventPayload, type MushiEnvironment, type MushiEventHandler, type MushiEventType, type MushiHallOfFameEntry, type MushiIdentityClaims, type MushiIntegrationsConfig, type MushiInternalRequestKind, type MushiLeaderboardEntry, type MushiNetworkEntry, type MushiOfflineConfig, type MushiOnDeviceClassifier, type MushiOnDeviceClassifierInput, type MushiOnDeviceClassifierResult, type MushiPageContext, type MushiPerformanceMetrics, type MushiPreFilterConfig, type MushiPreset, type MushiPrivacyConfig, type MushiProactiveConfig, type MushiRegion, type MushiReport, type MushiReportBuilder, type MushiReportCategory, type MushiReportStatus, type MushiReporterComment, type MushiReporterReport, type MushiReputationResult, type MushiRewardsConfig, type MushiRuntimeSdkConfig, type MushiSDKInstance, type MushiSdkVersionInfo, type MushiSelectedElement, type MushiSentryConfig, type MushiSentryContext, type MushiTesterReputation, type MushiThemeMode, type MushiTierResult, type MushiTimelineEntry, type MushiTimelineKind, type MushiTokenSnapshot, type MushiTracePropagationConfig, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PayloadGuardResult, type PiiScrubberConfig, type PreFilterResult, type ProjectFaviconSource, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, type ResolvedEnvConfig, 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 { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, type EnvConfigDiagnostics, type EnvNearMiss, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, 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, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, type MushiAssistantConfig, type MushiAssistantReply, type MushiAssistantStep, type MushiBannerConfig, type MushiBannerLink, type MushiBetaChangelogEntry, type MushiBetaModeConfig, type MushiBreadcrumb, type MushiCaptureConfig, type MushiCaptureEventInput, type MushiCaptureExceptionOptions, type MushiColorPalette, type MushiConfig, type MushiConsoleEntry, type MushiCooldownConfig, type MushiCrossAppReport, type MushiCustomCategory, type MushiDiagnosticsResult, type MushiDiscoverInventoryConfig, type MushiDiscoveryEventPayload, type MushiEnvironment, type MushiEventHandler, type MushiEventType, type MushiHallOfFameEntry, type MushiIdentityClaims, type MushiIntegrationsConfig, type MushiInternalRequestKind, type MushiLeaderboardEntry, type MushiNetworkEntry, type MushiOfflineConfig, type MushiOnDeviceClassifier, type MushiOnDeviceClassifierInput, type MushiOnDeviceClassifierResult, type MushiPageContext, type MushiPerformanceMetrics, type MushiPreFilterConfig, type MushiPreset, type MushiPrivacyConfig, type MushiProactiveConfig, type MushiRegion, type MushiReport, type MushiReportBuilder, type MushiReportCategory, type MushiReportStatus, type MushiReporterComment, type MushiReporterReport, type MushiReputationResult, type MushiRewardsConfig, type MushiRuntimeSdkConfig, type MushiSDKInstance, type MushiSdkVersionInfo, type MushiSelectedElement, type MushiSentryConfig, type MushiSentryContext, type MushiTesterReputation, type MushiThemeMode, type MushiTierResult, type MushiTimelineEntry, type MushiTimelineKind, type MushiTokenSnapshot, type MushiTracePropagationConfig, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PayloadGuardResult, type PiiScrubberConfig, type PreFilterResult, type ProjectFaviconSource, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, type ResolvedEnvConfig, buildIdentityClaims, buildSdkIngestHeaders, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, diagnoseEnvConfig, estimateJsonBytes, expandPreset, 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, validateConfig };

package/dist/index.d.ts

@@ -322,7 +322,7 @@ interface MushiWidgetAnchor {
     bottom?: string;
     left?: string;
 }
-type MushiPreset = 'production-calm' | 'beta-loud' | 'internal-debug' | 'manual-only';
+type MushiPreset = 'production-calm' | 'beta-loud' | 'internal-debug' | 'manual-only' | 'minimal' | 'standard' | 'full';
 interface MushiWidgetSmartHideConfig {
     onMobile?: 'edge-tab' | 'hide' | false;
     onScroll?: 'shrink' | 'hide' | false;
@@ -1740,6 +1740,56 @@ interface ResolvedEnvConfig {
  * can cleanly spread: `{ ...resolveEnvConfig(), ...explicitConfig }`.
  */
 declare function resolveEnvConfig(): ResolvedEnvConfig;
+interface EnvNearMiss {
+    field: 'projectId' | 'apiKey';
+    /** The variable that IS set, e.g. `VITE_MUSHI_API_KEY`. */
+    key: string;
+    /** Where it was found. */
+    via: 'import.meta.env' | 'process.env';
+}
+interface EnvConfigDiagnostics {
+    resolved: ResolvedEnvConfig;
+    /** Required fields that did not resolve. */
+    missing: Array<'projectId' | 'apiKey'>;
+    /**
+     * Variables that exist under a prefix this runtime does not read (e.g.
+     * `VITE_MUSHI_API_KEY` set but only `process.env` is available). The #1
+     * cause of "I set the env var but Mushi silently does nothing".
+     */
+    nearMisses: EnvNearMiss[];
+    /** Ready-to-print explanation, or null when nothing is wrong. */
+    message: string | null;
+}
+/**
+ * Explains WHY zero-config resolution failed instead of failing silently.
+ *
+ * Dynamic env access is fine here: this runs only on the diagnostic path
+ * (after resolution already failed), where we scan whatever env object the
+ * runtime actually exposes — in dev/SSR that is the full `process.env`, which
+ * is exactly where mis-prefixed variables are still visible. In a production
+ * client bundle a mis-prefixed var is simply absent, so we fall back to
+ * naming the expected variable for the detected runtime.
+ */
+declare function diagnoseEnvConfig(): EnvConfigDiagnostics;
+
+/**
+ * Expand `config.preset` into the nested option objects, with the user's
+ * explicit config winning on every key. Pure — returns a new object when a
+ * preset applies, or the input untouched for `standard` / no preset / an
+ * unknown value.
+ *
+ * The merge is deliberately per-sub-object (not a generic recursive deep
+ * merge) to avoid corrupting array/RegExp fields such as `capture.ignoreUrls`;
+ * only `proactive.cooldown` needs a second nested spread.
+ */
+declare function expandPreset(config: MushiConfig): MushiConfig;
+/**
+ * Runtime config sanity check that fails LOUD but never throws — a
+ * mis-configured host should see a `console.error` at init, not a crash. Warns
+ * on unknown top-level keys (usually a typo or a stale option name) and on an
+ * invalid `preset` value. Honours `MUSHI_SILENT`.
+ */
+declare function validateConfig(config: MushiConfig): void;
 
 interface PreFilterResult {
     passed: boolean;
@@ -2385,4 +2435,4 @@ declare function projectInitialsThemeIndex(projectId: string): number;
  */
 declare function readPageFaviconHref(): string | null;
 
-export { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, 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, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, type MushiAssistantConfig, type MushiAssistantReply, type MushiAssistantStep, type MushiBannerConfig, type MushiBannerLink, type MushiBetaChangelogEntry, type MushiBetaModeConfig, type MushiBreadcrumb, type MushiCaptureConfig, type MushiCaptureEventInput, type MushiCaptureExceptionOptions, type MushiColorPalette, type MushiConfig, type MushiConsoleEntry, type MushiCooldownConfig, type MushiCrossAppReport, type MushiCustomCategory, type MushiDiagnosticsResult, type MushiDiscoverInventoryConfig, type MushiDiscoveryEventPayload, type MushiEnvironment, type MushiEventHandler, type MushiEventType, type MushiHallOfFameEntry, type MushiIdentityClaims, type MushiIntegrationsConfig, type MushiInternalRequestKind, type MushiLeaderboardEntry, type MushiNetworkEntry, type MushiOfflineConfig, type MushiOnDeviceClassifier, type MushiOnDeviceClassifierInput, type MushiOnDeviceClassifierResult, type MushiPageContext, type MushiPerformanceMetrics, type MushiPreFilterConfig, type MushiPreset, type MushiPrivacyConfig, type MushiProactiveConfig, type MushiRegion, type MushiReport, type MushiReportBuilder, type MushiReportCategory, type MushiReportStatus, type MushiReporterComment, type MushiReporterReport, type MushiReputationResult, type MushiRewardsConfig, type MushiRuntimeSdkConfig, type MushiSDKInstance, type MushiSdkVersionInfo, type MushiSelectedElement, type MushiSentryConfig, type MushiSentryContext, type MushiTesterReputation, type MushiThemeMode, type MushiTierResult, type MushiTimelineEntry, type MushiTimelineKind, type MushiTokenSnapshot, type MushiTracePropagationConfig, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PayloadGuardResult, type PiiScrubberConfig, type PreFilterResult, type ProjectFaviconSource, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, type ResolvedEnvConfig, 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 { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT, type EnvConfigDiagnostics, type EnvNearMiss, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, 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, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, type MushiAssistantConfig, type MushiAssistantReply, type MushiAssistantStep, type MushiBannerConfig, type MushiBannerLink, type MushiBetaChangelogEntry, type MushiBetaModeConfig, type MushiBreadcrumb, type MushiCaptureConfig, type MushiCaptureEventInput, type MushiCaptureExceptionOptions, type MushiColorPalette, type MushiConfig, type MushiConsoleEntry, type MushiCooldownConfig, type MushiCrossAppReport, type MushiCustomCategory, type MushiDiagnosticsResult, type MushiDiscoverInventoryConfig, type MushiDiscoveryEventPayload, type MushiEnvironment, type MushiEventHandler, type MushiEventType, type MushiHallOfFameEntry, type MushiIdentityClaims, type MushiIntegrationsConfig, type MushiInternalRequestKind, type MushiLeaderboardEntry, type MushiNetworkEntry, type MushiOfflineConfig, type MushiOnDeviceClassifier, type MushiOnDeviceClassifierInput, type MushiOnDeviceClassifierResult, type MushiPageContext, type MushiPerformanceMetrics, type MushiPreFilterConfig, type MushiPreset, type MushiPrivacyConfig, type MushiProactiveConfig, type MushiRegion, type MushiReport, type MushiReportBuilder, type MushiReportCategory, type MushiReportStatus, type MushiReporterComment, type MushiReporterReport, type MushiReputationResult, type MushiRewardsConfig, type MushiRuntimeSdkConfig, type MushiSDKInstance, type MushiSdkVersionInfo, type MushiSelectedElement, type MushiSentryConfig, type MushiSentryContext, type MushiTesterReputation, type MushiThemeMode, type MushiTierResult, type MushiTimelineEntry, type MushiTimelineKind, type MushiTokenSnapshot, type MushiTracePropagationConfig, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PayloadGuardResult, type PiiScrubberConfig, type PreFilterResult, type ProjectFaviconSource, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, type ResolvedEnvConfig, buildIdentityClaims, buildSdkIngestHeaders, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, diagnoseEnvConfig, estimateJsonBytes, expandPreset, 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, validateConfig };

package/dist/index.js

@@ -599,6 +599,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;
@@ -1646,38 +1859,40 @@ function createRateLimiter(config = {}) {
   return { tryConsume, reset, availableTokens };
 }
 
-// src/pii-scrubber.ts
-var ORDERED_PATTERNS = [
-  { key: "ssns", regex: /\b\d{3}-\d{2}-\d{4}\b/g, replacement: "[REDACTED_SSN]" },
-  { key: "creditCards", regex: /\b(?:\d[ -]*){12,18}\d\b/g, replacement: "[REDACTED_CC]" },
-  // Vendor secret tokens — mirrors packages/server/.../pii-scrubber.ts exactly.
-  { key: "secretTokens", regex: /\b(?:AKIA|ASIA)[0-9A-Z]{16}\b/g, replacement: "[REDACTED_AWS_KEY]" },
-  { key: "secretTokens", regex: /(?:aws_secret_access_key|secret_access_key)["'\s:=]+[A-Za-z0-9/+=]{40}\b/gi, replacement: "aws_secret_access_key=[REDACTED_AWS_SECRET]" },
-  { key: "secretTokens", regex: /\b(?:sk|rk)_(?:live|test)_[A-Za-z0-9]{24,}\b/g, replacement: "[REDACTED_STRIPE_KEY]" },
-  { key: "secretTokens", regex: /\bpk_(?:live|test)_[A-Za-z0-9]{24,}\b/g, replacement: "[REDACTED_STRIPE_PK]" },
-  { key: "secretTokens", regex: /\bxox[abpor]-[A-Za-z0-9-]{10,}\b/g, replacement: "[REDACTED_SLACK_TOKEN]" },
-  { key: "secretTokens", regex: /\bghp_[A-Za-z0-9]{36}\b/g, replacement: "[REDACTED_GITHUB_PAT]" },
-  { key: "secretTokens", regex: /\bgithub_pat_[A-Za-z0-9_]{80,}\b/g, replacement: "[REDACTED_GITHUB_PAT]" },
-  { key: "secretTokens", regex: /\bsk-(?:proj-)?[A-Za-z0-9_-]{20,}\b/g, replacement: "[REDACTED_OPENAI_KEY]" },
-  { key: "secretTokens", regex: /\bsk-ant-[A-Za-z0-9_-]{20,}\b/g, replacement: "[REDACTED_ANTHROPIC_KEY]" },
-  { key: "secretTokens", regex: /\bAIza[0-9A-Za-z_-]{35}\b/g, replacement: "[REDACTED_GOOGLE_KEY]" },
-  { key: "secretTokens", regex: /\beyJ[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\.[A-Za-z0-9_-]+\b/g, replacement: "[REDACTED_JWT]" },
-  { key: "emails", regex: /\b[A-Za-z0-9._%+\-]+@[A-Za-z0-9.\-]+\.[A-Za-z]{2,}\b/g, replacement: "[REDACTED_EMAIL]" },
-  { key: "phones", regex: /(?:\+\d{1,3}[\s.-])?\(?\d{2,4}\)?[\s.-]\d{3,4}[\s.-]\d{3,4}\b/g, replacement: "[REDACTED_PHONE]" },
-  { key: "ipAddresses", regex: /\b(?:\d{1,3}\.){3}\d{1,3}\b/g, replacement: "[REDACTED_IP]" },
-  { key: "ipv6", regex: /\b(?:[A-Fa-f0-9]{1,4}:){2,7}[A-Fa-f0-9]{0,4}\b/g, replacement: "[REDACTED_IPV6]" }
-];
-var DEFAULT_CONFIG = {
-  emails: true,
-  phones: true,
-  creditCards: true,
-  ssns: true,
-  ipAddresses: false,
-  // Secret tokens default ON — if they leak into a bug report there's no
-  // good reason to ship them to our servers. Cheaper to scrub client-side.
-  secretTokens: true,
-  ipv6: false
+// src/pii-patterns.json
+var pii_patterns_default = {
+  patterns: [
+    { id: "ssn", configKey: "ssns", source: "\\b\\d{3}-\\d{2}-\\d{4}\\b", replacement: "[REDACTED_SSN]" },
+    { id: "creditCard", configKey: "creditCards", source: "\\b(?:\\d[ -]*){12,18}\\d\\b", replacement: "[REDACTED_CC]" },
+    { id: "awsAccessKey", configKey: "secretTokens", source: "\\b(?:AKIA|ASIA)[0-9A-Z]{16}\\b", replacement: "[REDACTED_AWS_KEY]" },
+    { id: "awsSecretKey", configKey: "secretTokens", source: `(?:aws_secret_access_key|secret_access_key)["'\\s:=]+[A-Za-z0-9/+=]{40}\\b`, caseInsensitive: true, replacement: "aws_secret_access_key=[REDACTED_AWS_SECRET]" },
+    { id: "stripeSecretKey", configKey: "secretTokens", source: "\\b(?:sk|rk)_(?:live|test)_[A-Za-z0-9]{24,}\\b", replacement: "[REDACTED_STRIPE_KEY]" },
+    { id: "stripePublishableKey", configKey: "secretTokens", source: "\\bpk_(?:live|test)_[A-Za-z0-9]{24,}\\b", replacement: "[REDACTED_STRIPE_PK]" },
+    { id: "slackToken", configKey: "secretTokens", source: "\\bxox[abpor]-[A-Za-z0-9-]{10,}\\b", replacement: "[REDACTED_SLACK_TOKEN]" },
+    { id: "githubPatClassic", configKey: "secretTokens", source: "\\bghp_[A-Za-z0-9]{36}\\b", replacement: "[REDACTED_GITHUB_PAT]" },
+    { id: "githubPatFineGrained", configKey: "secretTokens", source: "\\bgithub_pat_[A-Za-z0-9_]{80,}\\b", replacement: "[REDACTED_GITHUB_PAT]" },
+    { id: "openaiKey", configKey: "secretTokens", source: "\\bsk-(?:proj-)?[A-Za-z0-9_-]{20,}\\b", replacement: "[REDACTED_OPENAI_KEY]" },
+    { id: "anthropicKey", configKey: "secretTokens", source: "\\bsk-ant-[A-Za-z0-9_-]{20,}\\b", replacement: "[REDACTED_ANTHROPIC_KEY]" },
+    { id: "googleKey", configKey: "secretTokens", source: "\\bAIza[0-9A-Za-z_-]{35}\\b", replacement: "[REDACTED_GOOGLE_KEY]" },
+    { id: "jwt", configKey: "secretTokens", source: "\\beyJ[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\.[A-Za-z0-9_-]+\\b", replacement: "[REDACTED_JWT]" },
+    { id: "email", configKey: "emails", source: "\\b[A-Za-z0-9._%+\\-]+@[A-Za-z0-9.\\-]+\\.[A-Za-z]{2,}\\b", replacement: "[REDACTED_EMAIL]" },
+    { id: "phone", configKey: "phones", source: "(?:\\+\\d{1,3}[\\s.-])?\\(?\\d{2,4}\\)?[\\s.-]\\d{3,4}[\\s.-]\\d{3,4}\\b", replacement: "[REDACTED_PHONE]" },
+    { id: "ipv4", configKey: "ipAddresses", source: "\\b(?:\\d{1,3}\\.){3}\\d{1,3}\\b", replacement: "[REDACTED_IP]", defaultOn: false },
+    { id: "ipv6", configKey: "ipv6", source: "\\b(?:[A-Fa-f0-9]{1,4}:){2,7}[A-Fa-f0-9]{0,4}\\b", replacement: "[REDACTED_IPV6]", defaultOn: false }
+  ]
 };
+
+// src/pii-scrubber.ts
+var RAW_PATTERNS = pii_patterns_default.patterns;
+var ORDERED_PATTERNS = RAW_PATTERNS.map((p) => ({
+  key: p.configKey,
+  regex: new RegExp(p.source, p.caseInsensitive ? "gi" : "g"),
+  replacement: p.replacement
+}));
+var DEFAULT_CONFIG = RAW_PATTERNS.reduce((acc, p) => {
+  acc[p.configKey] = p.defaultOn !== false;
+  return acc;
+}, {});
 function createPiiScrubber(config = {}) {
   const merged = { ...DEFAULT_CONFIG, ...config };
   const activePatterns = ORDERED_PATTERNS.filter((p) => merged[p.key]);
@@ -2162,6 +2377,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, diagnoseEnvConfig, estimateJsonBytes, expandPreset, 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, validateConfig };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map