@mushi-mushi/core 1.22.5 → 1.25.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;
@@ -1390,6 +1390,10 @@ interface MushiApiClient {
     postDiscoveryEvent(event: MushiDiscoveryEventPayload): Promise<MushiApiResponse<{
         accepted: boolean;
     }>>;
+    /** POST /v1/sdk/session — lightweight session lifecycle event (best-effort). */
+    postSessionEvent(payload: MushiSessionEventPayload): Promise<MushiApiResponse<{
+        accepted: boolean;
+    }>>;
     listReporterReports(reporterToken: string): Promise<MushiApiResponse<{
         reports: MushiReporterReport[];
     }>>;
@@ -1520,6 +1524,28 @@ interface MushiDiscoveryEventPayload {
     sdk_version?: string;
     observed_at: string;
 }
+/** Payload for /v1/sdk/session — lightweight session lifecycle tracking.
+ *  Best-effort, no offline queue. Privacy-safe: no PII by default;
+ *  `user_id_hash` is the same device-fingerprint hash used elsewhere. */
+interface MushiSessionEventPayload {
+    /** Lifecycle event kind. */
+    kind: 'session_start' | 'session_heartbeat' | 'session_end' | 'page_view';
+    session_id: string;
+    /** ISO timestamp of the event. */
+    ts: string;
+    /** Entry route for session_start; current route for page_view. */
+    route?: string | null;
+    /** document.referrer on session_start. */
+    referrer?: string | null;
+    /** Total page views in this session so far (updated on heartbeat/end). */
+    page_view_count?: number;
+    /** Device fingerprint hash — same token used in reports. */
+    reporter_token_hash?: string | null;
+    /** user_id_hash when the host app called Mushi.identify(). */
+    user_id_hash?: string | null;
+    user_agent?: string | null;
+    sdk_version?: string;
+}
 interface MushiApiResponse<T> {
     ok: boolean;
     data?: T;
@@ -1740,6 +1766,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;
@@ -1882,6 +1958,48 @@ declare function getDeviceFingerprintHash(): Promise<string | null>;
 
 declare function getSessionId(): string;
 
+/**
+ * FILE: packages/core/src/session-tracker.ts
+ * PURPOSE: Lightweight session-lifecycle tracking for the Mushi SDK.
+ *
+ * Emits best-effort events to /v1/sdk/session so the console can show per-
+ * project activity analytics (DAU/WAU, page views, identified vs. anonymous
+ * user split, top routes). Mirrors the postDiscoveryEvent pattern: 1 retry,
+ * no offline queue, fire-and-forget after visibility-change.
+ *
+ * Privacy:
+ *   - No PII by default. `reporter_token_hash` is the same opaque device
+ *     fingerprint already used in reports. `user_id_hash` is only set when
+ *     the host app calls Mushi.identify().
+ *   - Respects the SDK-level `trackSessions: false` opt-out option.
+ *   - Respects a DNT / Global Privacy Control header at the SDK init layer;
+ *     callers should check `shouldRespectDnt()` before calling `initSession`.
+ */
+
+interface SessionTrackerOptions {
+    client: MushiApiClient;
+    sdkVersion?: string;
+    reporterTokenHash?: string | null;
+    userIdHash?: string | null;
+}
+/**
+ * Initialise the session tracker. Call once at SDK init for web environments.
+ * Subsequent calls on the same page are no-ops (idempotent).
+ *
+ * Emits: session_start immediately, heartbeats every minute, session_end on
+ * visibilitychange/pagehide, and page_view on history API navigation.
+ */
+declare function initSessionTracker(opts: SessionTrackerOptions): void;
+/**
+ * Record a page view manually — call from framework router hooks where the
+ * history patch may fire too early (e.g. React Router v7 loader transitions).
+ */
+declare function trackPageView(route?: string): void;
+/** Update the user identity after a Mushi.identify() call. */
+declare function updateSessionIdentity(userIdHash: string | null): void;
+/** Tear down timers (e.g. in tests or SSR environments). */
+declare function destroySessionTracker(): void;
+
 interface RateLimiterConfig {
     maxBurst?: number;
     refillRate?: number;
@@ -2385,4 +2503,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 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, sha256Hex, trackPageView, updateSessionIdentity, 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;
@@ -1390,6 +1390,10 @@ interface MushiApiClient {
     postDiscoveryEvent(event: MushiDiscoveryEventPayload): Promise<MushiApiResponse<{
         accepted: boolean;
     }>>;
+    /** POST /v1/sdk/session — lightweight session lifecycle event (best-effort). */
+    postSessionEvent(payload: MushiSessionEventPayload): Promise<MushiApiResponse<{
+        accepted: boolean;
+    }>>;
     listReporterReports(reporterToken: string): Promise<MushiApiResponse<{
         reports: MushiReporterReport[];
     }>>;
@@ -1520,6 +1524,28 @@ interface MushiDiscoveryEventPayload {
     sdk_version?: string;
     observed_at: string;
 }
+/** Payload for /v1/sdk/session — lightweight session lifecycle tracking.
+ *  Best-effort, no offline queue. Privacy-safe: no PII by default;
+ *  `user_id_hash` is the same device-fingerprint hash used elsewhere. */
+interface MushiSessionEventPayload {
+    /** Lifecycle event kind. */
+    kind: 'session_start' | 'session_heartbeat' | 'session_end' | 'page_view';
+    session_id: string;
+    /** ISO timestamp of the event. */
+    ts: string;
+    /** Entry route for session_start; current route for page_view. */
+    route?: string | null;
+    /** document.referrer on session_start. */
+    referrer?: string | null;
+    /** Total page views in this session so far (updated on heartbeat/end). */
+    page_view_count?: number;
+    /** Device fingerprint hash — same token used in reports. */
+    reporter_token_hash?: string | null;
+    /** user_id_hash when the host app called Mushi.identify(). */
+    user_id_hash?: string | null;
+    user_agent?: string | null;
+    sdk_version?: string;
+}
 interface MushiApiResponse<T> {
     ok: boolean;
     data?: T;
@@ -1740,6 +1766,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;
@@ -1882,6 +1958,48 @@ declare function getDeviceFingerprintHash(): Promise<string | null>;
 
 declare function getSessionId(): string;
 
+/**
+ * FILE: packages/core/src/session-tracker.ts
+ * PURPOSE: Lightweight session-lifecycle tracking for the Mushi SDK.
+ *
+ * Emits best-effort events to /v1/sdk/session so the console can show per-
+ * project activity analytics (DAU/WAU, page views, identified vs. anonymous
+ * user split, top routes). Mirrors the postDiscoveryEvent pattern: 1 retry,
+ * no offline queue, fire-and-forget after visibility-change.
+ *
+ * Privacy:
+ *   - No PII by default. `reporter_token_hash` is the same opaque device
+ *     fingerprint already used in reports. `user_id_hash` is only set when
+ *     the host app calls Mushi.identify().
+ *   - Respects the SDK-level `trackSessions: false` opt-out option.
+ *   - Respects a DNT / Global Privacy Control header at the SDK init layer;
+ *     callers should check `shouldRespectDnt()` before calling `initSession`.
+ */
+
+interface SessionTrackerOptions {
+    client: MushiApiClient;
+    sdkVersion?: string;
+    reporterTokenHash?: string | null;
+    userIdHash?: string | null;
+}
+/**
+ * Initialise the session tracker. Call once at SDK init for web environments.
+ * Subsequent calls on the same page are no-ops (idempotent).
+ *
+ * Emits: session_start immediately, heartbeats every minute, session_end on
+ * visibilitychange/pagehide, and page_view on history API navigation.
+ */
+declare function initSessionTracker(opts: SessionTrackerOptions): void;
+/**
+ * Record a page view manually — call from framework router hooks where the
+ * history patch may fire too early (e.g. React Router v7 loader transitions).
+ */
+declare function trackPageView(route?: string): void;
+/** Update the user identity after a Mushi.identify() call. */
+declare function updateSessionIdentity(userIdHash: string | null): void;
+/** Tear down timers (e.g. in tests or SSR environments). */
+declare function destroySessionTracker(): void;
+
 interface RateLimiterConfig {
     maxBurst?: number;
     refillRate?: number;
@@ -2385,4 +2503,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 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, sha256Hex, trackPageView, updateSessionIdentity, validateConfig };