@mushi-mushi/core 1.0.0 → 1.2.0

package/dist/index.d.cts

@@ -66,6 +66,38 @@ interface MushiWidgetConfig {
     brandFooter?: boolean;
     /** How the widget should surface SDK freshness warnings. Defaults to auto. */
     outdatedBanner?: 'auto' | 'banner' | 'console-only' | 'off';
+    /**
+     * Beta mode: injects discreet "early access" messaging into the widget panel.
+     * Shows a beta strip on the category step and a contact footer on the success
+     * step. Designed to reduce user frustration with in-progress apps while
+     * actively inviting feedback.
+     */
+    betaMode?: MushiBetaModeConfig;
+}
+interface MushiBetaModeConfig {
+    enabled?: boolean;
+    /** Display name of the app shown in the beta strip. Defaults to 'This app'. */
+    appName?: string;
+    /** Contact email shown on success step for direct founder/dev reach. */
+    contactEmail?: string;
+    /** Override the default beta strip message. */
+    message?: string;
+    /**
+     * Optional perks shown to the user for opting in as a beta tester.
+     * e.g. ['Early access to new lessons', 'Priority bug fix queue'].
+     */
+    perks?: string[];
+    /**
+     * Version-tied release notes rendered as a collapsible "What's new in this build"
+     * row in the widget. Closes the feedback loop — "did you fix what I reported?"
+     * Only the first entry (latest) is shown by default.
+     */
+    changelogItems?: MushiBetaChangelogEntry[];
+}
+interface MushiBetaChangelogEntry {
+    version: string;
+    date?: string;
+    items: string[];
 }
 interface MushiWidgetInset {
     top?: number | 'auto';
@@ -256,10 +288,62 @@ interface MushiOfflineConfig {
 }
 interface MushiRewardsConfig {
     enabled?: boolean;
-    requireAuth?: boolean;
+    /**
+     * P1: when true the SDK auto-tracks route navigations, [data-testid] clicks,
+     * and session dwell time and flushes them to POST /v1/sdk/activity.
+     * Default false. Requires opted_in_to_rewards = true from the end user.
+     */
+    trackActivity?: boolean;
+    /**
+     * Activity batch flush interval in ms. Default 300_000 (5 min).
+     * Minimum 30_000 (30s) — smaller values are clamped.
+     */
+    flushIntervalMs?: number;
+    /**
+     * Show a tier + points footer in the SDK widget.
+     * Default false.
+     */
+    showInWidget?: boolean;
+    /**
+     * Whether to show a "+X pts" toast notification on each award.
+     * Default true when enabled.
+     */
     showNotifications?: boolean;
+    /**
+     * 'auto'     — immediately opt the user in when identify() is called.
+     * 'explicit' — SDK surfaces a one-time consent prompt. Default 'explicit'.
+     */
+    consentMode?: 'auto' | 'explicit';
+    /**
+     * P2: callback that returns a host-app JWT for server-side identity
+     * verification before monetary rewards are issued. Return null to skip
+     * verification for non-monetary actions.
+     */
+    verifyUserToken?: () => Promise<string | null>;
+    /**
+     * @deprecated Superseded by server-side reward_webhooks table.
+     * Kept for backwards compatibility; has no effect from v0.10.0.
+     */
     webhookOnReward?: string;
 }
+interface MushiReputationResult {
+    totalPoints: number;
+    points30d: number;
+    reputation: number;
+    confirmedBugs: number;
+    totalReports: number;
+}
+interface MushiTierResult {
+    id: string;
+    slug: string;
+    displayName: string;
+    pointsThreshold: number;
+    perks: Record<string, unknown>;
+}
+interface MushiActivityEvent {
+    action: string;
+    metadata?: Record<string, unknown>;
+}
 type MushiReportCategory = 'bug' | 'slow' | 'visual' | 'confusing' | 'other';
 type MushiReportStatus = 'pending' | 'submitted' | 'classified' | 'grouped' | 'fixing' | 'fixed' | 'dismissed';
 interface MushiReport {
@@ -336,13 +420,21 @@ interface MushiBreadcrumb {
     /**
      * Coarse bucket for filtering / coloring in the report drawer.
      * - `navigation` — route or url change
-     * - `ui.click` — user clicked a `[data-testid]` element
+     * - `ui.click` — user clicked a `[data-testid]` element (web SDK)
+     * - `ui.tap` — user tapped a `UIView` / Android `View` (native SDKs)
      * - `console` — `console.error` / `console.warn` callsite
-     * - `xhr` / `fetch` — network request that errored or 4xx/5xx
+     * - `xhr` / `fetch` — network request that errored or 4xx/5xx (web SDK)
+     * - `network` — network failure on iOS / Android (native SDKs)
      * - `lifecycle` — Mushi SDK init / open / submit / queue
      * - `custom` — host called `Mushi.addBreadcrumb()`
+     *
+     * Admin tooling that filters by interaction should treat
+     * `ui.click` ∪ `ui.tap` as one bucket and `xhr` ∪ `fetch` ∪ `network`
+     * as one bucket. Native enums are platform-idiomatic (`tap` on touch
+     * devices, `network` because iOS/Android don't expose `XHR` / `fetch`
+     * separately) — every wire string is documented in the native READMEs.
      */
-    category: 'navigation' | 'ui.click' | 'console' | 'xhr' | 'fetch' | 'lifecycle' | 'custom';
+    category: 'navigation' | 'ui.click' | 'ui.tap' | 'console' | 'xhr' | 'fetch' | 'network' | 'lifecycle' | 'custom';
     /**
      * Severity — `info` is the default. `warning` / `error` map to a
      * coloured pill in the drawer; the Triage LLM uses these to decide
@@ -706,6 +798,24 @@ interface MushiSDKInstance {
     setTags(tags: Record<string, string | number | boolean>): void;
     /** Remove a single tag, or all tags when called with no argument. */
     clearTag(key?: string): void;
+    /**
+     * Returns the current user's reputation + legacy point totals from the
+     * reporter_reputation table. Available even when the rewards program is
+     * disabled (legacy surface).
+     */
+    getReputation(): Promise<MushiReputationResult | null>;
+    /**
+     * Returns the current user's tier from the rewards program.
+     * Returns null when the user has not yet been identified or the project
+     * has rewards_enabled = false.
+     */
+    getTier(): Promise<MushiTierResult | null>;
+    /**
+     * Manually record a host-defined activity event (e.g. 'lesson_completed').
+     * The SDK batches these and flushes to POST /v1/sdk/activity.
+     * No-op when rewards are disabled or the user has not opted in.
+     */
+    recordActivity(action: string, metadata?: Record<string, unknown>): void;
 }
 interface MushiCaptureExceptionOptions {
     /** Override the default `'bug'` category (e.g. `'slow'` for timeouts). */
@@ -769,6 +879,42 @@ interface MushiApiClient {
     replyToReporterReport(reportId: string, reporterToken: string, body: string): Promise<MushiApiResponse<{
         comment: MushiReporterComment;
     }>>;
+    /**
+     * Submit a batch of activity events for the current user.
+     * Requires rewards to be enabled on the project.
+     */
+    submitActivity(userId: string, events: MushiActivityEvent[], opts?: {
+        userTraits?: {
+            email?: string;
+            name?: string;
+            provider?: string;
+        };
+        reporterTokenHash?: string;
+        optedIn?: boolean;
+        /** P2: host-app JWT; when present the server attempts verifyHostJwt
+         *  and updates end_users.jwt_verified_at if valid. Required for
+         *  monetary payout eligibility. */
+        hostJwt?: string;
+    }): Promise<MushiApiResponse<{
+        accepted: number;
+        total: number;
+    }>>;
+    /** Fetch the current user's point totals (requires userId). */
+    getMyPoints(userId: string): Promise<MushiApiResponse<{
+        total_points: number;
+        points_30d: number;
+        points_lifetime: number;
+        tier: MushiTierResult | null;
+    }>>;
+    /** Fetch the current user's tier (requires userId). */
+    getMyTier(userId: string): Promise<MushiApiResponse<MushiTierResult | null>>;
+    /** Fetch the current user's activity history (requires userId). */
+    getMyHistory(userId: string, opts?: {
+        limit?: number;
+    }): Promise<MushiApiResponse<{
+        items: unknown[];
+        total: number;
+    }>>;
 }
 /**
  * Wire shape of a single discovery event sent by the SDK to
@@ -1121,4 +1267,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, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, 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 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 MushiRewardsConfig, type MushiRuntimeSdkConfig, type MushiSDKInstance, type MushiSdkVersionInfo, type MushiSelectedElement, type MushiSentryConfig, type MushiSentryContext, type MushiTimelineEntry, type MushiTimelineKind, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PiiScrubberConfig, type PreFilterResult, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, captureEnvironment, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, getDeviceFingerprintHash, getReporterToken, getSessionId, noopLogger, normaliseThrown, resolveRegionEndpoint, scrubPii };
+export { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, 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 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 MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PiiScrubberConfig, type PreFilterResult, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, captureEnvironment, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, getDeviceFingerprintHash, getReporterToken, getSessionId, noopLogger, normaliseThrown, resolveRegionEndpoint, scrubPii };

package/dist/index.d.ts

@@ -66,6 +66,38 @@ interface MushiWidgetConfig {
     brandFooter?: boolean;
     /** How the widget should surface SDK freshness warnings. Defaults to auto. */
     outdatedBanner?: 'auto' | 'banner' | 'console-only' | 'off';
+    /**
+     * Beta mode: injects discreet "early access" messaging into the widget panel.
+     * Shows a beta strip on the category step and a contact footer on the success
+     * step. Designed to reduce user frustration with in-progress apps while
+     * actively inviting feedback.
+     */
+    betaMode?: MushiBetaModeConfig;
+}
+interface MushiBetaModeConfig {
+    enabled?: boolean;
+    /** Display name of the app shown in the beta strip. Defaults to 'This app'. */
+    appName?: string;
+    /** Contact email shown on success step for direct founder/dev reach. */
+    contactEmail?: string;
+    /** Override the default beta strip message. */
+    message?: string;
+    /**
+     * Optional perks shown to the user for opting in as a beta tester.
+     * e.g. ['Early access to new lessons', 'Priority bug fix queue'].
+     */
+    perks?: string[];
+    /**
+     * Version-tied release notes rendered as a collapsible "What's new in this build"
+     * row in the widget. Closes the feedback loop — "did you fix what I reported?"
+     * Only the first entry (latest) is shown by default.
+     */
+    changelogItems?: MushiBetaChangelogEntry[];
+}
+interface MushiBetaChangelogEntry {
+    version: string;
+    date?: string;
+    items: string[];
 }
 interface MushiWidgetInset {
     top?: number | 'auto';
@@ -256,10 +288,62 @@ interface MushiOfflineConfig {
 }
 interface MushiRewardsConfig {
     enabled?: boolean;
-    requireAuth?: boolean;
+    /**
+     * P1: when true the SDK auto-tracks route navigations, [data-testid] clicks,
+     * and session dwell time and flushes them to POST /v1/sdk/activity.
+     * Default false. Requires opted_in_to_rewards = true from the end user.
+     */
+    trackActivity?: boolean;
+    /**
+     * Activity batch flush interval in ms. Default 300_000 (5 min).
+     * Minimum 30_000 (30s) — smaller values are clamped.
+     */
+    flushIntervalMs?: number;
+    /**
+     * Show a tier + points footer in the SDK widget.
+     * Default false.
+     */
+    showInWidget?: boolean;
+    /**
+     * Whether to show a "+X pts" toast notification on each award.
+     * Default true when enabled.
+     */
     showNotifications?: boolean;
+    /**
+     * 'auto'     — immediately opt the user in when identify() is called.
+     * 'explicit' — SDK surfaces a one-time consent prompt. Default 'explicit'.
+     */
+    consentMode?: 'auto' | 'explicit';
+    /**
+     * P2: callback that returns a host-app JWT for server-side identity
+     * verification before monetary rewards are issued. Return null to skip
+     * verification for non-monetary actions.
+     */
+    verifyUserToken?: () => Promise<string | null>;
+    /**
+     * @deprecated Superseded by server-side reward_webhooks table.
+     * Kept for backwards compatibility; has no effect from v0.10.0.
+     */
     webhookOnReward?: string;
 }
+interface MushiReputationResult {
+    totalPoints: number;
+    points30d: number;
+    reputation: number;
+    confirmedBugs: number;
+    totalReports: number;
+}
+interface MushiTierResult {
+    id: string;
+    slug: string;
+    displayName: string;
+    pointsThreshold: number;
+    perks: Record<string, unknown>;
+}
+interface MushiActivityEvent {
+    action: string;
+    metadata?: Record<string, unknown>;
+}
 type MushiReportCategory = 'bug' | 'slow' | 'visual' | 'confusing' | 'other';
 type MushiReportStatus = 'pending' | 'submitted' | 'classified' | 'grouped' | 'fixing' | 'fixed' | 'dismissed';
 interface MushiReport {
@@ -336,13 +420,21 @@ interface MushiBreadcrumb {
     /**
      * Coarse bucket for filtering / coloring in the report drawer.
      * - `navigation` — route or url change
-     * - `ui.click` — user clicked a `[data-testid]` element
+     * - `ui.click` — user clicked a `[data-testid]` element (web SDK)
+     * - `ui.tap` — user tapped a `UIView` / Android `View` (native SDKs)
      * - `console` — `console.error` / `console.warn` callsite
-     * - `xhr` / `fetch` — network request that errored or 4xx/5xx
+     * - `xhr` / `fetch` — network request that errored or 4xx/5xx (web SDK)
+     * - `network` — network failure on iOS / Android (native SDKs)
      * - `lifecycle` — Mushi SDK init / open / submit / queue
      * - `custom` — host called `Mushi.addBreadcrumb()`
+     *
+     * Admin tooling that filters by interaction should treat
+     * `ui.click` ∪ `ui.tap` as one bucket and `xhr` ∪ `fetch` ∪ `network`
+     * as one bucket. Native enums are platform-idiomatic (`tap` on touch
+     * devices, `network` because iOS/Android don't expose `XHR` / `fetch`
+     * separately) — every wire string is documented in the native READMEs.
      */
-    category: 'navigation' | 'ui.click' | 'console' | 'xhr' | 'fetch' | 'lifecycle' | 'custom';
+    category: 'navigation' | 'ui.click' | 'ui.tap' | 'console' | 'xhr' | 'fetch' | 'network' | 'lifecycle' | 'custom';
     /**
      * Severity — `info` is the default. `warning` / `error` map to a
      * coloured pill in the drawer; the Triage LLM uses these to decide
@@ -706,6 +798,24 @@ interface MushiSDKInstance {
     setTags(tags: Record<string, string | number | boolean>): void;
     /** Remove a single tag, or all tags when called with no argument. */
     clearTag(key?: string): void;
+    /**
+     * Returns the current user's reputation + legacy point totals from the
+     * reporter_reputation table. Available even when the rewards program is
+     * disabled (legacy surface).
+     */
+    getReputation(): Promise<MushiReputationResult | null>;
+    /**
+     * Returns the current user's tier from the rewards program.
+     * Returns null when the user has not yet been identified or the project
+     * has rewards_enabled = false.
+     */
+    getTier(): Promise<MushiTierResult | null>;
+    /**
+     * Manually record a host-defined activity event (e.g. 'lesson_completed').
+     * The SDK batches these and flushes to POST /v1/sdk/activity.
+     * No-op when rewards are disabled or the user has not opted in.
+     */
+    recordActivity(action: string, metadata?: Record<string, unknown>): void;
 }
 interface MushiCaptureExceptionOptions {
     /** Override the default `'bug'` category (e.g. `'slow'` for timeouts). */
@@ -769,6 +879,42 @@ interface MushiApiClient {
     replyToReporterReport(reportId: string, reporterToken: string, body: string): Promise<MushiApiResponse<{
         comment: MushiReporterComment;
     }>>;
+    /**
+     * Submit a batch of activity events for the current user.
+     * Requires rewards to be enabled on the project.
+     */
+    submitActivity(userId: string, events: MushiActivityEvent[], opts?: {
+        userTraits?: {
+            email?: string;
+            name?: string;
+            provider?: string;
+        };
+        reporterTokenHash?: string;
+        optedIn?: boolean;
+        /** P2: host-app JWT; when present the server attempts verifyHostJwt
+         *  and updates end_users.jwt_verified_at if valid. Required for
+         *  monetary payout eligibility. */
+        hostJwt?: string;
+    }): Promise<MushiApiResponse<{
+        accepted: number;
+        total: number;
+    }>>;
+    /** Fetch the current user's point totals (requires userId). */
+    getMyPoints(userId: string): Promise<MushiApiResponse<{
+        total_points: number;
+        points_30d: number;
+        points_lifetime: number;
+        tier: MushiTierResult | null;
+    }>>;
+    /** Fetch the current user's tier (requires userId). */
+    getMyTier(userId: string): Promise<MushiApiResponse<MushiTierResult | null>>;
+    /** Fetch the current user's activity history (requires userId). */
+    getMyHistory(userId: string, opts?: {
+        limit?: number;
+    }): Promise<MushiApiResponse<{
+        items: unknown[];
+        total: number;
+    }>>;
 }
 /**
  * Wire shape of a single discovery event sent by the SDK to
@@ -1121,4 +1267,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, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, 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 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 MushiRewardsConfig, type MushiRuntimeSdkConfig, type MushiSDKInstance, type MushiSdkVersionInfo, type MushiSelectedElement, type MushiSentryConfig, type MushiSentryContext, type MushiTimelineEntry, type MushiTimelineKind, type MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PiiScrubberConfig, type PreFilterResult, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, captureEnvironment, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, getDeviceFingerprintHash, getReporterToken, getSessionId, noopLogger, normaliseThrown, resolveRegionEndpoint, scrubPii };
+export { type ApiClientOptions, type BreadcrumbBuffer, type BreadcrumbBufferOptions, DEFAULT_API_ENDPOINT, type LogEntry, type LogFormat, type LogLevel, type Logger, type LoggerOptions, MUSHI_INTERNAL_HEADER, MUSHI_INTERNAL_INIT_MARKER, type MushiActivityEvent, type MushiApiCascadeConfig, type MushiApiClient, type MushiApiResponse, 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 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 MushiUrlMatcher, type MushiWidgetAnchor, type MushiWidgetConfig, type NormalisedException, type OfflineQueue, type PiiScrubberConfig, type PreFilterResult, REGION_ENDPOINTS, type RateLimiter, type RateLimiterConfig, captureEnvironment, createApiClient, createBreadcrumbBuffer, createLogger, createOfflineQueue, createPiiScrubber, createPreFilter, createRateLimiter, getDeviceFingerprintHash, getReporterToken, getSessionId, noopLogger, normaliseThrown, resolveRegionEndpoint, scrubPii };

package/dist/index.js

@@ -145,6 +145,53 @@ function createApiClient(options) {
         reporterToken,
         { body }
       );
+    },
+    // ─── Rewards program (P1) ──────────────────────────────────
+    async submitActivity(userId, events, opts) {
+      return request(
+        "POST",
+        "/v1/sdk/activity",
+        {
+          user_id: userId,
+          user_traits: opts?.userTraits,
+          opted_in: opts?.optedIn,
+          reporter_token_hash: opts?.reporterTokenHash,
+          // P2: JWT for monetary verification; omitted when null
+          ...opts?.hostJwt ? { host_jwt: opts.hostJwt } : {},
+          events
+        },
+        1,
+        // best-effort, 1 retry
+        "discovery"
+      );
+    },
+    async getMyPoints(userId) {
+      return request(
+        "GET",
+        `/v1/sdk/me/points?userId=${encodeURIComponent(userId)}`,
+        void 0,
+        1,
+        "reporter-poll"
+      );
+    },
+    async getMyTier(userId) {
+      return request(
+        "GET",
+        `/v1/sdk/me/tier?userId=${encodeURIComponent(userId)}`,
+        void 0,
+        1,
+        "reporter-poll"
+      );
+    },
+    async getMyHistory(userId, opts) {
+      const qs = new URLSearchParams({ userId, ...opts?.limit ? { limit: String(opts.limit) } : {} });
+      return request(
+        "GET",
+        `/v1/sdk/me/history?${qs}`,
+        void 0,
+        1,
+        "reporter-poll"
+      );
     }
   };
 }