@bbearai/core 0.9.6 → 0.9.8

package/dist/index.d.mts

@@ -413,6 +413,16 @@ interface TestAssignment {
     isVerification?: boolean;
     /** Original report ID if this is a verification assignment */
     originalReportId?: string;
+    /** Original bug report data (populated for verification assignments) */
+    originalReport?: {
+        id: string;
+        title: string;
+        description: string;
+        severity: Severity | null;
+        screenshotUrls: string[];
+        resolutionNotes?: string;
+        route?: string;
+    };
 }
 interface TestStep {
     stepNumber: number;
@@ -1280,6 +1290,30 @@ declare class BugBearClient {
         queued?: boolean;
         error?: string;
     }>;
+    /**
+     * Submit feedback about the BugBear widget itself.
+     * Sends to BugBear's own internal project via a dedicated API endpoint.
+     */
+    submitWidgetFeedback(feedback: {
+        description: string;
+        type: 'bug' | 'feedback' | 'suggestion';
+        severity?: Severity;
+        title?: string;
+        screenshots?: string[];
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get a pre-authenticated dashboard URL for the given tester email.
+     * Uses a server-generated magic link that bypasses the login page.
+     * Falls back to raw dashboardUrl when no API key is configured.
+     */
+    getDashboardLoginUrl(email: string): Promise<{
+        success: boolean;
+        loginUrl?: string;
+        error?: string;
+    }>;
     /**
      * Capture an email for QA testing.
      * Called by the email interceptor — not typically called directly.

package/dist/index.d.ts

@@ -413,6 +413,16 @@ interface TestAssignment {
     isVerification?: boolean;
     /** Original report ID if this is a verification assignment */
     originalReportId?: string;
+    /** Original bug report data (populated for verification assignments) */
+    originalReport?: {
+        id: string;
+        title: string;
+        description: string;
+        severity: Severity | null;
+        screenshotUrls: string[];
+        resolutionNotes?: string;
+        route?: string;
+    };
 }
 interface TestStep {
     stepNumber: number;
@@ -1280,6 +1290,30 @@ declare class BugBearClient {
         queued?: boolean;
         error?: string;
     }>;
+    /**
+     * Submit feedback about the BugBear widget itself.
+     * Sends to BugBear's own internal project via a dedicated API endpoint.
+     */
+    submitWidgetFeedback(feedback: {
+        description: string;
+        type: 'bug' | 'feedback' | 'suggestion';
+        severity?: Severity;
+        title?: string;
+        screenshots?: string[];
+    }): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * Get a pre-authenticated dashboard URL for the given tester email.
+     * Uses a server-generated magic link that bypasses the login page.
+     * Falls back to raw dashboardUrl when no API key is configured.
+     */
+    getDashboardLoginUrl(email: string): Promise<{
+        success: boolean;
+        loginUrl?: string;
+        error?: string;
+    }>;
     /**
      * Capture an email for QA testing.
      * Called by the email interceptor — not typically called directly.

package/dist/index.js

@@ -1417,6 +1417,80 @@ var BugBearClient = class {
       this.reportSubmitInFlight = false;
     }
   }
+  /**
+   * Submit feedback about the BugBear widget itself.
+   * Sends to BugBear's own internal project via a dedicated API endpoint.
+   */
+  async submitWidgetFeedback(feedback) {
+    try {
+      await this.ready();
+      const baseUrl = (this.config.apiBaseUrl || DEFAULT_API_BASE_URL).replace(/\/$/, "");
+      const testerInfo = await this.getTesterInfo();
+      const response = await fetch(`${baseUrl}/api/v1/widget-feedback`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...this.config.apiKey ? { "Authorization": `Bearer ${this.config.apiKey}` } : {}
+        },
+        body: JSON.stringify({
+          description: feedback.description,
+          type: feedback.type,
+          severity: feedback.severity,
+          title: feedback.title,
+          screenshots: feedback.screenshots,
+          deviceInfo: this.getDeviceInfo(),
+          appContext: this.getAppContext(),
+          reporterName: testerInfo?.name || null,
+          reporterEmail: testerInfo?.email || null
+        })
+      });
+      if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        return { success: false, error: body.error || `HTTP ${response.status}` };
+      }
+      return { success: true };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Widget feedback submission failed";
+      return { success: false, error: message };
+    }
+  }
+  /**
+   * Get a pre-authenticated dashboard URL for the given tester email.
+   * Uses a server-generated magic link that bypasses the login page.
+   * Falls back to raw dashboardUrl when no API key is configured.
+   */
+  async getDashboardLoginUrl(email) {
+    try {
+      if (!this.config.apiKey) {
+        const fallback = this.config.dashboardUrl;
+        if (fallback) return { success: true, loginUrl: fallback };
+        return { success: false, error: "API key required for auto-login" };
+      }
+      await this.ready();
+      const baseUrl = (this.config.apiBaseUrl || DEFAULT_API_BASE_URL).replace(/\/$/, "");
+      const response = await fetch(`${baseUrl}/api/v1/auth/widget-login`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this.config.apiKey}`
+        },
+        body: JSON.stringify({ email })
+      });
+      if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        return { success: false, error: body.error || `HTTP ${response.status}` };
+      }
+      const result = await response.json();
+      const loginUrl = result?.data?.loginUrl;
+      if (!loginUrl) {
+        return { success: false, error: "No login URL in response" };
+      }
+      return { success: true, loginUrl };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to get dashboard login URL";
+      return { success: false, error: message };
+    }
+  }
   /**
    * Capture an email for QA testing.
    * Called by the email interceptor — not typically called directly.
@@ -1475,6 +1549,15 @@ var BugBearClient = class {
           is_verification,
           original_report_id,
           notes,
+          original_report:reports(
+            id,
+            title,
+            description,
+            severity,
+            screenshot_urls,
+            resolution_notes,
+            app_context
+          ),
           test_case:test_cases(
             id,
             title,
@@ -1524,6 +1607,16 @@ var BugBearClient = class {
       ];
       const mapItem = (item) => {
         const tc = item.test_case;
+        const rpt = item.original_report;
+        const originalReport = rpt ? {
+          id: rpt.id,
+          title: rpt.title,
+          description: rpt.description,
+          severity: rpt.severity,
+          screenshotUrls: rpt.screenshot_urls || [],
+          resolutionNotes: rpt.resolution_notes || void 0,
+          route: rpt.app_context?.currentRoute || void 0
+        } : void 0;
         return {
           id: item.id,
           status: item.status,
@@ -1531,6 +1624,7 @@ var BugBearClient = class {
           skipReason: item.skip_reason,
           isVerification: item.is_verification || false,
           originalReportId: item.original_report_id,
+          originalReport,
           testCase: tc ? {
             id: tc.id,
             title: tc.title,
@@ -1565,15 +1659,15 @@ var BugBearClient = class {
             } : void 0,
             platforms: tc.platforms || void 0
           } : {
-            // Standalone verification assignment (bug reported without a test case)
+            // Standalone verification — use original report data when available
             id: item.original_report_id || item.id,
-            title: item.notes?.replace(/^Verification:\s*/i, "") || "Bug Verification",
+            title: rpt?.title || (item.notes?.replace(/^Verification:\s*/i, "") || "Bug Verification"),
             testKey: "VERIFY",
-            description: "Verify that the reported bug has been fixed",
+            description: rpt?.description || "Verify that the reported bug has been fixed",
             steps: [],
             expectedResult: "The bug should no longer be reproducible",
             priority: "P1",
-            targetRoute: void 0,
+            targetRoute: rpt?.app_context?.currentRoute || void 0,
             track: void 0,
             group: void 0,
             role: void 0,
@@ -1609,6 +1703,18 @@ var BugBearClient = class {
           started_at,
           completed_at,
           duration_seconds,
+          is_verification,
+          original_report_id,
+          notes,
+          original_report:reports(
+            id,
+            title,
+            description,
+            severity,
+            screenshot_urls,
+            resolution_notes,
+            app_context
+          ),
           test_case:test_cases(
             id,
             title,
@@ -1631,17 +1737,30 @@ var BugBearClient = class {
         `).eq("id", assignmentId).single();
       if (error || !data) return null;
       const testCase = data.test_case;
-      if (!testCase) {
+      const rpt = data.original_report;
+      const originalReport = rpt ? {
+        id: rpt.id,
+        title: rpt.title,
+        description: rpt.description,
+        severity: rpt.severity,
+        screenshotUrls: rpt.screenshot_urls || [],
+        resolutionNotes: rpt.resolution_notes || void 0,
+        route: rpt.app_context?.currentRoute || void 0
+      } : void 0;
+      if (!testCase && !data.is_verification) {
         console.error("BugBear: Assignment returned without test_case");
         return null;
       }
-      const track = testCase.track;
+      const track = testCase?.track;
       return {
         id: data.id,
         status: data.status,
         startedAt: data.started_at,
         durationSeconds: data.duration_seconds,
-        testCase: {
+        isVerification: data.is_verification || false,
+        originalReportId: data.original_report_id,
+        originalReport,
+        testCase: testCase ? {
           id: testCase.id,
           title: testCase.title,
           testKey: testCase.test_key,
@@ -1659,6 +1778,16 @@ var BugBearClient = class {
             rubricMode: track.rubric_mode || "pass_fail",
             description: track.description
           } : void 0
+        } : {
+          id: data.original_report_id || data.id,
+          title: rpt?.title || (data.notes?.replace(/^Verification:\s*/i, "") || "Bug Verification"),
+          testKey: "VERIFY",
+          description: rpt?.description || "Verify that the reported bug has been fixed",
+          steps: [],
+          expectedResult: "The bug should no longer be reproducible",
+          priority: "P1",
+          targetRoute: rpt?.app_context?.currentRoute || void 0,
+          track: void 0
         }
       };
     } catch (err) {

package/dist/index.mjs

@@ -1371,6 +1371,80 @@ var BugBearClient = class {
       this.reportSubmitInFlight = false;
     }
   }
+  /**
+   * Submit feedback about the BugBear widget itself.
+   * Sends to BugBear's own internal project via a dedicated API endpoint.
+   */
+  async submitWidgetFeedback(feedback) {
+    try {
+      await this.ready();
+      const baseUrl = (this.config.apiBaseUrl || DEFAULT_API_BASE_URL).replace(/\/$/, "");
+      const testerInfo = await this.getTesterInfo();
+      const response = await fetch(`${baseUrl}/api/v1/widget-feedback`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...this.config.apiKey ? { "Authorization": `Bearer ${this.config.apiKey}` } : {}
+        },
+        body: JSON.stringify({
+          description: feedback.description,
+          type: feedback.type,
+          severity: feedback.severity,
+          title: feedback.title,
+          screenshots: feedback.screenshots,
+          deviceInfo: this.getDeviceInfo(),
+          appContext: this.getAppContext(),
+          reporterName: testerInfo?.name || null,
+          reporterEmail: testerInfo?.email || null
+        })
+      });
+      if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        return { success: false, error: body.error || `HTTP ${response.status}` };
+      }
+      return { success: true };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Widget feedback submission failed";
+      return { success: false, error: message };
+    }
+  }
+  /**
+   * Get a pre-authenticated dashboard URL for the given tester email.
+   * Uses a server-generated magic link that bypasses the login page.
+   * Falls back to raw dashboardUrl when no API key is configured.
+   */
+  async getDashboardLoginUrl(email) {
+    try {
+      if (!this.config.apiKey) {
+        const fallback = this.config.dashboardUrl;
+        if (fallback) return { success: true, loginUrl: fallback };
+        return { success: false, error: "API key required for auto-login" };
+      }
+      await this.ready();
+      const baseUrl = (this.config.apiBaseUrl || DEFAULT_API_BASE_URL).replace(/\/$/, "");
+      const response = await fetch(`${baseUrl}/api/v1/auth/widget-login`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "Authorization": `Bearer ${this.config.apiKey}`
+        },
+        body: JSON.stringify({ email })
+      });
+      if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        return { success: false, error: body.error || `HTTP ${response.status}` };
+      }
+      const result = await response.json();
+      const loginUrl = result?.data?.loginUrl;
+      if (!loginUrl) {
+        return { success: false, error: "No login URL in response" };
+      }
+      return { success: true, loginUrl };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to get dashboard login URL";
+      return { success: false, error: message };
+    }
+  }
   /**
    * Capture an email for QA testing.
    * Called by the email interceptor — not typically called directly.
@@ -1429,6 +1503,15 @@ var BugBearClient = class {
           is_verification,
           original_report_id,
           notes,
+          original_report:reports(
+            id,
+            title,
+            description,
+            severity,
+            screenshot_urls,
+            resolution_notes,
+            app_context
+          ),
           test_case:test_cases(
             id,
             title,
@@ -1478,6 +1561,16 @@ var BugBearClient = class {
       ];
       const mapItem = (item) => {
         const tc = item.test_case;
+        const rpt = item.original_report;
+        const originalReport = rpt ? {
+          id: rpt.id,
+          title: rpt.title,
+          description: rpt.description,
+          severity: rpt.severity,
+          screenshotUrls: rpt.screenshot_urls || [],
+          resolutionNotes: rpt.resolution_notes || void 0,
+          route: rpt.app_context?.currentRoute || void 0
+        } : void 0;
         return {
           id: item.id,
           status: item.status,
@@ -1485,6 +1578,7 @@ var BugBearClient = class {
           skipReason: item.skip_reason,
           isVerification: item.is_verification || false,
           originalReportId: item.original_report_id,
+          originalReport,
           testCase: tc ? {
             id: tc.id,
             title: tc.title,
@@ -1519,15 +1613,15 @@ var BugBearClient = class {
             } : void 0,
             platforms: tc.platforms || void 0
           } : {
-            // Standalone verification assignment (bug reported without a test case)
+            // Standalone verification — use original report data when available
             id: item.original_report_id || item.id,
-            title: item.notes?.replace(/^Verification:\s*/i, "") || "Bug Verification",
+            title: rpt?.title || (item.notes?.replace(/^Verification:\s*/i, "") || "Bug Verification"),
             testKey: "VERIFY",
-            description: "Verify that the reported bug has been fixed",
+            description: rpt?.description || "Verify that the reported bug has been fixed",
             steps: [],
             expectedResult: "The bug should no longer be reproducible",
             priority: "P1",
-            targetRoute: void 0,
+            targetRoute: rpt?.app_context?.currentRoute || void 0,
             track: void 0,
             group: void 0,
             role: void 0,
@@ -1563,6 +1657,18 @@ var BugBearClient = class {
           started_at,
           completed_at,
           duration_seconds,
+          is_verification,
+          original_report_id,
+          notes,
+          original_report:reports(
+            id,
+            title,
+            description,
+            severity,
+            screenshot_urls,
+            resolution_notes,
+            app_context
+          ),
           test_case:test_cases(
             id,
             title,
@@ -1585,17 +1691,30 @@ var BugBearClient = class {
         `).eq("id", assignmentId).single();
       if (error || !data) return null;
       const testCase = data.test_case;
-      if (!testCase) {
+      const rpt = data.original_report;
+      const originalReport = rpt ? {
+        id: rpt.id,
+        title: rpt.title,
+        description: rpt.description,
+        severity: rpt.severity,
+        screenshotUrls: rpt.screenshot_urls || [],
+        resolutionNotes: rpt.resolution_notes || void 0,
+        route: rpt.app_context?.currentRoute || void 0
+      } : void 0;
+      if (!testCase && !data.is_verification) {
         console.error("BugBear: Assignment returned without test_case");
         return null;
       }
-      const track = testCase.track;
+      const track = testCase?.track;
       return {
         id: data.id,
         status: data.status,
         startedAt: data.started_at,
         durationSeconds: data.duration_seconds,
-        testCase: {
+        isVerification: data.is_verification || false,
+        originalReportId: data.original_report_id,
+        originalReport,
+        testCase: testCase ? {
           id: testCase.id,
           title: testCase.title,
           testKey: testCase.test_key,
@@ -1613,6 +1732,16 @@ var BugBearClient = class {
             rubricMode: track.rubric_mode || "pass_fail",
             description: track.description
           } : void 0
+        } : {
+          id: data.original_report_id || data.id,
+          title: rpt?.title || (data.notes?.replace(/^Verification:\s*/i, "") || "Bug Verification"),
+          testKey: "VERIFY",
+          description: rpt?.description || "Verify that the reported bug has been fixed",
+          steps: [],
+          expectedResult: "The bug should no longer be reproducible",
+          priority: "P1",
+          targetRoute: rpt?.app_context?.currentRoute || void 0,
+          track: void 0
         }
       };
     } catch (err) {

package/package.json

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