@bbearai/core 0.4.2 → 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 */
@@ -1065,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 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, 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 */
@@ -1065,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 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, 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,

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,

package/package.json

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