@mulingai-npm/redis 1.11.2 → 1.13.0

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

@@ -1,7 +1,5 @@
 import { RedisClient } from '../redis-client';
-export type SttStatus = 'INIT' | 'DISCARDED' | 'READY' | 'USED';
-export type TranslationStatus = 'INIT' | 'DISCARDED' | 'READY' | 'USED';
-export type TtsStatus = 'INIT' | 'DISCARDED' | 'READY' | 'USED';
+export type StepStatus = 'INIT' | 'DISCARDED' | 'READY' | 'USED';
 export type MulingstreamChunkStatus = 'INIT' | 'STARTED' | 'FINISHED' | 'CANCELED' | 'USED';
 export type MulingstreamChunkStep = 'RECEIVED' | 'STT' | 'TRANSLATION' | 'TTS' | 'EMITTED';
 export type SttProvider = 'azure' | 'whisper' | 'google' | 'aws';
@@ -25,21 +23,21 @@ export type MulingstreamChunkData = {
         processingStart: number;
     };
     stt: {
-        [sttService: string]: {
+        [sttProvider: string]: {
             transcription: string;
-            status: SttStatus;
+            status: StepStatus;
         };
     };
     translation: {
         [language: string]: {
             translation: string;
-            status: TranslationStatus;
+            status: StepStatus;
         };
     };
     tts: {
         [language: string]: {
             ttsAudioPath: string;
-            status: TtsStatus;
+            status: StepStatus;
             isEmitted: boolean;
         };
     };
@@ -67,6 +65,6 @@ export declare class MulingstreamChunkManager {
     getByChunkNumber(chunkNumber: number, roomId: string): Promise<MulingstreamChunkData | null>;
     updateMulingstreamChunkStatus(mulingstreamChunkId: string, mulingstreamChunkStep: MulingstreamChunkStep, mulingstreamChunkStatus: MulingstreamChunkStatus): Promise<boolean>;
     updateFinalTranscription(mulingstreamChunkId: string, finalTranscription: string): Promise<boolean>;
-    updateSttStatus(mulingstreamChunkId: string, service: SttProvider, status: SttStatus): Promise<boolean>;
-    updateTranscription(mulingstreamChunkId: string, service: SttProvider, transcription: string, sttStatus: SttStatus): Promise<boolean>;
+    updateSttStatus(mulingstreamChunkId: string, service: SttProvider, status: StepStatus): Promise<boolean>;
+    updateTranscription(mulingstreamChunkId: string, service: SttProvider, transcription: string, sttStatus: StepStatus): Promise<boolean>;
 }

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

@@ -0,0 +1,76 @@
+import { RedisClient } from '../redis-client';
+export type SttProvider = 'azure' | 'whisper' | 'google' | 'aws';
+export type MulingstreamRoomData = {
+    mulingstreamRoomTrackerId: string;
+    roomId: string;
+    lastReadyChunk: number;
+    lastUsedChunk: number;
+    lastDiscardedChunk: number;
+    stt: {
+        [sttProvider: string]: {
+            lastReadyStt: number;
+            lastUsedStt: number;
+            lastDiscardedStt: number;
+        };
+    };
+    translation: {
+        [language: string]: {
+            lastReadyTranslation: number;
+            lastUsedTranslation: number;
+            lastDiscardedTranslation: number;
+        };
+    };
+    tts: {
+        [language: string]: {
+            lastReadyTts: number;
+            lastUsedTts: number;
+            lastDiscardedTts: number;
+            lastEmittedTts: number;
+        };
+    };
+};
+export declare class MulingstreamRoomTracker {
+    private redisClient;
+    constructor(redisClient: RedisClient);
+    private parseHashData;
+    /**
+     * Initializes a new MulingstreamRoomTracker for a given room.
+     * - The ID is `[roomId]`.
+     * - All "lastReady", "lastUsed", "lastDiscarded", etc. are set to -1 initially.
+     * - The sttProviders array is used to create stt sub-objects.
+     * - The targetLanguages array is used to create translation/tts sub-objects.
+     */
+    initMulingstreamRoomTracker(params: {
+        roomId: string;
+        sttProviders: SttProvider[];
+        targetLanguages: string[];
+    }): Promise<string>;
+    /**
+     * Retrieves all MulingstreamRoomTrackers by scanning keys `mulingstreamRoomTracker:*`.
+     */
+    getMulingstreamRoomTrackers(): Promise<MulingstreamRoomData[]>;
+    /**
+     * Retrieves a single MulingstreamRoomTracker by roomId.
+     */
+    getMulingstreamRoomTracker(roomId: string): Promise<MulingstreamRoomData | null>;
+    /**
+     * Updates the chunk-level tracker fields (lastReadyChunk, lastUsedChunk, lastDiscardedChunk).
+     * Any argument passed as null means "do not update that field."
+     */
+    updateChunkTracker(roomId: string, lastReadyChunk: number | null, lastUsedChunk: number | null, lastDiscardedChunk: number | null): Promise<boolean>;
+    /**
+     * Updates the stt tracker for a specific STT provider in the room.
+     * If any argument is null, we do not update that field.
+     */
+    updateSttTracker(roomId: string, sttProvider: SttProvider, lastReadyStt: number | null, lastUsedStt: number | null, lastDiscardedStt: number | null): Promise<boolean>;
+    /**
+     * Updates the translation tracker for a specific language in the room.
+     * If any argument is null, we do not update that field.
+     */
+    updateTranslationTracker(roomId: string, language: string, lastReadyTranslation: number | null, lastUsedTranslation: number | null, lastDiscardedTranslation: number | null): Promise<boolean>;
+    /**
+     * Updates the TTS tracker for a specific language in the room.
+     * If any argument is null, we do not update that field.
+     */
+    updateTtsTracker(roomId: string, language: string, lastReadyTts: number | null, lastUsedTts: number | null, lastDiscardedTts: number | null, lastEmittedTts: number | null): Promise<boolean>;
+}

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

@@ -1,174 +1,227 @@
-// import { v4 as uuidv4 } from 'uuid';
-// import { RedisClient } from '../redis-client';
-// export type SttStatus = 'INIT' | 'DISCARDED' | 'READY' | 'USED';
-// export type TranslationStatus = 'INIT' | 'DISCARDED' | 'READY' | 'USED';
-// export type TtsStatus = 'INIT' | 'DISCARDED' | 'READY' | 'USED';
-// export type MulingstreamChunkStatus = 'INIT' | 'DISCARDED' | 'USED';
-// export type MulingstreamRoomData = {
-//     mulingstreamRoomTrackerId: string;
-//     roomId: string;
-//     lastReadyChunk: number;
-//     lastUsedChunk: number;
-//     lastDiscardedChunk: number;
-//     stt: {
-//         lastReadyStt: number;
-//         lastUsedStt: number;
-//         lastDiscardedStt: number;
-//     };
-//     translation: {
-//         [language: string]: {
-//             lastReadyTranslation: number;
-//             lastUsedTranslation: number;
-//             lastDiscardedTranslation: number;
-//         };
-//     };
-//     tts: {
-//         [language: string]: {
-//             lastReadyTts: number;
-//             lastUsedTts: number;
-//             lastDiscardedTts: number;
-//             lastEmittedTts: number;
-//         };
-//     };
-// };
-// const EXPIRATION = 4 * 60 * 60; // 4 hours in seconds
-// export class MulingstreamChunkManager {
-//     private redisClient: RedisClient;
-//     constructor(redisClient: RedisClient) {
-//         this.redisClient = redisClient;
-//     }
-//     private parseHashData(data: Record<string, string>): MulingstreamChunkData {
-//         // Parse nested JSON fields
-//         const audioChunk = JSON.parse(data.audioChunk);
-//         const stt = JSON.parse(data.stt);
-//         const postStt = JSON.parse(data.postStt);
-//         return {
-//             mulingstreamChunkId: data.mulingstreamChunkId,
-//             roomId: data.roomId,
-//             chunkNumber: parseInt(data.chunkNumber, 10),
-//             language: data.language,
-//             mulingstreamChunkStatus: data.mulingstreamChunkStatus as MulingstreamChunkStatus,
-//             audioChunk,
-//             stt,
-//             postStt
-//         };
-//     }
-//     // Adds a new mulingstream chunk.
-//     // - Creates a unique mulingstreamChunkId.
-//     // - Stores the chunk data in a Redis hash under `mulingstreamChunk:{mulingstreamChunkId}`.
-//     // - Applies an expiration (4h).
-//     public async addMulingstreamChunk(params: {
-//         roomId: string;
-//         chunkNumber: number;
-//         language: string;
-//         start: number;
-//         end: number;
-//         duration: number;
-//         isFirst: boolean;
-//         isLast: boolean;
-//         theme: string;
-//         services: string[];
-//         postSttLanguages: string[]; // e.g. ['en-US', 'es-ES', 'de-DE']
-//     }): Promise<string> {
-//         const { roomId, chunkNumber, language, start, end, duration, isFirst, isLast, theme, services, postSttLanguages } = params;
-//         const mulingstreamChunkId = `[${roomId}]-[${chunkNumber}]-[${uuidv4()}]`;
-//         // Prepare the nested objects
-//         const audioChunk = {
-//             start,
-//             end,
-//             duration,
-//             isFirst,
-//             isLast,
-//             theme,
-//             processingStart: Date.now()
-//         };
-//         const stt = {
-//             services,
-//             azureTranscription: '',
-//             whisperTranscription: '',
-//             googleTranscription: '',
-//             finalTranscription: '',
-//             status: 'INIT' as SttStatus
-//         };
-//         // Build postStt object keyed by each language
-//         const postStt: MulingstreamChunkData['postStt'] = {};
-//         for (const lang of postSttLanguages) {
-//             postStt[lang] = {
-//                 translation: '',
-//                 translationStatus: 'INIT',
-//                 ttsAudioPath: '',
-//                 ttsStatus: 'INIT',
-//                 isEmitted: false
-//             };
-//         }
-//         // Store the data in a Redis hash
-//         await this.redisClient.hset(`mulingstreamChunk:${mulingstreamChunkId}`, {
-//             mulingstreamChunkId,
-//             roomId,
-//             chunkNumber: chunkNumber.toString(),
-//             language,
-//             mulingstreamChunkStatus: 'INIT',
-//             audioChunk: JSON.stringify(audioChunk),
-//             stt: JSON.stringify(stt),
-//             postStt: JSON.stringify(postStt)
-//         });
-//         // set expiration
-//         await this.redisClient.expire(`mulingstreamChunk:${mulingstreamChunkId}`, EXPIRATION);
-//         return mulingstreamChunkId;
-//     }
-//     // Retrieves all mulingstream chunks by scanning keys `mulingstreamChunk:*`.
-//     public async getMulingstreamChunks(): Promise<MulingstreamChunkData[]> {
-//         const keys = await this.redisClient.keys('mulingstreamChunk:*');
-//         if (!keys || keys.length === 0) {
-//             return [];
-//         }
-//         const results: MulingstreamChunkData[] = [];
-//         for (const key of keys) {
-//             const data = await this.redisClient.hgetall(key);
-//             if (data && data.mulingstreamChunkId) {
-//                 results.push(this.parseHashData(data));
-//             }
-//         }
-//         return results;
-//     }
-//     // Retrieves a single mulingstream chunk by ID.
-//     public async getMulingstreamChunk(mulingstreamChunkId: string): Promise<MulingstreamChunkData | null> {
-//         const data = await this.redisClient.hgetall(`mulingstreamChunk:${mulingstreamChunkId}`);
-//         if (!data || !data.mulingstreamChunkId) {
-//             return null;
-//         }
-//         return this.parseHashData(data);
-//     }
-//     // Retrieves all mulingstream chunks for a specific room by pattern matching keys `mulingstreamChunk:[roomId]-*`.
-//     public async getMulingstreamChunksByRoom(roomId: string): Promise<MulingstreamChunkData[]> {
-//         const pattern = `mulingstreamChunk:[${roomId}]-*`;
-//         const keys = await this.redisClient.keys(pattern);
-//         if (!keys || keys.length === 0) {
-//             return [];
-//         }
-//         const results: MulingstreamChunkData[] = [];
-//         for (const key of keys) {
-//             const data = await this.redisClient.hgetall(key);
-//             if (!data || !data.mulingstreamChunkId) {
-//                 continue;
-//             }
-//             results.push(this.parseHashData(data));
-//         }
-//         return results;
-//     }
-//     // Retrieves a mulingstream chunk by (roomId, chunkNumber).
-//     // Since mulingstreamChunkId = `[${roomId}]-[${chunkNumber}]-[uuid]`, we can pattern-match on keys.
-//     public async getByChunkNumber(chunkNumber: number, roomId: string): Promise<MulingstreamChunkData | null> {
-//         const pattern = `mulingstreamChunk:[${roomId}]-[${chunkNumber}]-*`;
-//         const keys = await this.redisClient.keys(pattern);
-//         if (!keys || keys.length === 0) {
-//             return null;
-//         }
-//         // If multiple match, return the first
-//         const data = await this.redisClient.hgetall(keys[0]);
-//         if (!data || !data.mulingstreamChunkId) {
-//             return null;
-//         }
-//         return this.parseHashData(data);
-//     }
-// }
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MulingstreamRoomTracker = void 0;
+const EXPIRATION = 48 * 60 * 60; // 48 hours in seconds
+class MulingstreamRoomTracker {
+    constructor(redisClient) {
+        this.redisClient = redisClient;
+    }
+    parseHashData(data) {
+        const stt = JSON.parse(data.stt);
+        const translation = JSON.parse(data.translation);
+        const tts = JSON.parse(data.tts);
+        return {
+            mulingstreamRoomTrackerId: data.mulingstreamRoomTrackerId,
+            roomId: data.roomId,
+            lastReadyChunk: parseInt(data.lastReadyChunk, 10),
+            lastUsedChunk: parseInt(data.lastUsedChunk, 10),
+            lastDiscardedChunk: parseInt(data.lastDiscardedChunk, 10),
+            stt,
+            translation,
+            tts
+        };
+    }
+    /**
+     * Initializes a new MulingstreamRoomTracker for a given room.
+     * - The ID is `[roomId]`.
+     * - All "lastReady", "lastUsed", "lastDiscarded", etc. are set to -1 initially.
+     * - The sttProviders array is used to create stt sub-objects.
+     * - The targetLanguages array is used to create translation/tts sub-objects.
+     */
+    async initMulingstreamRoomTracker(params) {
+        const { roomId, sttProviders, targetLanguages } = params;
+        // We'll use [roomId] as the unique ID
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        // Build stt object
+        // For each provider, set lastReadyStt = -1, lastUsedStt = -1, lastDiscardedStt = -1
+        const stt = {};
+        for (const provider of sttProviders) {
+            stt[provider] = {
+                lastReadyStt: -1,
+                lastUsedStt: -1,
+                lastDiscardedStt: -1
+            };
+        }
+        // Build translation object
+        // For each target language, set lastReadyTranslation = -1, lastUsedTranslation = -1, lastDiscardedTranslation = -1
+        const translation = {};
+        for (const lang of targetLanguages) {
+            translation[lang] = {
+                lastReadyTranslation: -1,
+                lastUsedTranslation: -1,
+                lastDiscardedTranslation: -1
+            };
+        }
+        // Build tts object
+        // For each target language, set lastReadyTts = -1, lastUsedTts = -1, lastDiscardedTts = -1, lastEmittedTts = -1
+        const tts = {};
+        for (const lang of targetLanguages) {
+            tts[lang] = {
+                lastReadyTts: -1,
+                lastUsedTts: -1,
+                lastDiscardedTts: -1,
+                lastEmittedTts: -1
+            };
+        }
+        // Root-level chunk trackers
+        const lastReadyChunk = -1;
+        const lastUsedChunk = -1;
+        const lastDiscardedChunk = -1;
+        // Store everything in Redis
+        await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, {
+            mulingstreamRoomTrackerId,
+            roomId,
+            lastReadyChunk: lastReadyChunk.toString(),
+            lastUsedChunk: lastUsedChunk.toString(),
+            lastDiscardedChunk: lastDiscardedChunk.toString(),
+            stt: JSON.stringify(stt),
+            translation: JSON.stringify(translation),
+            tts: JSON.stringify(tts)
+        });
+        // set expiration
+        await this.redisClient.expire(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, EXPIRATION);
+        return mulingstreamRoomTrackerId;
+    }
+    /**
+     * Retrieves all MulingstreamRoomTrackers by scanning keys `mulingstreamRoomTracker:*`.
+     */
+    async getMulingstreamRoomTrackers() {
+        const pattern = 'mulingstreamRoomTracker:*';
+        const keys = await this.redisClient.keys(pattern);
+        if (!keys || keys.length === 0) {
+            return [];
+        }
+        const results = [];
+        for (const key of keys) {
+            const data = await this.redisClient.hgetall(key);
+            if (data && data.mulingstreamRoomTrackerId) {
+                results.push(this.parseHashData(data));
+            }
+        }
+        return results;
+    }
+    /**
+     * Retrieves a single MulingstreamRoomTracker by roomId.
+     */
+    async getMulingstreamRoomTracker(roomId) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return null;
+        }
+        return this.parseHashData(data);
+    }
+    /**
+     * Updates the chunk-level tracker fields (lastReadyChunk, lastUsedChunk, lastDiscardedChunk).
+     * Any argument passed as null means "do not update that field."
+     */
+    async updateChunkTracker(roomId, lastReadyChunk, lastUsedChunk, lastDiscardedChunk) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return false;
+        }
+        const updates = {};
+        if (lastReadyChunk !== null) {
+            updates.lastReadyChunk = lastReadyChunk.toString();
+        }
+        if (lastUsedChunk !== null) {
+            updates.lastUsedChunk = lastUsedChunk.toString();
+        }
+        if (lastDiscardedChunk !== null) {
+            updates.lastDiscardedChunk = lastDiscardedChunk.toString();
+        }
+        if (Object.keys(updates).length > 0) {
+            await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, updates);
+        }
+        return true;
+    }
+    /**
+     * Updates the stt tracker for a specific STT provider in the room.
+     * If any argument is null, we do not update that field.
+     */
+    async updateSttTracker(roomId, sttProvider, lastReadyStt, lastUsedStt, lastDiscardedStt) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return false;
+        }
+        const stt = JSON.parse(data.stt);
+        if (!stt[sttProvider]) {
+            return false; // The provider doesn't exist in this room
+        }
+        if (lastReadyStt !== null) {
+            stt[sttProvider].lastReadyStt = lastReadyStt;
+        }
+        if (lastUsedStt !== null) {
+            stt[sttProvider].lastUsedStt = lastUsedStt;
+        }
+        if (lastDiscardedStt !== null) {
+            stt[sttProvider].lastDiscardedStt = lastDiscardedStt;
+        }
+        await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, {
+            stt: JSON.stringify(stt)
+        });
+        return true;
+    }
+    /**
+     * Updates the translation tracker for a specific language in the room.
+     * If any argument is null, we do not update that field.
+     */
+    async updateTranslationTracker(roomId, language, lastReadyTranslation, lastUsedTranslation, lastDiscardedTranslation) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return false;
+        }
+        const translation = JSON.parse(data.translation);
+        if (!translation[language]) {
+            return false; // The language isn't tracked in this room
+        }
+        if (lastReadyTranslation !== null) {
+            translation[language].lastReadyTranslation = lastReadyTranslation;
+        }
+        if (lastUsedTranslation !== null) {
+            translation[language].lastUsedTranslation = lastUsedTranslation;
+        }
+        if (lastDiscardedTranslation !== null) {
+            translation[language].lastDiscardedTranslation = lastDiscardedTranslation;
+        }
+        await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, {
+            translation: JSON.stringify(translation)
+        });
+        return true;
+    }
+    /**
+     * Updates the TTS tracker for a specific language in the room.
+     * If any argument is null, we do not update that field.
+     */
+    async updateTtsTracker(roomId, language, lastReadyTts, lastUsedTts, lastDiscardedTts, lastEmittedTts) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return false;
+        }
+        const tts = JSON.parse(data.tts);
+        if (!tts[language]) {
+            return false; // The language isn't tracked in this room
+        }
+        if (lastReadyTts !== null) {
+            tts[language].lastReadyTts = lastReadyTts;
+        }
+        if (lastUsedTts !== null) {
+            tts[language].lastUsedTts = lastUsedTts;
+        }
+        if (lastDiscardedTts !== null) {
+            tts[language].lastDiscardedTts = lastDiscardedTts;
+        }
+        if (lastEmittedTts !== null) {
+            tts[language].lastEmittedTts = lastEmittedTts;
+        }
+        await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, {
+            tts: JSON.stringify(tts)
+        });
+        return true;
+    }
+}
+exports.MulingstreamRoomTracker = MulingstreamRoomTracker;

package/dist/managers/mulingstream-room-tracker.d.ts

@@ -0,0 +1,76 @@
+import { RedisClient } from '../redis-client';
+export type SttProvider = 'azure' | 'whisper' | 'google' | 'aws';
+export type MulingstreamRoomData = {
+    mulingstreamRoomTrackerId: string;
+    roomId: string;
+    lastReadyChunk: number;
+    lastUsedChunk: number;
+    lastDiscardedChunk: number;
+    stt: {
+        [sttProvider: string]: {
+            lastReadyStt: number;
+            lastUsedStt: number;
+            lastDiscardedStt: number;
+        };
+    };
+    translation: {
+        [language: string]: {
+            lastReadyTranslation: number;
+            lastUsedTranslation: number;
+            lastDiscardedTranslation: number;
+        };
+    };
+    tts: {
+        [language: string]: {
+            lastReadyTts: number;
+            lastUsedTts: number;
+            lastDiscardedTts: number;
+            lastEmittedTts: number;
+        };
+    };
+};
+export declare class MulingstreamRoomTracker {
+    private redisClient;
+    constructor(redisClient: RedisClient);
+    private parseHashData;
+    /**
+     * Initializes a new MulingstreamRoomTracker for a given room.
+     * - The ID is `[roomId]`.
+     * - All "lastReady", "lastUsed", "lastDiscarded", etc. are set to -1 initially.
+     * - The sttProviders array is used to create stt sub-objects.
+     * - The targetLanguages array is used to create translation/tts sub-objects.
+     */
+    initMulingstreamRoomTracker(params: {
+        roomId: string;
+        sttProviders: SttProvider[];
+        targetLanguages: string[];
+    }): Promise<string>;
+    /**
+     * Retrieves all MulingstreamRoomTrackers by scanning keys `mulingstreamRoomTracker:*`.
+     */
+    getMulingstreamRoomTrackers(): Promise<MulingstreamRoomData[]>;
+    /**
+     * Retrieves a single MulingstreamRoomTracker by roomId.
+     */
+    getMulingstreamRoomTracker(roomId: string): Promise<MulingstreamRoomData | null>;
+    /**
+     * Updates the chunk-level tracker fields (lastReadyChunk, lastUsedChunk, lastDiscardedChunk).
+     * Any argument passed as null means "do not update that field."
+     */
+    updateChunkTracker(roomId: string, lastReadyChunk: number | null, lastUsedChunk: number | null, lastDiscardedChunk: number | null): Promise<boolean>;
+    /**
+     * Updates the stt tracker for a specific STT provider in the room.
+     * If any argument is null, we do not update that field.
+     */
+    updateSttTracker(roomId: string, sttProvider: SttProvider, lastReadyStt: number | null, lastUsedStt: number | null, lastDiscardedStt: number | null): Promise<boolean>;
+    /**
+     * Updates the translation tracker for a specific language in the room.
+     * If any argument is null, we do not update that field.
+     */
+    updateTranslationTracker(roomId: string, language: string, lastReadyTranslation: number | null, lastUsedTranslation: number | null, lastDiscardedTranslation: number | null): Promise<boolean>;
+    /**
+     * Updates the TTS tracker for a specific language in the room.
+     * If any argument is null, we do not update that field.
+     */
+    updateTtsTracker(roomId: string, language: string, lastReadyTts: number | null, lastUsedTts: number | null, lastDiscardedTts: number | null, lastEmittedTts: number | null): Promise<boolean>;
+}

package/dist/managers/mulingstream-room-tracker.js

@@ -0,0 +1,227 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MulingstreamRoomTracker = void 0;
+const EXPIRATION = 48 * 60 * 60; // 48 hours in seconds
+class MulingstreamRoomTracker {
+    constructor(redisClient) {
+        this.redisClient = redisClient;
+    }
+    parseHashData(data) {
+        const stt = JSON.parse(data.stt);
+        const translation = JSON.parse(data.translation);
+        const tts = JSON.parse(data.tts);
+        return {
+            mulingstreamRoomTrackerId: data.mulingstreamRoomTrackerId,
+            roomId: data.roomId,
+            lastReadyChunk: parseInt(data.lastReadyChunk, 10),
+            lastUsedChunk: parseInt(data.lastUsedChunk, 10),
+            lastDiscardedChunk: parseInt(data.lastDiscardedChunk, 10),
+            stt,
+            translation,
+            tts
+        };
+    }
+    /**
+     * Initializes a new MulingstreamRoomTracker for a given room.
+     * - The ID is `[roomId]`.
+     * - All "lastReady", "lastUsed", "lastDiscarded", etc. are set to -1 initially.
+     * - The sttProviders array is used to create stt sub-objects.
+     * - The targetLanguages array is used to create translation/tts sub-objects.
+     */
+    async initMulingstreamRoomTracker(params) {
+        const { roomId, sttProviders, targetLanguages } = params;
+        // We'll use [roomId] as the unique ID
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        // Build stt object
+        // For each provider, set lastReadyStt = -1, lastUsedStt = -1, lastDiscardedStt = -1
+        const stt = {};
+        for (const provider of sttProviders) {
+            stt[provider] = {
+                lastReadyStt: -1,
+                lastUsedStt: -1,
+                lastDiscardedStt: -1
+            };
+        }
+        // Build translation object
+        // For each target language, set lastReadyTranslation = -1, lastUsedTranslation = -1, lastDiscardedTranslation = -1
+        const translation = {};
+        for (const lang of targetLanguages) {
+            translation[lang] = {
+                lastReadyTranslation: -1,
+                lastUsedTranslation: -1,
+                lastDiscardedTranslation: -1
+            };
+        }
+        // Build tts object
+        // For each target language, set lastReadyTts = -1, lastUsedTts = -1, lastDiscardedTts = -1, lastEmittedTts = -1
+        const tts = {};
+        for (const lang of targetLanguages) {
+            tts[lang] = {
+                lastReadyTts: -1,
+                lastUsedTts: -1,
+                lastDiscardedTts: -1,
+                lastEmittedTts: -1
+            };
+        }
+        // Root-level chunk trackers
+        const lastReadyChunk = -1;
+        const lastUsedChunk = -1;
+        const lastDiscardedChunk = -1;
+        // Store everything in Redis
+        await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, {
+            mulingstreamRoomTrackerId,
+            roomId,
+            lastReadyChunk: lastReadyChunk.toString(),
+            lastUsedChunk: lastUsedChunk.toString(),
+            lastDiscardedChunk: lastDiscardedChunk.toString(),
+            stt: JSON.stringify(stt),
+            translation: JSON.stringify(translation),
+            tts: JSON.stringify(tts)
+        });
+        // set expiration
+        await this.redisClient.expire(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, EXPIRATION);
+        return mulingstreamRoomTrackerId;
+    }
+    /**
+     * Retrieves all MulingstreamRoomTrackers by scanning keys `mulingstreamRoomTracker:*`.
+     */
+    async getMulingstreamRoomTrackers() {
+        const pattern = 'mulingstreamRoomTracker:*';
+        const keys = await this.redisClient.keys(pattern);
+        if (!keys || keys.length === 0) {
+            return [];
+        }
+        const results = [];
+        for (const key of keys) {
+            const data = await this.redisClient.hgetall(key);
+            if (data && data.mulingstreamRoomTrackerId) {
+                results.push(this.parseHashData(data));
+            }
+        }
+        return results;
+    }
+    /**
+     * Retrieves a single MulingstreamRoomTracker by roomId.
+     */
+    async getMulingstreamRoomTracker(roomId) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return null;
+        }
+        return this.parseHashData(data);
+    }
+    /**
+     * Updates the chunk-level tracker fields (lastReadyChunk, lastUsedChunk, lastDiscardedChunk).
+     * Any argument passed as null means "do not update that field."
+     */
+    async updateChunkTracker(roomId, lastReadyChunk, lastUsedChunk, lastDiscardedChunk) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return false;
+        }
+        const updates = {};
+        if (lastReadyChunk !== null) {
+            updates.lastReadyChunk = lastReadyChunk.toString();
+        }
+        if (lastUsedChunk !== null) {
+            updates.lastUsedChunk = lastUsedChunk.toString();
+        }
+        if (lastDiscardedChunk !== null) {
+            updates.lastDiscardedChunk = lastDiscardedChunk.toString();
+        }
+        if (Object.keys(updates).length > 0) {
+            await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, updates);
+        }
+        return true;
+    }
+    /**
+     * Updates the stt tracker for a specific STT provider in the room.
+     * If any argument is null, we do not update that field.
+     */
+    async updateSttTracker(roomId, sttProvider, lastReadyStt, lastUsedStt, lastDiscardedStt) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return false;
+        }
+        const stt = JSON.parse(data.stt);
+        if (!stt[sttProvider]) {
+            return false; // The provider doesn't exist in this room
+        }
+        if (lastReadyStt !== null) {
+            stt[sttProvider].lastReadyStt = lastReadyStt;
+        }
+        if (lastUsedStt !== null) {
+            stt[sttProvider].lastUsedStt = lastUsedStt;
+        }
+        if (lastDiscardedStt !== null) {
+            stt[sttProvider].lastDiscardedStt = lastDiscardedStt;
+        }
+        await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, {
+            stt: JSON.stringify(stt)
+        });
+        return true;
+    }
+    /**
+     * Updates the translation tracker for a specific language in the room.
+     * If any argument is null, we do not update that field.
+     */
+    async updateTranslationTracker(roomId, language, lastReadyTranslation, lastUsedTranslation, lastDiscardedTranslation) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return false;
+        }
+        const translation = JSON.parse(data.translation);
+        if (!translation[language]) {
+            return false; // The language isn't tracked in this room
+        }
+        if (lastReadyTranslation !== null) {
+            translation[language].lastReadyTranslation = lastReadyTranslation;
+        }
+        if (lastUsedTranslation !== null) {
+            translation[language].lastUsedTranslation = lastUsedTranslation;
+        }
+        if (lastDiscardedTranslation !== null) {
+            translation[language].lastDiscardedTranslation = lastDiscardedTranslation;
+        }
+        await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, {
+            translation: JSON.stringify(translation)
+        });
+        return true;
+    }
+    /**
+     * Updates the TTS tracker for a specific language in the room.
+     * If any argument is null, we do not update that field.
+     */
+    async updateTtsTracker(roomId, language, lastReadyTts, lastUsedTts, lastDiscardedTts, lastEmittedTts) {
+        const mulingstreamRoomTrackerId = `[${roomId}]`;
+        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
+        if (!data || !data.mulingstreamRoomTrackerId) {
+            return false;
+        }
+        const tts = JSON.parse(data.tts);
+        if (!tts[language]) {
+            return false; // The language isn't tracked in this room
+        }
+        if (lastReadyTts !== null) {
+            tts[language].lastReadyTts = lastReadyTts;
+        }
+        if (lastUsedTts !== null) {
+            tts[language].lastUsedTts = lastUsedTts;
+        }
+        if (lastDiscardedTts !== null) {
+            tts[language].lastDiscardedTts = lastDiscardedTts;
+        }
+        if (lastEmittedTts !== null) {
+            tts[language].lastEmittedTts = lastEmittedTts;
+        }
+        await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, {
+            tts: JSON.stringify(tts)
+        });
+        return true;
+    }
+}
+exports.MulingstreamRoomTracker = MulingstreamRoomTracker;

package/package.json

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