@mulingai-npm/redis 3.40.14 → 3.40.16

package/dist/managers/mulingstream-speaker-manager.d.ts

@@ -11,6 +11,7 @@ export type MulingstreamSpeakerData = {
     recordingsDuration: number;
     targetLanguages: string[];
     timestamp: string;
+    lastHeartbeat?: number;
     isDemoSession?: boolean;
     demoExpiresAt?: number;
 };
@@ -37,6 +38,17 @@ export declare class MulingstreamSpeakerManager {
     getSpeakersLength(roomId: string): Promise<number>;
     isRoomEmpty(roomId: string): Promise<boolean>;
     updateSourceLanguage(socketId: string, newLang: string): Promise<boolean>;
+    /**
+     * Update lastHeartbeat timestamp for a speaker (called on every HEARTBEAT event from frontend).
+     * Returns the updated speaker, or null if not found.
+     * Mirrors MulingstreamListenerManager.updateHeartbeat — see MULINGSTREAM_RELIABILITY_ROADMAP.md §0.2.
+     */
+    updateHeartbeat(speakerId: string): Promise<MulingstreamSpeakerData | null>;
+    /**
+     * Update socketId for a speaker (called by heartbeat self-heal when reconnect creates a new socket).
+     * Mirrors the listener-side self-heal pattern — see MULINGSTREAM_RELIABILITY_ROADMAP.md §0.2.
+     */
+    updateSocketId(speakerId: string, newSocketId: string): Promise<boolean>;
     updateTargetLanguages(socketId: string, languages: string[]): Promise<boolean>;
     updateSourceLanguageByRoomId(roomId: string, newLang: string): Promise<number>;
     updateTargetLanguagesByRoomId(roomId: string, languages: string[]): Promise<number>;

package/dist/managers/mulingstream-speaker-manager.js

@@ -33,6 +33,7 @@ class MulingstreamSpeakerManager {
             recordingsDuration: parseInt(hash.recordingsDuration, 10) || 0,
             targetLanguages: JSON.parse(hash.targetLanguages || '[]'),
             timestamp: hash.timestamp,
+            lastHeartbeat: hash.lastHeartbeat ? parseInt(hash.lastHeartbeat, 10) : undefined,
             isDemoSession: hash.isDemoSession === 'true',
             demoExpiresAt: parseInt(hash.demoExpiresAt, 10) || 0
         };
@@ -50,9 +51,12 @@ class MulingstreamSpeakerManager {
             targetLanguages: JSON.stringify(data.targetLanguages),
             timestamp: data.timestamp
         };
-        if (data.roomUuid) {
+        if (data.roomUuid !== undefined) {
             result.roomUuid = data.roomUuid;
         }
+        if (data.lastHeartbeat !== undefined) {
+            result.lastHeartbeat = data.lastHeartbeat.toString();
+        }
         if (data.isDemoSession) {
             result.isDemoSession = 'true';
         }
@@ -202,6 +206,30 @@ class MulingstreamSpeakerManager {
         await this.redisClient.hset(this.buildKey(speaker.speakerId), { sourceLanguage: newLang });
         return true;
     }
+    /**
+     * Update lastHeartbeat timestamp for a speaker (called on every HEARTBEAT event from frontend).
+     * Returns the updated speaker, or null if not found.
+     * Mirrors MulingstreamListenerManager.updateHeartbeat — see MULINGSTREAM_RELIABILITY_ROADMAP.md §0.2.
+     */
+    async updateHeartbeat(speakerId) {
+        const speaker = await this.getSpeakerBySpeakerId(speakerId);
+        if (speaker === null)
+            return null;
+        const now = Date.now();
+        await this.redisClient.hset(this.buildKey(speakerId), { lastHeartbeat: now.toString() });
+        return { ...speaker, lastHeartbeat: now };
+    }
+    /**
+     * Update socketId for a speaker (called by heartbeat self-heal when reconnect creates a new socket).
+     * Mirrors the listener-side self-heal pattern — see MULINGSTREAM_RELIABILITY_ROADMAP.md §0.2.
+     */
+    async updateSocketId(speakerId, newSocketId) {
+        const speaker = await this.getSpeakerBySpeakerId(speakerId);
+        if (speaker === null)
+            return false;
+        await this.redisClient.hset(this.buildKey(speakerId), { socketId: newSocketId });
+        return true;
+    }
     async updateTargetLanguages(socketId, languages) {
         const speaker = await this.getSpeakerBySocketId(socketId);
         if (speaker === null)

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mulingai-npm/redis",
-    "version": "3.40.14",
+    "version": "3.40.16",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "repository": {