@mushi-mushi/core 1.12.0 → 1.14.0

package/dist/index.d.cts

@@ -39,7 +39,16 @@ interface MushiWidgetConfig {
      * banners. When set, these values win over `position` + numeric `inset`.
      */
     anchor?: MushiWidgetAnchor;
-    theme?: 'auto' | 'light' | 'dark';
+    theme?: 'auto' | 'light' | 'dark' | 'inherit';
+    /**
+     * Override the widget's primary accent colour (default: vermillion #E03C2C).
+     * Must be a CSS colour value that has sufficient contrast against both light
+     * and dark widget backgrounds. The widget derives a wash + accessible ink
+     * colour automatically, so only the base colour is required.
+     */
+    accent?: string;
+    /** Explicit text colour on the accent surface. Auto-computed when omitted. */
+    accentText?: string;
     triggerText?: string;
     expandedTitle?: string;
     mode?: 'simple' | 'conversational';
@@ -73,7 +82,20 @@ interface MushiWidgetConfig {
     environments?: Partial<Record<'production' | 'staging' | 'development', 'always' | 'never' | 'manual'>>;
     /** Opt-in smart trigger behavior; planned to become the default in a later minor. */
     smartHide?: boolean | MushiWidgetSmartHideConfig;
-    draggable?: boolean;
+    /**
+     * Allow the FAB to be dragged and repositioned by the user.
+     * - `true`  — drag enabled, persisted to localStorage, snaps to nearest edge on release.
+     * - `false` — fixed position (default).
+     * - Object — fine-grained control:
+     *   - `persist`     save position per projectId (default true when draggable).
+     *   - `snapToEdge`  snap to the nearest left/right edge on release (default true).
+     *   - `axis`        constrain movement to one axis (`'x'`, `'y'`, or `'both'` default).
+     */
+    draggable?: boolean | {
+        persist?: boolean;
+        snapToEdge?: boolean;
+        axis?: 'both' | 'x' | 'y';
+    };
     /** Show the tiny "Powered by Mushi vX" footer inside the widget panel. */
     brandFooter?: boolean;
     /** How the widget should surface SDK freshness warnings. Defaults to auto. */
@@ -129,6 +151,51 @@ interface MushiWidgetConfig {
      * avoidSelectors: ['[data-mobile-header]', '#sign-in-cta']
      */
     avoidSelectors?: string[];
+    /**
+     * Override the default five-category picker with a custom category list.
+     * When set, the widget renders these categories instead of the built-in
+     * `bug / slow / visual / confusing / other` set.
+     *
+     * Each custom category maps onto one of the five built-in `MushiReportCategory`
+     * values via `baseCategory` (defaults to `'other'`). The custom id is
+     * preserved as `userCategory` on the report so the Mushi console can filter
+     * by it independently of the LLM-assigned `category`.
+     *
+     * Deep-link helpers (`open`, `openWith`, `report`) accept the custom `id`
+     * in addition to the built-in enum values when this option is set.
+     *
+     * When absent, behaviour is identical to the historical defaults (backward-compatible).
+     */
+    categories?: MushiCustomCategory[];
+}
+/**
+ * Descriptor for a single entry in a host-app custom category list.
+ * Passed as `widget.categories` to `Mushi.init()`.
+ */
+interface MushiCustomCategory {
+    /** Unique identifier used in `openWith(id)` / `report({ category: id })`. */
+    id: string;
+    /** Human-readable label shown in the category picker step. */
+    label: string;
+    /** Optional helper text shown beneath the label. */
+    description?: string;
+    /**
+     * Localised intent options displayed on the second step ("What happened?").
+     * When omitted, the widget skips the intent step and goes straight to
+     * the description.
+     */
+    intents?: string[];
+    /**
+     * Emoji or single-character icon rendered next to the label in the picker.
+     * Falls back to a neutral bubble when absent.
+     */
+    icon?: string;
+    /**
+     * Which built-in `MushiReportCategory` value this custom category maps to
+     * for server-side classification. Defaults to `'other'`.
+     * The custom `id` is always preserved in `report.userCategory`.
+     */
+    baseCategory?: MushiReportCategory;
 }
 /** Optional flat link in the rich banner action row (admin-console BetaBanner style). */
 interface MushiBannerLink {
@@ -543,6 +610,13 @@ interface MushiReport {
     id: string;
     projectId: string;
     category: MushiReportCategory;
+    /**
+     * Custom category identifier set by the host app via `widget.categories`.
+     * Preserved as `reports.user_category` on the server so the Mushi console
+     * can filter by it independently of the LLM-assigned `category`.
+     * Not set when the host uses the default built-in category set.
+     */
+    userCategory?: string;
     description: string;
     userIntent?: string;
     environment: MushiEnvironment;
@@ -957,9 +1031,12 @@ interface MushiSDKInstance {
      * feature-request shortcut. Pass `{ category }` to deep-link into a
      * specific bug intent, or `{ featureRequest: true }` to deep-link into
      * the feature-request description step (skips intent picker).
+     *
+     * When `widget.categories` is configured, `category` also accepts a
+     * custom category `id` from that list.
      */
     report(options?: {
-        category?: MushiReportCategory;
+        category?: MushiReportCategory | string;
         featureRequest?: boolean;
     }): void;
     on(event: MushiEventType, handler: MushiEventHandler): () => void;
@@ -976,7 +1053,12 @@ interface MushiSDKInstance {
     }): void;
     isOpen(): boolean;
     open(): void;
-    openWith(category: MushiReportCategory): void;
+    /**
+     * Open the widget deep-linked to a specific category. Accepts a built-in
+     * `MushiReportCategory` value or a custom category `id` when
+     * `widget.categories` is configured.
+     */
+    openWith(category: MushiReportCategory | string): void;
     show(): void;
     hide(): void;
     attachTo(selectorOrElement: string | Element, options?: MushiWidgetConfig): () => void;
@@ -1239,6 +1321,38 @@ interface MushiApiClient {
             project_name: string;
         };
     }>>;
+    /** Link the anonymous reporter_token_hash to the caller's mushi_testers row. */
+    sendMagicLink(email: string): Promise<MushiApiResponse<{
+        ok: boolean;
+    }>>;
+    linkReporterToken(reporterTokenHash: string, jwt: string): Promise<MushiApiResponse<{
+        ok: boolean;
+        linked: number;
+    }>>;
+    /** All reports filed by the signed-in tester, across all projects. */
+    getCrossAppReports(jwt: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<MushiApiResponse<{
+        reports: MushiCrossAppReport[];
+    }>>;
+    /** The signed-in tester's global rank + points. */
+    getMyReputation(jwt: string): Promise<MushiApiResponse<{
+        reputation: MushiTesterReputation | null;
+    }>>;
+    /** Top-N global tester leaderboard (no auth required). */
+    getPublicLeaderboard(limit?: number): Promise<MushiApiResponse<{
+        leaderboard: MushiLeaderboardEntry[];
+    }>>;
+    /** Whether the caller has a mushi_testers row. */
+    getTesterStatus(jwt: string): Promise<MushiApiResponse<{
+        is_tester: boolean;
+        tester: {
+            id: string;
+            public_handle: string | null;
+            display_name: string | null;
+        } | null;
+    }>>;
 }
 /**
  * Wire shape of a single discovery event sent by the SDK to
@@ -1314,6 +1428,38 @@ interface MushiHallOfFameEntry {
     points_30d: number;
     total_points: number;
 }
+/** A report filed by the current tester, across any project. */
+interface MushiCrossAppReport {
+    id: string;
+    short_id: string | null;
+    title: string | null;
+    category: string;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    project_id: string | null;
+    app_name: string | null;
+    app_slug: string | null;
+}
+/** A single entry in the global tester leaderboard. */
+interface MushiLeaderboardEntry {
+    tester_id: string;
+    public_handle: string | null;
+    display_name: string | null;
+    rank: number;
+    points_30d: number;
+    total_points: number;
+    badge_slug?: string | null;
+}
+/** The caller's global reputation snapshot. */
+interface MushiTesterReputation {
+    tester_id: string;
+    public_handle: string | null;
+    display_name: string | null;
+    rank: number | null;
+    points_30d: number;
+    total_points: number;
+}
 
 interface ApiClientOptions {
     projectId: string;
@@ -1329,7 +1475,7 @@ interface ApiClientOptions {
 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';
+type MushiInternalRequestKind = 'sdk-config' | 'report-submit' | 'report-status' | 'reporter-poll' | 'diagnose' | 'discovery' | 'community';
 declare function createApiClient(options: ApiClientOptions): MushiApiClient;
 
 /**
@@ -1649,4 +1795,4 @@ declare function createLogger(options: LoggerOptions): Logger;
  */
 declare const noopLogger: Logger;
 
-export { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, MAX_REPORT_PAYLOAD_BYTES, MAX_SCREENSHOT_DATA_URL_BYTES, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, type MushiBannerConfig, type MushiBannerLink, type MushiBetaChangelogEntry, type MushiBetaModeConfig, type MushiBreadcrumb, type MushiCaptureConfig, type MushiCaptureEventInput, type MushiCaptureExceptionOptions, type MushiConfig, type MushiConsoleEntry, type MushiCooldownConfig, type MushiDiagnosticsResult, type MushiDiscoverInventoryConfig, type MushiDiscoveryEventPayload, type MushiEnvironment, type MushiEventHandler, type MushiEventType, type MushiHallOfFameEntry, type MushiIntegrationsConfig, type MushiInternalRequestKind, type MushiNetworkEntry, type MushiOfflineConfig, type MushiOnDeviceClassifier, type MushiOnDeviceClassifierInput, type MushiOnDeviceClassifierResult, 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 MushiTierResult, type MushiTimelineEntry, type MushiTimelineKind, type MushiTracePropagationConfig, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PayloadGuardResult, type PiiScrubberConfig, type PreFilterResult, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, estimateJsonBytes, formatBytes, getDeviceFingerprintHash, getReporterToken, getSessionId, newUuid, noopLogger, normaliseThrown, resolveRegionEndpoint, scrubPii };
+export { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, MAX_REPORT_PAYLOAD_BYTES, MAX_SCREENSHOT_DATA_URL_BYTES, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, type MushiBannerConfig, type MushiBannerLink, type MushiBetaChangelogEntry, type MushiBetaModeConfig, type MushiBreadcrumb, type MushiCaptureConfig, type MushiCaptureEventInput, type MushiCaptureExceptionOptions, 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 MushiIntegrationsConfig, type MushiInternalRequestKind, type MushiLeaderboardEntry, type MushiNetworkEntry, type MushiOfflineConfig, type MushiOnDeviceClassifier, type MushiOnDeviceClassifierInput, type MushiOnDeviceClassifierResult, 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 MushiTierResult, type MushiTimelineEntry, type MushiTimelineKind, type MushiTracePropagationConfig, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PayloadGuardResult, type PiiScrubberConfig, type PreFilterResult, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, estimateJsonBytes, formatBytes, getDeviceFingerprintHash, getReporterToken, getSessionId, newUuid, noopLogger, normaliseThrown, resolveRegionEndpoint, scrubPii };

package/dist/index.d.ts

@@ -39,7 +39,16 @@ interface MushiWidgetConfig {
      * banners. When set, these values win over `position` + numeric `inset`.
      */
     anchor?: MushiWidgetAnchor;
-    theme?: 'auto' | 'light' | 'dark';
+    theme?: 'auto' | 'light' | 'dark' | 'inherit';
+    /**
+     * Override the widget's primary accent colour (default: vermillion #E03C2C).
+     * Must be a CSS colour value that has sufficient contrast against both light
+     * and dark widget backgrounds. The widget derives a wash + accessible ink
+     * colour automatically, so only the base colour is required.
+     */
+    accent?: string;
+    /** Explicit text colour on the accent surface. Auto-computed when omitted. */
+    accentText?: string;
     triggerText?: string;
     expandedTitle?: string;
     mode?: 'simple' | 'conversational';
@@ -73,7 +82,20 @@ interface MushiWidgetConfig {
     environments?: Partial<Record<'production' | 'staging' | 'development', 'always' | 'never' | 'manual'>>;
     /** Opt-in smart trigger behavior; planned to become the default in a later minor. */
     smartHide?: boolean | MushiWidgetSmartHideConfig;
-    draggable?: boolean;
+    /**
+     * Allow the FAB to be dragged and repositioned by the user.
+     * - `true`  — drag enabled, persisted to localStorage, snaps to nearest edge on release.
+     * - `false` — fixed position (default).
+     * - Object — fine-grained control:
+     *   - `persist`     save position per projectId (default true when draggable).
+     *   - `snapToEdge`  snap to the nearest left/right edge on release (default true).
+     *   - `axis`        constrain movement to one axis (`'x'`, `'y'`, or `'both'` default).
+     */
+    draggable?: boolean | {
+        persist?: boolean;
+        snapToEdge?: boolean;
+        axis?: 'both' | 'x' | 'y';
+    };
     /** Show the tiny "Powered by Mushi vX" footer inside the widget panel. */
     brandFooter?: boolean;
     /** How the widget should surface SDK freshness warnings. Defaults to auto. */
@@ -129,6 +151,51 @@ interface MushiWidgetConfig {
      * avoidSelectors: ['[data-mobile-header]', '#sign-in-cta']
      */
     avoidSelectors?: string[];
+    /**
+     * Override the default five-category picker with a custom category list.
+     * When set, the widget renders these categories instead of the built-in
+     * `bug / slow / visual / confusing / other` set.
+     *
+     * Each custom category maps onto one of the five built-in `MushiReportCategory`
+     * values via `baseCategory` (defaults to `'other'`). The custom id is
+     * preserved as `userCategory` on the report so the Mushi console can filter
+     * by it independently of the LLM-assigned `category`.
+     *
+     * Deep-link helpers (`open`, `openWith`, `report`) accept the custom `id`
+     * in addition to the built-in enum values when this option is set.
+     *
+     * When absent, behaviour is identical to the historical defaults (backward-compatible).
+     */
+    categories?: MushiCustomCategory[];
+}
+/**
+ * Descriptor for a single entry in a host-app custom category list.
+ * Passed as `widget.categories` to `Mushi.init()`.
+ */
+interface MushiCustomCategory {
+    /** Unique identifier used in `openWith(id)` / `report({ category: id })`. */
+    id: string;
+    /** Human-readable label shown in the category picker step. */
+    label: string;
+    /** Optional helper text shown beneath the label. */
+    description?: string;
+    /**
+     * Localised intent options displayed on the second step ("What happened?").
+     * When omitted, the widget skips the intent step and goes straight to
+     * the description.
+     */
+    intents?: string[];
+    /**
+     * Emoji or single-character icon rendered next to the label in the picker.
+     * Falls back to a neutral bubble when absent.
+     */
+    icon?: string;
+    /**
+     * Which built-in `MushiReportCategory` value this custom category maps to
+     * for server-side classification. Defaults to `'other'`.
+     * The custom `id` is always preserved in `report.userCategory`.
+     */
+    baseCategory?: MushiReportCategory;
 }
 /** Optional flat link in the rich banner action row (admin-console BetaBanner style). */
 interface MushiBannerLink {
@@ -543,6 +610,13 @@ interface MushiReport {
     id: string;
     projectId: string;
     category: MushiReportCategory;
+    /**
+     * Custom category identifier set by the host app via `widget.categories`.
+     * Preserved as `reports.user_category` on the server so the Mushi console
+     * can filter by it independently of the LLM-assigned `category`.
+     * Not set when the host uses the default built-in category set.
+     */
+    userCategory?: string;
     description: string;
     userIntent?: string;
     environment: MushiEnvironment;
@@ -957,9 +1031,12 @@ interface MushiSDKInstance {
      * feature-request shortcut. Pass `{ category }` to deep-link into a
      * specific bug intent, or `{ featureRequest: true }` to deep-link into
      * the feature-request description step (skips intent picker).
+     *
+     * When `widget.categories` is configured, `category` also accepts a
+     * custom category `id` from that list.
      */
     report(options?: {
-        category?: MushiReportCategory;
+        category?: MushiReportCategory | string;
         featureRequest?: boolean;
     }): void;
     on(event: MushiEventType, handler: MushiEventHandler): () => void;
@@ -976,7 +1053,12 @@ interface MushiSDKInstance {
     }): void;
     isOpen(): boolean;
     open(): void;
-    openWith(category: MushiReportCategory): void;
+    /**
+     * Open the widget deep-linked to a specific category. Accepts a built-in
+     * `MushiReportCategory` value or a custom category `id` when
+     * `widget.categories` is configured.
+     */
+    openWith(category: MushiReportCategory | string): void;
     show(): void;
     hide(): void;
     attachTo(selectorOrElement: string | Element, options?: MushiWidgetConfig): () => void;
@@ -1239,6 +1321,38 @@ interface MushiApiClient {
             project_name: string;
         };
     }>>;
+    /** Link the anonymous reporter_token_hash to the caller's mushi_testers row. */
+    sendMagicLink(email: string): Promise<MushiApiResponse<{
+        ok: boolean;
+    }>>;
+    linkReporterToken(reporterTokenHash: string, jwt: string): Promise<MushiApiResponse<{
+        ok: boolean;
+        linked: number;
+    }>>;
+    /** All reports filed by the signed-in tester, across all projects. */
+    getCrossAppReports(jwt: string, opts?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<MushiApiResponse<{
+        reports: MushiCrossAppReport[];
+    }>>;
+    /** The signed-in tester's global rank + points. */
+    getMyReputation(jwt: string): Promise<MushiApiResponse<{
+        reputation: MushiTesterReputation | null;
+    }>>;
+    /** Top-N global tester leaderboard (no auth required). */
+    getPublicLeaderboard(limit?: number): Promise<MushiApiResponse<{
+        leaderboard: MushiLeaderboardEntry[];
+    }>>;
+    /** Whether the caller has a mushi_testers row. */
+    getTesterStatus(jwt: string): Promise<MushiApiResponse<{
+        is_tester: boolean;
+        tester: {
+            id: string;
+            public_handle: string | null;
+            display_name: string | null;
+        } | null;
+    }>>;
 }
 /**
  * Wire shape of a single discovery event sent by the SDK to
@@ -1314,6 +1428,38 @@ interface MushiHallOfFameEntry {
     points_30d: number;
     total_points: number;
 }
+/** A report filed by the current tester, across any project. */
+interface MushiCrossAppReport {
+    id: string;
+    short_id: string | null;
+    title: string | null;
+    category: string;
+    status: string;
+    created_at: string;
+    updated_at: string;
+    project_id: string | null;
+    app_name: string | null;
+    app_slug: string | null;
+}
+/** A single entry in the global tester leaderboard. */
+interface MushiLeaderboardEntry {
+    tester_id: string;
+    public_handle: string | null;
+    display_name: string | null;
+    rank: number;
+    points_30d: number;
+    total_points: number;
+    badge_slug?: string | null;
+}
+/** The caller's global reputation snapshot. */
+interface MushiTesterReputation {
+    tester_id: string;
+    public_handle: string | null;
+    display_name: string | null;
+    rank: number | null;
+    points_30d: number;
+    total_points: number;
+}
 
 interface ApiClientOptions {
     projectId: string;
@@ -1329,7 +1475,7 @@ interface ApiClientOptions {
 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';
+type MushiInternalRequestKind = 'sdk-config' | 'report-submit' | 'report-status' | 'reporter-poll' | 'diagnose' | 'discovery' | 'community';
 declare function createApiClient(options: ApiClientOptions): MushiApiClient;
 
 /**
@@ -1649,4 +1795,4 @@ declare function createLogger(options: LoggerOptions): Logger;
  */
 declare const noopLogger: Logger;
 
-export { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, MAX_REPORT_PAYLOAD_BYTES, MAX_SCREENSHOT_DATA_URL_BYTES, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, type MushiBannerConfig, type MushiBannerLink, type MushiBetaChangelogEntry, type MushiBetaModeConfig, type MushiBreadcrumb, type MushiCaptureConfig, type MushiCaptureEventInput, type MushiCaptureExceptionOptions, type MushiConfig, type MushiConsoleEntry, type MushiCooldownConfig, type MushiDiagnosticsResult, type MushiDiscoverInventoryConfig, type MushiDiscoveryEventPayload, type MushiEnvironment, type MushiEventHandler, type MushiEventType, type MushiHallOfFameEntry, type MushiIntegrationsConfig, type MushiInternalRequestKind, type MushiNetworkEntry, type MushiOfflineConfig, type MushiOnDeviceClassifier, type MushiOnDeviceClassifierInput, type MushiOnDeviceClassifierResult, 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 MushiTierResult, type MushiTimelineEntry, type MushiTimelineKind, type MushiTracePropagationConfig, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PayloadGuardResult, type PiiScrubberConfig, type PreFilterResult, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, estimateJsonBytes, formatBytes, getDeviceFingerprintHash, getReporterToken, getSessionId, newUuid, noopLogger, normaliseThrown, resolveRegionEndpoint, scrubPii };
+export { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, MAX_REPORT_PAYLOAD_BYTES, MAX_SCREENSHOT_DATA_URL_BYTES, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, type MushiBannerConfig, type MushiBannerLink, type MushiBetaChangelogEntry, type MushiBetaModeConfig, type MushiBreadcrumb, type MushiCaptureConfig, type MushiCaptureEventInput, type MushiCaptureExceptionOptions, 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 MushiIntegrationsConfig, type MushiInternalRequestKind, type MushiLeaderboardEntry, type MushiNetworkEntry, type MushiOfflineConfig, type MushiOnDeviceClassifier, type MushiOnDeviceClassifierInput, type MushiOnDeviceClassifierResult, 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 MushiTierResult, type MushiTimelineEntry, type MushiTimelineKind, type MushiTracePropagationConfig, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PayloadGuardResult, type PiiScrubberConfig, type PreFilterResult, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, captureEnvironment, checkReportPayloadSize, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, estimateJsonBytes, formatBytes, getDeviceFingerprintHash, getReporterToken, getSessionId, newUuid, noopLogger, normaliseThrown, resolveRegionEndpoint, scrubPii };

package/dist/index.js

@@ -55,7 +55,7 @@ function createApiClient(options) {
     maxRetries = DEFAULT_MAX_RETRIES
   } = options;
   let baseUrl = apiEndpoint.replace(/\/$/, "");
-  async function request(method, path, body, retries = maxRetries, internalKind) {
+  async function request(method, path, body, retries = maxRetries, internalKind, extraHeaders) {
     const url = `${baseUrl}${path}`;
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), timeout);
@@ -66,7 +66,8 @@ function createApiClient(options) {
           "Content-Type": "application/json",
           "X-Mushi-Api-Key": apiKey,
           "X-Mushi-Project": projectId,
-          ...internalKind ? { [MUSHI_INTERNAL_HEADER]: internalKind } : {}
+          ...internalKind ? { [MUSHI_INTERNAL_HEADER]: internalKind } : {},
+          ...extraHeaders
         },
         body: body ? JSON.stringify(body) : void 0,
         signal: controller.signal,
@@ -79,7 +80,7 @@ function createApiClient(options) {
           const targetBase = target.replace(/\/v1\/.*$/, "").replace(/\/$/, "");
           if (targetBase !== baseUrl) {
             baseUrl = targetBase;
-            return request(method, path, body, retries - 1, internalKind);
+            return request(method, path, body, retries - 1, internalKind, extraHeaders);
           }
         }
       }
@@ -87,7 +88,7 @@ function createApiClient(options) {
         const errorBody = await response.json().catch(() => ({}));
         if (response.status >= 500 && retries > 0) {
           await sleep(getBackoffDelay(maxRetries - retries));
-          return request(method, path, body, retries - 1, internalKind);
+          return request(method, path, body, retries - 1, internalKind, extraHeaders);
         }
         return {
           ok: false,
@@ -295,6 +296,69 @@ function createApiClient(options) {
         1,
         "reporter-poll"
       );
+    },
+    // ─── Cross-app community (in-widget tester identity) ──────────
+    async sendMagicLink(email) {
+      return request(
+        "POST",
+        "/v1/tester/magic-link",
+        { email },
+        1,
+        "community"
+      );
+    },
+    async linkReporterToken(reporterTokenHash, jwt) {
+      return request(
+        "POST",
+        "/v1/tester/link-reporter",
+        { reporter_token_hash: reporterTokenHash },
+        1,
+        "community",
+        { Authorization: `Bearer ${jwt}` }
+      );
+    },
+    async getCrossAppReports(jwt, opts) {
+      const qs = new URLSearchParams();
+      if (opts?.limit) qs.set("limit", String(opts.limit));
+      if (opts?.offset) qs.set("offset", String(opts.offset));
+      const suffix = qs.size ? `?${qs.toString()}` : "";
+      return request(
+        "GET",
+        `/v1/tester/cross-app-reports${suffix}`,
+        void 0,
+        1,
+        "community",
+        { Authorization: `Bearer ${jwt}` }
+      );
+    },
+    async getMyReputation(jwt) {
+      return request(
+        "GET",
+        "/v1/tester/reputation",
+        void 0,
+        1,
+        "community",
+        { Authorization: `Bearer ${jwt}` }
+      );
+    },
+    async getPublicLeaderboard(limit = 20) {
+      return request(
+        "GET",
+        `/v1/public/tester-leaderboard?limit=${limit}`,
+        void 0,
+        1,
+        "reporter-poll"
+      );
+    },
+    async getTesterStatus(jwt) {
+      return request(
+        "GET",
+        "/v1/me/tester-status",
+        void 0,
+        1,
+        "community",
+        { Authorization: `Bearer ${jwt}` }
+      );
     }
   };
 }