@bbearai/core 0.4.4 → 0.4.6

package/dist/index.d.mts

@@ -3,7 +3,12 @@
  */
 type ReportType = 'bug' | 'feedback' | 'suggestion' | 'test_pass' | 'test_fail';
 type Severity = 'critical' | 'high' | 'medium' | 'low';
-type BugCategory = 'ui_ux' | 'functional' | 'crash' | 'security' | 'other';
+/** Valid bug categories - single source of truth */
+declare const BUG_CATEGORIES: readonly ["ui_ux", "functional", "crash", "security", "other"];
+/** Bug category type derived from BUG_CATEGORIES */
+type BugCategory = typeof BUG_CATEGORIES[number];
+/** Type guard to check if a string is a valid BugCategory */
+declare function isBugCategory(value: unknown): value is BugCategory;
 type ReportStatus = 'new' | 'triaging' | 'confirmed' | 'in_progress' | 'fixed' | 'ready_to_test' | 'verified' | 'resolved' | 'reviewed' | 'closed' | 'wont_fix' | 'duplicate';
 interface AppContext {
     /** Current route/screen path */
@@ -1068,4 +1073,4 @@ declare function captureError(error: Error, errorInfo?: {
     componentStack?: string;
 };
 
-export { type AddFindingOptions, type AppContext, BugBearClient, type BugBearConfig, type BugBearReport, type BugBearTheme, type BugCategory, type ChecklistItem, type ChecklistResult, type ConsoleLogEntry, type CoverageGap, type CoverageMatrixCell, type CoverageMatrixRow, type DeployChecklist, type DeviceInfo, type EndSessionOptions, type EnhancedBugContext, type FindingSeverity, type FindingType, type HostUserInfo, type IssueCategory, type IssueCounts, type MessageSenderType, type NetworkRequest, type PriorityFactors, type ProjectRole, type QAFinding, type QAHealthMetrics, type QAHealthScore, type QASession, type QASessionStatus, type QATrack, type RegressionEvent, type ReportStatus, type ReportType, type RoutePriority, type RouteTestStats, type RubricMode, type RubricResult, type Severity, type SkipReason, type StartSessionOptions, 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, captureError, contextCapture, createBugBear };
+export { type AddFindingOptions, type AppContext, BUG_CATEGORIES, BugBearClient, type BugBearConfig, type BugBearReport, type BugBearTheme, type BugCategory, type ChecklistItem, type ChecklistResult, type ConsoleLogEntry, type CoverageGap, type CoverageMatrixCell, type CoverageMatrixRow, type DeployChecklist, type DeviceInfo, type EndSessionOptions, type EnhancedBugContext, type FindingSeverity, type FindingType, type HostUserInfo, type IssueCategory, type IssueCounts, type MessageSenderType, type NetworkRequest, type PriorityFactors, type ProjectRole, type QAFinding, type QAHealthMetrics, type QAHealthScore, type QASession, type QASessionStatus, type QATrack, type RegressionEvent, type ReportStatus, type ReportType, type RoutePriority, type RouteTestStats, type RubricMode, type RubricResult, type Severity, type SkipReason, type StartSessionOptions, 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, captureError, contextCapture, createBugBear, isBugCategory };

package/dist/index.d.ts

@@ -3,7 +3,12 @@
  */
 type ReportType = 'bug' | 'feedback' | 'suggestion' | 'test_pass' | 'test_fail';
 type Severity = 'critical' | 'high' | 'medium' | 'low';
-type BugCategory = 'ui_ux' | 'functional' | 'crash' | 'security' | 'other';
+/** Valid bug categories - single source of truth */
+declare const BUG_CATEGORIES: readonly ["ui_ux", "functional", "crash", "security", "other"];
+/** Bug category type derived from BUG_CATEGORIES */
+type BugCategory = typeof BUG_CATEGORIES[number];
+/** Type guard to check if a string is a valid BugCategory */
+declare function isBugCategory(value: unknown): value is BugCategory;
 type ReportStatus = 'new' | 'triaging' | 'confirmed' | 'in_progress' | 'fixed' | 'ready_to_test' | 'verified' | 'resolved' | 'reviewed' | 'closed' | 'wont_fix' | 'duplicate';
 interface AppContext {
     /** Current route/screen path */
@@ -1068,4 +1073,4 @@ declare function captureError(error: Error, errorInfo?: {
     componentStack?: string;
 };
 
-export { type AddFindingOptions, type AppContext, BugBearClient, type BugBearConfig, type BugBearReport, type BugBearTheme, type BugCategory, type ChecklistItem, type ChecklistResult, type ConsoleLogEntry, type CoverageGap, type CoverageMatrixCell, type CoverageMatrixRow, type DeployChecklist, type DeviceInfo, type EndSessionOptions, type EnhancedBugContext, type FindingSeverity, type FindingType, type HostUserInfo, type IssueCategory, type IssueCounts, type MessageSenderType, type NetworkRequest, type PriorityFactors, type ProjectRole, type QAFinding, type QAHealthMetrics, type QAHealthScore, type QASession, type QASessionStatus, type QATrack, type RegressionEvent, type ReportStatus, type ReportType, type RoutePriority, type RouteTestStats, type RubricMode, type RubricResult, type Severity, type SkipReason, type StartSessionOptions, 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, captureError, contextCapture, createBugBear };
+export { type AddFindingOptions, type AppContext, BUG_CATEGORIES, BugBearClient, type BugBearConfig, type BugBearReport, type BugBearTheme, type BugCategory, type ChecklistItem, type ChecklistResult, type ConsoleLogEntry, type CoverageGap, type CoverageMatrixCell, type CoverageMatrixRow, type DeployChecklist, type DeviceInfo, type EndSessionOptions, type EnhancedBugContext, type FindingSeverity, type FindingType, type HostUserInfo, type IssueCategory, type IssueCounts, type MessageSenderType, type NetworkRequest, type PriorityFactors, type ProjectRole, type QAFinding, type QAHealthMetrics, type QAHealthScore, type QASession, type QASessionStatus, type QATrack, type RegressionEvent, type ReportStatus, type ReportType, type RoutePriority, type RouteTestStats, type RubricMode, type RubricResult, type Severity, type SkipReason, type StartSessionOptions, 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, captureError, contextCapture, createBugBear, isBugCategory };

package/dist/index.js

@@ -20,13 +20,21 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  BUG_CATEGORIES: () => BUG_CATEGORIES,
   BugBearClient: () => BugBearClient,
   captureError: () => captureError,
   contextCapture: () => contextCapture,
-  createBugBear: () => createBugBear
+  createBugBear: () => createBugBear,
+  isBugCategory: () => isBugCategory
 });
 module.exports = __toCommonJS(index_exports);
 
+// src/types.ts
+var BUG_CATEGORIES = ["ui_ux", "functional", "crash", "security", "other"];
+function isBugCategory(value) {
+  return typeof value === "string" && BUG_CATEGORIES.includes(value);
+}
+
 // src/client.ts
 var import_supabase_js = require("@supabase/supabase-js");
 
@@ -467,7 +475,13 @@ var BugBearClient = class {
         console.error("BugBear: Failed to fetch assignments", formatPgError(error));
         return [];
       }
-      const mapped = (data || []).map((item) => ({
+      const mapped = (data || []).filter((item) => {
+        if (!item.test_case) {
+          console.warn("BugBear: Assignment returned without test_case", { id: item.id });
+          return false;
+        }
+        return true;
+      }).map((item) => ({
         id: item.id,
         status: item.status,
         startedAt: item.started_at,
@@ -724,6 +738,16 @@ var BugBearClient = class {
       if (feedback.rating < 1 || feedback.rating > 5) {
         return { success: false, error: "Rating must be between 1 and 5" };
       }
+      const optionalRatings = [
+        { name: "clarityRating", value: feedback.clarityRating },
+        { name: "stepsRating", value: feedback.stepsRating },
+        { name: "relevanceRating", value: feedback.relevanceRating }
+      ];
+      for (const { name, value } of optionalRatings) {
+        if (value !== void 0 && value !== null && (value < 1 || value > 5)) {
+          return { success: false, error: `${name} must be between 1 and 5` };
+        }
+      }
       const { error: feedbackError } = await this.supabase.from("test_feedback").insert({
         project_id: this.config.projectId,
         test_case_id: testCaseId,
@@ -975,9 +999,8 @@ var BugBearClient = class {
     if (report.severity && !validSeverities.includes(report.severity)) {
       return `Invalid severity: ${report.severity}. Must be one of: ${validSeverities.join(", ")}`;
     }
-    const validCategories = ["ui_ux", "functional", "crash", "security", "other"];
-    if (report.category && !validCategories.includes(report.category)) {
-      return `Invalid category: ${report.category}. Must be one of: ${validCategories.join(", ")}`;
+    if (report.category && !BUG_CATEGORIES.includes(report.category)) {
+      return `Invalid category: ${report.category}. Must be one of: ${BUG_CATEGORIES.join(", ")}`;
     }
     if (report.title && report.title.length > 500) {
       return "Title must be 500 characters or less";
@@ -1051,6 +1074,10 @@ var BugBearClient = class {
       });
       if (error) {
         console.warn("BugBear: Rate limit check failed, allowing request", error.message);
+        this.config.onError?.(new Error(`Rate limit check failed: ${error.message}`), {
+          projectId: this.config.projectId,
+          context: "rate_limit_check_failed_open"
+        });
         return { allowed: true };
       }
       if (!data.allowed) {
@@ -1067,7 +1094,12 @@ var BugBearClient = class {
         resetAt: data.reset_at
       };
     } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown rate limit error";
       console.warn("BugBear: Rate limit check error", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), {
+        projectId: this.config.projectId,
+        context: "rate_limit_check_failed_open"
+      });
       return { allowed: true };
     }
   }
@@ -1131,6 +1163,9 @@ var BugBearClient = class {
       }
       return data ?? true;
     } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error checking QA status";
+      console.error("BugBear: Error checking QA status", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), { projectId: this.config.projectId });
       return true;
     }
   }
@@ -1159,13 +1194,24 @@ var BugBearClient = class {
         upsert: false
       });
       if (error) {
-        console.error("BugBear: Failed to upload screenshot", formatPgError(error));
+        const formattedError = formatPgError(error);
+        const errorMessage = formattedError.message || "Failed to upload screenshot";
+        console.error("BugBear: Failed to upload screenshot", formattedError);
+        this.config.onError?.(new Error(errorMessage), {
+          projectId: this.config.projectId,
+          context: "screenshot_upload_failed"
+        });
         return null;
       }
       const { data: { publicUrl } } = this.supabase.storage.from(bucket).getPublicUrl(path);
       return publicUrl;
     } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error uploading screenshot";
       console.error("BugBear: Error uploading screenshot", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), {
+        projectId: this.config.projectId,
+        context: "screenshot_upload_failed"
+      });
       return null;
     }
   }
@@ -1190,13 +1236,24 @@ var BugBearClient = class {
         upsert: false
       });
       if (error) {
-        console.error("BugBear: Failed to upload image from URI", formatPgError(error));
+        const formattedError = formatPgError(error);
+        const errorMessage = formattedError.message || "Failed to upload image";
+        console.error("BugBear: Failed to upload image from URI", formattedError);
+        this.config.onError?.(new Error(errorMessage), {
+          projectId: this.config.projectId,
+          context: "image_upload_failed"
+        });
         return null;
       }
       const { data: { publicUrl } } = this.supabase.storage.from(bucket).getPublicUrl(path);
       return publicUrl;
     } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error uploading image";
       console.error("BugBear: Error uploading image from URI", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), {
+        projectId: this.config.projectId,
+        context: "image_upload_failed"
+      });
       return null;
     }
   }
@@ -1727,8 +1784,10 @@ function createBugBear(config) {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  BUG_CATEGORIES,
   BugBearClient,
   captureError,
   contextCapture,
-  createBugBear
+  createBugBear,
+  isBugCategory
 });

package/dist/index.mjs

@@ -1,3 +1,9 @@
+// src/types.ts
+var BUG_CATEGORIES = ["ui_ux", "functional", "crash", "security", "other"];
+function isBugCategory(value) {
+  return typeof value === "string" && BUG_CATEGORIES.includes(value);
+}
+
 // src/client.ts
 import { createClient } from "@supabase/supabase-js";
 
@@ -438,7 +444,13 @@ var BugBearClient = class {
         console.error("BugBear: Failed to fetch assignments", formatPgError(error));
         return [];
       }
-      const mapped = (data || []).map((item) => ({
+      const mapped = (data || []).filter((item) => {
+        if (!item.test_case) {
+          console.warn("BugBear: Assignment returned without test_case", { id: item.id });
+          return false;
+        }
+        return true;
+      }).map((item) => ({
         id: item.id,
         status: item.status,
         startedAt: item.started_at,
@@ -695,6 +707,16 @@ var BugBearClient = class {
       if (feedback.rating < 1 || feedback.rating > 5) {
         return { success: false, error: "Rating must be between 1 and 5" };
       }
+      const optionalRatings = [
+        { name: "clarityRating", value: feedback.clarityRating },
+        { name: "stepsRating", value: feedback.stepsRating },
+        { name: "relevanceRating", value: feedback.relevanceRating }
+      ];
+      for (const { name, value } of optionalRatings) {
+        if (value !== void 0 && value !== null && (value < 1 || value > 5)) {
+          return { success: false, error: `${name} must be between 1 and 5` };
+        }
+      }
       const { error: feedbackError } = await this.supabase.from("test_feedback").insert({
         project_id: this.config.projectId,
         test_case_id: testCaseId,
@@ -946,9 +968,8 @@ var BugBearClient = class {
     if (report.severity && !validSeverities.includes(report.severity)) {
       return `Invalid severity: ${report.severity}. Must be one of: ${validSeverities.join(", ")}`;
     }
-    const validCategories = ["ui_ux", "functional", "crash", "security", "other"];
-    if (report.category && !validCategories.includes(report.category)) {
-      return `Invalid category: ${report.category}. Must be one of: ${validCategories.join(", ")}`;
+    if (report.category && !BUG_CATEGORIES.includes(report.category)) {
+      return `Invalid category: ${report.category}. Must be one of: ${BUG_CATEGORIES.join(", ")}`;
     }
     if (report.title && report.title.length > 500) {
       return "Title must be 500 characters or less";
@@ -1022,6 +1043,10 @@ var BugBearClient = class {
       });
       if (error) {
         console.warn("BugBear: Rate limit check failed, allowing request", error.message);
+        this.config.onError?.(new Error(`Rate limit check failed: ${error.message}`), {
+          projectId: this.config.projectId,
+          context: "rate_limit_check_failed_open"
+        });
         return { allowed: true };
       }
       if (!data.allowed) {
@@ -1038,7 +1063,12 @@ var BugBearClient = class {
         resetAt: data.reset_at
       };
     } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown rate limit error";
       console.warn("BugBear: Rate limit check error", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), {
+        projectId: this.config.projectId,
+        context: "rate_limit_check_failed_open"
+      });
       return { allowed: true };
     }
   }
@@ -1102,6 +1132,9 @@ var BugBearClient = class {
       }
       return data ?? true;
     } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error checking QA status";
+      console.error("BugBear: Error checking QA status", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), { projectId: this.config.projectId });
       return true;
     }
   }
@@ -1130,13 +1163,24 @@ var BugBearClient = class {
         upsert: false
       });
       if (error) {
-        console.error("BugBear: Failed to upload screenshot", formatPgError(error));
+        const formattedError = formatPgError(error);
+        const errorMessage = formattedError.message || "Failed to upload screenshot";
+        console.error("BugBear: Failed to upload screenshot", formattedError);
+        this.config.onError?.(new Error(errorMessage), {
+          projectId: this.config.projectId,
+          context: "screenshot_upload_failed"
+        });
         return null;
       }
       const { data: { publicUrl } } = this.supabase.storage.from(bucket).getPublicUrl(path);
       return publicUrl;
     } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error uploading screenshot";
       console.error("BugBear: Error uploading screenshot", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), {
+        projectId: this.config.projectId,
+        context: "screenshot_upload_failed"
+      });
       return null;
     }
   }
@@ -1161,13 +1205,24 @@ var BugBearClient = class {
         upsert: false
       });
       if (error) {
-        console.error("BugBear: Failed to upload image from URI", formatPgError(error));
+        const formattedError = formatPgError(error);
+        const errorMessage = formattedError.message || "Failed to upload image";
+        console.error("BugBear: Failed to upload image from URI", formattedError);
+        this.config.onError?.(new Error(errorMessage), {
+          projectId: this.config.projectId,
+          context: "image_upload_failed"
+        });
         return null;
       }
       const { data: { publicUrl } } = this.supabase.storage.from(bucket).getPublicUrl(path);
       return publicUrl;
     } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error uploading image";
       console.error("BugBear: Error uploading image from URI", err);
+      this.config.onError?.(err instanceof Error ? err : new Error(message), {
+        projectId: this.config.projectId,
+        context: "image_upload_failed"
+      });
       return null;
     }
   }
@@ -1697,8 +1752,10 @@ function createBugBear(config) {
   return new BugBearClient(config);
 }
 export {
+  BUG_CATEGORIES,
   BugBearClient,
   captureError,
   contextCapture,
-  createBugBear
+  createBugBear,
+  isBugCategory
 };

package/package.json

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