@mulingai-npm/redis 3.40.19 → 3.40.21

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

@@ -79,6 +79,13 @@ export declare class MulingstreamChunkManager {
     initRoom(roomId: string): Promise<boolean>;
     getRooms(): Promise<string[]>;
     getMulingstreamChunksByRoom(roomId: string): Promise<MulingstreamChunkData[] | null>;
+    /**
+     * Return the most recent `limit` chunks for a room, ordered oldest → newest.
+     * Used by the /translation-history and /transcription-history endpoints
+     * (§0.8) to prime listeners' panels when they switch language or toggle
+     * Speaker's Words on.
+     */
+    getRecentChunks(roomId: string, limit: number): Promise<MulingstreamChunkData[]>;
     getRoomById(roomId: string): Promise<MulingstreamChunkData[]>;
     /**
      * Add a streaming chunk with STT already completed

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

@@ -73,6 +73,25 @@ class MulingstreamChunkManager {
             return null;
         return res === null || res === void 0 ? void 0 : res.map(([, d]) => this.hashToChunk(d));
     }
+    /**
+     * Return the most recent `limit` chunks for a room, ordered oldest → newest.
+     * Used by the /translation-history and /transcription-history endpoints
+     * (§0.8) to prime listeners' panels when they switch language or toggle
+     * Speaker's Words on.
+     */
+    async getRecentChunks(roomId, limit) {
+        if (limit <= 0)
+            return [];
+        const ids = await this.redisClient.zrange(this.roomZsetKey(roomId), -limit, -1);
+        if (!ids.length)
+            return [];
+        const pipe = this.redisClient.pipeline();
+        ids.forEach((cid) => pipe.hgetall(this.chunkHashKey(cid)));
+        const res = await pipe.exec();
+        if (!res)
+            return [];
+        return res.map(([, d]) => this.hashToChunk(d));
+    }
     getRoomById(roomId) {
         return this.getMulingstreamChunksByRoom(roomId);
     }

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

@@ -1,4 +1,5 @@
 import { RedisClient } from '../redis-client';
+export type ListenerBreakpoint = 'mobile' | 'desktop' | 'display';
 export type MulingstreamListenerData = {
     listenerId: string;
     roomId: string;
@@ -10,6 +11,7 @@ export type MulingstreamListenerData = {
     language?: string;
     color?: string;
     isListening?: boolean;
+    breakpoint?: ListenerBreakpoint;
 };
 export declare class MulingstreamListenerManager {
     private redisClient;
@@ -22,6 +24,11 @@ export declare class MulingstreamListenerManager {
     removeListener(tokenOrListenerId: string): Promise<MulingstreamListenerData | null>;
     updateNameLanguage(listenerIdOrToken: string, name: string, language: string): Promise<MulingstreamListenerData | null>;
     updateSocketId(listenerIdOrToken: string, socketId: string): Promise<MulingstreamListenerData | null>;
+    /**
+     * Update viewport breakpoint. Called on LISTENER_JOINED and on UPDATE_BREAKPOINT
+     * (resize crossing the 1024px threshold). Drives Socket.IO room membership (§0.8).
+     */
+    updateBreakpoint(listenerIdOrToken: string, breakpoint: ListenerBreakpoint): Promise<MulingstreamListenerData | null>;
     getTargetSocketIdsByRoomLanguage(roomId: string, language: string): Promise<string[]>;
     getUniqueLanguagesByRoom(roomId: string): Promise<string[]>;
     updateHeartbeat(listenerIdOrToken: string): Promise<MulingstreamListenerData | null>;

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

@@ -36,6 +36,7 @@ class MulingstreamListenerManager {
         this.redisClient = redisClient;
     }
     parseHashData(data) {
+        const bp = data.breakpoint;
         return {
             listenerId: data.listenerId,
             roomId: data.roomId,
@@ -46,14 +47,15 @@ class MulingstreamListenerManager {
             lastHeartbeat: parseInt(data.lastHeartbeat, 10),
             language: data.language || '',
             color: data.color || '',
-            isListening: data.isListening === 'true'
+            isListening: data.isListening === 'true',
+            breakpoint: bp === 'mobile' || bp === 'desktop' || bp === 'display' ? bp : undefined
         };
     }
     // Creates a new listener.
     // -Generates a unique listenerId and adds it to the room's set.
     // -Stores the listener data in a Redis hash under `listener:{listenerId}`.
     async addListener(listenerData) {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
         // You can combine roomId + uuid, or just a uuid, up to you:
         const listenerId = listenerData.listenerId;
         // Generate a unique bright color for this listener's activity log
@@ -71,7 +73,8 @@ class MulingstreamListenerManager {
             lastHeartbeat: listenerData.lastHeartbeat.toString(),
             language: (_c = listenerData.language) !== null && _c !== void 0 ? _c : '',
             color,
-            isListening: 'false'
+            isListening: 'false',
+            breakpoint: (_d = listenerData.breakpoint) !== null && _d !== void 0 ? _d : ''
         });
         // expire listener
         await this.redisClient.expire(`listener:${listenerId}`, EXPIRATION);
@@ -166,6 +169,18 @@ class MulingstreamListenerManager {
         });
         return { ...listener, socketId };
     }
+    /**
+     * Update viewport breakpoint. Called on LISTENER_JOINED and on UPDATE_BREAKPOINT
+     * (resize crossing the 1024px threshold). Drives Socket.IO room membership (§0.8).
+     */
+    async updateBreakpoint(listenerIdOrToken, breakpoint) {
+        const listener = await this.getListener(listenerIdOrToken);
+        if (!listener) {
+            return null;
+        }
+        await this.redisClient.hset(`listener:${listener.listenerId}`, { breakpoint });
+        return { ...listener, breakpoint };
+    }
     async getTargetSocketIdsByRoomLanguage(roomId, language) {
         const listeners = await this.getListenersByRoom(roomId);
         const filteredListeners = listeners.filter((listener) => {

package/package.json

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