@bbearai/core 0.3.0 → 0.4.0

package/dist/index.d.mts

@@ -187,6 +187,15 @@ interface TestGroup {
     description?: string;
     sortOrder: number;
 }
+/** Project role — a user role in the app under test (e.g., Owner, Manager) */
+interface ProjectRole {
+    id: string;
+    name: string;
+    slug: string;
+    color: string;
+    description?: string;
+    loginHint?: string;
+}
 interface QATrack {
     id: string;
     name: string;
@@ -212,6 +221,8 @@ interface TestAssignment {
         track?: QATrack;
         /** Test group (folder) this test belongs to */
         group?: TestGroup;
+        /** Required app role for testing (e.g., Owner, Manager) */
+        role?: ProjectRole;
     };
     status: 'pending' | 'in_progress' | 'passed' | 'failed' | 'blocked' | 'skipped';
     /** Reason for skipping (when status is 'skipped') */
@@ -1007,4 +1018,4 @@ declare function captureError(error: Error, errorInfo?: {
     componentStack?: string;
 };
 
-export { type AddFindingOptions, type AppContext, BugBearClient, type BugBearConfig, type BugBearReport, type BugBearTheme, 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 MessageSenderType, type NetworkRequest, type PriorityFactors, 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 TesterMessage, type TesterProfileUpdate, type TesterThread, type ThreadPriority, type ThreadType, captureError, contextCapture, createBugBear };
+export { type AddFindingOptions, type AppContext, BugBearClient, type BugBearConfig, type BugBearReport, type BugBearTheme, 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 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 TesterMessage, type TesterProfileUpdate, type TesterThread, type ThreadPriority, type ThreadType, captureError, contextCapture, createBugBear };

package/dist/index.d.ts

@@ -187,6 +187,15 @@ interface TestGroup {
     description?: string;
     sortOrder: number;
 }
+/** Project role — a user role in the app under test (e.g., Owner, Manager) */
+interface ProjectRole {
+    id: string;
+    name: string;
+    slug: string;
+    color: string;
+    description?: string;
+    loginHint?: string;
+}
 interface QATrack {
     id: string;
     name: string;
@@ -212,6 +221,8 @@ interface TestAssignment {
         track?: QATrack;
         /** Test group (folder) this test belongs to */
         group?: TestGroup;
+        /** Required app role for testing (e.g., Owner, Manager) */
+        role?: ProjectRole;
     };
     status: 'pending' | 'in_progress' | 'passed' | 'failed' | 'blocked' | 'skipped';
     /** Reason for skipping (when status is 'skipped') */
@@ -1007,4 +1018,4 @@ declare function captureError(error: Error, errorInfo?: {
     componentStack?: string;
 };
 
-export { type AddFindingOptions, type AppContext, BugBearClient, type BugBearConfig, type BugBearReport, type BugBearTheme, 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 MessageSenderType, type NetworkRequest, type PriorityFactors, 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 TesterMessage, type TesterProfileUpdate, type TesterThread, type ThreadPriority, type ThreadType, captureError, contextCapture, createBugBear };
+export { type AddFindingOptions, type AppContext, BugBearClient, type BugBearConfig, type BugBearReport, type BugBearTheme, 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 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 TesterMessage, type TesterProfileUpdate, type TesterThread, type ThreadPriority, type ThreadType, captureError, contextCapture, createBugBear };

package/dist/index.js

@@ -273,6 +273,11 @@ function captureError(error, errorInfo) {
 }
 
 // src/client.ts
+var formatPgError = (e) => {
+  if (!e || typeof e !== "object") return { raw: e };
+  const { message, code, details, hint } = e;
+  return { message, code, details, hint };
+};
 var DEFAULT_SUPABASE_URL = "https://kyxgzjnqgvapvlnvqawz.supabase.co";
 var getEnvVar = (key) => {
   try {
@@ -438,11 +443,19 @@ var BugBearClient = class {
               name,
               description,
               sort_order
+            ),
+            role:project_roles(
+              id,
+              name,
+              slug,
+              color,
+              description,
+              login_hint
             )
           )
         `).eq("project_id", this.config.projectId).eq("tester_id", testerInfo.id).in("status", ["pending", "in_progress"]).order("created_at", { ascending: true }).limit(100);
       if (error) {
-        console.error("BugBear: Failed to fetch assignments", error);
+        console.error("BugBear: Failed to fetch assignments", formatPgError(error));
         return [];
       }
       const mapped = (data || []).map((item) => ({
@@ -475,6 +488,14 @@ var BugBearClient = class {
             name: item.test_case.group.name,
             description: item.test_case.group.description,
             sortOrder: item.test_case.group.sort_order
+          } : void 0,
+          role: item.test_case.role ? {
+            id: item.test_case.role.id,
+            name: item.test_case.role.name,
+            slug: item.test_case.role.slug,
+            color: item.test_case.role.color,
+            description: item.test_case.role.description,
+            loginHint: item.test_case.role.login_hint
           } : void 0
         }
       }));
@@ -670,7 +691,7 @@ var BugBearClient = class {
       }
       const { error } = await this.supabase.from("test_assignments").update(updateData).eq("id", assignmentId);
       if (error) {
-        console.error("BugBear: Failed to skip assignment", error);
+        console.error("BugBear: Failed to skip assignment", formatPgError(error));
         return { success: false, error: error.message };
       }
       return { success: true };
@@ -849,7 +870,7 @@ var BugBearClient = class {
         p_tester_id: testerInfo.id
       });
       if (error) {
-        console.error("BugBear: Failed to fetch tester stats", error);
+        console.error("BugBear: Failed to fetch tester stats", formatPgError(error));
         return null;
       }
       return data;
@@ -1000,7 +1021,7 @@ var BugBearClient = class {
       if (updates.platforms !== void 0) updateData.platforms = updates.platforms;
       const { error } = await this.supabase.from("testers").update(updateData).eq("id", testerInfo.id);
       if (error) {
-        console.error("BugBear: updateTesterProfile error", error);
+        console.error("BugBear: updateTesterProfile error", formatPgError(error));
         return { success: false, error: error.message };
       }
       return { success: true };
@@ -1022,14 +1043,14 @@ var BugBearClient = class {
    */
   async isQAEnabled() {
     try {
-      const { data, error } = await this.supabase.from("projects").select("is_qa_enabled").eq("id", this.config.projectId).single();
+      const { data, error } = await this.supabase.rpc("check_qa_enabled", {
+        p_project_id: this.config.projectId
+      });
       if (error) {
-        if (error.code !== "PGRST116") {
-          console.warn("BugBear: Could not check QA status", error.message || error.code || "Unknown error");
-        }
+        console.warn("BugBear: Could not check QA status", error.message || error.code || "Unknown error");
         return true;
       }
-      return data?.is_qa_enabled ?? true;
+      return data ?? true;
     } catch (err) {
       return true;
     }
@@ -1059,7 +1080,7 @@ var BugBearClient = class {
         upsert: false
       });
       if (error) {
-        console.error("BugBear: Failed to upload screenshot", error);
+        console.error("BugBear: Failed to upload screenshot", formatPgError(error));
         return null;
       }
       const { data: { publicUrl } } = this.supabase.storage.from(bucket).getPublicUrl(path);
@@ -1090,7 +1111,7 @@ var BugBearClient = class {
         upsert: false
       });
       if (error) {
-        console.error("BugBear: Failed to upload image from URI", error);
+        console.error("BugBear: Failed to upload image from URI", formatPgError(error));
         return null;
       }
       const { data: { publicUrl } } = this.supabase.storage.from(bucket).getPublicUrl(path);
@@ -1165,7 +1186,7 @@ var BugBearClient = class {
       }
       const { data, error } = await query;
       if (error) {
-        console.error("BugBear: Failed to fetch fix requests", error);
+        console.error("BugBear: Failed to fetch fix requests", formatPgError(error));
         return [];
       }
       return (data || []).map((fr) => ({
@@ -1196,7 +1217,7 @@ var BugBearClient = class {
         p_tester_id: testerInfo.id
       });
       if (error) {
-        console.error("BugBear: Failed to fetch threads via RPC", error);
+        console.error("BugBear: Failed to fetch threads via RPC", formatPgError(error));
         return [];
       }
       if (!data || data.length === 0) return [];
@@ -1240,7 +1261,7 @@ var BugBearClient = class {
           attachments
         `).eq("thread_id", threadId).order("created_at", { ascending: true }).limit(200);
       if (error) {
-        console.error("BugBear: Failed to fetch messages", error);
+        console.error("BugBear: Failed to fetch messages", formatPgError(error));
         return [];
       }
       return (data || []).map((msg) => ({
@@ -1284,7 +1305,7 @@ var BugBearClient = class {
       }
       const { error } = await this.supabase.from("discussion_messages").insert(insertData);
       if (error) {
-        console.error("BugBear: Failed to send message", error);
+        console.error("BugBear: Failed to send message", formatPgError(error));
         return false;
       }
       await this.markThreadAsRead(threadId);
@@ -1400,7 +1421,7 @@ var BugBearClient = class {
         p_platform: options.platform || null
       });
       if (error) {
-        console.error("BugBear: Failed to start session", error);
+        console.error("BugBear: Failed to start session", formatPgError(error));
         return { success: false, error: error.message };
       }
       const session = await this.getSession(data);
@@ -1425,7 +1446,7 @@ var BugBearClient = class {
         p_routes_covered: options.routesCovered || null
       });
       if (error) {
-        console.error("BugBear: Failed to end session", error);
+        console.error("BugBear: Failed to end session", formatPgError(error));
         return { success: false, error: error.message };
       }
       const session = this.transformSession(data);
@@ -1473,7 +1494,7 @@ var BugBearClient = class {
       if (!testerInfo) return [];
       const { data, error } = await this.supabase.from("qa_sessions").select("*").eq("project_id", this.config.projectId).eq("tester_id", testerInfo.id).order("started_at", { ascending: false }).limit(limit);
       if (error) {
-        console.error("BugBear: Failed to fetch session history", error);
+        console.error("BugBear: Failed to fetch session history", formatPgError(error));
         return [];
       }
       return (data || []).map((s) => this.transformSession(s));
@@ -1501,7 +1522,7 @@ var BugBearClient = class {
         p_app_context: options.appContext || null
       });
       if (error) {
-        console.error("BugBear: Failed to add finding", error);
+        console.error("BugBear: Failed to add finding", formatPgError(error));
         return { success: false, error: error.message };
       }
       const finding = this.transformFinding(data);
@@ -1519,7 +1540,7 @@ var BugBearClient = class {
     try {
       const { data, error } = await this.supabase.from("qa_findings").select("*").eq("session_id", sessionId).order("created_at", { ascending: true }).limit(100);
       if (error) {
-        console.error("BugBear: Failed to fetch findings", error);
+        console.error("BugBear: Failed to fetch findings", formatPgError(error));
         return [];
       }
       return (data || []).map((f) => this.transformFinding(f));
@@ -1537,7 +1558,7 @@ var BugBearClient = class {
         p_finding_id: findingId
       });
       if (error) {
-        console.error("BugBear: Failed to convert finding", error);
+        console.error("BugBear: Failed to convert finding", formatPgError(error));
         return { success: false, error: error.message };
       }
       return { success: true, bugId: data };
@@ -1558,7 +1579,7 @@ var BugBearClient = class {
         dismissed_at: (/* @__PURE__ */ new Date()).toISOString()
       }).eq("id", findingId);
       if (error) {
-        console.error("BugBear: Failed to dismiss finding", error);
+        console.error("BugBear: Failed to dismiss finding", formatPgError(error));
         return { success: false, error: error.message };
       }
       return { success: true };

package/dist/index.mjs

@@ -244,6 +244,11 @@ function captureError(error, errorInfo) {
 }
 
 // src/client.ts
+var formatPgError = (e) => {
+  if (!e || typeof e !== "object") return { raw: e };
+  const { message, code, details, hint } = e;
+  return { message, code, details, hint };
+};
 var DEFAULT_SUPABASE_URL = "https://kyxgzjnqgvapvlnvqawz.supabase.co";
 var getEnvVar = (key) => {
   try {
@@ -409,11 +414,19 @@ var BugBearClient = class {
               name,
               description,
               sort_order
+            ),
+            role:project_roles(
+              id,
+              name,
+              slug,
+              color,
+              description,
+              login_hint
             )
           )
         `).eq("project_id", this.config.projectId).eq("tester_id", testerInfo.id).in("status", ["pending", "in_progress"]).order("created_at", { ascending: true }).limit(100);
       if (error) {
-        console.error("BugBear: Failed to fetch assignments", error);
+        console.error("BugBear: Failed to fetch assignments", formatPgError(error));
         return [];
       }
       const mapped = (data || []).map((item) => ({
@@ -446,6 +459,14 @@ var BugBearClient = class {
             name: item.test_case.group.name,
             description: item.test_case.group.description,
             sortOrder: item.test_case.group.sort_order
+          } : void 0,
+          role: item.test_case.role ? {
+            id: item.test_case.role.id,
+            name: item.test_case.role.name,
+            slug: item.test_case.role.slug,
+            color: item.test_case.role.color,
+            description: item.test_case.role.description,
+            loginHint: item.test_case.role.login_hint
           } : void 0
         }
       }));
@@ -641,7 +662,7 @@ var BugBearClient = class {
       }
       const { error } = await this.supabase.from("test_assignments").update(updateData).eq("id", assignmentId);
       if (error) {
-        console.error("BugBear: Failed to skip assignment", error);
+        console.error("BugBear: Failed to skip assignment", formatPgError(error));
         return { success: false, error: error.message };
       }
       return { success: true };
@@ -820,7 +841,7 @@ var BugBearClient = class {
         p_tester_id: testerInfo.id
       });
       if (error) {
-        console.error("BugBear: Failed to fetch tester stats", error);
+        console.error("BugBear: Failed to fetch tester stats", formatPgError(error));
         return null;
       }
       return data;
@@ -971,7 +992,7 @@ var BugBearClient = class {
       if (updates.platforms !== void 0) updateData.platforms = updates.platforms;
       const { error } = await this.supabase.from("testers").update(updateData).eq("id", testerInfo.id);
       if (error) {
-        console.error("BugBear: updateTesterProfile error", error);
+        console.error("BugBear: updateTesterProfile error", formatPgError(error));
         return { success: false, error: error.message };
       }
       return { success: true };
@@ -993,14 +1014,14 @@ var BugBearClient = class {
    */
   async isQAEnabled() {
     try {
-      const { data, error } = await this.supabase.from("projects").select("is_qa_enabled").eq("id", this.config.projectId).single();
+      const { data, error } = await this.supabase.rpc("check_qa_enabled", {
+        p_project_id: this.config.projectId
+      });
       if (error) {
-        if (error.code !== "PGRST116") {
-          console.warn("BugBear: Could not check QA status", error.message || error.code || "Unknown error");
-        }
+        console.warn("BugBear: Could not check QA status", error.message || error.code || "Unknown error");
         return true;
       }
-      return data?.is_qa_enabled ?? true;
+      return data ?? true;
     } catch (err) {
       return true;
     }
@@ -1030,7 +1051,7 @@ var BugBearClient = class {
         upsert: false
       });
       if (error) {
-        console.error("BugBear: Failed to upload screenshot", error);
+        console.error("BugBear: Failed to upload screenshot", formatPgError(error));
         return null;
       }
       const { data: { publicUrl } } = this.supabase.storage.from(bucket).getPublicUrl(path);
@@ -1061,7 +1082,7 @@ var BugBearClient = class {
         upsert: false
       });
       if (error) {
-        console.error("BugBear: Failed to upload image from URI", error);
+        console.error("BugBear: Failed to upload image from URI", formatPgError(error));
         return null;
       }
       const { data: { publicUrl } } = this.supabase.storage.from(bucket).getPublicUrl(path);
@@ -1136,7 +1157,7 @@ var BugBearClient = class {
       }
       const { data, error } = await query;
       if (error) {
-        console.error("BugBear: Failed to fetch fix requests", error);
+        console.error("BugBear: Failed to fetch fix requests", formatPgError(error));
         return [];
       }
       return (data || []).map((fr) => ({
@@ -1167,7 +1188,7 @@ var BugBearClient = class {
         p_tester_id: testerInfo.id
       });
       if (error) {
-        console.error("BugBear: Failed to fetch threads via RPC", error);
+        console.error("BugBear: Failed to fetch threads via RPC", formatPgError(error));
         return [];
       }
       if (!data || data.length === 0) return [];
@@ -1211,7 +1232,7 @@ var BugBearClient = class {
           attachments
         `).eq("thread_id", threadId).order("created_at", { ascending: true }).limit(200);
       if (error) {
-        console.error("BugBear: Failed to fetch messages", error);
+        console.error("BugBear: Failed to fetch messages", formatPgError(error));
         return [];
       }
       return (data || []).map((msg) => ({
@@ -1255,7 +1276,7 @@ var BugBearClient = class {
       }
       const { error } = await this.supabase.from("discussion_messages").insert(insertData);
       if (error) {
-        console.error("BugBear: Failed to send message", error);
+        console.error("BugBear: Failed to send message", formatPgError(error));
         return false;
       }
       await this.markThreadAsRead(threadId);
@@ -1371,7 +1392,7 @@ var BugBearClient = class {
         p_platform: options.platform || null
       });
       if (error) {
-        console.error("BugBear: Failed to start session", error);
+        console.error("BugBear: Failed to start session", formatPgError(error));
         return { success: false, error: error.message };
       }
       const session = await this.getSession(data);
@@ -1396,7 +1417,7 @@ var BugBearClient = class {
         p_routes_covered: options.routesCovered || null
       });
       if (error) {
-        console.error("BugBear: Failed to end session", error);
+        console.error("BugBear: Failed to end session", formatPgError(error));
         return { success: false, error: error.message };
       }
       const session = this.transformSession(data);
@@ -1444,7 +1465,7 @@ var BugBearClient = class {
       if (!testerInfo) return [];
       const { data, error } = await this.supabase.from("qa_sessions").select("*").eq("project_id", this.config.projectId).eq("tester_id", testerInfo.id).order("started_at", { ascending: false }).limit(limit);
       if (error) {
-        console.error("BugBear: Failed to fetch session history", error);
+        console.error("BugBear: Failed to fetch session history", formatPgError(error));
         return [];
       }
       return (data || []).map((s) => this.transformSession(s));
@@ -1472,7 +1493,7 @@ var BugBearClient = class {
         p_app_context: options.appContext || null
       });
       if (error) {
-        console.error("BugBear: Failed to add finding", error);
+        console.error("BugBear: Failed to add finding", formatPgError(error));
         return { success: false, error: error.message };
       }
       const finding = this.transformFinding(data);
@@ -1490,7 +1511,7 @@ var BugBearClient = class {
     try {
       const { data, error } = await this.supabase.from("qa_findings").select("*").eq("session_id", sessionId).order("created_at", { ascending: true }).limit(100);
       if (error) {
-        console.error("BugBear: Failed to fetch findings", error);
+        console.error("BugBear: Failed to fetch findings", formatPgError(error));
         return [];
       }
       return (data || []).map((f) => this.transformFinding(f));
@@ -1508,7 +1529,7 @@ var BugBearClient = class {
         p_finding_id: findingId
       });
       if (error) {
-        console.error("BugBear: Failed to convert finding", error);
+        console.error("BugBear: Failed to convert finding", formatPgError(error));
         return { success: false, error: error.message };
       }
       return { success: true, bugId: data };
@@ -1529,7 +1550,7 @@ var BugBearClient = class {
         dismissed_at: (/* @__PURE__ */ new Date()).toISOString()
       }).eq("id", findingId);
       if (error) {
-        console.error("BugBear: Failed to dismiss finding", error);
+        console.error("BugBear: Failed to dismiss finding", formatPgError(error));
         return { success: false, error: error.message };
       }
       return { success: true };

package/package.json

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