@bbearai/core 0.7.2 → 0.8.1

package/dist/index.d.mts

@@ -377,6 +377,8 @@ interface TestAssignment {
     startedAt?: string;
     /** Duration in seconds (calculated when completed) */
     durationSeconds?: number;
+    /** Active time in seconds, computed from presence heartbeats */
+    activeSeconds?: number;
     /** Whether this is a verification assignment for a fixed bug */
     isVerification?: boolean;
     /** Original report ID if this is a verification assignment */
@@ -479,6 +481,7 @@ interface TesterThread {
     createdAt: string;
     unreadCount: number;
     lastMessage?: TesterMessage;
+    reporterName?: string;
 }
 interface TesterMessage {
     id: string;
@@ -788,6 +791,14 @@ interface TesterIssue {
     originalBugId?: string;
     /** Original bug title (for reopened/test_fail issues) */
     originalBugTitle?: string;
+    /** Resolution notes from the developer (for ready_to_test issues) */
+    resolutionNotes?: string;
+    /** Fix commit SHA (for ready_to_test issues) */
+    fixCommitSha?: string;
+    /** Fix commit message */
+    fixCommitMessage?: string;
+    /** Files changed in the fix */
+    fixFilesChanged?: string[];
 }
 /** Delivery status for captured emails */
 type EmailDeliveryStatus = 'pending' | 'sent' | 'delivered' | 'bounced' | 'dropped' | 'deferred';
@@ -1102,6 +1113,12 @@ declare class BugBearClient {
     private initialized;
     /** Initialization error, if any. */
     private initError;
+    /** Active presence session ID (passive time tracking). */
+    private _presenceSessionId;
+    /** Heartbeat interval for presence tracking. */
+    private _presenceInterval;
+    /** Whether presence is paused (tab hidden / app backgrounded). */
+    private _presencePaused;
     constructor(config: BugBearConfig);
     /** Whether the client is ready for requests. */
     get isReady(): boolean;
@@ -1561,6 +1578,22 @@ declare class BugBearClient {
      * Transform database finding to QAFinding type
      */
     private transformFinding;
+    /** Current presence session ID (null if not tracking). */
+    get presenceSessionId(): string | null;
+    /**
+     * Start passive presence tracking for this tester.
+     * Idempotent — reuses an existing active session if one exists.
+     */
+    startPresence(platform: 'web' | 'ios' | 'android'): Promise<string | null>;
+    /** Gracefully end the current presence session. */
+    endPresence(): Promise<void>;
+    /** Pause heartbeat (tab hidden / app backgrounded). Sends one final beat. */
+    pausePresence(): void;
+    /** Resume heartbeat after pause. Restarts if session was cleaned up. */
+    resumePresence(): Promise<void>;
+    private heartbeatPresence;
+    private startPresenceHeartbeat;
+    private stopPresenceHeartbeat;
 }
 /**
  * Create a BugBear client instance

package/dist/index.d.ts

@@ -377,6 +377,8 @@ interface TestAssignment {
     startedAt?: string;
     /** Duration in seconds (calculated when completed) */
     durationSeconds?: number;
+    /** Active time in seconds, computed from presence heartbeats */
+    activeSeconds?: number;
     /** Whether this is a verification assignment for a fixed bug */
     isVerification?: boolean;
     /** Original report ID if this is a verification assignment */
@@ -479,6 +481,7 @@ interface TesterThread {
     createdAt: string;
     unreadCount: number;
     lastMessage?: TesterMessage;
+    reporterName?: string;
 }
 interface TesterMessage {
     id: string;
@@ -788,6 +791,14 @@ interface TesterIssue {
     originalBugId?: string;
     /** Original bug title (for reopened/test_fail issues) */
     originalBugTitle?: string;
+    /** Resolution notes from the developer (for ready_to_test issues) */
+    resolutionNotes?: string;
+    /** Fix commit SHA (for ready_to_test issues) */
+    fixCommitSha?: string;
+    /** Fix commit message */
+    fixCommitMessage?: string;
+    /** Files changed in the fix */
+    fixFilesChanged?: string[];
 }
 /** Delivery status for captured emails */
 type EmailDeliveryStatus = 'pending' | 'sent' | 'delivered' | 'bounced' | 'dropped' | 'deferred';
@@ -1102,6 +1113,12 @@ declare class BugBearClient {
     private initialized;
     /** Initialization error, if any. */
     private initError;
+    /** Active presence session ID (passive time tracking). */
+    private _presenceSessionId;
+    /** Heartbeat interval for presence tracking. */
+    private _presenceInterval;
+    /** Whether presence is paused (tab hidden / app backgrounded). */
+    private _presencePaused;
     constructor(config: BugBearConfig);
     /** Whether the client is ready for requests. */
     get isReady(): boolean;
@@ -1561,6 +1578,22 @@ declare class BugBearClient {
      * Transform database finding to QAFinding type
      */
     private transformFinding;
+    /** Current presence session ID (null if not tracking). */
+    get presenceSessionId(): string | null;
+    /**
+     * Start passive presence tracking for this tester.
+     * Idempotent — reuses an existing active session if one exists.
+     */
+    startPresence(platform: 'web' | 'ios' | 'android'): Promise<string | null>;
+    /** Gracefully end the current presence session. */
+    endPresence(): Promise<void>;
+    /** Pause heartbeat (tab hidden / app backgrounded). Sends one final beat. */
+    pausePresence(): void;
+    /** Resume heartbeat after pause. Restarts if session was cleaned up. */
+    resumePresence(): Promise<void>;
+    private heartbeatPresence;
+    private startPresenceHeartbeat;
+    private stopPresenceHeartbeat;
 }
 /**
  * Create a BugBear client instance

package/dist/index.js

@@ -914,6 +914,12 @@ var BugBearClient = class {
     this.initialized = false;
     /** Initialization error, if any. */
     this.initError = null;
+    /** Active presence session ID (passive time tracking). */
+    this._presenceSessionId = null;
+    /** Heartbeat interval for presence tracking. */
+    this._presenceInterval = null;
+    /** Whether presence is paused (tab hidden / app backgrounded). */
+    this._presencePaused = false;
     this.config = config;
     if (config.apiKey) {
       this.pendingInit = this.resolveFromApiKey(config.apiKey);
@@ -1469,55 +1475,66 @@ var BugBearClient = class {
         ...pendingResult.data || [],
         ...completedResult.data || []
       ];
-      const mapItem = (item) => ({
-        id: item.id,
-        status: item.status,
-        startedAt: item.started_at,
-        skipReason: item.skip_reason,
-        isVerification: item.is_verification || false,
-        originalReportId: item.original_report_id,
-        testCase: {
-          id: item.test_case.id,
-          title: item.test_case.title,
-          testKey: item.test_case.test_key,
-          description: item.test_case.description,
-          steps: item.test_case.steps,
-          expectedResult: item.test_case.expected_result,
-          priority: item.test_case.priority,
-          targetRoute: item.test_case.target_route,
-          track: item.test_case.track ? {
-            id: item.test_case.track.id,
-            name: item.test_case.track.name,
-            icon: item.test_case.track.icon,
-            color: item.test_case.track.color,
-            testTemplate: item.test_case.track.test_template,
-            rubricMode: item.test_case.track.rubric_mode || "pass_fail",
-            description: item.test_case.track.description
-          } : void 0,
-          group: item.test_case.group ? {
-            id: item.test_case.group.id,
-            name: item.test_case.group.name,
-            description: item.test_case.group.description,
-            sortOrder: item.test_case.group.sort_order
-          } : void 0,
-          role: item.test_case.role ? {
-            id: item.test_case.role.id,
-            name: item.test_case.role.name,
-            slug: item.test_case.role.slug,
-            color: item.test_case.role.color,
-            description: item.test_case.role.description,
-            loginHint: item.test_case.role.login_hint
-          } : void 0,
-          platforms: item.test_case.platforms || void 0
-        }
-      });
-      const mapped = allData.filter((item) => {
-        if (!item.test_case) {
-          console.warn("BugBear: Assignment returned without test_case", { id: item.id });
-          return false;
-        }
-        return true;
-      }).map(mapItem);
+      const mapItem = (item) => {
+        const tc = item.test_case;
+        return {
+          id: item.id,
+          status: item.status,
+          startedAt: item.started_at,
+          skipReason: item.skip_reason,
+          isVerification: item.is_verification || false,
+          originalReportId: item.original_report_id,
+          testCase: tc ? {
+            id: tc.id,
+            title: tc.title,
+            testKey: tc.test_key,
+            description: tc.description,
+            steps: tc.steps,
+            expectedResult: tc.expected_result,
+            priority: tc.priority,
+            targetRoute: tc.target_route,
+            track: tc.track ? {
+              id: tc.track.id,
+              name: tc.track.name,
+              icon: tc.track.icon,
+              color: tc.track.color,
+              testTemplate: tc.track.test_template,
+              rubricMode: tc.track.rubric_mode || "pass_fail",
+              description: tc.track.description
+            } : void 0,
+            group: tc.group ? {
+              id: tc.group.id,
+              name: tc.group.name,
+              description: tc.group.description,
+              sortOrder: tc.group.sort_order
+            } : void 0,
+            role: tc.role ? {
+              id: tc.role.id,
+              name: tc.role.name,
+              slug: tc.role.slug,
+              color: tc.role.color,
+              description: tc.role.description,
+              loginHint: tc.role.login_hint
+            } : void 0,
+            platforms: tc.platforms || void 0
+          } : {
+            // Standalone verification assignment (bug reported without a test case)
+            id: item.original_report_id || item.id,
+            title: item.notes || "Bug Verification",
+            testKey: "VERIFY",
+            description: "Verify that the reported bug has been fixed",
+            steps: [],
+            expectedResult: "The bug should no longer be reproducible",
+            priority: "P1",
+            targetRoute: void 0,
+            track: void 0,
+            group: void 0,
+            role: void 0,
+            platforms: void 0
+          }
+        };
+      };
+      const mapped = allData.map(mapItem);
       mapped.sort((a, b) => {
         if (a.isVerification && !b.isVerification) return -1;
         if (!a.isVerification && b.isVerification) return 1;
@@ -1611,7 +1628,7 @@ var BugBearClient = class {
   async updateAssignmentStatus(assignmentId, status, options) {
     try {
       await this.ensureReady();
-      const { data: currentAssignment, error: fetchError } = await this.supabase.from("test_assignments").select("status, started_at").eq("id", assignmentId).single();
+      const { data: currentAssignment, error: fetchError } = await this.supabase.from("test_assignments").select("status, started_at, tester_id, project_id").eq("id", assignmentId).single();
       if (fetchError || !currentAssignment) {
         console.error("BugBear: Assignment not found", {
           message: fetchError?.message,
@@ -1632,6 +1649,19 @@ var BugBearClient = class {
           const completedAt = /* @__PURE__ */ new Date();
           durationSeconds = Math.round((completedAt.getTime() - startedAt.getTime()) / 1e3);
           updateData.duration_seconds = durationSeconds;
+          if (currentAssignment.tester_id && currentAssignment.project_id) {
+            try {
+              const { data: activeTime } = await this.supabase.rpc("compute_assignment_active_time", {
+                p_tester_id: currentAssignment.tester_id,
+                p_project_id: currentAssignment.project_id,
+                p_started_at: currentAssignment.started_at,
+                p_completed_at: updateData.completed_at
+              });
+              updateData.active_seconds = typeof activeTime === "number" ? activeTime : Math.min(durationSeconds, 1800);
+            } catch {
+              updateData.active_seconds = Math.min(durationSeconds, 1800);
+            }
+          }
         }
       }
       if (options?.notes) {
@@ -1710,6 +1740,7 @@ var BugBearClient = class {
         started_at: (/* @__PURE__ */ new Date()).toISOString(),
         completed_at: null,
         duration_seconds: null,
+        active_seconds: null,
         skip_reason: null
       }).eq("id", assignmentId).eq("status", current.status);
       if (error) {
@@ -2017,7 +2048,11 @@ var BugBearClient = class {
         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
+        originalBugTitle: row.original_bug_title || void 0,
+        resolutionNotes: row.resolution_notes || void 0,
+        fixCommitSha: row.code_context?.fix?.commit_sha || void 0,
+        fixCommitMessage: row.code_context?.fix?.commit_message || void 0,
+        fixFilesChanged: row.code_context?.fix?.files_changed || void 0
       }));
     } catch (err) {
       console.error("BugBear: Error fetching issues", err);
@@ -2559,6 +2594,7 @@ var BugBearClient = class {
         lastMessageAt: row.last_message_at,
         createdAt: row.created_at,
         unreadCount: Number(row.unread_count) || 0,
+        reporterName: row.reporter_name || void 0,
         lastMessage: row.last_message_preview ? {
           id: "",
           threadId: row.thread_id,
@@ -2998,6 +3034,93 @@ var BugBearClient = class {
       updatedAt: data.updated_at
     };
   }
+  // ─── Passive Presence Tracking ──────────────────────────────
+  /** Current presence session ID (null if not tracking). */
+  get presenceSessionId() {
+    return this._presenceSessionId;
+  }
+  /**
+   * Start passive presence tracking for this tester.
+   * Idempotent — reuses an existing active session if one exists.
+   */
+  async startPresence(platform) {
+    try {
+      await this.ensureReady();
+      const testerInfo = await this.getTesterInfo();
+      if (!testerInfo) return null;
+      const { data, error } = await this.supabase.rpc("upsert_tester_presence", {
+        p_project_id: this.config.projectId,
+        p_tester_id: testerInfo.id,
+        p_platform: platform
+      });
+      if (error) {
+        console.error("BugBear: Failed to start presence", formatPgError(error));
+        return null;
+      }
+      this._presenceSessionId = data;
+      this._presencePaused = false;
+      this.startPresenceHeartbeat();
+      return data;
+    } catch (err) {
+      console.error("BugBear: Error starting presence", err);
+      return null;
+    }
+  }
+  /** Gracefully end the current presence session. */
+  async endPresence() {
+    this.stopPresenceHeartbeat();
+    if (!this._presenceSessionId) return;
+    try {
+      await this.supabase.rpc("end_tester_presence", {
+        p_session_id: this._presenceSessionId
+      });
+    } catch {
+    }
+    this._presenceSessionId = null;
+  }
+  /** Pause heartbeat (tab hidden / app backgrounded). Sends one final beat. */
+  pausePresence() {
+    this._presencePaused = true;
+    this.heartbeatPresence();
+  }
+  /** Resume heartbeat after pause. Restarts if session was cleaned up. */
+  async resumePresence() {
+    if (!this._presenceSessionId) return;
+    this._presencePaused = false;
+    try {
+      const { data } = await this.supabase.rpc("heartbeat_tester_presence", {
+        p_session_id: this._presenceSessionId
+      });
+      if (!data) {
+        this._presenceSessionId = null;
+      }
+    } catch {
+      this._presenceSessionId = null;
+    }
+  }
+  async heartbeatPresence() {
+    if (!this._presenceSessionId || this._presencePaused) return;
+    try {
+      const { data, error } = await this.supabase.rpc("heartbeat_tester_presence", {
+        p_session_id: this._presenceSessionId
+      });
+      if (error || data === false) {
+        this.stopPresenceHeartbeat();
+        this._presenceSessionId = null;
+      }
+    } catch {
+    }
+  }
+  startPresenceHeartbeat() {
+    this.stopPresenceHeartbeat();
+    this._presenceInterval = setInterval(() => this.heartbeatPresence(), 6e4);
+  }
+  stopPresenceHeartbeat() {
+    if (this._presenceInterval) {
+      clearInterval(this._presenceInterval);
+      this._presenceInterval = null;
+    }
+  }
 };
 function createBugBear(config) {
   return new BugBearClient(config);

package/dist/index.mjs

@@ -868,6 +868,12 @@ var BugBearClient = class {
     this.initialized = false;
     /** Initialization error, if any. */
     this.initError = null;
+    /** Active presence session ID (passive time tracking). */
+    this._presenceSessionId = null;
+    /** Heartbeat interval for presence tracking. */
+    this._presenceInterval = null;
+    /** Whether presence is paused (tab hidden / app backgrounded). */
+    this._presencePaused = false;
     this.config = config;
     if (config.apiKey) {
       this.pendingInit = this.resolveFromApiKey(config.apiKey);
@@ -1423,55 +1429,66 @@ var BugBearClient = class {
         ...pendingResult.data || [],
         ...completedResult.data || []
       ];
-      const mapItem = (item) => ({
-        id: item.id,
-        status: item.status,
-        startedAt: item.started_at,
-        skipReason: item.skip_reason,
-        isVerification: item.is_verification || false,
-        originalReportId: item.original_report_id,
-        testCase: {
-          id: item.test_case.id,
-          title: item.test_case.title,
-          testKey: item.test_case.test_key,
-          description: item.test_case.description,
-          steps: item.test_case.steps,
-          expectedResult: item.test_case.expected_result,
-          priority: item.test_case.priority,
-          targetRoute: item.test_case.target_route,
-          track: item.test_case.track ? {
-            id: item.test_case.track.id,
-            name: item.test_case.track.name,
-            icon: item.test_case.track.icon,
-            color: item.test_case.track.color,
-            testTemplate: item.test_case.track.test_template,
-            rubricMode: item.test_case.track.rubric_mode || "pass_fail",
-            description: item.test_case.track.description
-          } : void 0,
-          group: item.test_case.group ? {
-            id: item.test_case.group.id,
-            name: item.test_case.group.name,
-            description: item.test_case.group.description,
-            sortOrder: item.test_case.group.sort_order
-          } : void 0,
-          role: item.test_case.role ? {
-            id: item.test_case.role.id,
-            name: item.test_case.role.name,
-            slug: item.test_case.role.slug,
-            color: item.test_case.role.color,
-            description: item.test_case.role.description,
-            loginHint: item.test_case.role.login_hint
-          } : void 0,
-          platforms: item.test_case.platforms || void 0
-        }
-      });
-      const mapped = allData.filter((item) => {
-        if (!item.test_case) {
-          console.warn("BugBear: Assignment returned without test_case", { id: item.id });
-          return false;
-        }
-        return true;
-      }).map(mapItem);
+      const mapItem = (item) => {
+        const tc = item.test_case;
+        return {
+          id: item.id,
+          status: item.status,
+          startedAt: item.started_at,
+          skipReason: item.skip_reason,
+          isVerification: item.is_verification || false,
+          originalReportId: item.original_report_id,
+          testCase: tc ? {
+            id: tc.id,
+            title: tc.title,
+            testKey: tc.test_key,
+            description: tc.description,
+            steps: tc.steps,
+            expectedResult: tc.expected_result,
+            priority: tc.priority,
+            targetRoute: tc.target_route,
+            track: tc.track ? {
+              id: tc.track.id,
+              name: tc.track.name,
+              icon: tc.track.icon,
+              color: tc.track.color,
+              testTemplate: tc.track.test_template,
+              rubricMode: tc.track.rubric_mode || "pass_fail",
+              description: tc.track.description
+            } : void 0,
+            group: tc.group ? {
+              id: tc.group.id,
+              name: tc.group.name,
+              description: tc.group.description,
+              sortOrder: tc.group.sort_order
+            } : void 0,
+            role: tc.role ? {
+              id: tc.role.id,
+              name: tc.role.name,
+              slug: tc.role.slug,
+              color: tc.role.color,
+              description: tc.role.description,
+              loginHint: tc.role.login_hint
+            } : void 0,
+            platforms: tc.platforms || void 0
+          } : {
+            // Standalone verification assignment (bug reported without a test case)
+            id: item.original_report_id || item.id,
+            title: item.notes || "Bug Verification",
+            testKey: "VERIFY",
+            description: "Verify that the reported bug has been fixed",
+            steps: [],
+            expectedResult: "The bug should no longer be reproducible",
+            priority: "P1",
+            targetRoute: void 0,
+            track: void 0,
+            group: void 0,
+            role: void 0,
+            platforms: void 0
+          }
+        };
+      };
+      const mapped = allData.map(mapItem);
       mapped.sort((a, b) => {
         if (a.isVerification && !b.isVerification) return -1;
         if (!a.isVerification && b.isVerification) return 1;
@@ -1565,7 +1582,7 @@ var BugBearClient = class {
   async updateAssignmentStatus(assignmentId, status, options) {
     try {
       await this.ensureReady();
-      const { data: currentAssignment, error: fetchError } = await this.supabase.from("test_assignments").select("status, started_at").eq("id", assignmentId).single();
+      const { data: currentAssignment, error: fetchError } = await this.supabase.from("test_assignments").select("status, started_at, tester_id, project_id").eq("id", assignmentId).single();
       if (fetchError || !currentAssignment) {
         console.error("BugBear: Assignment not found", {
           message: fetchError?.message,
@@ -1586,6 +1603,19 @@ var BugBearClient = class {
           const completedAt = /* @__PURE__ */ new Date();
           durationSeconds = Math.round((completedAt.getTime() - startedAt.getTime()) / 1e3);
           updateData.duration_seconds = durationSeconds;
+          if (currentAssignment.tester_id && currentAssignment.project_id) {
+            try {
+              const { data: activeTime } = await this.supabase.rpc("compute_assignment_active_time", {
+                p_tester_id: currentAssignment.tester_id,
+                p_project_id: currentAssignment.project_id,
+                p_started_at: currentAssignment.started_at,
+                p_completed_at: updateData.completed_at
+              });
+              updateData.active_seconds = typeof activeTime === "number" ? activeTime : Math.min(durationSeconds, 1800);
+            } catch {
+              updateData.active_seconds = Math.min(durationSeconds, 1800);
+            }
+          }
         }
       }
       if (options?.notes) {
@@ -1664,6 +1694,7 @@ var BugBearClient = class {
         started_at: (/* @__PURE__ */ new Date()).toISOString(),
         completed_at: null,
         duration_seconds: null,
+        active_seconds: null,
         skip_reason: null
       }).eq("id", assignmentId).eq("status", current.status);
       if (error) {
@@ -1971,7 +2002,11 @@ var BugBearClient = class {
         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
+        originalBugTitle: row.original_bug_title || void 0,
+        resolutionNotes: row.resolution_notes || void 0,
+        fixCommitSha: row.code_context?.fix?.commit_sha || void 0,
+        fixCommitMessage: row.code_context?.fix?.commit_message || void 0,
+        fixFilesChanged: row.code_context?.fix?.files_changed || void 0
       }));
     } catch (err) {
       console.error("BugBear: Error fetching issues", err);
@@ -2513,6 +2548,7 @@ var BugBearClient = class {
         lastMessageAt: row.last_message_at,
         createdAt: row.created_at,
         unreadCount: Number(row.unread_count) || 0,
+        reporterName: row.reporter_name || void 0,
         lastMessage: row.last_message_preview ? {
           id: "",
           threadId: row.thread_id,
@@ -2952,6 +2988,93 @@ var BugBearClient = class {
       updatedAt: data.updated_at
     };
   }
+  // ─── Passive Presence Tracking ──────────────────────────────
+  /** Current presence session ID (null if not tracking). */
+  get presenceSessionId() {
+    return this._presenceSessionId;
+  }
+  /**
+   * Start passive presence tracking for this tester.
+   * Idempotent — reuses an existing active session if one exists.
+   */
+  async startPresence(platform) {
+    try {
+      await this.ensureReady();
+      const testerInfo = await this.getTesterInfo();
+      if (!testerInfo) return null;
+      const { data, error } = await this.supabase.rpc("upsert_tester_presence", {
+        p_project_id: this.config.projectId,
+        p_tester_id: testerInfo.id,
+        p_platform: platform
+      });
+      if (error) {
+        console.error("BugBear: Failed to start presence", formatPgError(error));
+        return null;
+      }
+      this._presenceSessionId = data;
+      this._presencePaused = false;
+      this.startPresenceHeartbeat();
+      return data;
+    } catch (err) {
+      console.error("BugBear: Error starting presence", err);
+      return null;
+    }
+  }
+  /** Gracefully end the current presence session. */
+  async endPresence() {
+    this.stopPresenceHeartbeat();
+    if (!this._presenceSessionId) return;
+    try {
+      await this.supabase.rpc("end_tester_presence", {
+        p_session_id: this._presenceSessionId
+      });
+    } catch {
+    }
+    this._presenceSessionId = null;
+  }
+  /** Pause heartbeat (tab hidden / app backgrounded). Sends one final beat. */
+  pausePresence() {
+    this._presencePaused = true;
+    this.heartbeatPresence();
+  }
+  /** Resume heartbeat after pause. Restarts if session was cleaned up. */
+  async resumePresence() {
+    if (!this._presenceSessionId) return;
+    this._presencePaused = false;
+    try {
+      const { data } = await this.supabase.rpc("heartbeat_tester_presence", {
+        p_session_id: this._presenceSessionId
+      });
+      if (!data) {
+        this._presenceSessionId = null;
+      }
+    } catch {
+      this._presenceSessionId = null;
+    }
+  }
+  async heartbeatPresence() {
+    if (!this._presenceSessionId || this._presencePaused) return;
+    try {
+      const { data, error } = await this.supabase.rpc("heartbeat_tester_presence", {
+        p_session_id: this._presenceSessionId
+      });
+      if (error || data === false) {
+        this.stopPresenceHeartbeat();
+        this._presenceSessionId = null;
+      }
+    } catch {
+    }
+  }
+  startPresenceHeartbeat() {
+    this.stopPresenceHeartbeat();
+    this._presenceInterval = setInterval(() => this.heartbeatPresence(), 6e4);
+  }
+  stopPresenceHeartbeat() {
+    if (this._presenceInterval) {
+      clearInterval(this._presenceInterval);
+      this._presenceInterval = null;
+    }
+  }
 };
 function createBugBear(config) {
   return new BugBearClient(config);

package/package.json

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