@mulingai-npm/redis 3.40.15 → 3.40.17

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;
 };
@@ -20,6 +21,13 @@ export declare class MulingstreamSpeakerManager {
     private buildLockKey;
     acquireRoomLock(roomId: string, socketId: string, ttl?: number): Promise<boolean>;
     releaseRoomLock(roomId: string, socketId: string): Promise<void>;
+    /**
+     * Force-delete the room lock regardless of which socket owns it. Used by the
+     * speaker-joining recovery path when the lock is orphaned (no speaker records
+     * exist for the room but the lock key remains because the previous process
+     * crashed after SETNX and before addSpeaker).
+     */
+    forceReleaseRoomLock(roomId: string): Promise<void>;
     private parseHash;
     private serialize;
     private buildId;
@@ -37,6 +45,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

@@ -20,6 +20,15 @@ class MulingstreamSpeakerManager {
             await this.redisClient.del(lockKey);
         }
     }
+    /**
+     * Force-delete the room lock regardless of which socket owns it. Used by the
+     * speaker-joining recovery path when the lock is orphaned (no speaker records
+     * exist for the room but the lock key remains because the previous process
+     * crashed after SETNX and before addSpeaker).
+     */
+    async forceReleaseRoomLock(roomId) {
+        await this.redisClient.del(this.buildLockKey(roomId));
+    }
     parseHash(hash) {
         return {
             speakerId: hash.speakerId,
@@ -33,6 +42,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
         };
@@ -53,6 +63,9 @@ class MulingstreamSpeakerManager {
         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 +215,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.15",
+    "version": "3.40.17",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
     "repository": {