@mulingai-npm/redis 3.36.1 → 3.37.0

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

@@ -9,6 +9,7 @@ export type MulingstreamListenerData = {
     lastHeartbeat: number;
     language?: string;
     color?: string;
+    isListening?: boolean;
 };
 export declare class MulingstreamListenerManager {
     private redisClient;
@@ -29,4 +30,21 @@ export declare class MulingstreamListenerManager {
         languageBreakdown: Record<string, number>;
     }>;
     getListenerBySocketId(socketId: string): Promise<MulingstreamListenerData | null>;
+    /**
+     * Update the isListening state for a listener (audio play/pause).
+     */
+    setListeningState(listenerIdOrToken: string, isListening: boolean): Promise<MulingstreamListenerData | null>;
+    /**
+     * Returns unique languages that have at least one listener with isListening=true.
+     * Used by pipeline to determine which languages need TTS generation.
+     */
+    getLanguagesWithActiveListeners(roomId: string): Promise<string[]>;
+    /**
+     * Returns socket IDs for listeners of a language who have isListening=true (audio on).
+     */
+    getListeningSocketIdsByRoomLanguage(roomId: string, language: string): Promise<string[]>;
+    /**
+     * Returns socket IDs for listeners of a language who have isListening=false (audio off, reading text only).
+     */
+    getNonListeningSocketIdsByRoomLanguage(roomId: string, language: string): Promise<string[]>;
 }

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

@@ -45,7 +45,8 @@ class MulingstreamListenerManager {
             firstJoined: parseInt(data.firstJoined, 10),
             lastHeartbeat: parseInt(data.lastHeartbeat, 10),
             language: data.language || '',
-            color: data.color || ''
+            color: data.color || '',
+            isListening: data.isListening === 'true'
         };
     }
     // Creates a new listener.
@@ -69,7 +70,8 @@ class MulingstreamListenerManager {
             firstJoined: listenerData.firstJoined.toString(),
             lastHeartbeat: listenerData.lastHeartbeat.toString(),
             language: (_c = listenerData.language) !== null && _c !== void 0 ? _c : '',
-            color
+            color,
+            isListening: 'false'
         });
         // expire listener
         await this.redisClient.expire(`listener:${listenerId}`, EXPIRATION);
@@ -235,5 +237,56 @@ class MulingstreamListenerManager {
         }
         return null;
     }
+    /**
+     * Update the isListening state for a listener (audio play/pause).
+     */
+    async setListeningState(listenerIdOrToken, isListening) {
+        const listener = await this.getListener(listenerIdOrToken);
+        if (!listener) {
+            return null;
+        }
+        await this.redisClient.hset(`listener:${listener.listenerId}`, {
+            isListening: isListening.toString()
+        });
+        return { ...listener, isListening };
+    }
+    /**
+     * Returns unique languages that have at least one listener with isListening=true.
+     * Used by pipeline to determine which languages need TTS generation.
+     */
+    async getLanguagesWithActiveListeners(roomId) {
+        const listeners = await this.getListenersByRoom(roomId);
+        const languageCountMap = {};
+        for (const listener of listeners) {
+            if (!listener.language || !listener.language.trim())
+                continue;
+            if (!listener.isListening)
+                continue;
+            const lang = listener.language;
+            languageCountMap[lang] = (languageCountMap[lang] || 0) + 1;
+        }
+        const sortedEntries = Object.entries(languageCountMap).sort(([, countA], [, countB]) => countB - countA);
+        return sortedEntries.map(([language]) => language);
+    }
+    /**
+     * Returns socket IDs for listeners of a language who have isListening=true (audio on).
+     */
+    async getListeningSocketIdsByRoomLanguage(roomId, language) {
+        const listeners = await this.getListenersByRoom(roomId);
+        return listeners
+            .filter(l => l.language === language && l.isListening)
+            .map(l => l.socketId)
+            .filter((id) => !!id);
+    }
+    /**
+     * Returns socket IDs for listeners of a language who have isListening=false (audio off, reading text only).
+     */
+    async getNonListeningSocketIdsByRoomLanguage(roomId, language) {
+        const listeners = await this.getListenersByRoom(roomId);
+        return listeners
+            .filter(l => l.language === language && !l.isListening)
+            .map(l => l.socketId)
+            .filter((id) => !!id);
+    }
 }
 exports.MulingstreamListenerManager = MulingstreamListenerManager;

package/package.json

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