@mushi-mushi/core 1.13.0 → 1.15.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. */
@@ -215,7 +237,7 @@ interface MushiBannerConfig {
     label?: string | false;
     /** Override the call-to-action text in the banner. Defaults to '🐛 Report a bug'. */
     bugCta?: string;
-    /** Show a "✨ Request a feature" button alongside the bug button. Defaults to true. */
+    /** Show a "Request a feature" button alongside the bug button. Defaults to true. */
     featureCta?: boolean;
     /** Override the feature-request button label. */
     featureCtaLabel?: string;
@@ -1299,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
@@ -1374,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;
@@ -1389,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;
 
 /**
@@ -1675,6 +1761,13 @@ interface LoggerOptions {
     level?: LogLevel;
     meta?: Record<string, unknown>;
     format?: LogFormat;
+    /**
+     * Where to write log output.
+     * - `'stdout'` (default): normal servers, browsers.
+     * - `'stderr'`: use for stdio MCP servers where stdout is the JSON-RPC
+     *   protocol pipe; any non-JSON-RPC bytes there corrupt the connection.
+     */
+    destination?: 'stdout' | 'stderr';
 }
 interface Logger {
     debug(msg: string, meta?: Record<string, unknown>): void;
@@ -1709,4 +1802,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 MushiCustomCategory, 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. */
@@ -215,7 +237,7 @@ interface MushiBannerConfig {
     label?: string | false;
     /** Override the call-to-action text in the banner. Defaults to '🐛 Report a bug'. */
     bugCta?: string;
-    /** Show a "✨ Request a feature" button alongside the bug button. Defaults to true. */
+    /** Show a "Request a feature" button alongside the bug button. Defaults to true. */
     featureCta?: boolean;
     /** Override the feature-request button label. */
     featureCtaLabel?: string;
@@ -1299,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
@@ -1374,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;
@@ -1389,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;
 
 /**
@@ -1675,6 +1761,13 @@ interface LoggerOptions {
     level?: LogLevel;
     meta?: Record<string, unknown>;
     format?: LogFormat;
+    /**
+     * Where to write log output.
+     * - `'stdout'` (default): normal servers, browsers.
+     * - `'stderr'`: use for stdio MCP servers where stdout is the JSON-RPC
+     *   protocol pipe; any non-JSON-RPC bytes there corrupt the connection.
+     */
+    destination?: 'stdout' | 'stderr';
 }
 interface Logger {
     debug(msg: string, meta?: Record<string, unknown>): void;
@@ -1709,4 +1802,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 MushiCustomCategory, 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}` }
+      );
     }
   };
 }
@@ -513,20 +577,27 @@ function formatPretty(entry) {
 function formatJson(entry) {
   return JSON.stringify(entry);
 }
-function emit(level, formatted) {
-  switch (level) {
-    case "error":
-    case "fatal":
+function makeEmitter(destination) {
+  if (destination === "stderr") {
+    return (level, formatted) => {
       console.error(formatted);
-      break;
-    case "warn":
-      console.warn(formatted);
-      break;
-    default:
-      console.log(formatted);
+    };
   }
+  return (level, formatted) => {
+    switch (level) {
+      case "error":
+      case "fatal":
+        console.error(formatted);
+        break;
+      case "warn":
+        console.warn(formatted);
+        break;
+      default:
+        console.log(formatted);
+    }
+  };
 }
-function buildLogger(scope, minLevel, baseMeta, formatter) {
+function buildLogger(scope, minLevel, baseMeta, formatter, emit) {
   let currentLevel = minLevel;
   function log(level, msg, meta) {
     if (LEVEL_VALUE[level] < LEVEL_VALUE[currentLevel]) return;
@@ -551,7 +622,8 @@ function buildLogger(scope, minLevel, baseMeta, formatter) {
         `${scope}:${childScope}`,
         currentLevel,
         { ...baseMeta, ...childMeta },
-        formatter
+        formatter,
+        emit
       );
     },
     setLevel(level) {
@@ -564,11 +636,13 @@ function createLogger(options) {
     scope,
     level = "info",
     meta = {},
-    format = "auto"
+    format = "auto",
+    destination = "stdout"
   } = options;
   const resolvedFormat = format === "auto" ? detectFormat() : format;
   const formatter = resolvedFormat === "json" ? formatJson : formatPretty;
-  return buildLogger(scope, level, meta, formatter);
+  const emit = makeEmitter(destination);
+  return buildLogger(scope, level, meta, formatter, emit);
 }
 var noopLogger = {
   debug: () => {