@mushi-mushi/core 1.27.1 → 1.28.0

package/dist/index.d.cts

@@ -46,6 +46,31 @@ interface MushiConfig {
      * when omitted (legacy Vercel Analytics wiring).
      */
     appVersion?: string;
+    /**
+     * Same-origin (or absolute) ingest proxy. When set, every SDK HTTP call
+     * goes here instead of `apiEndpoint` so ad blockers that drop third-party
+     * `*.supabase.co/functions` hosts cannot silently eat reports.
+     * Relative URLs resolve against the page origin — that is the recommended
+     * form (no CORS preflight; matches Sentry `tunnel`).
+     *
+     * @example
+     * tunnel: '/api/mushi-tunnel'
+     */
+    tunnel?: string;
+    /**
+     * Drop automatic error reports whose message matches any string (substring)
+     * or RegExp. Never applied to user-submitted widget feedback.
+     */
+    ignoreErrors?: Array<string | RegExp>;
+    /**
+     * Drop automatic error reports whose script URL / stack filename matches.
+     */
+    denyUrls?: Array<string | RegExp>;
+    /**
+     * When set, drop automatic error reports unless the script URL matches
+     * at least one entry.
+     */
+    allowUrls?: Array<string | RegExp>;
     /**
      * Probabilistic sampling rate for session-replay recording (rrweb/lite).
      * Range 0–1, default 1 (record all sessions). The sampling decision is made
@@ -59,6 +84,13 @@ interface MushiConfig {
      * replaySampleRate: 0.2  // record replay for ~20% of sessions
      */
     replaySampleRate?: number;
+    /**
+     * When session replay was sampled out, still start the rolling buffer for
+     * this fraction of sessions (0–1, default 0) so an error/feedback report
+     * can attach replay. Keep at 0 unless you have accepted the CPU/egress
+     * cost — do not set to 1 with `capture.replay: 'rrweb'`.
+     */
+    replaysOnErrorSampleRate?: number;
     /**
      * Probabilistic sampling rate for automatic (non-user-initiated) error
      * reports. Range 0–1, default 1 (send all). User-initiated feedback reports
@@ -1711,6 +1743,8 @@ interface MushiTesterReputation {
     total_points: number;
 }
 
+/** Replay the last POST via keepalive/beacon during pagehide. */
+declare function flushLastOutboundOnUnload(): boolean;
 /** Header carrying the signed end-user identity token (verified server-side). */
 declare const MUSHI_USER_TOKEN_HEADER = "X-Mushi-User-Token";
 /** Project scope header — paired with the API key on every SDK request. */
@@ -1759,14 +1793,101 @@ interface ApiClientOptions {
      * backend can verify it and scope identity-bound features to that user.
      */
     getUserToken?: () => string | null | undefined;
+    /**
+     * Same-origin (or absolute) proxy. When set, replaces `apiEndpoint` as the
+     * request base so browser calls stay first-party. See `MushiConfig.tunnel`.
+     */
+    tunnel?: string;
 }
 declare const DEFAULT_API_ENDPOINT = "https://dxptnwrhwsqckaftyymj.supabase.co/functions/v1/api";
 declare const MUSHI_INTERNAL_HEADER = "X-Mushi-Internal";
 declare const MUSHI_INTERNAL_INIT_MARKER = "__mushiInternal";
 type MushiInternalRequestKind = 'sdk-config' | 'report-submit' | 'report-status' | 'reporter-poll' | 'diagnose' | 'discovery' | 'community';
+/** Resolve the HTTP base: tunnel wins so ingest stays first-party. */
+declare function resolveRequestBaseUrl(apiEndpoint: string | undefined, tunnel?: string): string;
 declare const DEFAULT_TIMEOUT = 10000;
 declare const DEFAULT_MAX_RETRIES = 2;
 declare function createApiClient(options: ApiClientOptions): MushiApiClient;
+declare function getBackoffDelay(attempt: number): number;
+/**
+ * Parse a `Retry-After` header into a delay in milliseconds. The header comes
+ * in two shapes (RFC 9110): delta-seconds, or an HTTP-date to wait until.
+ * Returns null when the header is absent, malformed, or negative, so the
+ * caller falls back to its own backoff curve.
+ */
+declare function parseRetryAfter(value: string | null | undefined, now?: number): number | null;
+
+/**
+ * FILE: packages/core/src/error-filters.ts
+ * PURPOSE: Sentry-grade drop filters for automatic error capture.
+ *
+ * OVERVIEW:
+ * - ignoreErrors — drop when the error message matches a string or RegExp
+ * - denyUrls — drop when the script URL / stack frame matches
+ * - allowUrls — when set, drop unless the script URL matches at least one
+ *
+ * USAGE:
+ * - captureException / window.onerror / unhandledrejection only
+ * - Never applied to user-submitted widget feedback
+ *
+ * NOTES:
+ * - String matchers are case-sensitive substrings (Sentry JS semantics)
+ * - Invalid RegExp sources are treated as non-matches, not throws
+ */
+type MushiErrorFilter = string | RegExp;
+declare function matchesErrorFilter(value: string | undefined | null, filters: readonly MushiErrorFilter[] | undefined): boolean;
+declare function shouldDropCapturedError(input: {
+    message: string;
+    filename?: string | null;
+    ignoreErrors?: readonly MushiErrorFilter[];
+    denyUrls?: readonly MushiErrorFilter[];
+    allowUrls?: readonly MushiErrorFilter[];
+}): boolean;
+
+/**
+ * FILE: packages/core/src/unload-transport.ts
+ * PURPOSE: Pagehide-safe report delivery (fetch keepalive + sendBeacon).
+ *
+ * OVERVIEW:
+ * - fetch({ keepalive: true }) keeps custom X-Mushi-* headers (Sentry 2024+ primary)
+ * - sendBeacon cannot set headers, so it wraps credentials in a beacon envelope
+ *   that only the same-origin tunnel unwraps
+ *
+ * NOTES:
+ * - Beacon payloads over 60 KiB are skipped (browser sendBeacon limit ~64 KiB)
+ * - Never put the API key in the query string
+ */
+declare const MUSHI_BEACON_MAX_BYTES: number;
+interface MushiBeaconEnvelope {
+    mushiBeacon: true;
+    path: string;
+    headers: Record<string, string>;
+    body: unknown;
+}
+declare function isMushiBeaconEnvelope(value: unknown): value is MushiBeaconEnvelope;
+declare function buildBeaconEnvelope(opts: {
+    path: string;
+    headers: Record<string, string>;
+    body: unknown;
+}): MushiBeaconEnvelope;
+/** True when the URL is same-origin or relative (safe for sendBeacon + tunnel). */
+declare function isSameOriginOrRelative(url: string, origin?: string): boolean;
+declare function extractTunnelPath(url: string): string;
+interface SendOnUnloadOptions {
+    url: string;
+    headers: Record<string, string>;
+    body: string;
+    path?: string;
+    fetchImpl?: typeof fetch;
+    sendBeacon?: (url: string, data: Blob) => boolean;
+}
+/**
+ * Deliver one JSON POST during pagehide. Prefers fetch keepalive (headers).
+ * Falls back to sendBeacon with a credential envelope on same-origin URLs.
+ */
+declare function sendOnUnload(opts: SendOnUnloadOptions): boolean;
+declare function markPageUnloading(): void;
+declare function isPageUnloading(): boolean;
 
 /**
  * C7: Data residency region resolution.
@@ -2632,4 +2753,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 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_BORDER, MUSHI_COLORS_DARK, MUSHI_COLORS_LIGHT, MUSHI_CONTROL_DISABLED, MUSHI_COPY, MUSHI_DURATION, MUSHI_GEOMETRY, MUSHI_IDENTITY_TOKEN_PREFIX, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, MUSHI_INVERSE, MUSHI_LETTER_SPACING, MUSHI_MOTION, MUSHI_ON_ACCENT, MUSHI_OPACITY, MUSHI_PROJECT_HEADER, MUSHI_RADIUS, MUSHI_REPORTER_STATUS, MUSHI_SDK_PACKAGE_HEADER, MUSHI_SDK_VERSION_HEADER, MUSHI_SHADOW_INK, 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 MushiSessionEventPayload, 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, type SessionTrackerOptions, 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, scrubUrl, sha256Hex, trackPageView, updateSessionIdentity, validateConfig };
+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_BEACON_MAX_BYTES, MUSHI_BORDER, MUSHI_COLORS_DARK, MUSHI_COLORS_LIGHT, MUSHI_CONTROL_DISABLED, MUSHI_COPY, MUSHI_DURATION, MUSHI_GEOMETRY, MUSHI_IDENTITY_TOKEN_PREFIX, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, MUSHI_INVERSE, MUSHI_LETTER_SPACING, MUSHI_MOTION, MUSHI_ON_ACCENT, MUSHI_OPACITY, MUSHI_PROJECT_HEADER, MUSHI_RADIUS, MUSHI_REPORTER_STATUS, MUSHI_SDK_PACKAGE_HEADER, MUSHI_SDK_VERSION_HEADER, MUSHI_SHADOW_INK, 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 MushiBeaconEnvelope, 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 MushiErrorFilter, 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 MushiSessionEventPayload, 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, type SessionTrackerOptions, buildBeaconEnvelope, buildIdentityClaims, buildSdkIngestHeaders, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, destroySessionTracker, diagnoseEnvConfig, estimateJsonBytes, expandPreset, extractTunnelPath, faviconUrlCandidates, flushLastOutboundOnUnload, formatBytes, getBackoffDelay, getDeviceFingerprintHash, getReporterToken, getSessionId, githubRepoDomainHint, hmacSha256Hex, initSessionTracker, isLikelyGenericFavicon, isMushiBeaconEnvelope, isPageUnloading, isSameOriginOrRelative, isUntrustedFaviconUrl, markPageUnloading, matchesErrorFilter, mushiPalette, mushiTokens, newUuid, noopLogger, normaliseThrown, originToDomain, parseIdentityToken, parseRetryAfter, projectFaviconUrlCandidates, projectInitials, projectInitialsThemeIndex, readPageFaviconHref, resolveEnvConfig, resolveProjectDomain, resolveProjectFaviconDomains, resolveRegionEndpoint, resolveRequestBaseUrl, resolveWidgetAccent, safeWidgetHex, scrubPii, scrubUrl, sendOnUnload, sha256Hex, shouldDropCapturedError, trackPageView, updateSessionIdentity, validateConfig };

package/dist/index.d.ts

@@ -46,6 +46,31 @@ interface MushiConfig {
      * when omitted (legacy Vercel Analytics wiring).
      */
     appVersion?: string;
+    /**
+     * Same-origin (or absolute) ingest proxy. When set, every SDK HTTP call
+     * goes here instead of `apiEndpoint` so ad blockers that drop third-party
+     * `*.supabase.co/functions` hosts cannot silently eat reports.
+     * Relative URLs resolve against the page origin — that is the recommended
+     * form (no CORS preflight; matches Sentry `tunnel`).
+     *
+     * @example
+     * tunnel: '/api/mushi-tunnel'
+     */
+    tunnel?: string;
+    /**
+     * Drop automatic error reports whose message matches any string (substring)
+     * or RegExp. Never applied to user-submitted widget feedback.
+     */
+    ignoreErrors?: Array<string | RegExp>;
+    /**
+     * Drop automatic error reports whose script URL / stack filename matches.
+     */
+    denyUrls?: Array<string | RegExp>;
+    /**
+     * When set, drop automatic error reports unless the script URL matches
+     * at least one entry.
+     */
+    allowUrls?: Array<string | RegExp>;
     /**
      * Probabilistic sampling rate for session-replay recording (rrweb/lite).
      * Range 0–1, default 1 (record all sessions). The sampling decision is made
@@ -59,6 +84,13 @@ interface MushiConfig {
      * replaySampleRate: 0.2  // record replay for ~20% of sessions
      */
     replaySampleRate?: number;
+    /**
+     * When session replay was sampled out, still start the rolling buffer for
+     * this fraction of sessions (0–1, default 0) so an error/feedback report
+     * can attach replay. Keep at 0 unless you have accepted the CPU/egress
+     * cost — do not set to 1 with `capture.replay: 'rrweb'`.
+     */
+    replaysOnErrorSampleRate?: number;
     /**
      * Probabilistic sampling rate for automatic (non-user-initiated) error
      * reports. Range 0–1, default 1 (send all). User-initiated feedback reports
@@ -1711,6 +1743,8 @@ interface MushiTesterReputation {
     total_points: number;
 }
 
+/** Replay the last POST via keepalive/beacon during pagehide. */
+declare function flushLastOutboundOnUnload(): boolean;
 /** Header carrying the signed end-user identity token (verified server-side). */
 declare const MUSHI_USER_TOKEN_HEADER = "X-Mushi-User-Token";
 /** Project scope header — paired with the API key on every SDK request. */
@@ -1759,14 +1793,101 @@ interface ApiClientOptions {
      * backend can verify it and scope identity-bound features to that user.
      */
     getUserToken?: () => string | null | undefined;
+    /**
+     * Same-origin (or absolute) proxy. When set, replaces `apiEndpoint` as the
+     * request base so browser calls stay first-party. See `MushiConfig.tunnel`.
+     */
+    tunnel?: string;
 }
 declare const DEFAULT_API_ENDPOINT = "https://dxptnwrhwsqckaftyymj.supabase.co/functions/v1/api";
 declare const MUSHI_INTERNAL_HEADER = "X-Mushi-Internal";
 declare const MUSHI_INTERNAL_INIT_MARKER = "__mushiInternal";
 type MushiInternalRequestKind = 'sdk-config' | 'report-submit' | 'report-status' | 'reporter-poll' | 'diagnose' | 'discovery' | 'community';
+/** Resolve the HTTP base: tunnel wins so ingest stays first-party. */
+declare function resolveRequestBaseUrl(apiEndpoint: string | undefined, tunnel?: string): string;
 declare const DEFAULT_TIMEOUT = 10000;
 declare const DEFAULT_MAX_RETRIES = 2;
 declare function createApiClient(options: ApiClientOptions): MushiApiClient;
+declare function getBackoffDelay(attempt: number): number;
+/**
+ * Parse a `Retry-After` header into a delay in milliseconds. The header comes
+ * in two shapes (RFC 9110): delta-seconds, or an HTTP-date to wait until.
+ * Returns null when the header is absent, malformed, or negative, so the
+ * caller falls back to its own backoff curve.
+ */
+declare function parseRetryAfter(value: string | null | undefined, now?: number): number | null;
+
+/**
+ * FILE: packages/core/src/error-filters.ts
+ * PURPOSE: Sentry-grade drop filters for automatic error capture.
+ *
+ * OVERVIEW:
+ * - ignoreErrors — drop when the error message matches a string or RegExp
+ * - denyUrls — drop when the script URL / stack frame matches
+ * - allowUrls — when set, drop unless the script URL matches at least one
+ *
+ * USAGE:
+ * - captureException / window.onerror / unhandledrejection only
+ * - Never applied to user-submitted widget feedback
+ *
+ * NOTES:
+ * - String matchers are case-sensitive substrings (Sentry JS semantics)
+ * - Invalid RegExp sources are treated as non-matches, not throws
+ */
+type MushiErrorFilter = string | RegExp;
+declare function matchesErrorFilter(value: string | undefined | null, filters: readonly MushiErrorFilter[] | undefined): boolean;
+declare function shouldDropCapturedError(input: {
+    message: string;
+    filename?: string | null;
+    ignoreErrors?: readonly MushiErrorFilter[];
+    denyUrls?: readonly MushiErrorFilter[];
+    allowUrls?: readonly MushiErrorFilter[];
+}): boolean;
+
+/**
+ * FILE: packages/core/src/unload-transport.ts
+ * PURPOSE: Pagehide-safe report delivery (fetch keepalive + sendBeacon).
+ *
+ * OVERVIEW:
+ * - fetch({ keepalive: true }) keeps custom X-Mushi-* headers (Sentry 2024+ primary)
+ * - sendBeacon cannot set headers, so it wraps credentials in a beacon envelope
+ *   that only the same-origin tunnel unwraps
+ *
+ * NOTES:
+ * - Beacon payloads over 60 KiB are skipped (browser sendBeacon limit ~64 KiB)
+ * - Never put the API key in the query string
+ */
+declare const MUSHI_BEACON_MAX_BYTES: number;
+interface MushiBeaconEnvelope {
+    mushiBeacon: true;
+    path: string;
+    headers: Record<string, string>;
+    body: unknown;
+}
+declare function isMushiBeaconEnvelope(value: unknown): value is MushiBeaconEnvelope;
+declare function buildBeaconEnvelope(opts: {
+    path: string;
+    headers: Record<string, string>;
+    body: unknown;
+}): MushiBeaconEnvelope;
+/** True when the URL is same-origin or relative (safe for sendBeacon + tunnel). */
+declare function isSameOriginOrRelative(url: string, origin?: string): boolean;
+declare function extractTunnelPath(url: string): string;
+interface SendOnUnloadOptions {
+    url: string;
+    headers: Record<string, string>;
+    body: string;
+    path?: string;
+    fetchImpl?: typeof fetch;
+    sendBeacon?: (url: string, data: Blob) => boolean;
+}
+/**
+ * Deliver one JSON POST during pagehide. Prefers fetch keepalive (headers).
+ * Falls back to sendBeacon with a credential envelope on same-origin URLs.
+ */
+declare function sendOnUnload(opts: SendOnUnloadOptions): boolean;
+declare function markPageUnloading(): void;
+declare function isPageUnloading(): boolean;
 
 /**
  * C7: Data residency region resolution.
@@ -2632,4 +2753,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 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_BORDER, MUSHI_COLORS_DARK, MUSHI_COLORS_LIGHT, MUSHI_CONTROL_DISABLED, MUSHI_COPY, MUSHI_DURATION, MUSHI_GEOMETRY, MUSHI_IDENTITY_TOKEN_PREFIX, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, MUSHI_INVERSE, MUSHI_LETTER_SPACING, MUSHI_MOTION, MUSHI_ON_ACCENT, MUSHI_OPACITY, MUSHI_PROJECT_HEADER, MUSHI_RADIUS, MUSHI_REPORTER_STATUS, MUSHI_SDK_PACKAGE_HEADER, MUSHI_SDK_VERSION_HEADER, MUSHI_SHADOW_INK, 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 MushiSessionEventPayload, 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, type SessionTrackerOptions, 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, scrubUrl, sha256Hex, trackPageView, updateSessionIdentity, validateConfig };
+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_BEACON_MAX_BYTES, MUSHI_BORDER, MUSHI_COLORS_DARK, MUSHI_COLORS_LIGHT, MUSHI_CONTROL_DISABLED, MUSHI_COPY, MUSHI_DURATION, MUSHI_GEOMETRY, MUSHI_IDENTITY_TOKEN_PREFIX, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, MUSHI_INVERSE, MUSHI_LETTER_SPACING, MUSHI_MOTION, MUSHI_ON_ACCENT, MUSHI_OPACITY, MUSHI_PROJECT_HEADER, MUSHI_RADIUS, MUSHI_REPORTER_STATUS, MUSHI_SDK_PACKAGE_HEADER, MUSHI_SDK_VERSION_HEADER, MUSHI_SHADOW_INK, 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 MushiBeaconEnvelope, 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 MushiErrorFilter, 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 MushiSessionEventPayload, 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, type SessionTrackerOptions, buildBeaconEnvelope, buildIdentityClaims, buildSdkIngestHeaders, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, destroySessionTracker, diagnoseEnvConfig, estimateJsonBytes, expandPreset, extractTunnelPath, faviconUrlCandidates, flushLastOutboundOnUnload, formatBytes, getBackoffDelay, getDeviceFingerprintHash, getReporterToken, getSessionId, githubRepoDomainHint, hmacSha256Hex, initSessionTracker, isLikelyGenericFavicon, isMushiBeaconEnvelope, isPageUnloading, isSameOriginOrRelative, isUntrustedFaviconUrl, markPageUnloading, matchesErrorFilter, mushiPalette, mushiTokens, newUuid, noopLogger, normaliseThrown, originToDomain, parseIdentityToken, parseRetryAfter, projectFaviconUrlCandidates, projectInitials, projectInitialsThemeIndex, readPageFaviconHref, resolveEnvConfig, resolveProjectDomain, resolveProjectFaviconDomains, resolveRegionEndpoint, resolveRequestBaseUrl, resolveWidgetAccent, safeWidgetHex, scrubPii, scrubUrl, sendOnUnload, sha256Hex, shouldDropCapturedError, trackPageView, updateSessionIdentity, validateConfig };