@mulingai-npm/redis 3.4.1 → 3.5.0

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

@@ -1,29 +1,29 @@
-import { RedisClient } from '../redis-client';
-export type MulingstreamListenerData = {
-    listenerId: string;
-    roomId: string;
-    socketId?: string;
-    token: string;
-    name?: string;
-    firstJoined: number;
-    language?: string;
-    isActive?: boolean;
-};
-export declare class MulingstreamListenerManager {
-    private redisClient;
-    constructor(redisClient: RedisClient);
-    private parseHashData;
-    addListener(listenerData: Omit<MulingstreamListenerData, 'listenerId'>): Promise<string>;
-    getAllListeners(): Promise<MulingstreamListenerData[]>;
-    getListenersByRoom(roomId: string): Promise<MulingstreamListenerData[]>;
-    getListener(listenerIdOrToken: string): Promise<MulingstreamListenerData | null>;
-    removeListenerByToken(token: string): Promise<boolean>;
-    updateNameLanguage(listenerIdOrToken: string, name: string, language: string): Promise<boolean>;
-    updateSocketId(listenerIdOrToken: string, socketId: string): Promise<boolean>;
-    getTargetSocketIdsByRoomLanguage(roomId: string, language: string): Promise<string[]>;
-    /**
-     * Returns an array of unique languages for the given room, from highest frequency to lowest.
-     * If a listener has no language (empty string / undefined), it is ignored.
-     */
-    getUniqueLanguagesByRoom(roomId: string): Promise<string[]>;
-}
+import { RedisClient } from '../redis-client';
+export type MulingstreamListenerData = {
+    listenerId: string;
+    roomId: string;
+    socketId?: string;
+    token: string;
+    name?: string;
+    firstJoined: number;
+    language?: string;
+    isActive?: boolean;
+};
+export declare class MulingstreamListenerManager {
+    private redisClient;
+    constructor(redisClient: RedisClient);
+    private parseHashData;
+    addListener(listenerData: Omit<MulingstreamListenerData, 'listenerId'>): Promise<string>;
+    getAllListeners(): Promise<MulingstreamListenerData[]>;
+    getListenersByRoom(roomId: string): Promise<MulingstreamListenerData[]>;
+    getListener(listenerIdOrToken: string): Promise<MulingstreamListenerData | null>;
+    removeListenerByToken(token: string): Promise<boolean>;
+    updateNameLanguage(listenerIdOrToken: string, name: string, language: string): Promise<boolean>;
+    updateSocketId(listenerIdOrToken: string, socketId: string): Promise<boolean>;
+    getTargetSocketIdsByRoomLanguage(roomId: string, language: string): Promise<string[]>;
+    /**
+     * Returns an array of unique languages for the given room, from highest frequency to lowest.
+     * If a listener has no language (empty string / undefined), it is ignored.
+     */
+    getUniqueLanguagesByRoom(roomId: string): Promise<string[]>;
+}

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

@@ -1,169 +1,169 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MulingstreamListenerManager = void 0;
-const uuid_1 = require("uuid");
-const EXPIRATION = 24 * 60 * 60; // 24 hours in seconds
-class MulingstreamListenerManager {
-    constructor(redisClient) {
-        this.redisClient = redisClient;
-    }
-    parseHashData(data) {
-        return {
-            listenerId: data.listenerId,
-            roomId: data.roomId,
-            socketId: data.socketId || '',
-            token: data.token,
-            name: data.name || '',
-            firstJoined: parseInt(data.firstJoined, 10),
-            language: data.language || '',
-            isActive: data.isActive === 'true'
-        };
-    }
-    // Creates a new listener.
-    // -Generates a unique listenerId and adds it to the room's set.
-    // -Stores the listener data in a Redis hash under `listener:{listenerId}`.
-    async addListener(listenerData) {
-        var _a, _b, _c;
-        // You can combine roomId + uuid, or just a uuid, up to you:
-        const listenerId = `[${listenerData.roomId}]-[${(0, uuid_1.v4)()}]`;
-        // Add listenerId to the set for that room
-        await this.redisClient.sadd(`room:${listenerData.roomId}:listeners`, listenerId);
-        // Store listener data in a hash
-        await this.redisClient.hset(`listener:${listenerId}`, {
-            listenerId,
-            roomId: listenerData.roomId,
-            socketId: (_a = listenerData.socketId) !== null && _a !== void 0 ? _a : '',
-            token: listenerData.token,
-            name: (_b = listenerData.name) !== null && _b !== void 0 ? _b : '',
-            firstJoined: listenerData.firstJoined.toString(),
-            language: (_c = listenerData.language) !== null && _c !== void 0 ? _c : '',
-            isActive: 'true'
-        });
-        // expire listener
-        await this.redisClient.expire(`listener:${listenerId}`, EXPIRATION);
-        return listenerId;
-    }
-    async getAllListeners() {
-        // get all keys that match 'listener:*'
-        // TODO: if we have many keys, consider using SCAN instead of KEYS to avoid performance issues.
-        const keys = await this.redisClient.keys('listener:*');
-        if (!keys || keys.length === 0) {
-            return [];
-        }
-        // fetch each hash with HGETALL
-        const listeners = [];
-        for (const key of keys) {
-            const data = await this.redisClient.hgetall(key);
-            listeners.push(this.parseHashData(data));
-        }
-        return listeners;
-    }
-    async getListenersByRoom(roomId) {
-        // get the set of listener IDs
-        const listenerIds = await this.redisClient.smembers(`room:${roomId}:listeners`);
-        if (!listenerIds || listenerIds.length === 0) {
-            return [];
-        }
-        const listeners = [];
-        for (const id of listenerIds) {
-            // get hash data
-            const data = await this.redisClient.hgetall(`listener:${id}`);
-            // if the hash doesn't exist, it may have expired, so remove from the set
-            if (!data || Object.keys(data).length === 0) {
-                await this.redisClient.srem(`room:${roomId}:listeners`, id);
-                continue;
-            }
-            // otherwise, parse and keep it
-            listeners.push(this.parseHashData(data));
-        }
-        return listeners;
-    }
-    async getListener(listenerIdOrToken) {
-        // try direct lookup by listenerId:
-        const directData = await this.redisClient.hgetall(`listener:${listenerIdOrToken}`);
-        if (directData && directData.listenerId) {
-            return this.parseHashData(directData);
-        }
-        // if not found by listenerId, treat 'listenerIdOrToken' as a token and scan all listeners
-        const keys = await this.redisClient.keys('listener:*');
-        if (!keys || keys.length === 0) {
-            return null;
-        }
-        for (const key of keys) {
-            const data = await this.redisClient.hgetall(key);
-            if (data && data.token === listenerIdOrToken) {
-                return this.parseHashData(data);
-            }
-        }
-        return null;
-    }
-    async removeListenerByToken(token) {
-        // find the listener by token
-        const listener = await this.getListener(token);
-        if (!listener) {
-            return false;
-        }
-        // remove the listener ID from the room's set
-        await this.redisClient.srem(`room:${listener.roomId}:listeners`, listener.listenerId);
-        // remove the listener data (the hash)
-        await this.redisClient.del(`listener:${listener.listenerId}`);
-        return true;
-    }
-    async updateNameLanguage(listenerIdOrToken, name, language) {
-        const listener = await this.getListener(listenerIdOrToken);
-        if (!listener) {
-            return false;
-        }
-        // Update the name/language on the listener’s hash key
-        await this.redisClient.hset(`listener:${listener.listenerId}`, {
-            name,
-            language
-        });
-        return true;
-    }
-    async updateSocketId(listenerIdOrToken, socketId) {
-        const listener = await this.getListener(listenerIdOrToken);
-        if (!listener) {
-            return false;
-        }
-        // Update the name/language on the listener’s hash key
-        await this.redisClient.hset(`listener:${listener.listenerId}`, {
-            socketId
-        });
-        return true;
-    }
-    async getTargetSocketIdsByRoomLanguage(roomId, language) {
-        const listeners = await this.getListenersByRoom(roomId);
-        const filteredListeners = listeners.filter((listener) => {
-            return listener.isActive === true && listener.language === language && listener.socketId && listener.socketId.trim() !== '';
-        });
-        return filteredListeners.map((listener) => listener.socketId);
-    }
-    /**
-     * Returns an array of unique languages for the given room, from highest frequency to lowest.
-     * If a listener has no language (empty string / undefined), it is ignored.
-     */
-    async getUniqueLanguagesByRoom(roomId) {
-        // 1) Fetch all listeners for the room.
-        //    (This includes inactive ones, but feel free to filter out isActive === false if you only want active ones.)
-        const listeners = await this.getListenersByRoom(roomId);
-        // if I wanted to get only active listeners
-        // const listeners = (await this.getListenersByRoom(roomId)).filter(l => l.isActive);
-        // 2) Count how many times each language appears.
-        const languageCountMap = {};
-        for (const listener of listeners) {
-            // skip blank/unset language
-            if (!listener.language || !listener.language.trim()) {
-                continue;
-            }
-            // increment count
-            const lang = listener.language;
-            languageCountMap[lang] = (languageCountMap[lang] || 0) + 1;
-        }
-        // 3) Sort by frequency descending: highest count first
-        const sortedEntries = Object.entries(languageCountMap).sort(([, countA], [, countB]) => countB - countA);
-        // 4) Map back to just the language strings in order
-        return sortedEntries.map(([language]) => language);
-    }
-}
-exports.MulingstreamListenerManager = MulingstreamListenerManager;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MulingstreamListenerManager = void 0;
+const uuid_1 = require("uuid");
+const EXPIRATION = 24 * 60 * 60; // 24 hours in seconds
+class MulingstreamListenerManager {
+    constructor(redisClient) {
+        this.redisClient = redisClient;
+    }
+    parseHashData(data) {
+        return {
+            listenerId: data.listenerId,
+            roomId: data.roomId,
+            socketId: data.socketId || '',
+            token: data.token,
+            name: data.name || '',
+            firstJoined: parseInt(data.firstJoined, 10),
+            language: data.language || '',
+            isActive: data.isActive === 'true'
+        };
+    }
+    // Creates a new listener.
+    // -Generates a unique listenerId and adds it to the room's set.
+    // -Stores the listener data in a Redis hash under `listener:{listenerId}`.
+    async addListener(listenerData) {
+        var _a, _b, _c;
+        // You can combine roomId + uuid, or just a uuid, up to you:
+        const listenerId = `[${listenerData.roomId}]-[${(0, uuid_1.v4)()}]`;
+        // Add listenerId to the set for that room
+        await this.redisClient.sadd(`room:${listenerData.roomId}:listeners`, listenerId);
+        // Store listener data in a hash
+        await this.redisClient.hset(`listener:${listenerId}`, {
+            listenerId,
+            roomId: listenerData.roomId,
+            socketId: (_a = listenerData.socketId) !== null && _a !== void 0 ? _a : '',
+            token: listenerData.token,
+            name: (_b = listenerData.name) !== null && _b !== void 0 ? _b : '',
+            firstJoined: listenerData.firstJoined.toString(),
+            language: (_c = listenerData.language) !== null && _c !== void 0 ? _c : '',
+            isActive: 'true'
+        });
+        // expire listener
+        await this.redisClient.expire(`listener:${listenerId}`, EXPIRATION);
+        return listenerId;
+    }
+    async getAllListeners() {
+        // get all keys that match 'listener:*'
+        // TODO: if we have many keys, consider using SCAN instead of KEYS to avoid performance issues.
+        const keys = await this.redisClient.keys('listener:*');
+        if (!keys || keys.length === 0) {
+            return [];
+        }
+        // fetch each hash with HGETALL
+        const listeners = [];
+        for (const key of keys) {
+            const data = await this.redisClient.hgetall(key);
+            listeners.push(this.parseHashData(data));
+        }
+        return listeners;
+    }
+    async getListenersByRoom(roomId) {
+        // get the set of listener IDs
+        const listenerIds = await this.redisClient.smembers(`room:${roomId}:listeners`);
+        if (!listenerIds || listenerIds.length === 0) {
+            return [];
+        }
+        const listeners = [];
+        for (const id of listenerIds) {
+            // get hash data
+            const data = await this.redisClient.hgetall(`listener:${id}`);
+            // if the hash doesn't exist, it may have expired, so remove from the set
+            if (!data || Object.keys(data).length === 0) {
+                await this.redisClient.srem(`room:${roomId}:listeners`, id);
+                continue;
+            }
+            // otherwise, parse and keep it
+            listeners.push(this.parseHashData(data));
+        }
+        return listeners;
+    }
+    async getListener(listenerIdOrToken) {
+        // try direct lookup by listenerId:
+        const directData = await this.redisClient.hgetall(`listener:${listenerIdOrToken}`);
+        if (directData && directData.listenerId) {
+            return this.parseHashData(directData);
+        }
+        // if not found by listenerId, treat 'listenerIdOrToken' as a token and scan all listeners
+        const keys = await this.redisClient.keys('listener:*');
+        if (!keys || keys.length === 0) {
+            return null;
+        }
+        for (const key of keys) {
+            const data = await this.redisClient.hgetall(key);
+            if (data && data.token === listenerIdOrToken) {
+                return this.parseHashData(data);
+            }
+        }
+        return null;
+    }
+    async removeListenerByToken(token) {
+        // find the listener by token
+        const listener = await this.getListener(token);
+        if (!listener) {
+            return false;
+        }
+        // remove the listener ID from the room's set
+        await this.redisClient.srem(`room:${listener.roomId}:listeners`, listener.listenerId);
+        // remove the listener data (the hash)
+        await this.redisClient.del(`listener:${listener.listenerId}`);
+        return true;
+    }
+    async updateNameLanguage(listenerIdOrToken, name, language) {
+        const listener = await this.getListener(listenerIdOrToken);
+        if (!listener) {
+            return false;
+        }
+        // Update the name/language on the listener’s hash key
+        await this.redisClient.hset(`listener:${listener.listenerId}`, {
+            name,
+            language
+        });
+        return true;
+    }
+    async updateSocketId(listenerIdOrToken, socketId) {
+        const listener = await this.getListener(listenerIdOrToken);
+        if (!listener) {
+            return false;
+        }
+        // Update the name/language on the listener’s hash key
+        await this.redisClient.hset(`listener:${listener.listenerId}`, {
+            socketId
+        });
+        return true;
+    }
+    async getTargetSocketIdsByRoomLanguage(roomId, language) {
+        const listeners = await this.getListenersByRoom(roomId);
+        const filteredListeners = listeners.filter((listener) => {
+            return listener.isActive === true && listener.language === language && listener.socketId && listener.socketId.trim() !== '';
+        });
+        return filteredListeners.map((listener) => listener.socketId);
+    }
+    /**
+     * Returns an array of unique languages for the given room, from highest frequency to lowest.
+     * If a listener has no language (empty string / undefined), it is ignored.
+     */
+    async getUniqueLanguagesByRoom(roomId) {
+        // 1) Fetch all listeners for the room.
+        //    (This includes inactive ones, but feel free to filter out isActive === false if you only want active ones.)
+        const listeners = await this.getListenersByRoom(roomId);
+        // if I wanted to get only active listeners
+        // const listeners = (await this.getListenersByRoom(roomId)).filter(l => l.isActive);
+        // 2) Count how many times each language appears.
+        const languageCountMap = {};
+        for (const listener of listeners) {
+            // skip blank/unset language
+            if (!listener.language || !listener.language.trim()) {
+                continue;
+            }
+            // increment count
+            const lang = listener.language;
+            languageCountMap[lang] = (languageCountMap[lang] || 0) + 1;
+        }
+        // 3) Sort by frequency descending: highest count first
+        const sortedEntries = Object.entries(languageCountMap).sort(([, countA], [, countB]) => countB - countA);
+        // 4) Map back to just the language strings in order
+        return sortedEntries.map(([language]) => language);
+    }
+}
+exports.MulingstreamListenerManager = MulingstreamListenerManager;

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

@@ -1,37 +1,44 @@
-import { RedisClient } from '../redis-client';
-export type MulingstreamSpeakerData = {
-    speakerId: string;
-    userId: string;
-    roomId: string;
-    socketId: string;
-    sourceLanguage: string;
-    theme: string;
-    prompts: string;
-    recordingsDuration: number;
-    targetLanguages: string[];
-    timestamp: string;
-};
-export declare class MulingstreamSpeakerManager {
-    private redisClient;
-    constructor(redisClient: RedisClient);
-    private parseHash;
-    private serialize;
-    private buildId;
-    private buildKey;
-    addSpeaker(payload: Omit<MulingstreamSpeakerData, 'speakerId' | 'timestamp'>): Promise<string>;
-    removeSpeakerBySocketId(socketId: string): Promise<boolean>;
-    removeSpeakersByUserId(userId: string): Promise<number>;
-    removeSpeakersByRoomId(roomId: string): Promise<number>;
-    private removeSpeakerById;
-    getSpeakerBySpeakerId(speakerId: string): Promise<MulingstreamSpeakerData | null>;
-    getSpeakerBySocketId(socketId: string): Promise<MulingstreamSpeakerData | null>;
-    getSpeakersByRoomId(roomId: string): Promise<MulingstreamSpeakerData[]>;
-    getSpeakersByUserId(userId: string): Promise<MulingstreamSpeakerData[]>;
-    getSpeakerByUserRoom(roomId: string, userId: string): Promise<MulingstreamSpeakerData | null>;
-    getSpeakersLength(roomId: string): Promise<number>;
-    isRoomEmpty(roomId: string): Promise<boolean>;
-    updateSourceLanguage(socketId: string, newLang: string): Promise<boolean>;
-    updateTargetLanguages(socketId: string, languages: string[]): Promise<boolean>;
-    increaseRecordingDuration(socketId: string, delta: number): Promise<number>;
-    private cleanIndexes;
-}
+import { RedisClient } from '../redis-client';
+export type MulingstreamSpeakerData = {
+    speakerId: string;
+    userId: string;
+    roomId: string;
+    socketId: string;
+    sourceLanguage: string;
+    theme: string;
+    prompts: string;
+    recordingsDuration: number;
+    targetLanguages: string[];
+    timestamp: string;
+};
+export declare class MulingstreamSpeakerManager {
+    private redisClient;
+    constructor(redisClient: RedisClient);
+    private buildLockKey;
+    /** Try to claim the speaker slot for this room.
+     *  @returns true when the lock was acquired, false if someone else holds it.
+     */
+    acquireRoomLock(roomId: string, socketId: string, ttl?: number): Promise<boolean>;
+    /** Release the lock if we still own it. */
+    releaseRoomLock(roomId: string, socketId: string): Promise<void>;
+    private parseHash;
+    private serialize;
+    private buildId;
+    private buildKey;
+    addSpeaker(payload: Omit<MulingstreamSpeakerData, 'speakerId' | 'timestamp'>): Promise<string>;
+    removeSpeakerBySocketId(socketId: string): Promise<boolean>;
+    removeSpeakersByUserId(userId: string): Promise<number>;
+    removeSpeakersByRoomId(roomId: string): Promise<number>;
+    private removeSpeakerById;
+    getSpeakerBySpeakerId(speakerId: string): Promise<MulingstreamSpeakerData | null>;
+    getSpeakerBySocketId(socketId: string): Promise<MulingstreamSpeakerData | null>;
+    getSpeakersByRoomId(roomId: string): Promise<MulingstreamSpeakerData[]>;
+    getSpeakersByUserId(userId: string): Promise<MulingstreamSpeakerData[]>;
+    getSpeakerByUserRoom(roomId: string, userId: string): Promise<MulingstreamSpeakerData | null>;
+    getSpeakersLength(roomId: string): Promise<number>;
+    isRoomEmpty(roomId: string): Promise<boolean>;
+    updateSourceLanguage(socketId: string, newLang: string): Promise<boolean>;
+    updateTargetLanguages(socketId: string, languages: string[]): Promise<boolean>;
+    increaseRecordingDuration(socketId: string, delta: number): Promise<number>;
+    private cleanIndexes;
+}