@mulingai-npm/redis 1.14.0 → 1.14.1

package/package.json

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

package/dist/managers/audio-stt-manager.d.ts

@@ -1,33 +0,0 @@
-import { RedisClient } from '../redis-client';
-type AudioSttStatus = 'RECEIVED' | 'DISCARDED' | 'EMPTY' | 'READY' | 'USED';
-export type AudioSttData = {
-    audioSttId: string;
-    roomId: string;
-    start: number;
-    end: number;
-    duration: number;
-    chunkNumber: number;
-    isFirst: boolean;
-    isLast: boolean;
-    language: string;
-    theme: string;
-    services: string[];
-    azureTranscription?: string;
-    whisperTranscription?: string;
-    googleTranscription?: string;
-    processingStart: number;
-    totalStatusCheck: number;
-    status: AudioSttStatus;
-};
-export declare class AudioSttManager {
-    private redisClient;
-    constructor(redisClient: RedisClient);
-    private parseHashData;
-    addAudioStt(sttData: Omit<AudioSttData, 'audioSttId' | 'processingStart' | 'totalStatusCheck' | 'status'>): Promise<string>;
-    getAllAudioStt(): Promise<AudioSttData[]>;
-    getAllAudioSttByRoom(roomId: string): Promise<AudioSttData[]>;
-    getAudioStt(audioSttId: string): Promise<AudioSttData | null>;
-    updateAudioSttStatus(audioSttId: string, status: AudioSttStatus): Promise<boolean>;
-    updateAudioSttAzureTranscription(audioSttId: string, azureTranscription: string, status: AudioSttStatus): Promise<boolean>;
-}
-export {};

package/dist/managers/audio-stt-manager.js

@@ -1,131 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AudioSttManager = void 0;
-const uuid_1 = require("uuid");
-const EXPIRATION = 4 * 60 * 60; // 4 hours in seconds
-class AudioSttManager {
-    constructor(redisClient) {
-        this.redisClient = redisClient;
-    }
-    parseHashData(data) {
-        return {
-            audioSttId: data.audioSttId,
-            roomId: data.roomId,
-            start: parseInt(data.start, 10),
-            end: parseInt(data.end, 10),
-            duration: parseInt(data.duration, 10),
-            chunkNumber: parseInt(data.chunkNumber, 10),
-            isFirst: data.isFirst === 'true',
-            isLast: data.isLast === 'true',
-            language: data.language,
-            theme: data.theme,
-            services: data.services ? JSON.parse(data.services) : [],
-            azureTranscription: data.azureTranscription || undefined,
-            whisperTranscription: data.whisperTranscription || undefined,
-            googleTranscription: data.googleTranscription || undefined,
-            processingStart: parseInt(data.processingStart, 10),
-            totalStatusCheck: parseInt(data.totalStatusCheck, 10),
-            status: data.status
-        };
-    }
-    // Creates a new audio-stt entry.
-    // - Generates a unique audioSttId and adds it to the room’s set.
-    // - Stores the data in a Redis hash under `audioStt:{audioSttId}`.
-    // - Optionally sets an expiration (4h).
-    async addAudioStt(sttData) {
-        const audioSttId = `[${sttData.roomId}]-[${(0, uuid_1.v4)()}]`;
-        const servicesJson = sttData.services ? JSON.stringify(sttData.services) : '[]';
-        // Add audioSttId to the set for that room
-        await this.redisClient.sadd(`room:${sttData.roomId}:audioStt`, audioSttId);
-        // Store audio-stt data in a hash
-        await this.redisClient.hset(`audioStt:${audioSttId}`, {
-            audioSttId,
-            roomId: sttData.roomId,
-            start: sttData.start.toString(),
-            end: sttData.end.toString(),
-            duration: sttData.duration.toString(),
-            chunkNumber: sttData.chunkNumber.toString(),
-            isFirst: sttData.isFirst.toString(),
-            isLast: sttData.isLast.toString(),
-            language: sttData.language,
-            theme: sttData.theme,
-            services: servicesJson,
-            processingStart: Date.now().toString(),
-            totalStatusCheck: (0).toString(),
-            status: 'RECEIVED'
-        });
-        // Set expiration if desired
-        await this.redisClient.expire(`audioStt:${audioSttId}`, EXPIRATION);
-        return audioSttId;
-    }
-    // Retrieves *all* audio-stt entries by scanning the keys that match `audioStt:*`
-    async getAllAudioStt() {
-        const keys = await this.redisClient.keys('audioStt:*');
-        if (!keys || keys.length === 0) {
-            return [];
-        }
-        const results = [];
-        for (const key of keys) {
-            const data = await this.redisClient.hgetall(key);
-            if (data && data.audioSttId) {
-                results.push(this.parseHashData(data));
-            }
-        }
-        return results;
-    }
-    // Retrieves all audio-stt entries for a specific room by looking up
-    // the set `room:{roomId}:audioStt` and then fetching each hash.
-    async getAllAudioSttByRoom(roomId) {
-        const audioSttIds = await this.redisClient.smembers(`room:${roomId}:audioStt`);
-        if (!audioSttIds || audioSttIds.length === 0) {
-            return [];
-        }
-        const results = [];
-        for (const id of audioSttIds) {
-            const data = await this.redisClient.hgetall(`audioStt:${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}:audioStt`, id);
-                continue;
-            }
-            results.push(this.parseHashData(data));
-        }
-        return results;
-    }
-    // Retrieves a single audio-stt entry by ID.
-    async getAudioStt(audioSttId) {
-        const data = await this.redisClient.hgetall(`audioStt:${audioSttId}`);
-        if (!data || !data.audioSttId) {
-            return null;
-        }
-        return this.parseHashData(data);
-    }
-    async updateAudioSttStatus(audioSttId, status) {
-        // Attempt to fetch the data first
-        const data = await this.redisClient.hgetall(`audioStt:${audioSttId}`);
-        if (!data || !data.audioSttId) {
-            // AudioStt either doesn’t exist or has expired
-            return false;
-        }
-        // update the status field
-        await this.redisClient.hset(`audioStt:${audioSttId}`, {
-            status
-        });
-        return true;
-    }
-    async updateAudioSttAzureTranscription(audioSttId, azureTranscription, status) {
-        // Attempt to fetch the data first
-        const data = await this.redisClient.hgetall(`audioStt:${audioSttId}`);
-        if (!data || !data.audioSttId) {
-            // AudioStt either doesn’t exist or has expired
-            return false;
-        }
-        // Update the azureTranscription and status fields
-        await this.redisClient.hset(`audioStt:${audioSttId}`, {
-            azureTranscription,
-            status
-        });
-        return true;
-    }
-}
-exports.AudioSttManager = AudioSttManager;

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

@@ -1,76 +0,0 @@
-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,227 +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) {
-        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;