@bbearai/core 0.2.11 → 0.2.13

package/README.md

@@ -2,7 +2,7 @@
 
 Core client and utilities for BugBear QA platform.
 
-> **Note:** Most users should install `@bbearai/react` instead, which includes this package automatically.
+> **Note:** Most users should install `@bbearai/react` or `@bbearai/react-native` instead, which include this package automatically.
 
 ## Installation
 
@@ -20,6 +20,7 @@ const bugbear = createBugBear({
   getCurrentUser: async () => ({
     id: 'user-123',
     email: 'user@example.com',
+    name: 'Jane Doe', // Optional, used for reporter identity
   }),
 });
 
@@ -28,6 +29,7 @@ await bugbear.submitReport({
   type: 'bug',
   description: 'Button does not work',
   severity: 'high',
+  appContext: { currentRoute: '/dashboard' },
 });
 
 // Check if user is a tester
@@ -37,13 +39,84 @@ const isTester = await bugbear.isTester();
 const assignments = await bugbear.getAssignedTests();
 ```
 
-## API Reference
+## Configuration
 
-### createBugBear(config)
+```typescript
+interface BugBearConfig {
+  // Required
+  projectId: string;
+  getCurrentUser: () => Promise<{ id: string; email: string; name?: string } | null>;
+
+  // Optional — context
+  getAppContext?: () => AppContext;          // Rich app context (userRole, etc.)
+  getNavigationHistory?: () => string[];    // Custom navigation tracking
+
+  // Optional — callbacks
+  onReportSubmitted?: (report: BugBearReport) => void;
+  onNavigate?: (route: string) => void;     // Deep linking from test cases
+
+  // Optional — self-hosted
+  supabaseUrl?: string;
+  supabaseAnonKey?: string;
+}
+```
+
+### AppContext
+
+Provide `getAppContext` to attach rich context to every bug report. This helps the developer fixing the bug understand the user's state:
+
+```typescript
+const bugbear = createBugBear({
+  projectId: 'your-project-id',
+  getCurrentUser: async () => ({ id: user.id, email: user.email }),
+  getAppContext: () => ({
+    currentRoute: window.location.pathname,
+    userRole: currentUser?.role,       // e.g. 'owner', 'manager', 'guest'
+    propertyId: currentProperty?.id,   // App-specific context
+    custom: {                          // Any additional context
+      theme: 'dark',
+      locale: 'en-US',
+    },
+  }),
+});
+```
+
+## Automatic Context Capture
+
+BugBear automatically captures debugging context when initialized via `BugBearProvider` (React or React Native). No manual setup required.
 
-Creates a BugBear client instance.
+**What's captured automatically:**
 
-### Client Methods
+| Data | Details |
+|------|---------|
+| **Console logs** | Last 50 `console.log/warn/error/info` calls |
+| **Network requests** | Last 20 `fetch()` calls with method, URL, status, duration |
+| **Failed response bodies** | First 500 chars of response body for 4xx/5xx errors |
+| **Navigation history** | Last 20 route changes (via `pushState`/`replaceState`/`popstate`) |
+| **Performance metrics** | Page load time, memory usage (Chrome) |
+| **Environment** | Language, timezone, online status, cookies, localStorage |
+
+This data is attached to every bug report as `enhanced_context` and is available to the MCP server's `get_report_context` tool.
+
+### Manual Capture (framework authors)
+
+If you're not using `BugBearProvider`, start capture manually:
+
+```typescript
+import { contextCapture } from '@bbearai/core';
+
+// Start capturing (call once at app init)
+contextCapture.startCapture();
+
+// For React Native: manually track screen changes
+contextCapture.trackNavigation('/home');
+contextCapture.trackNavigation('/settings');
+
+// Get captured data (automatically included in submitReport)
+const context = contextCapture.getEnhancedContext();
+```
+
+## Client Methods
 
 | Method | Description |
 |--------|-------------|
@@ -53,7 +126,9 @@ Creates a BugBear client instance.
 | `shouldShowWidget()` | Check if widget should be visible (QA enabled + is tester) |
 | `getTesterInfo()` | Get current tester's info |
 | `getAssignedTests()` | Get test cases assigned to current tester |
-| `trackNavigation(route)` | Track navigation for context |
+| `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 |
 | `uploadScreenshot(file)` | Upload a screenshot |
 
 ## Types
@@ -66,7 +141,15 @@ interface BugBearReport {
   severity?: 'critical' | 'high' | 'medium' | 'low';
   screenshots?: string[];
   appContext?: AppContext;
-  // ... and more
+  enhancedContext?: EnhancedBugContext;
+}
+
+interface AppContext {
+  currentRoute: string;
+  screenName?: string;
+  userRole?: string;
+  propertyId?: string;
+  custom?: Record<string, unknown>;
 }
 
 interface TesterInfo {
@@ -96,7 +179,11 @@ interface TestAssignment {
 If you're building a BugBear integration for a different framework (Vue, Svelte, etc.), use this package as the foundation:
 
 ```typescript
-import { BugBearClient, createBugBear, BugBearConfig } from '@bbearai/core';
+import { BugBearClient, createBugBear, contextCapture, BugBearConfig } from '@bbearai/core';
+
+// Start context capture at app init
+contextCapture.startCapture();
 
 // Create your framework-specific wrapper around the client
+const client = createBugBear(config);
 ```

package/dist/index.d.mts

@@ -39,6 +39,8 @@ interface NetworkRequest {
     duration?: number;
     timestamp: string;
     error?: string;
+    /** Truncated response body for failed requests (4xx/5xx) */
+    responseBody?: string;
 }
 /** Enhanced bug context for detailed debugging */
 interface EnhancedBugContext {
@@ -46,6 +48,8 @@ interface EnhancedBugContext {
     consoleLogs?: ConsoleLogEntry[];
     /** Recent network requests (last 20) */
     networkRequests?: NetworkRequest[];
+    /** Auto-captured navigation history (last 20 route changes) */
+    navigationHistory?: string[];
     /** Current Redux/state snapshot (serialized) */
     stateSnapshot?: Record<string, unknown>;
     /** Performance metrics */
@@ -602,13 +606,20 @@ declare class BugBearClient {
     private navigationHistory;
     constructor(config: BugBearConfig);
     /**
-     * Track navigation for context
+     * Track navigation for context.
+     * Also forwards to contextCapture for auto-tracked navigation.
      */
     trackNavigation(route: string): void;
     /**
-     * Get current navigation history
+     * Get current navigation history.
+     * Priority: config callback > manual tracking > auto-captured (pushState/popstate)
      */
     getNavigationHistory(): string[];
+    /**
+     * Get current app context.
+     * Uses config.getAppContext() callback if provided, otherwise builds from available data.
+     */
+    getAppContext(): AppContext;
     /**
      * Get current user info from host app or BugBear's own auth
      */
@@ -651,11 +662,30 @@ declare class BugBearClient {
         error?: string;
         durationSeconds?: number;
     }>;
+    /**
+     * Pass a test assignment — convenience wrapper around updateAssignmentStatus
+     */
+    passAssignment(assignmentId: string): Promise<{
+        success: boolean;
+        error?: string;
+        durationSeconds?: number;
+    }>;
+    /**
+     * Fail a test assignment — convenience wrapper around updateAssignmentStatus
+     */
+    failAssignment(assignmentId: string): Promise<{
+        success: boolean;
+        error?: string;
+        durationSeconds?: number;
+    }>;
     /**
      * Skip a test assignment with a required reason
      * Marks the assignment as 'skipped' and records why it was skipped
      */
-    skipAssignment(assignmentId: string, reason: SkipReason, notes?: string): Promise<{
+    skipAssignment(assignmentId: string, reason: SkipReason | {
+        reason: SkipReason;
+        notes?: string;
+    }, notes?: string): Promise<{
         success: boolean;
         error?: string;
     }>;
@@ -892,16 +922,21 @@ declare function createBugBear(config: BugBearConfig): BugBearClient;
  */
 
 /**
- * Context capture singleton that captures console logs and network requests
+ * Context capture singleton that captures console logs, network requests,
+ * and navigation history automatically.
  */
 declare class ContextCaptureManager {
     private consoleLogs;
     private networkRequests;
+    private navigationHistory;
     private originalConsole;
     private originalFetch?;
+    private originalPushState?;
+    private originalReplaceState?;
+    private popstateHandler?;
     private isCapturing;
     /**
-     * Start capturing console logs and network requests
+     * Start capturing console logs, network requests, and navigation
      */
     startCapture(): void;
     /**
@@ -912,6 +947,18 @@ declare class ContextCaptureManager {
      * Get captured context for a bug report
      */
     getEnhancedContext(): EnhancedBugContext;
+    /**
+     * Get the auto-captured navigation history
+     */
+    getNavigationHistory(): string[];
+    /**
+     * Get the current route (last entry in navigation history, or window.location)
+     */
+    getCurrentRoute(): string;
+    /**
+     * Manually track a navigation event (for React Native or custom routing)
+     */
+    trackNavigation(route: string): void;
     /**
      * Clear captured data
      */
@@ -926,6 +973,7 @@ declare class ContextCaptureManager {
     addNetworkRequest(request: NetworkRequest): void;
     private captureConsole;
     private captureFetch;
+    private captureNavigation;
     private getPerformanceMetrics;
     private getEnvironmentInfo;
 }

package/dist/index.d.ts

@@ -39,6 +39,8 @@ interface NetworkRequest {
     duration?: number;
     timestamp: string;
     error?: string;
+    /** Truncated response body for failed requests (4xx/5xx) */
+    responseBody?: string;
 }
 /** Enhanced bug context for detailed debugging */
 interface EnhancedBugContext {
@@ -46,6 +48,8 @@ interface EnhancedBugContext {
     consoleLogs?: ConsoleLogEntry[];
     /** Recent network requests (last 20) */
     networkRequests?: NetworkRequest[];
+    /** Auto-captured navigation history (last 20 route changes) */
+    navigationHistory?: string[];
     /** Current Redux/state snapshot (serialized) */
     stateSnapshot?: Record<string, unknown>;
     /** Performance metrics */
@@ -602,13 +606,20 @@ declare class BugBearClient {
     private navigationHistory;
     constructor(config: BugBearConfig);
     /**
-     * Track navigation for context
+     * Track navigation for context.
+     * Also forwards to contextCapture for auto-tracked navigation.
      */
     trackNavigation(route: string): void;
     /**
-     * Get current navigation history
+     * Get current navigation history.
+     * Priority: config callback > manual tracking > auto-captured (pushState/popstate)
      */
     getNavigationHistory(): string[];
+    /**
+     * Get current app context.
+     * Uses config.getAppContext() callback if provided, otherwise builds from available data.
+     */
+    getAppContext(): AppContext;
     /**
      * Get current user info from host app or BugBear's own auth
      */
@@ -651,11 +662,30 @@ declare class BugBearClient {
         error?: string;
         durationSeconds?: number;
     }>;
+    /**
+     * Pass a test assignment — convenience wrapper around updateAssignmentStatus
+     */
+    passAssignment(assignmentId: string): Promise<{
+        success: boolean;
+        error?: string;
+        durationSeconds?: number;
+    }>;
+    /**
+     * Fail a test assignment — convenience wrapper around updateAssignmentStatus
+     */
+    failAssignment(assignmentId: string): Promise<{
+        success: boolean;
+        error?: string;
+        durationSeconds?: number;
+    }>;
     /**
      * Skip a test assignment with a required reason
      * Marks the assignment as 'skipped' and records why it was skipped
      */
-    skipAssignment(assignmentId: string, reason: SkipReason, notes?: string): Promise<{
+    skipAssignment(assignmentId: string, reason: SkipReason | {
+        reason: SkipReason;
+        notes?: string;
+    }, notes?: string): Promise<{
         success: boolean;
         error?: string;
     }>;
@@ -892,16 +922,21 @@ declare function createBugBear(config: BugBearConfig): BugBearClient;
  */
 
 /**
- * Context capture singleton that captures console logs and network requests
+ * Context capture singleton that captures console logs, network requests,
+ * and navigation history automatically.
  */
 declare class ContextCaptureManager {
     private consoleLogs;
     private networkRequests;
+    private navigationHistory;
     private originalConsole;
     private originalFetch?;
+    private originalPushState?;
+    private originalReplaceState?;
+    private popstateHandler?;
     private isCapturing;
     /**
-     * Start capturing console logs and network requests
+     * Start capturing console logs, network requests, and navigation
      */
     startCapture(): void;
     /**
@@ -912,6 +947,18 @@ declare class ContextCaptureManager {
      * Get captured context for a bug report
      */
     getEnhancedContext(): EnhancedBugContext;
+    /**
+     * Get the auto-captured navigation history
+     */
+    getNavigationHistory(): string[];
+    /**
+     * Get the current route (last entry in navigation history, or window.location)
+     */
+    getCurrentRoute(): string;
+    /**
+     * Manually track a navigation event (for React Native or custom routing)
+     */
+    trackNavigation(route: string): void;
     /**
      * Clear captured data
      */
@@ -926,6 +973,7 @@ declare class ContextCaptureManager {
     addNetworkRequest(request: NetworkRequest): void;
     private captureConsole;
     private captureFetch;
+    private captureNavigation;
     private getPerformanceMetrics;
     private getEnvironmentInfo;
 }

package/dist/index.js

@@ -33,21 +33,25 @@ var import_supabase_js = require("@supabase/supabase-js");
 // src/capture.ts
 var MAX_CONSOLE_LOGS = 50;
 var MAX_NETWORK_REQUESTS = 20;
+var MAX_NAVIGATION_HISTORY = 20;
+var MAX_RESPONSE_BODY_LENGTH = 500;
 var ContextCaptureManager = class {
   constructor() {
     this.consoleLogs = [];
     this.networkRequests = [];
+    this.navigationHistory = [];
     this.originalConsole = {};
     this.isCapturing = false;
   }
   /**
-   * Start capturing console logs and network requests
+   * Start capturing console logs, network requests, and navigation
    */
   startCapture() {
     if (this.isCapturing) return;
     this.isCapturing = true;
     this.captureConsole();
     this.captureFetch();
+    this.captureNavigation();
   }
   /**
    * Stop capturing and restore original functions
@@ -62,6 +66,17 @@ var ContextCaptureManager = class {
     if (this.originalFetch && typeof window !== "undefined") {
       window.fetch = this.originalFetch;
     }
+    if (typeof window !== "undefined" && typeof history !== "undefined") {
+      if (this.originalPushState) {
+        history.pushState = this.originalPushState;
+      }
+      if (this.originalReplaceState) {
+        history.replaceState = this.originalReplaceState;
+      }
+      if (this.popstateHandler) {
+        window.removeEventListener("popstate", this.popstateHandler);
+      }
+    }
   }
   /**
    * Get captured context for a bug report
@@ -70,16 +85,47 @@ var ContextCaptureManager = class {
     return {
       consoleLogs: [...this.consoleLogs],
       networkRequests: [...this.networkRequests],
+      navigationHistory: [...this.navigationHistory],
       performanceMetrics: this.getPerformanceMetrics(),
       environment: this.getEnvironmentInfo()
     };
   }
+  /**
+   * Get the auto-captured navigation history
+   */
+  getNavigationHistory() {
+    return [...this.navigationHistory];
+  }
+  /**
+   * Get the current route (last entry in navigation history, or window.location)
+   */
+  getCurrentRoute() {
+    if (this.navigationHistory.length > 0) {
+      return this.navigationHistory[this.navigationHistory.length - 1];
+    }
+    if (typeof window !== "undefined") {
+      return window.location.pathname;
+    }
+    return "unknown";
+  }
+  /**
+   * Manually track a navigation event (for React Native or custom routing)
+   */
+  trackNavigation(route) {
+    const last = this.navigationHistory[this.navigationHistory.length - 1];
+    if (route === last) return;
+    this.navigationHistory.push(route);
+    if (this.navigationHistory.length > MAX_NAVIGATION_HISTORY) {
+      this.navigationHistory.shift();
+    }
+  }
   /**
    * Clear captured data
    */
   clear() {
     this.consoleLogs = [];
     this.networkRequests = [];
+    this.navigationHistory = [];
   }
   /**
    * Add a log entry manually (for custom logging)
@@ -136,14 +182,25 @@ var ContextCaptureManager = class {
       const method = init?.method || "GET";
       try {
         const response = await self.originalFetch.call(window, input, init);
-        self.addNetworkRequest({
+        const requestEntry = {
           method,
           url: url.slice(0, 200),
           // Limit URL length
           status: response.status,
           duration: Date.now() - startTime,
           timestamp: (/* @__PURE__ */ new Date()).toISOString()
-        });
+        };
+        if (response.status >= 400) {
+          try {
+            const cloned = response.clone();
+            const body = await cloned.text();
+            if (body) {
+              requestEntry.responseBody = body.slice(0, MAX_RESPONSE_BODY_LENGTH);
+            }
+          } catch {
+          }
+        }
+        self.addNetworkRequest(requestEntry);
         return response;
       } catch (error) {
         self.addNetworkRequest({
@@ -157,6 +214,25 @@ var ContextCaptureManager = class {
       }
     };
   }
+  captureNavigation() {
+    if (typeof window === "undefined" || typeof history === "undefined") return;
+    this.trackNavigation(window.location.pathname);
+    const self = this;
+    this.originalPushState = history.pushState;
+    history.pushState = function(...args) {
+      self.originalPushState.apply(history, args);
+      self.trackNavigation(window.location.pathname);
+    };
+    this.originalReplaceState = history.replaceState;
+    history.replaceState = function(...args) {
+      self.originalReplaceState.apply(history, args);
+      self.trackNavigation(window.location.pathname);
+    };
+    this.popstateHandler = () => {
+      self.trackNavigation(window.location.pathname);
+    };
+    window.addEventListener("popstate", this.popstateHandler);
+  }
   getPerformanceMetrics() {
     if (typeof window === "undefined" || typeof performance === "undefined") return void 0;
     const metrics = {};
@@ -218,22 +294,40 @@ var BugBearClient = class {
     );
   }
   /**
-   * Track navigation for context
+   * Track navigation for context.
+   * Also forwards to contextCapture for auto-tracked navigation.
    */
   trackNavigation(route) {
     this.navigationHistory.push(route);
     if (this.navigationHistory.length > 10) {
       this.navigationHistory.shift();
     }
+    contextCapture.trackNavigation(route);
   }
   /**
-   * Get current navigation history
+   * Get current navigation history.
+   * Priority: config callback > manual tracking > auto-captured (pushState/popstate)
    */
   getNavigationHistory() {
     if (this.config.getNavigationHistory) {
       return this.config.getNavigationHistory();
     }
-    return [...this.navigationHistory];
+    if (this.navigationHistory.length > 0) {
+      return [...this.navigationHistory];
+    }
+    return contextCapture.getNavigationHistory();
+  }
+  /**
+   * Get current app context.
+   * Uses config.getAppContext() callback if provided, otherwise builds from available data.
+   */
+  getAppContext() {
+    if (this.config.getAppContext) {
+      return this.config.getAppContext();
+    }
+    return {
+      currentRoute: contextCapture.getCurrentRoute()
+    };
   }
   /**
    * Get current user info from host app or BugBear's own auth
@@ -536,19 +630,40 @@ var BugBearClient = class {
       return { success: false, error: message };
     }
   }
+  /**
+   * Pass a test assignment — convenience wrapper around updateAssignmentStatus
+   */
+  async passAssignment(assignmentId) {
+    return this.updateAssignmentStatus(assignmentId, "passed");
+  }
+  /**
+   * Fail a test assignment — convenience wrapper around updateAssignmentStatus
+   */
+  async failAssignment(assignmentId) {
+    return this.updateAssignmentStatus(assignmentId, "failed");
+  }
   /**
    * Skip a test assignment with a required reason
    * Marks the assignment as 'skipped' and records why it was skipped
    */
   async skipAssignment(assignmentId, reason, notes) {
+    let actualReason;
+    let actualNotes;
+    if (typeof reason === "object") {
+      actualReason = reason.reason;
+      actualNotes = reason.notes;
+    } else {
+      actualReason = reason;
+      actualNotes = notes;
+    }
     try {
       const updateData = {
         status: "skipped",
-        skip_reason: reason,
+        skip_reason: actualReason,
         completed_at: (/* @__PURE__ */ new Date()).toISOString()
       };
-      if (notes) {
-        updateData.notes = notes;
+      if (actualNotes) {
+        updateData.notes = actualNotes;
       }
       const { error } = await this.supabase.from("test_assignments").update(updateData).eq("id", assignmentId);
       if (error) {

package/dist/index.mjs

@@ -4,21 +4,25 @@ import { createClient } from "@supabase/supabase-js";
 // src/capture.ts
 var MAX_CONSOLE_LOGS = 50;
 var MAX_NETWORK_REQUESTS = 20;
+var MAX_NAVIGATION_HISTORY = 20;
+var MAX_RESPONSE_BODY_LENGTH = 500;
 var ContextCaptureManager = class {
   constructor() {
     this.consoleLogs = [];
     this.networkRequests = [];
+    this.navigationHistory = [];
     this.originalConsole = {};
     this.isCapturing = false;
   }
   /**
-   * Start capturing console logs and network requests
+   * Start capturing console logs, network requests, and navigation
    */
   startCapture() {
     if (this.isCapturing) return;
     this.isCapturing = true;
     this.captureConsole();
     this.captureFetch();
+    this.captureNavigation();
   }
   /**
    * Stop capturing and restore original functions
@@ -33,6 +37,17 @@ var ContextCaptureManager = class {
     if (this.originalFetch && typeof window !== "undefined") {
       window.fetch = this.originalFetch;
     }
+    if (typeof window !== "undefined" && typeof history !== "undefined") {
+      if (this.originalPushState) {
+        history.pushState = this.originalPushState;
+      }
+      if (this.originalReplaceState) {
+        history.replaceState = this.originalReplaceState;
+      }
+      if (this.popstateHandler) {
+        window.removeEventListener("popstate", this.popstateHandler);
+      }
+    }
   }
   /**
    * Get captured context for a bug report
@@ -41,16 +56,47 @@ var ContextCaptureManager = class {
     return {
       consoleLogs: [...this.consoleLogs],
       networkRequests: [...this.networkRequests],
+      navigationHistory: [...this.navigationHistory],
       performanceMetrics: this.getPerformanceMetrics(),
       environment: this.getEnvironmentInfo()
     };
   }
+  /**
+   * Get the auto-captured navigation history
+   */
+  getNavigationHistory() {
+    return [...this.navigationHistory];
+  }
+  /**
+   * Get the current route (last entry in navigation history, or window.location)
+   */
+  getCurrentRoute() {
+    if (this.navigationHistory.length > 0) {
+      return this.navigationHistory[this.navigationHistory.length - 1];
+    }
+    if (typeof window !== "undefined") {
+      return window.location.pathname;
+    }
+    return "unknown";
+  }
+  /**
+   * Manually track a navigation event (for React Native or custom routing)
+   */
+  trackNavigation(route) {
+    const last = this.navigationHistory[this.navigationHistory.length - 1];
+    if (route === last) return;
+    this.navigationHistory.push(route);
+    if (this.navigationHistory.length > MAX_NAVIGATION_HISTORY) {
+      this.navigationHistory.shift();
+    }
+  }
   /**
    * Clear captured data
    */
   clear() {
     this.consoleLogs = [];
     this.networkRequests = [];
+    this.navigationHistory = [];
   }
   /**
    * Add a log entry manually (for custom logging)
@@ -107,14 +153,25 @@ var ContextCaptureManager = class {
       const method = init?.method || "GET";
       try {
         const response = await self.originalFetch.call(window, input, init);
-        self.addNetworkRequest({
+        const requestEntry = {
           method,
           url: url.slice(0, 200),
           // Limit URL length
           status: response.status,
           duration: Date.now() - startTime,
           timestamp: (/* @__PURE__ */ new Date()).toISOString()
-        });
+        };
+        if (response.status >= 400) {
+          try {
+            const cloned = response.clone();
+            const body = await cloned.text();
+            if (body) {
+              requestEntry.responseBody = body.slice(0, MAX_RESPONSE_BODY_LENGTH);
+            }
+          } catch {
+          }
+        }
+        self.addNetworkRequest(requestEntry);
         return response;
       } catch (error) {
         self.addNetworkRequest({
@@ -128,6 +185,25 @@ var ContextCaptureManager = class {
       }
     };
   }
+  captureNavigation() {
+    if (typeof window === "undefined" || typeof history === "undefined") return;
+    this.trackNavigation(window.location.pathname);
+    const self = this;
+    this.originalPushState = history.pushState;
+    history.pushState = function(...args) {
+      self.originalPushState.apply(history, args);
+      self.trackNavigation(window.location.pathname);
+    };
+    this.originalReplaceState = history.replaceState;
+    history.replaceState = function(...args) {
+      self.originalReplaceState.apply(history, args);
+      self.trackNavigation(window.location.pathname);
+    };
+    this.popstateHandler = () => {
+      self.trackNavigation(window.location.pathname);
+    };
+    window.addEventListener("popstate", this.popstateHandler);
+  }
   getPerformanceMetrics() {
     if (typeof window === "undefined" || typeof performance === "undefined") return void 0;
     const metrics = {};
@@ -189,22 +265,40 @@ var BugBearClient = class {
     );
   }
   /**
-   * Track navigation for context
+   * Track navigation for context.
+   * Also forwards to contextCapture for auto-tracked navigation.
    */
   trackNavigation(route) {
     this.navigationHistory.push(route);
     if (this.navigationHistory.length > 10) {
       this.navigationHistory.shift();
     }
+    contextCapture.trackNavigation(route);
   }
   /**
-   * Get current navigation history
+   * Get current navigation history.
+   * Priority: config callback > manual tracking > auto-captured (pushState/popstate)
    */
   getNavigationHistory() {
     if (this.config.getNavigationHistory) {
       return this.config.getNavigationHistory();
     }
-    return [...this.navigationHistory];
+    if (this.navigationHistory.length > 0) {
+      return [...this.navigationHistory];
+    }
+    return contextCapture.getNavigationHistory();
+  }
+  /**
+   * Get current app context.
+   * Uses config.getAppContext() callback if provided, otherwise builds from available data.
+   */
+  getAppContext() {
+    if (this.config.getAppContext) {
+      return this.config.getAppContext();
+    }
+    return {
+      currentRoute: contextCapture.getCurrentRoute()
+    };
   }
   /**
    * Get current user info from host app or BugBear's own auth
@@ -507,19 +601,40 @@ var BugBearClient = class {
       return { success: false, error: message };
     }
   }
+  /**
+   * Pass a test assignment — convenience wrapper around updateAssignmentStatus
+   */
+  async passAssignment(assignmentId) {
+    return this.updateAssignmentStatus(assignmentId, "passed");
+  }
+  /**
+   * Fail a test assignment — convenience wrapper around updateAssignmentStatus
+   */
+  async failAssignment(assignmentId) {
+    return this.updateAssignmentStatus(assignmentId, "failed");
+  }
   /**
    * Skip a test assignment with a required reason
    * Marks the assignment as 'skipped' and records why it was skipped
    */
   async skipAssignment(assignmentId, reason, notes) {
+    let actualReason;
+    let actualNotes;
+    if (typeof reason === "object") {
+      actualReason = reason.reason;
+      actualNotes = reason.notes;
+    } else {
+      actualReason = reason;
+      actualNotes = notes;
+    }
     try {
       const updateData = {
         status: "skipped",
-        skip_reason: reason,
+        skip_reason: actualReason,
         completed_at: (/* @__PURE__ */ new Date()).toISOString()
       };
-      if (notes) {
-        updateData.notes = notes;
+      if (actualNotes) {
+        updateData.notes = actualNotes;
       }
       const { error } = await this.supabase.from("test_assignments").update(updateData).eq("id", assignmentId);
       if (error) {

package/package.json

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