@mulingai-npm/redis 1.8.1 → 1.10.0

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

@@ -4,11 +4,15 @@ export type TranslationStatus = 'INIT' | 'DISCARDED' | 'READY' | 'USED';
 export type TtsStatus = 'INIT' | 'DISCARDED' | 'READY' | 'USED';
 export type MulingstreamChunkStatus = 'INIT' | 'IN_PROGRESS' | 'DISCARDED' | 'USED';
 export type MulingstreamChunkStep = 'RECEIVED' | 'STT' | 'TRANSLATION' | 'TTS' | 'EMITTED' | 'COMPLETED' | 'CANCELED';
+export type SttProvider = 'azure' | 'whisper' | 'google' | 'aws';
 export type MulingstreamChunkData = {
     mulingstreamChunkId: string;
     roomId: string;
     chunkNumber: number;
     language: string;
+    sttProviders: SttProvider[];
+    targetLanguages: string[];
+    finalTranscription: string;
     mulingstreamChunkStatus: MulingstreamChunkStatus;
     mulingstreamChunkStep: MulingstreamChunkStep;
     audioChunk: {
@@ -21,19 +25,21 @@ export type MulingstreamChunkData = {
         processingStart: number;
     };
     stt: {
-        services: string[];
-        azureTranscription?: string;
-        whisperTranscription?: string;
-        googleTranscription?: string;
-        finalTranscription: string;
-        status: SttStatus;
+        [sttService: string]: {
+            transcription: string;
+            status: SttStatus;
+        };
     };
-    postStt: {
+    translation: {
         [language: string]: {
             translation: string;
-            translationStatus: TranslationStatus;
+            status: TranslationStatus;
+        };
+    };
+    tts: {
+        [language: string]: {
             ttsAudioPath: string;
-            ttsStatus: TtsStatus;
+            status: TtsStatus;
             isEmitted: boolean;
         };
     };
@@ -52,13 +58,32 @@ export declare class MulingstreamChunkManager {
         isFirst: boolean;
         isLast: boolean;
         theme: string;
-        services: string[];
-        postSttLanguages: string[];
+        sttProviders: SttProvider[];
+        targetLanguages: string[];
     }): Promise<string>;
     getMulingstreamChunks(): Promise<MulingstreamChunkData[]>;
     getMulingstreamChunk(mulingstreamChunkId: string): Promise<MulingstreamChunkData | null>;
     getMulingstreamChunksByRoom(roomId: string): Promise<MulingstreamChunkData[]>;
     getByChunkNumber(chunkNumber: number, roomId: string): Promise<MulingstreamChunkData | null>;
-    updateSttStatus(mulingstreamChunkId: string, status: SttStatus, chunkStatus: MulingstreamChunkStatus, chunkStep: MulingstreamChunkStep): Promise<boolean>;
-    updateAzureTranscription(mulingstreamChunkId: string, transcription: string, sttStatus: SttStatus, chunkStatus: MulingstreamChunkStatus, chunkStep: MulingstreamChunkStep): Promise<boolean>;
+    /**
+     * Updates the STT status for a given service in the chunk's STT data.
+     *
+     * @param mulingstreamChunkId The chunk ID.
+     * @param status The new SttStatus to set (INIT, DISCARDED, READY, USED).
+     * @param service Which STT service to update (must be among the chunk's services).
+     * @param chunkStatus Overall chunk status (e.g. IN_PROGRESS, DISCARDED, USED).
+     * @param chunkStep Overall chunk step (e.g. STT, TRANSLATION, etc.).
+     */
+    updateSttStatus(mulingstreamChunkId: string, status: SttStatus, service: SttProvider, chunkStatus: MulingstreamChunkStatus, chunkStep: MulingstreamChunkStep): Promise<boolean>;
+    /**
+     * Updates the transcription + status for a given service in the chunk's STT data.
+     *
+     * @param mulingstreamChunkId The chunk ID.
+     * @param transcription The transcription text to store.
+     * @param sttStatus The new status for this STT service.
+     * @param service Which STT service to update.
+     * @param chunkStatus Overall chunk status (e.g. IN_PROGRESS, DISCARDED, USED).
+     * @param chunkStep Overall chunk step (e.g. STT, TRANSLATION, etc.).
+     */
+    updateTranscription(mulingstreamChunkId: string, transcription: string, sttStatus: SttStatus, service: SttProvider, chunkStatus: MulingstreamChunkStatus, chunkStep: MulingstreamChunkStep): Promise<boolean>;
 }

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

@@ -8,20 +8,27 @@ class MulingstreamChunkManager {
         this.redisClient = redisClient;
     }
     parseHashData(data) {
-        // Parse nested JSON fields
+        // Parse the arrays and nested JSON fields
+        const sttProviders = JSON.parse(data.sttProviders);
+        const targetLanguages = JSON.parse(data.targetLanguages);
         const audioChunk = JSON.parse(data.audioChunk);
         const stt = JSON.parse(data.stt);
-        const postStt = JSON.parse(data.postStt);
+        const translation = JSON.parse(data.translation);
+        const tts = JSON.parse(data.tts);
         return {
             mulingstreamChunkId: data.mulingstreamChunkId,
             roomId: data.roomId,
             chunkNumber: parseInt(data.chunkNumber, 10),
             language: data.language,
+            sttProviders,
+            targetLanguages,
+            finalTranscription: data.finalTranscription,
             mulingstreamChunkStatus: data.mulingstreamChunkStatus,
             mulingstreamChunkStep: data.mulingstreamChunkStep,
             audioChunk,
             stt,
-            postStt
+            translation,
+            tts
         };
     }
     // Adds a new mulingstream chunk.
@@ -29,7 +36,7 @@ class MulingstreamChunkManager {
     // - Stores the chunk data in a Redis hash under `mulingstreamChunk:{mulingstreamChunkId}`.
     // - Applies an expiration (12h).
     async addMulingstreamChunk(params) {
-        const { roomId, chunkNumber, language, start, end, duration, isFirst, isLast, theme, services, postSttLanguages } = params;
+        const { roomId, chunkNumber, language, start, end, duration, isFirst, isLast, theme, sttProviders, targetLanguages } = params;
         const mulingstreamChunkId = `[${roomId}]-[${chunkNumber}]-[${(0, uuid_1.v4)()}]`;
         // Prepare the nested objects
         const audioChunk = {
@@ -41,36 +48,46 @@ class MulingstreamChunkManager {
             theme,
             processingStart: Date.now()
         };
-        const stt = {
-            services,
-            azureTranscription: '',
-            whisperTranscription: '',
-            googleTranscription: '',
-            finalTranscription: '',
-            status: 'INIT'
-        };
-        // Build postStt object keyed by each language
-        const postStt = {};
-        for (const lang of postSttLanguages) {
-            postStt[lang] = {
+        // Build the STT object
+        // For each service in `services`, create { transcription: '', status: 'INIT' }
+        const stt = {};
+        for (const service of sttProviders) {
+            stt[service] = {
+                transcription: '',
+                status: 'INIT'
+            };
+        }
+        // Build translation & tts objects keyed by each target language
+        const translation = {};
+        const tts = {};
+        for (const lang of targetLanguages) {
+            translation[lang] = {
                 translation: '',
-                translationStatus: 'INIT',
+                status: 'INIT'
+            };
+            tts[lang] = {
                 ttsAudioPath: '',
-                ttsStatus: 'INIT',
+                status: 'INIT',
                 isEmitted: false
             };
         }
+        // Root-level finalTranscription is empty initially
+        const finalTranscription = '';
         // Store the data in a Redis hash
         await this.redisClient.hset(`mulingstreamChunk:${mulingstreamChunkId}`, {
             mulingstreamChunkId,
             roomId,
             chunkNumber: chunkNumber.toString(),
             language,
+            sttProviders: JSON.stringify(sttProviders),
+            targetLanguages: JSON.stringify(targetLanguages),
+            finalTranscription,
             mulingstreamChunkStatus: 'INIT',
             mulingstreamChunkStep: 'RECEIVED',
             audioChunk: JSON.stringify(audioChunk),
             stt: JSON.stringify(stt),
-            postStt: JSON.stringify(postStt)
+            translation: JSON.stringify(translation),
+            tts: JSON.stringify(tts)
         });
         // set expiration
         await this.redisClient.expire(`mulingstreamChunk:${mulingstreamChunkId}`, EXPIRATION);
@@ -131,17 +148,25 @@ class MulingstreamChunkManager {
         }
         return this.parseHashData(data);
     }
-    async updateSttStatus(mulingstreamChunkId, status, chunkStatus, chunkStep) {
-        // Fetch the chunk data first
+    /**
+     * Updates the STT status for a given service in the chunk's STT data.
+     *
+     * @param mulingstreamChunkId The chunk ID.
+     * @param status The new SttStatus to set (INIT, DISCARDED, READY, USED).
+     * @param service Which STT service to update (must be among the chunk's services).
+     * @param chunkStatus Overall chunk status (e.g. IN_PROGRESS, DISCARDED, USED).
+     * @param chunkStep Overall chunk step (e.g. STT, TRANSLATION, etc.).
+     */
+    async updateSttStatus(mulingstreamChunkId, status, service, chunkStatus, chunkStep) {
         const data = await this.redisClient.hgetall(`mulingstreamChunk:${mulingstreamChunkId}`);
         if (!data || !data.mulingstreamChunkId) {
-            return false; // The chunk may not exist or has expired
+            return false;
         }
-        // Parse the existing stt field
         const stt = JSON.parse(data.stt);
-        // Update the status
-        stt.status = status;
-        // Write back the updated stt object
+        if (!stt[service]) {
+            return false; // service not in stt object
+        }
+        stt[service].status = status;
         await this.redisClient.hset(`mulingstreamChunk:${mulingstreamChunkId}`, {
             mulingstreamChunkStatus: chunkStatus,
             mulingstreamChunkStep: chunkStep,
@@ -149,18 +174,27 @@ class MulingstreamChunkManager {
         });
         return true;
     }
-    async updateAzureTranscription(mulingstreamChunkId, transcription, sttStatus, chunkStatus, chunkStep) {
-        // Fetch the chunk data first
+    /**
+     * Updates the transcription + status for a given service in the chunk's STT data.
+     *
+     * @param mulingstreamChunkId The chunk ID.
+     * @param transcription The transcription text to store.
+     * @param sttStatus The new status for this STT service.
+     * @param service Which STT service to update.
+     * @param chunkStatus Overall chunk status (e.g. IN_PROGRESS, DISCARDED, USED).
+     * @param chunkStep Overall chunk step (e.g. STT, TRANSLATION, etc.).
+     */
+    async updateTranscription(mulingstreamChunkId, transcription, sttStatus, service, chunkStatus, chunkStep) {
         const data = await this.redisClient.hgetall(`mulingstreamChunk:${mulingstreamChunkId}`);
         if (!data || !data.mulingstreamChunkId) {
-            return false; // The chunk may not exist or has expired
+            return false;
         }
-        // Parse the existing stt field
         const stt = JSON.parse(data.stt);
-        // Update fields
-        stt.azureTranscription = transcription;
-        stt.status = sttStatus;
-        // Write back the updated stt object
+        if (!stt[service]) {
+            return false; // service not in stt object
+        }
+        stt[service].transcription = transcription;
+        stt[service].status = sttStatus;
         await this.redisClient.hset(`mulingstreamChunk:${mulingstreamChunkId}`, {
             mulingstreamChunkStatus: chunkStatus,
             mulingstreamChunkStep: chunkStep,

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

@@ -1,60 +0,0 @@
-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 MulingstreamChunkData = {
-    mulingstreamChunkId: string;
-    roomId: string;
-    chunkNumber: number;
-    language: string;
-    mulingstreamChunkStatus: MulingstreamChunkStatus;
-    audioChunk: {
-        start: number;
-        end: number;
-        duration: number;
-        isFirst: boolean;
-        isLast: boolean;
-        theme: string;
-        processingStart: number;
-    };
-    stt: {
-        services: string[];
-        azureTranscription?: string;
-        whisperTranscription?: string;
-        googleTranscription?: string;
-        finalTranscription: string;
-        status: SttStatus;
-    };
-    postStt: {
-        [language: string]: {
-            translation: string;
-            translationStatus: TranslationStatus;
-            ttsAudioPath: string;
-            ttsStatus: TtsStatus;
-            isEmitted: boolean;
-        };
-    };
-};
-export declare class MulingstreamChunkManager {
-    private redisClient;
-    constructor(redisClient: RedisClient);
-    private parseHashData;
-    addMulingstreamChunk(params: {
-        roomId: string;
-        chunkNumber: number;
-        language: string;
-        start: number;
-        end: number;
-        duration: number;
-        isFirst: boolean;
-        isLast: boolean;
-        theme: string;
-        services: string[];
-        postSttLanguages: string[];
-    }): Promise<string>;
-    getMulingstreamChunks(): Promise<MulingstreamChunkData[]>;
-    getMulingstreamChunk(mulingstreamChunkId: string): Promise<MulingstreamChunkData | null>;
-    getMulingstreamChunksByRoom(roomId: string): Promise<MulingstreamChunkData[]>;
-    getByChunkNumber(chunkNumber: number, roomId: string): Promise<MulingstreamChunkData | null>;
-}

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

@@ -1,133 +1,174 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.MulingstreamChunkManager = void 0;
-const uuid_1 = require("uuid");
-const EXPIRATION = 4 * 60 * 60; // 4 hours in seconds
-class MulingstreamChunkManager {
-    constructor(redisClient) {
-        this.redisClient = redisClient;
-    }
-    parseHashData(data) {
-        // 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,
-            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).
-    async addMulingstreamChunk(params) {
-        const { roomId, chunkNumber, language, start, end, duration, isFirst, isLast, theme, services, postSttLanguages } = params;
-        const mulingstreamChunkId = `[${roomId}]-[${chunkNumber}]-[${(0, uuid_1.v4)()}]`;
-        // Prepare the nested objects
-        const audioChunk = {
-            start,
-            end,
-            duration,
-            isFirst,
-            isLast,
-            theme,
-            processingStart: Date.now()
-        };
-        const stt = {
-            services,
-            azureTranscription: '',
-            whisperTranscription: '',
-            googleTranscription: '',
-            finalTranscription: '',
-            status: 'INIT'
-        };
-        // Build postStt object keyed by each language
-        const 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:*`.
-    async getMulingstreamChunks() {
-        const keys = await this.redisClient.keys('mulingstreamChunk:*');
-        if (!keys || keys.length === 0) {
-            return [];
-        }
-        const results = [];
-        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.
-    async getMulingstreamChunk(mulingstreamChunkId) {
-        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]-*`.
-    async getMulingstreamChunksByRoom(roomId) {
-        const pattern = `mulingstreamChunk:[${roomId}]-*`;
-        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.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.
-    async getByChunkNumber(chunkNumber, roomId) {
-        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);
-    }
-}
-exports.MulingstreamChunkManager = MulingstreamChunkManager;
+// 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);
+//     }
+// }

package/package.json

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