@bbearai/core 0.1.6 → 0.2.1

package/dist/index.d.mts

@@ -186,6 +186,10 @@ interface TestAssignment {
         track?: QATrack;
     };
     status: 'pending' | 'in_progress' | 'passed' | 'failed' | 'blocked';
+    /** When the assignment was started (set to in_progress) */
+    startedAt?: string;
+    /** Duration in seconds (calculated when completed) */
+    durationSeconds?: number;
 }
 interface TestStep {
     stepNumber: number;
@@ -213,6 +217,37 @@ interface TestResult {
     /** Overall notes */
     notes?: string;
 }
+/**
+ * Feedback from testers about a test case
+ * Helps improve test quality over time
+ */
+interface TestFeedback {
+    /** Overall rating (1-5 stars) */
+    rating: 1 | 2 | 3 | 4 | 5;
+    /** Optional detailed ratings */
+    clarityRating?: 1 | 2 | 3 | 4 | 5;
+    stepsRating?: 1 | 2 | 3 | 4 | 5;
+    relevanceRating?: 1 | 2 | 3 | 4 | 5;
+    /** Free-form feedback note */
+    feedbackNote?: string;
+    /** Specific improvement suggestion */
+    suggestedImprovement?: string;
+    /** Quick feedback flags */
+    isOutdated?: boolean;
+    needsMoreDetail?: boolean;
+    stepsUnclear?: boolean;
+    expectedResultUnclear?: boolean;
+}
+/**
+ * Options for submitting test feedback
+ */
+interface SubmitFeedbackOptions {
+    testCaseId: string;
+    assignmentId?: string;
+    feedback: TestFeedback;
+    /** Time taken to complete in seconds */
+    timeToCompleteSeconds?: number;
+}
 interface TesterInfo {
     id: string;
     name: string;
@@ -263,6 +298,271 @@ interface TesterMessage {
         name: string;
     }>;
 }
+/** Priority factors breakdown for a route */
+interface PriorityFactors {
+    bugFrequency: {
+        score: number;
+        openBugs: number;
+        bugs7d: number;
+    };
+    criticalSeverity: {
+        score: number;
+        critical: number;
+        high: number;
+    };
+    staleness: {
+        score: number;
+        daysSinceTest: number | null;
+    };
+    coverageGap: {
+        score: number;
+        testCount: number;
+    };
+    regressionRisk: {
+        score: number;
+        regressionCount: number;
+    };
+}
+/** Route priority with stats and recommendations */
+interface RoutePriority {
+    rank: number;
+    route: string;
+    priorityScore: number;
+    urgency: 'critical' | 'high' | 'medium' | 'low';
+    stats: {
+        openBugs: number;
+        criticalBugs: number;
+        highBugs: number;
+        testCases: number;
+        daysSinceTest: number | null;
+        regressions: number;
+        recentBugs: number;
+    };
+    factors?: PriorityFactors;
+    recommendation?: string;
+}
+/** Coverage gap identification */
+interface CoverageGap {
+    route: string;
+    severity: 'critical' | 'high' | 'medium';
+    type: 'untested' | 'missing_tracks' | 'stale';
+    details: {
+        missingTracks?: string[];
+        daysSinceTest?: number;
+        openBugs?: number;
+        criticalBugs?: number;
+    };
+    recommendation: string;
+}
+/** Regression event tracking */
+interface RegressionEvent {
+    id: string;
+    route: string;
+    severity: 'critical' | 'high' | 'medium';
+    originalBug: {
+        id: string;
+        description: string;
+        resolvedAt: string;
+    };
+    newBugs: Array<{
+        id: string;
+        description: string;
+        severity: string;
+        createdAt: string;
+    }>;
+    daysSinceResolution: number;
+    regressionCount: number;
+    detectedAt: string;
+}
+/** Deploy checklist item */
+interface ChecklistItem {
+    testCaseId?: string;
+    testKey?: string;
+    title: string;
+    route: string;
+    reason: string;
+    priority: 'P0' | 'P1' | 'P2' | 'P3';
+    lastTested?: string;
+    hasCriticalBugs?: boolean;
+}
+/** Deploy checklist grouped by urgency */
+interface DeployChecklist {
+    critical: ChecklistItem[];
+    recommended: ChecklistItem[];
+    optional: ChecklistItem[];
+    gaps: ChecklistItem[];
+}
+/** QA Health metrics with trends */
+interface QAHealthMetrics {
+    velocity: {
+        testsPerWeek: number;
+        testsCompleted: number;
+        trend: 'up' | 'down' | 'stable';
+        changePercent?: number;
+    };
+    bugDiscovery: {
+        bugsFound: number;
+        bugsPerTest: number;
+        criticalBugs: number;
+        trend: 'up' | 'down' | 'stable';
+        changePercent?: number;
+    };
+    resolution: {
+        bugsResolved: number;
+        avgResolutionDays: number;
+        trend: 'up' | 'down' | 'stable';
+        changePercent?: number;
+    };
+    coverage: {
+        routeCoverage: number;
+        routesWithTests: number;
+        totalRoutes: number;
+    };
+    testerHealth: {
+        activeTesters: number;
+        totalTesters: number;
+        utilizationPercent: number;
+    };
+}
+/** QA Health score with grade */
+interface QAHealthScore {
+    score: number;
+    grade: 'A' | 'B' | 'C' | 'D' | 'F';
+    breakdown: {
+        coverage: number;
+        velocity: number;
+        resolution: number;
+        stability: number;
+    };
+}
+/** Aggregated route test statistics */
+interface RouteTestStats {
+    id: string;
+    projectId: string;
+    route: string;
+    totalBugs: number;
+    openBugs: number;
+    criticalBugs: number;
+    highBugs: number;
+    resolvedBugs: number;
+    testCaseCount: number;
+    testsByTrack: Record<string, number>;
+    lastTestedAt: string | null;
+    totalTestExecutions: number;
+    passCount: number;
+    failCount: number;
+    passRate: number | null;
+    regressionCount: number;
+    lastRegressionAt: string | null;
+    bugsLast7Days: number;
+    bugsLast30Days: number;
+    priorityScore: number;
+    calculatedAt: string;
+}
+/** Coverage matrix cell */
+interface CoverageMatrixCell {
+    testCount: number;
+    passCount: number;
+    failCount: number;
+    passRate: number | null;
+    lastTestedAt: string | null;
+    staleDays: number | null;
+}
+/** Coverage matrix row (route × tracks) */
+interface CoverageMatrixRow {
+    route: string;
+    totalTests: number;
+    openBugs: number;
+    criticalBugs: number;
+    lastTestedAt: string | null;
+    tracks: Record<string, CoverageMatrixCell>;
+}
+/** Session status */
+type QASessionStatus = 'active' | 'paused' | 'completed' | 'abandoned';
+/** Finding type - lighter than a bug report */
+type FindingType = 'bug' | 'concern' | 'suggestion' | 'question';
+/** Finding severity - includes observation for non-issues */
+type FindingSeverity = 'critical' | 'high' | 'medium' | 'low' | 'observation';
+/** QA Session - exploratory testing session */
+interface QASession {
+    id: string;
+    projectId: string;
+    testerId: string;
+    /** Area being explored */
+    focusArea?: string;
+    /** QA track focus */
+    track?: string;
+    /** Platform being tested */
+    platform?: string;
+    /** Timing */
+    startedAt: string;
+    endedAt?: string;
+    /** Session notes */
+    notes?: string;
+    /** Routes visited during session */
+    routesCovered: string[];
+    /** Status */
+    status: QASessionStatus;
+    /** Metrics */
+    durationMinutes?: number;
+    findingsCount: number;
+    bugsFiled: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** QA Finding - quick observation during a session */
+interface QAFinding {
+    id: string;
+    sessionId: string;
+    projectId: string;
+    /** Type of finding */
+    type: FindingType;
+    /** Severity level */
+    severity: FindingSeverity;
+    /** Content */
+    title: string;
+    description?: string;
+    /** Context (auto-captured) */
+    route?: string;
+    screenshotUrl?: string;
+    consoleLogs?: ConsoleLogEntry[];
+    networkSnapshot?: NetworkRequest[];
+    deviceInfo?: DeviceInfo;
+    appContext?: AppContext;
+    /** Conversion tracking */
+    convertedToBugId?: string;
+    convertedToTestId?: string;
+    /** Dismissal */
+    dismissed: boolean;
+    dismissedReason?: string;
+    dismissedAt?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Options for starting a QA session */
+interface StartSessionOptions {
+    focusArea?: string;
+    track?: string;
+    platform?: string;
+}
+/** Options for ending a QA session */
+interface EndSessionOptions {
+    notes?: string;
+    routesCovered?: string[];
+}
+/** Options for adding a finding */
+interface AddFindingOptions {
+    type: FindingType;
+    title: string;
+    description?: string;
+    severity?: FindingSeverity;
+    route?: string;
+    screenshotUrl?: string;
+    consoleLogs?: ConsoleLogEntry[];
+    networkSnapshot?: NetworkRequest[];
+    deviceInfo?: DeviceInfo;
+    appContext?: AppContext;
+}
 
 /**
  * BugBear Client
@@ -301,11 +601,69 @@ declare class BugBearClient {
      * First looks up the tester by email, then fetches their assignments
      */
     getAssignedTests(): Promise<TestAssignment[]>;
+    /**
+     * Get assignment by ID with time tracking fields
+     */
+    getAssignment(assignmentId: string): Promise<(TestAssignment & {
+        startedAt?: string;
+        durationSeconds?: number;
+    }) | null>;
+    /**
+     * Update assignment status with automatic time tracking
+     * - Sets started_at when status changes to 'in_progress'
+     * - Calculates duration_seconds when status changes to 'passed'/'failed'/'blocked'
+     * - Optionally include feedback when completing a test
+     */
+    updateAssignmentStatus(assignmentId: string, status: TestAssignment['status'], options?: {
+        notes?: string;
+        testResult?: TestResult;
+        /** Include feedback when completing the test */
+        feedback?: TestFeedback;
+    }): Promise<{
+        success: boolean;
+        error?: string;
+        durationSeconds?: number;
+    }>;
+    /**
+     * Submit feedback on a test case to help improve test quality
+     * This empowers testers to shape better tests over time
+     */
+    submitTestFeedback(options: SubmitFeedbackOptions): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get the currently active (in_progress) assignment for the tester
+     */
+    getActiveAssignment(): Promise<(TestAssignment & {
+        startedAt?: string;
+    }) | null>;
     /**
      * Get current tester info
      * Looks up tester by email from the host app's authenticated user
+     * Checks both primary email AND additional_emails array
+     * Uses parameterized RPC function to prevent SQL injection
      */
     getTesterInfo(): Promise<TesterInfo | null>;
+    /**
+     * Basic email format validation (defense in depth)
+     */
+    private isValidEmail;
+    /**
+     * Validate report input before submission
+     * Returns error message if invalid, null if valid
+     */
+    private validateReport;
+    /**
+     * Validate profile update input
+     * Returns error message if invalid, null if valid
+     */
+    private validateProfileUpdate;
+    /**
+     * Check rate limit for an action
+     * Returns { allowed: boolean, error?: string, remaining?: number }
+     */
+    private checkRateLimit;
     /**
      * Update tester profile
      * Allows testers to update their name, additional emails, avatar, and platforms
@@ -406,6 +764,69 @@ declare class BugBearClient {
         threadId?: string;
         error?: string;
     }>;
+    /**
+     * Start a new QA session for exploratory testing
+     */
+    startSession(options?: StartSessionOptions): Promise<{
+        success: boolean;
+        session?: QASession;
+        error?: string;
+    }>;
+    /**
+     * End the current QA session
+     */
+    endSession(sessionId: string, options?: EndSessionOptions): Promise<{
+        success: boolean;
+        session?: QASession;
+        error?: string;
+    }>;
+    /**
+     * Get the current active session for the tester
+     */
+    getActiveSession(): Promise<QASession | null>;
+    /**
+     * Get a session by ID
+     */
+    getSession(sessionId: string): Promise<QASession | null>;
+    /**
+     * Get session history for the tester
+     */
+    getSessionHistory(limit?: number): Promise<QASession[]>;
+    /**
+     * Add a finding during a session
+     */
+    addFinding(sessionId: string, options: AddFindingOptions): Promise<{
+        success: boolean;
+        finding?: QAFinding;
+        error?: string;
+    }>;
+    /**
+     * Get findings for a session
+     */
+    getSessionFindings(sessionId: string): Promise<QAFinding[]>;
+    /**
+     * Convert a finding to a bug report
+     */
+    convertFindingToBug(findingId: string): Promise<{
+        success: boolean;
+        bugId?: string;
+        error?: string;
+    }>;
+    /**
+     * Dismiss a finding
+     */
+    dismissFinding(findingId: string, reason?: string): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Transform database session to QASession type
+     */
+    private transformSession;
+    /**
+     * Transform database finding to QAFinding type
+     */
+    private transformFinding;
 }
 /**
  * Create a BugBear client instance
@@ -467,4 +888,4 @@ declare function captureError(error: Error, errorInfo?: {
     componentStack?: string;
 };
 
-export { type AppContext, BugBearClient, type BugBearConfig, type BugBearReport, type BugBearTheme, type ChecklistResult, type ConsoleLogEntry, type DeviceInfo, type EnhancedBugContext, type HostUserInfo, type MessageSenderType, type NetworkRequest, type QATrack, type ReportStatus, type ReportType, type RubricMode, type RubricResult, type Severity, type TestAssignment, 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 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 StartSessionOptions, type SubmitFeedbackOptions, type TestAssignment, type TestFeedback, type TestResult, type TestStep, type TestTemplate, type TesterInfo, type TesterMessage, type TesterProfileUpdate, type TesterThread, type ThreadPriority, type ThreadType, captureError, contextCapture, createBugBear };