@bbearai/core 0.4.1 → 0.4.3

package/README.md

@@ -129,6 +129,8 @@ const context = contextCapture.getEnhancedContext();
 | `getAppContext()` | Get current app context (uses config callback or auto-captured) |
 | `getNavigationHistory()` | Get navigation history (config callback > manual > auto-captured) |
 | `trackNavigation(route)` | Manually track a route change |
+| `getIssueCounts()` | Get issue counts by category (open, done, reopened) |
+| `getIssues(category)` | Get enriched issue list with verification proof and original bug context |
 | `uploadScreenshot(file)` | Upload a screenshot |
 
 ## Types
@@ -172,6 +174,55 @@ interface TestAssignment {
     priority: string;
   };
 }
+
+type IssueCategory = 'open' | 'done' | 'reopened';
+
+interface IssueCounts {
+  open: number;
+  done: number;
+  reopened: number;
+}
+
+interface TesterIssue {
+  id: string;
+  title: string;
+  description: string;
+  reportType: ReportType;
+  severity: Severity | null;
+  status: ReportStatus;
+  screenshotUrls: string[];
+  route?: string;
+  reporterName?: string;
+  createdAt: string;
+  updatedAt: string;
+  verifiedByName?: string;   // Who retested (done issues)
+  verifiedAt?: string;       // When verification passed (done issues)
+  originalBugId?: string;    // Original report ID (reopened issues)
+  originalBugTitle?: string; // Original bug title (reopened issues)
+}
+```
+
+## Issue Tracking
+
+The SDK provides methods for testers to track their bug lifecycle:
+
+```typescript
+// Get counts for issue cards (open, done, reopened)
+const counts = await bugbear.getIssueCounts();
+// { open: 3, done: 12, reopened: 1 }
+
+// Get enriched issue list by category
+const openIssues = await bugbear.getIssues('open');
+const doneIssues = await bugbear.getIssues('done');
+const reopenedIssues = await bugbear.getIssues('reopened');
+
+// Done issues include verification proof
+doneIssues[0].verifiedByName;  // "Jane Doe"
+doneIssues[0].verifiedAt;      // "2026-02-05T12:00:00Z"
+
+// Reopened issues include original bug context
+reopenedIssues[0].originalBugTitle;  // "Login button unresponsive"
+reopenedIssues[0].originalBugId;     // "uuid-of-original-report"
 ```
 
 ## For Framework Authors

package/dist/index.d.mts

@@ -3,6 +3,7 @@
  */
 type ReportType = 'bug' | 'feedback' | 'suggestion' | 'test_pass' | 'test_fail';
 type Severity = 'critical' | 'high' | 'medium' | 'low';
+type BugCategory = 'ui_ux' | 'functional' | 'crash' | 'security' | 'other';
 type ReportStatus = 'new' | 'triaging' | 'confirmed' | 'in_progress' | 'fixed' | 'ready_to_test' | 'verified' | 'resolved' | 'reviewed' | 'closed' | 'wont_fix' | 'duplicate';
 interface AppContext {
     /** Current route/screen path */
@@ -93,6 +94,8 @@ interface BugBearReport {
     title?: string;
     /** Severity (for bugs) */
     severity?: Severity;
+    /** Bug category for triage */
+    category?: BugCategory;
     /** Which step failed (for test failures) */
     failedAtStep?: string;
     /** Voice audio URL if voice input was used */
@@ -610,6 +613,37 @@ interface AddFindingOptions {
     deviceInfo?: DeviceInfo;
     appContext?: AppContext;
 }
+/** Category for filtering tester issues in the widget */
+type IssueCategory = 'open' | 'done' | 'reopened';
+/** Issue counts for each category (HomeScreen cards) */
+interface IssueCounts {
+    open: number;
+    done: number;
+    reopened: number;
+}
+/** A report as seen by the tester in the widget */
+interface TesterIssue {
+    id: string;
+    title: string;
+    description: string;
+    reportType: ReportType;
+    severity: Severity | null;
+    status: ReportStatus;
+    screenshotUrls: string[];
+    /** Route where the issue was observed (from app_context) */
+    route?: string;
+    reporterName?: string;
+    createdAt: string;
+    updatedAt: string;
+    /** Who verified/retested this issue (for done issues) */
+    verifiedByName?: string;
+    /** When verification passed (for done issues) */
+    verifiedAt?: string;
+    /** Original bug report ID (for reopened/test_fail issues) */
+    originalBugId?: string;
+    /** Original bug title (for reopened/test_fail issues) */
+    originalBugTitle?: string;
+}
 
 /**
  * BugBear Client
@@ -740,6 +774,21 @@ declare class BugBearClient {
         skipped: number;
         total: number;
     } | null>;
+    /**
+     * Get issue counts for the tester (Open, Done, Reopened)
+     * Used by the widget HomeScreen cards
+     */
+    getIssueCounts(): Promise<{
+        open: number;
+        done: number;
+        reopened: number;
+    }>;
+    /**
+     * Get issues for the tester by category.
+     * Returns enriched data: done issues include verification proof,
+     * reopened issues include original bug context.
+     */
+    getIssues(category: 'open' | 'done' | 'reopened'): Promise<TesterIssue[]>;
     /**
      * Basic email format validation (defense in depth)
      */
@@ -1019,4 +1068,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 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 };
+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 };

package/dist/index.d.ts

@@ -3,6 +3,7 @@
  */
 type ReportType = 'bug' | 'feedback' | 'suggestion' | 'test_pass' | 'test_fail';
 type Severity = 'critical' | 'high' | 'medium' | 'low';
+type BugCategory = 'ui_ux' | 'functional' | 'crash' | 'security' | 'other';
 type ReportStatus = 'new' | 'triaging' | 'confirmed' | 'in_progress' | 'fixed' | 'ready_to_test' | 'verified' | 'resolved' | 'reviewed' | 'closed' | 'wont_fix' | 'duplicate';
 interface AppContext {
     /** Current route/screen path */
@@ -93,6 +94,8 @@ interface BugBearReport {
     title?: string;
     /** Severity (for bugs) */
     severity?: Severity;
+    /** Bug category for triage */
+    category?: BugCategory;
     /** Which step failed (for test failures) */
     failedAtStep?: string;
     /** Voice audio URL if voice input was used */
@@ -610,6 +613,37 @@ interface AddFindingOptions {
     deviceInfo?: DeviceInfo;
     appContext?: AppContext;
 }
+/** Category for filtering tester issues in the widget */
+type IssueCategory = 'open' | 'done' | 'reopened';
+/** Issue counts for each category (HomeScreen cards) */
+interface IssueCounts {
+    open: number;
+    done: number;
+    reopened: number;
+}
+/** A report as seen by the tester in the widget */
+interface TesterIssue {
+    id: string;
+    title: string;
+    description: string;
+    reportType: ReportType;
+    severity: Severity | null;
+    status: ReportStatus;
+    screenshotUrls: string[];
+    /** Route where the issue was observed (from app_context) */
+    route?: string;
+    reporterName?: string;
+    createdAt: string;
+    updatedAt: string;
+    /** Who verified/retested this issue (for done issues) */
+    verifiedByName?: string;
+    /** When verification passed (for done issues) */
+    verifiedAt?: string;
+    /** Original bug report ID (for reopened/test_fail issues) */
+    originalBugId?: string;
+    /** Original bug title (for reopened/test_fail issues) */
+    originalBugTitle?: string;
+}
 
 /**
  * BugBear Client
@@ -740,6 +774,21 @@ declare class BugBearClient {
         skipped: number;
         total: number;
     } | null>;
+    /**
+     * Get issue counts for the tester (Open, Done, Reopened)
+     * Used by the widget HomeScreen cards
+     */
+    getIssueCounts(): Promise<{
+        open: number;
+        done: number;
+        reopened: number;
+    }>;
+    /**
+     * Get issues for the tester by category.
+     * Returns enriched data: done issues include verification proof,
+     * reopened issues include original bug context.
+     */
+    getIssues(category: 'open' | 'done' | 'reopened'): Promise<TesterIssue[]>;
     /**
      * Basic email format validation (defense in depth)
      */
@@ -1019,4 +1068,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 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 };
+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 };

package/dist/index.js

@@ -385,6 +385,8 @@ var BugBearClient = class {
         title: report.title || this.generateTitle(report),
         description: report.description,
         severity: report.severity,
+        category: report.category,
+        // Bug category (ui, performance, crash, etc.)
         failed_at_step: report.failedAtStep,
         voice_audio_url: report.voiceAudioUrl,
         voice_transcript: report.voiceTranscript,
@@ -886,6 +888,72 @@ var BugBearClient = class {
       return null;
     }
   }
+  /**
+   * Get issue counts for the tester (Open, Done, Reopened)
+   * Used by the widget HomeScreen cards
+   */
+  async getIssueCounts() {
+    try {
+      const testerInfo = await this.getTesterInfo();
+      if (!testerInfo) return { open: 0, done: 0, reopened: 0 };
+      const { data, error } = await this.supabase.rpc("get_tester_issue_counts", {
+        p_project_id: this.config.projectId,
+        p_tester_id: testerInfo.id
+      });
+      if (error) {
+        console.error("BugBear: Failed to fetch issue counts", formatPgError(error));
+        return { open: 0, done: 0, reopened: 0 };
+      }
+      return {
+        open: data?.open ?? 0,
+        done: data?.done ?? 0,
+        reopened: data?.reopened ?? 0
+      };
+    } catch (err) {
+      console.error("BugBear: Error fetching issue counts", err);
+      return { open: 0, done: 0, reopened: 0 };
+    }
+  }
+  /**
+   * Get issues for the tester by category.
+   * Returns enriched data: done issues include verification proof,
+   * reopened issues include original bug context.
+   */
+  async getIssues(category) {
+    try {
+      const testerInfo = await this.getTesterInfo();
+      if (!testerInfo) return [];
+      const { data, error } = await this.supabase.rpc("get_tester_issues", {
+        p_project_id: this.config.projectId,
+        p_tester_id: testerInfo.id,
+        p_category: category
+      });
+      if (error) {
+        console.error("BugBear: Failed to fetch issues", formatPgError(error));
+        return [];
+      }
+      return (data || []).map((row) => ({
+        id: row.id,
+        title: row.title || "Untitled",
+        description: row.description,
+        reportType: row.report_type,
+        severity: row.severity || null,
+        status: row.status,
+        screenshotUrls: row.screenshot_urls || [],
+        route: row.app_context?.currentRoute || void 0,
+        reporterName: row.reporter_name || void 0,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        verifiedByName: row.verified_by_name || void 0,
+        verifiedAt: row.verified_at || void 0,
+        originalBugId: row.original_bug_id || void 0,
+        originalBugTitle: row.original_bug_title || void 0
+      }));
+    } catch (err) {
+      console.error("BugBear: Error fetching issues", err);
+      return [];
+    }
+  }
   /**
    * Basic email format validation (defense in depth)
    */

package/dist/index.mjs

@@ -356,6 +356,8 @@ var BugBearClient = class {
         title: report.title || this.generateTitle(report),
         description: report.description,
         severity: report.severity,
+        category: report.category,
+        // Bug category (ui, performance, crash, etc.)
         failed_at_step: report.failedAtStep,
         voice_audio_url: report.voiceAudioUrl,
         voice_transcript: report.voiceTranscript,
@@ -857,6 +859,72 @@ var BugBearClient = class {
       return null;
     }
   }
+  /**
+   * Get issue counts for the tester (Open, Done, Reopened)
+   * Used by the widget HomeScreen cards
+   */
+  async getIssueCounts() {
+    try {
+      const testerInfo = await this.getTesterInfo();
+      if (!testerInfo) return { open: 0, done: 0, reopened: 0 };
+      const { data, error } = await this.supabase.rpc("get_tester_issue_counts", {
+        p_project_id: this.config.projectId,
+        p_tester_id: testerInfo.id
+      });
+      if (error) {
+        console.error("BugBear: Failed to fetch issue counts", formatPgError(error));
+        return { open: 0, done: 0, reopened: 0 };
+      }
+      return {
+        open: data?.open ?? 0,
+        done: data?.done ?? 0,
+        reopened: data?.reopened ?? 0
+      };
+    } catch (err) {
+      console.error("BugBear: Error fetching issue counts", err);
+      return { open: 0, done: 0, reopened: 0 };
+    }
+  }
+  /**
+   * Get issues for the tester by category.
+   * Returns enriched data: done issues include verification proof,
+   * reopened issues include original bug context.
+   */
+  async getIssues(category) {
+    try {
+      const testerInfo = await this.getTesterInfo();
+      if (!testerInfo) return [];
+      const { data, error } = await this.supabase.rpc("get_tester_issues", {
+        p_project_id: this.config.projectId,
+        p_tester_id: testerInfo.id,
+        p_category: category
+      });
+      if (error) {
+        console.error("BugBear: Failed to fetch issues", formatPgError(error));
+        return [];
+      }
+      return (data || []).map((row) => ({
+        id: row.id,
+        title: row.title || "Untitled",
+        description: row.description,
+        reportType: row.report_type,
+        severity: row.severity || null,
+        status: row.status,
+        screenshotUrls: row.screenshot_urls || [],
+        route: row.app_context?.currentRoute || void 0,
+        reporterName: row.reporter_name || void 0,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+        verifiedByName: row.verified_by_name || void 0,
+        verifiedAt: row.verified_at || void 0,
+        originalBugId: row.original_bug_id || void 0,
+        originalBugTitle: row.original_bug_title || void 0
+      }));
+    } catch (err) {
+      console.error("BugBear: Error fetching issues", err);
+      return [];
+    }
+  }
   /**
    * Basic email format validation (defense in depth)
    */

package/package.json

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