@bbearai/core 0.7.0 → 0.7.1

package/dist/index.d.mts

@@ -301,8 +301,13 @@ interface MonitoringEvent {
     /** Sentry breadcrumbs — populated by @bbearai/sentry adapter */
     sentryBreadcrumbs?: unknown[];
 }
-/** Widget color scheme: 'dark' (default), 'light', or 'auto' (follows system preference). */
+/** Widget color scheme: 'dark', 'light', or 'auto' (follows system preference, default). */
 type WidgetColorScheme = 'dark' | 'light' | 'auto';
+/** Server-side widget configuration set by the project admin in the dashboard. */
+interface WidgetConfig {
+    /** Admin-forced color scheme. When set, overrides the developer's config and user's OS preference. */
+    colorScheme?: WidgetColorScheme;
+}
 interface BugBearTheme {
     /** Primary brand color */
     primaryColor?: string;
@@ -312,7 +317,7 @@ interface BugBearTheme {
     textColor?: string;
     /** Border radius */
     borderRadius?: number;
-    /** Color scheme for the widget. Defaults to 'dark'. */
+    /** Color scheme for the widget. Defaults to 'auto' (follows OS preference). */
     colorScheme?: WidgetColorScheme;
 }
 type TestTemplate = 'steps' | 'checklist' | 'rubric' | 'freeform';
@@ -1284,18 +1289,28 @@ declare class BugBearClient {
      * This is a master switch that admins can toggle in the dashboard
      */
     isQAEnabled(): Promise<boolean>;
+    /**
+     * Fetch server-side widget config set by the project admin.
+     * Returns settings like color scheme override. Returns empty config on error.
+     */
+    getWidgetConfig(): Promise<WidgetConfig>;
+    /**
+     * Check if feedback mode is enabled for this project.
+     * This is a master switch that admins can toggle in the dashboard.
+     */
+    isFeedbackEnabled(): Promise<boolean>;
     /**
      * Check if the widget should be visible.
      * Behavior depends on the configured mode:
      * - 'qa': QA enabled AND user is a registered tester
-     * - 'feedback': Any authenticated user
-     * - 'auto': Either QA tester OR authenticated non-tester
+     * - 'feedback': Feedback enabled AND user is authenticated
+     * - 'auto': QA tester (if QA enabled) OR authenticated user (if feedback enabled)
      */
     shouldShowWidget(): Promise<boolean>;
     /**
      * Resolve the effective widget mode for the current user.
      * - 'qa' or 'feedback' config → returned as-is
-     * - 'auto' → checks if user is a QA tester (role='tester') → 'qa', otherwise 'feedback'
+     * - 'auto' → QA tester with QA enabled → 'qa', feedback enabled → 'feedback', else 'qa'
      */
     getEffectiveMode(): Promise<'qa' | 'feedback'>;
     /**
@@ -1543,4 +1558,4 @@ declare function captureError(error: Error, errorInfo?: {
     componentStack?: string;
 };
 
-export { type AddFindingOptions, type AppContext, BUG_CATEGORIES, BugBearClient, type BugBearConfig, type BugBearMode, type BugBearReport, type BugBearTheme, type BugCategory, type ChecklistItem, type ChecklistResult, type ConsoleLogEntry, type CoverageGap, type CoverageMatrixCell, type CoverageMatrixRow, DedupWindow, type DeployChecklist, type DeviceInfo, type EndSessionOptions, type EnhancedBugContext, ErrorMonitor, type FindingSeverity, type FindingType, type HostUserInfo, type IssueCategory, type IssueCounts, LocalStorageAdapter, type MessageSenderType, type MonitorDeps, type MonitoringConfig, type MonitoringEvent, type NetworkRequest, OfflineQueue, type OfflineQueueConfig, type PriorityFactors, type ProjectRole, type QAFinding, type QAHealthMetrics, type QAHealthScore, type QASession, type QASessionStatus, type QATrack, type QueueItem, type QueueItemType, RNApiFailureHandler, RNCrashHandler, RNRageClickHandler, RageClickDetector, type RageClickEvent, type RegressionEvent, type ReportSource, type ReportStatus, type ReportType, type RoutePriority, type RouteTestStats, type RubricMode, type RubricResult, type Severity, type SkipReason, type StartSessionOptions, type StorageAdapter, type SubmitFeedbackOptions, type TestAssignment, type TestFeedback, type TestGroup, type TestResult, type TestStep, type TestTemplate, type TesterInfo, type TesterIssue, type TesterMessage, type TesterProfileUpdate, type TesterThread, type ThreadPriority, type ThreadType, WebApiFailureHandler, WebCrashHandler, WebRageClickHandler, type WidgetColorScheme, captureError, contextCapture, createBugBear, generateFingerprint, isBugCategory, isNetworkError, scrubUrl };
+export { type AddFindingOptions, type AppContext, BUG_CATEGORIES, BugBearClient, type BugBearConfig, type BugBearMode, type BugBearReport, type BugBearTheme, type BugCategory, type ChecklistItem, type ChecklistResult, type ConsoleLogEntry, type CoverageGap, type CoverageMatrixCell, type CoverageMatrixRow, DedupWindow, type DeployChecklist, type DeviceInfo, type EndSessionOptions, type EnhancedBugContext, ErrorMonitor, type FindingSeverity, type FindingType, type HostUserInfo, type IssueCategory, type IssueCounts, LocalStorageAdapter, type MessageSenderType, type MonitorDeps, type MonitoringConfig, type MonitoringEvent, type NetworkRequest, OfflineQueue, type OfflineQueueConfig, type PriorityFactors, type ProjectRole, type QAFinding, type QAHealthMetrics, type QAHealthScore, type QASession, type QASessionStatus, type QATrack, type QueueItem, type QueueItemType, RNApiFailureHandler, RNCrashHandler, RNRageClickHandler, RageClickDetector, type RageClickEvent, type RegressionEvent, type ReportSource, type ReportStatus, type ReportType, type RoutePriority, type RouteTestStats, type RubricMode, type RubricResult, type Severity, type SkipReason, type StartSessionOptions, type StorageAdapter, type SubmitFeedbackOptions, type TestAssignment, type TestFeedback, type TestGroup, type TestResult, type TestStep, type TestTemplate, type TesterInfo, type TesterIssue, type TesterMessage, type TesterProfileUpdate, type TesterThread, type ThreadPriority, type ThreadType, WebApiFailureHandler, WebCrashHandler, WebRageClickHandler, type WidgetColorScheme, type WidgetConfig, captureError, contextCapture, createBugBear, generateFingerprint, isBugCategory, isNetworkError, scrubUrl };

package/dist/index.d.ts

@@ -301,8 +301,13 @@ interface MonitoringEvent {
     /** Sentry breadcrumbs — populated by @bbearai/sentry adapter */
     sentryBreadcrumbs?: unknown[];
 }
-/** Widget color scheme: 'dark' (default), 'light', or 'auto' (follows system preference). */
+/** Widget color scheme: 'dark', 'light', or 'auto' (follows system preference, default). */
 type WidgetColorScheme = 'dark' | 'light' | 'auto';
+/** Server-side widget configuration set by the project admin in the dashboard. */
+interface WidgetConfig {
+    /** Admin-forced color scheme. When set, overrides the developer's config and user's OS preference. */
+    colorScheme?: WidgetColorScheme;
+}
 interface BugBearTheme {
     /** Primary brand color */
     primaryColor?: string;
@@ -312,7 +317,7 @@ interface BugBearTheme {
     textColor?: string;
     /** Border radius */
     borderRadius?: number;
-    /** Color scheme for the widget. Defaults to 'dark'. */
+    /** Color scheme for the widget. Defaults to 'auto' (follows OS preference). */
     colorScheme?: WidgetColorScheme;
 }
 type TestTemplate = 'steps' | 'checklist' | 'rubric' | 'freeform';
@@ -1284,18 +1289,28 @@ declare class BugBearClient {
      * This is a master switch that admins can toggle in the dashboard
      */
     isQAEnabled(): Promise<boolean>;
+    /**
+     * Fetch server-side widget config set by the project admin.
+     * Returns settings like color scheme override. Returns empty config on error.
+     */
+    getWidgetConfig(): Promise<WidgetConfig>;
+    /**
+     * Check if feedback mode is enabled for this project.
+     * This is a master switch that admins can toggle in the dashboard.
+     */
+    isFeedbackEnabled(): Promise<boolean>;
     /**
      * Check if the widget should be visible.
      * Behavior depends on the configured mode:
      * - 'qa': QA enabled AND user is a registered tester
-     * - 'feedback': Any authenticated user
-     * - 'auto': Either QA tester OR authenticated non-tester
+     * - 'feedback': Feedback enabled AND user is authenticated
+     * - 'auto': QA tester (if QA enabled) OR authenticated user (if feedback enabled)
      */
     shouldShowWidget(): Promise<boolean>;
     /**
      * Resolve the effective widget mode for the current user.
      * - 'qa' or 'feedback' config → returned as-is
-     * - 'auto' → checks if user is a QA tester (role='tester') → 'qa', otherwise 'feedback'
+     * - 'auto' → QA tester with QA enabled → 'qa', feedback enabled → 'feedback', else 'qa'
      */
     getEffectiveMode(): Promise<'qa' | 'feedback'>;
     /**
@@ -1543,4 +1558,4 @@ declare function captureError(error: Error, errorInfo?: {
     componentStack?: string;
 };
 
-export { type AddFindingOptions, type AppContext, BUG_CATEGORIES, BugBearClient, type BugBearConfig, type BugBearMode, type BugBearReport, type BugBearTheme, type BugCategory, type ChecklistItem, type ChecklistResult, type ConsoleLogEntry, type CoverageGap, type CoverageMatrixCell, type CoverageMatrixRow, DedupWindow, type DeployChecklist, type DeviceInfo, type EndSessionOptions, type EnhancedBugContext, ErrorMonitor, type FindingSeverity, type FindingType, type HostUserInfo, type IssueCategory, type IssueCounts, LocalStorageAdapter, type MessageSenderType, type MonitorDeps, type MonitoringConfig, type MonitoringEvent, type NetworkRequest, OfflineQueue, type OfflineQueueConfig, type PriorityFactors, type ProjectRole, type QAFinding, type QAHealthMetrics, type QAHealthScore, type QASession, type QASessionStatus, type QATrack, type QueueItem, type QueueItemType, RNApiFailureHandler, RNCrashHandler, RNRageClickHandler, RageClickDetector, type RageClickEvent, type RegressionEvent, type ReportSource, type ReportStatus, type ReportType, type RoutePriority, type RouteTestStats, type RubricMode, type RubricResult, type Severity, type SkipReason, type StartSessionOptions, type StorageAdapter, type SubmitFeedbackOptions, type TestAssignment, type TestFeedback, type TestGroup, type TestResult, type TestStep, type TestTemplate, type TesterInfo, type TesterIssue, type TesterMessage, type TesterProfileUpdate, type TesterThread, type ThreadPriority, type ThreadType, WebApiFailureHandler, WebCrashHandler, WebRageClickHandler, type WidgetColorScheme, captureError, contextCapture, createBugBear, generateFingerprint, isBugCategory, isNetworkError, scrubUrl };
+export { type AddFindingOptions, type AppContext, BUG_CATEGORIES, BugBearClient, type BugBearConfig, type BugBearMode, type BugBearReport, type BugBearTheme, type BugCategory, type ChecklistItem, type ChecklistResult, type ConsoleLogEntry, type CoverageGap, type CoverageMatrixCell, type CoverageMatrixRow, DedupWindow, type DeployChecklist, type DeviceInfo, type EndSessionOptions, type EnhancedBugContext, ErrorMonitor, type FindingSeverity, type FindingType, type HostUserInfo, type IssueCategory, type IssueCounts, LocalStorageAdapter, type MessageSenderType, type MonitorDeps, type MonitoringConfig, type MonitoringEvent, type NetworkRequest, OfflineQueue, type OfflineQueueConfig, type PriorityFactors, type ProjectRole, type QAFinding, type QAHealthMetrics, type QAHealthScore, type QASession, type QASessionStatus, type QATrack, type QueueItem, type QueueItemType, RNApiFailureHandler, RNCrashHandler, RNRageClickHandler, RageClickDetector, type RageClickEvent, type RegressionEvent, type ReportSource, type ReportStatus, type ReportType, type RoutePriority, type RouteTestStats, type RubricMode, type RubricResult, type Severity, type SkipReason, type StartSessionOptions, type StorageAdapter, type SubmitFeedbackOptions, type TestAssignment, type TestFeedback, type TestGroup, type TestResult, type TestStep, type TestTemplate, type TesterInfo, type TesterIssue, type TesterMessage, type TesterProfileUpdate, type TesterThread, type ThreadPriority, type ThreadType, WebApiFailureHandler, WebCrashHandler, WebRageClickHandler, type WidgetColorScheme, type WidgetConfig, captureError, contextCapture, createBugBear, generateFingerprint, isBugCategory, isNetworkError, scrubUrl };

package/dist/index.js

@@ -2102,12 +2102,56 @@ var BugBearClient = class {
       return true;
     }
   }
+  /**
+   * Fetch server-side widget config set by the project admin.
+   * Returns settings like color scheme override. Returns empty config on error.
+   */
+  async getWidgetConfig() {
+    try {
+      await this.ensureReady();
+      const { data, error } = await this.supabase.rpc("get_widget_config", {
+        p_project_id: this.config.projectId
+      });
+      if (error) {
+        console.warn("BugBear: Could not fetch widget config", error.message || error.code || "Unknown error");
+        return {};
+      }
+      return data ?? {};
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error fetching widget config";
+      console.error("BugBear: Error fetching widget config", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), { projectId: this.config.projectId });
+      return {};
+    }
+  }
+  /**
+   * Check if feedback mode is enabled for this project.
+   * This is a master switch that admins can toggle in the dashboard.
+   */
+  async isFeedbackEnabled() {
+    try {
+      await this.ensureReady();
+      const { data, error } = await this.supabase.rpc("check_feedback_enabled", {
+        p_project_id: this.config.projectId
+      });
+      if (error) {
+        console.warn("BugBear: Could not check feedback status", error.message || error.code || "Unknown error");
+        return false;
+      }
+      return data ?? false;
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error checking feedback status";
+      console.error("BugBear: Error checking feedback status", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), { projectId: this.config.projectId });
+      return false;
+    }
+  }
   /**
    * Check if the widget should be visible.
    * Behavior depends on the configured mode:
    * - 'qa': QA enabled AND user is a registered tester
-   * - 'feedback': Any authenticated user
-   * - 'auto': Either QA tester OR authenticated non-tester
+   * - 'feedback': Feedback enabled AND user is authenticated
+   * - 'auto': QA tester (if QA enabled) OR authenticated user (if feedback enabled)
    */
   async shouldShowWidget() {
     const mode = this.config.mode || "qa";
@@ -2119,33 +2163,39 @@ var BugBearClient = class {
       return qaEnabled2 && tester;
     }
     if (mode === "feedback") {
-      const userInfo2 = await this.getCurrentUserInfo();
-      return userInfo2 !== null;
+      const [feedbackEnabled2, userInfo2] = await Promise.all([
+        this.isFeedbackEnabled(),
+        this.getCurrentUserInfo()
+      ]);
+      return feedbackEnabled2 && userInfo2 !== null;
     }
-    const [qaEnabled, testerInfo, userInfo] = await Promise.all([
+    const [qaEnabled, feedbackEnabled, testerInfo, userInfo] = await Promise.all([
       this.isQAEnabled(),
+      this.isFeedbackEnabled(),
       this.getTesterInfo(),
       this.getCurrentUserInfo()
     ]);
     if (qaEnabled && testerInfo && testerInfo.role !== "feedback") return true;
-    if (userInfo) return true;
+    if (feedbackEnabled && userInfo) return true;
     return false;
   }
   /**
    * Resolve the effective widget mode for the current user.
    * - 'qa' or 'feedback' config → returned as-is
-   * - 'auto' → checks if user is a QA tester (role='tester') → 'qa', otherwise 'feedback'
+   * - 'auto' → QA tester with QA enabled → 'qa', feedback enabled → 'feedback', else 'qa'
    */
   async getEffectiveMode() {
     const mode = this.config.mode || "qa";
     if (mode === "qa") return "qa";
     if (mode === "feedback") return "feedback";
-    const [qaEnabled, testerInfo] = await Promise.all([
+    const [qaEnabled, feedbackEnabled, testerInfo] = await Promise.all([
       this.isQAEnabled(),
+      this.isFeedbackEnabled(),
       this.getTesterInfo()
     ]);
     if (qaEnabled && testerInfo && testerInfo.role !== "feedback") return "qa";
-    return "feedback";
+    if (feedbackEnabled) return "feedback";
+    return "qa";
   }
   /**
    * Auto-provision a feedback user record in the testers table.

package/dist/index.mjs

@@ -2057,12 +2057,56 @@ var BugBearClient = class {
       return true;
     }
   }
+  /**
+   * Fetch server-side widget config set by the project admin.
+   * Returns settings like color scheme override. Returns empty config on error.
+   */
+  async getWidgetConfig() {
+    try {
+      await this.ensureReady();
+      const { data, error } = await this.supabase.rpc("get_widget_config", {
+        p_project_id: this.config.projectId
+      });
+      if (error) {
+        console.warn("BugBear: Could not fetch widget config", error.message || error.code || "Unknown error");
+        return {};
+      }
+      return data ?? {};
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error fetching widget config";
+      console.error("BugBear: Error fetching widget config", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), { projectId: this.config.projectId });
+      return {};
+    }
+  }
+  /**
+   * Check if feedback mode is enabled for this project.
+   * This is a master switch that admins can toggle in the dashboard.
+   */
+  async isFeedbackEnabled() {
+    try {
+      await this.ensureReady();
+      const { data, error } = await this.supabase.rpc("check_feedback_enabled", {
+        p_project_id: this.config.projectId
+      });
+      if (error) {
+        console.warn("BugBear: Could not check feedback status", error.message || error.code || "Unknown error");
+        return false;
+      }
+      return data ?? false;
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error checking feedback status";
+      console.error("BugBear: Error checking feedback status", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), { projectId: this.config.projectId });
+      return false;
+    }
+  }
   /**
    * Check if the widget should be visible.
    * Behavior depends on the configured mode:
    * - 'qa': QA enabled AND user is a registered tester
-   * - 'feedback': Any authenticated user
-   * - 'auto': Either QA tester OR authenticated non-tester
+   * - 'feedback': Feedback enabled AND user is authenticated
+   * - 'auto': QA tester (if QA enabled) OR authenticated user (if feedback enabled)
    */
   async shouldShowWidget() {
     const mode = this.config.mode || "qa";
@@ -2074,33 +2118,39 @@ var BugBearClient = class {
       return qaEnabled2 && tester;
     }
     if (mode === "feedback") {
-      const userInfo2 = await this.getCurrentUserInfo();
-      return userInfo2 !== null;
+      const [feedbackEnabled2, userInfo2] = await Promise.all([
+        this.isFeedbackEnabled(),
+        this.getCurrentUserInfo()
+      ]);
+      return feedbackEnabled2 && userInfo2 !== null;
     }
-    const [qaEnabled, testerInfo, userInfo] = await Promise.all([
+    const [qaEnabled, feedbackEnabled, testerInfo, userInfo] = await Promise.all([
       this.isQAEnabled(),
+      this.isFeedbackEnabled(),
       this.getTesterInfo(),
       this.getCurrentUserInfo()
     ]);
     if (qaEnabled && testerInfo && testerInfo.role !== "feedback") return true;
-    if (userInfo) return true;
+    if (feedbackEnabled && userInfo) return true;
     return false;
   }
   /**
    * Resolve the effective widget mode for the current user.
    * - 'qa' or 'feedback' config → returned as-is
-   * - 'auto' → checks if user is a QA tester (role='tester') → 'qa', otherwise 'feedback'
+   * - 'auto' → QA tester with QA enabled → 'qa', feedback enabled → 'feedback', else 'qa'
    */
   async getEffectiveMode() {
     const mode = this.config.mode || "qa";
     if (mode === "qa") return "qa";
     if (mode === "feedback") return "feedback";
-    const [qaEnabled, testerInfo] = await Promise.all([
+    const [qaEnabled, feedbackEnabled, testerInfo] = await Promise.all([
       this.isQAEnabled(),
+      this.isFeedbackEnabled(),
       this.getTesterInfo()
     ]);
     if (qaEnabled && testerInfo && testerInfo.role !== "feedback") return "qa";
-    return "feedback";
+    if (feedbackEnabled) return "feedback";
+    return "qa";
   }
   /**
    * Auto-provision a feedback user record in the testers table.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bbearai/core",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Core utilities and types for BugBear QA platform",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",