@mulingai-npm/redis 2.1.0 → 2.1.2

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

@@ -6,7 +6,8 @@ export type MulingstreamChunkData = {
     chunkNumber: number;
     language: string;
     sttProviders: SttProvider[];
-    targetLanguages: string[];
+    translationTargetLanguages: string[];
+    ttsTargetLanguages: string[];
     finalTranscription: string;
     sttStatus: StepStatus;
     audioChunk: {
@@ -77,7 +78,8 @@ export declare class MulingstreamChunkManager {
         isLast: boolean;
         theme: string;
         sttProviders: SttProvider[];
-        targetLanguages: string[];
+        translationTargetLanguages: string[];
+        ttsTargetLanguages: string[];
     }): Promise<void>;
     /**
      * Given roomId and chunkNumber, return the single chunk from the array

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

@@ -58,7 +58,7 @@ class MulingstreamChunkManager {
      * Adds a new Mulingstream chunk to the array stored at [${roomId}].
      */
     async addMulingstreamChunk(params) {
-        const { roomId, chunkNumber, language, start, end, duration, isFirst, isLast, theme, sttProviders, targetLanguages } = params;
+        const { roomId, chunkNumber, language, start, end, duration, isFirst, isLast, theme, sttProviders, translationTargetLanguages, ttsTargetLanguages } = params;
         // ensure we only keep the last 5 elements
         const currentLength = await this.redisClient.jsonArrLen(`[${roomId}]`, '.');
         if ((currentLength !== null && currentLength !== void 0 ? currentLength : 0) >= ROOM_ARRAY_LENGTH) {
@@ -86,12 +86,14 @@ class MulingstreamChunkManager {
         // Build translation and tts objects
         const translation = {};
         const tts = {};
-        for (const lang of targetLanguages) {
-            translation[lang] = {
+        for (const language of translationTargetLanguages) {
+            translation[language] = {
                 translation: '',
                 status: 'INIT'
             };
-            tts[lang] = {
+        }
+        for (const language of ttsTargetLanguages) {
+            tts[language] = {
                 ttsAudioPath: '',
                 status: 'INIT',
                 isEmitted: false
@@ -102,7 +104,8 @@ class MulingstreamChunkManager {
             chunkNumber,
             language,
             sttProviders,
-            targetLanguages,
+            translationTargetLanguages,
+            ttsTargetLanguages,
             finalTranscription: '',
             sttStatus: 'INIT',
             audioChunk,

package/package.json

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

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

@@ -1,86 +0,0 @@
-import { RedisClient } from '../redis-client';
-export type SttProvider = 'azure' | 'whisper' | 'google' | 'aws';
-export type MulingstreamRoomData = {
-    mulingstreamRoomTrackerId: string;
-    roomId: string;
-    sttProviders: SttProvider[];
-    targetLanguages: string[];
-    lastReadyChunk: number;
-    lastUsedChunk: number;
-    lastDiscardedChunk: number;
-    lastReadyTranscription: number;
-    lastUsedTranscription: number;
-    lastDiscardedTranscription: 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 transcription tracker fields (lastReadyTranscription, lastUsedTranscription , lastDiscardedTranscription).
-     * Any argument passed as null means "do not update that field."
-     */
-    updateTranscriptionTracker(roomId: string, lastReadyTranscription: number | null, lastUsedTranscription: number | null, lastDiscardedTranscription: 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

@@ -1,268 +0,0 @@
-"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) {
-        // Parse any JSON fields
-        const sttProviders = JSON.parse(data.sttProviders);
-        const targetLanguages = JSON.parse(data.targetLanguages);
-        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,
-            sttProviders,
-            targetLanguages,
-            lastReadyChunk: parseInt(data.lastReadyChunk, 10),
-            lastUsedChunk: parseInt(data.lastUsedChunk, 10),
-            lastDiscardedChunk: parseInt(data.lastDiscardedChunk, 10),
-            lastReadyTranscription: parseInt(data.lastReadyTranscription, 10),
-            lastUsedTranscription: parseInt(data.lastUsedTranscription, 10),
-            lastDiscardedTranscription: parseInt(data.lastDiscardedTranscription, 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;
-        const lastReadyTranscription = -1;
-        const lastUsedTranscription = -1;
-        const lastDiscardedTranscription = -1;
-        // Store everything in Redis
-        await this.redisClient.hset(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`, {
-            mulingstreamRoomTrackerId,
-            roomId,
-            sttProviders: JSON.stringify(sttProviders),
-            targetLanguages: JSON.stringify(targetLanguages),
-            lastReadyChunk: lastReadyChunk.toString(),
-            lastUsedChunk: lastUsedChunk.toString(),
-            lastDiscardedChunk: lastDiscardedChunk.toString(),
-            lastReadyTranscription: lastReadyTranscription.toString(),
-            lastUsedTranscription: lastUsedTranscription.toString(),
-            lastDiscardedTranscription: lastDiscardedTranscription.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 transcription tracker fields (lastReadyTranscription, lastUsedTranscription , lastDiscardedTranscription).
-     * Any argument passed as null means "do not update that field."
-     */
-    async updateTranscriptionTracker(roomId, lastReadyTranscription, lastUsedTranscription, lastDiscardedTranscription) {
-        const mulingstreamRoomTrackerId = `[${roomId}]`;
-        const data = await this.redisClient.hgetall(`mulingstreamRoomTracker:${mulingstreamRoomTrackerId}`);
-        if (!data || !data.mulingstreamRoomTrackerId) {
-            return false;
-        }
-        const updates = {};
-        if (lastReadyTranscription !== null) {
-            updates.lastReadyTranscription = lastReadyTranscription.toString();
-        }
-        if (lastUsedTranscription !== null) {
-            updates.lastUsedTranscription = lastUsedTranscription.toString();
-        }
-        if (lastDiscardedTranscription !== null) {
-            updates.lastDiscardedTranscription = lastDiscardedTranscription.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;