@mulingai-npm/redis 1.6.1 → 1.7.0

package/dist/enums/redis-database.d.ts

@@ -1,4 +1,5 @@
 export declare enum RedisDatabase {
     MULINGSTREAM_LISTENER = 0,
-    AUDIO_STT = 1
+    MULINGSTREAM_ROOM = 1,
+    MULINGSTREAM_CHUNK = 2
 }

package/dist/enums/redis-database.js

@@ -4,5 +4,6 @@ exports.RedisDatabase = void 0;
 var RedisDatabase;
 (function (RedisDatabase) {
     RedisDatabase[RedisDatabase["MULINGSTREAM_LISTENER"] = 0] = "MULINGSTREAM_LISTENER";
-    RedisDatabase[RedisDatabase["AUDIO_STT"] = 1] = "AUDIO_STT";
+    RedisDatabase[RedisDatabase["MULINGSTREAM_ROOM"] = 1] = "MULINGSTREAM_ROOM";
+    RedisDatabase[RedisDatabase["MULINGSTREAM_CHUNK"] = 2] = "MULINGSTREAM_CHUNK";
 })(RedisDatabase = exports.RedisDatabase || (exports.RedisDatabase = {}));

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

@@ -0,0 +1,60 @@
+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

@@ -0,0 +1,133 @@
+"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;

package/package.json

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