@bbearai/core 0.7.2 → 0.8.0

package/dist/index.d.mts

@@ -479,6 +479,7 @@ interface TesterThread {
     createdAt: string;
     unreadCount: number;
     lastMessage?: TesterMessage;
+    reporterName?: string;
 }
 interface TesterMessage {
     id: string;
@@ -1102,6 +1103,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 +1568,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

@@ -479,6 +479,7 @@ interface TesterThread {
     createdAt: string;
     unreadCount: number;
     lastMessage?: TesterMessage;
+    reporterName?: string;
 }
 interface TesterMessage {
     id: string;
@@ -1102,6 +1103,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 +1568,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);
@@ -2559,6 +2565,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 +3005,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);
@@ -2513,6 +2519,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 +2959,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.0",
   "description": "Core utilities and types for BugBear QA platform",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",