@mulingai-npm/redis 3.40.3 → 3.40.5

package/dist/managers/context-enhancer-manager.d.ts

@@ -6,18 +6,33 @@
  * to improve translation quality and transcription correction.
  *
  * Redis key: smarttranslate:context-enhancer:{roomId}
- * Type: String (raw text, up to 15,000 chars)
- * TTL: 36 hours (covers "prep day before" use case)
+ * Type: String (JSON: { text, savedAt })
+ * TTL: environment-dependent (15min localhost, 30min development, 36h production)
  */
 import { RedisClient } from '../redis-client';
+export interface ContextEnhancerResult {
+    text: string;
+    savedAt: number;
+    expiresAt: number;
+    ttlSeconds: number;
+}
 export declare class ContextEnhancerManager {
     private redisClient;
-    constructor(redisClient: RedisClient);
+    private ttlSeconds;
+    constructor(redisClient: RedisClient, environment?: string);
     private key;
-    /** Save context text for a room. Truncates to MAX_CHARS. */
+    /** Get TTL configured for this environment (in seconds) */
+    getTtlSeconds(): number;
+    /** Check cooldown. Returns remaining seconds (0 = no cooldown). */
+    getCooldownRemaining(roomId: string | number): Promise<number>;
+    /** Save context text for a room. Truncates to MAX_CHARS. Call getCooldownRemaining() first. */
     saveContext(roomId: string | number, text: string): Promise<void>;
-    /** Get context text for a room. Returns null if expired or not set. */
-    getContext(roomId: string | number): Promise<string | null>;
+    /** Get raw context data (internal). */
+    private getContextData;
+    /** Get context with metadata (text, savedAt, expiresAt, ttlSeconds). */
+    getContext(roomId: string | number): Promise<ContextEnhancerResult | null>;
+    /** Get just the text (for pipeline injection, no metadata overhead). */
+    getContextText(roomId: string | number): Promise<string | null>;
     /** Delete context text for a room. */
     deleteContext(roomId: string | number): Promise<void>;
     /** Check if context text exists for a room (not expired). */

package/dist/managers/context-enhancer-manager.js

@@ -7,30 +7,85 @@
  * to improve translation quality and transcription correction.
  *
  * Redis key: smarttranslate:context-enhancer:{roomId}
- * Type: String (raw text, up to 15,000 chars)
- * TTL: 36 hours (covers "prep day before" use case)
+ * Type: String (JSON: { text, savedAt })
+ * TTL: environment-dependent (15min localhost, 30min development, 36h production)
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContextEnhancerManager = void 0;
-const CONTEXT_ENHANCER_TTL = 36 * 60 * 60; // 36 hours
 const MAX_CHARS = 15000;
+const COOLDOWN_SECONDS = 60; // 1 minute cooldown between saves
+// TTL by environment (seconds)
+const TTL_BY_ENV = {
+    localhost: 15 * 60,
+    development: 30 * 60,
+    production: 36 * 60 * 60 // 36 hours
+};
 class ContextEnhancerManager {
-    constructor(redisClient) {
+    constructor(redisClient, environment) {
         this.redisClient = redisClient;
+        this.ttlSeconds = TTL_BY_ENV[environment || 'production'] || TTL_BY_ENV.production;
     }
     key(roomId) {
         return `smarttranslate:context-enhancer:${roomId}`;
     }
-    /** Save context text for a room. Truncates to MAX_CHARS. */
+    /** Get TTL configured for this environment (in seconds) */
+    getTtlSeconds() {
+        return this.ttlSeconds;
+    }
+    /** Check cooldown. Returns remaining seconds (0 = no cooldown). */
+    async getCooldownRemaining(roomId) {
+        const existing = await this.getContextData(roomId);
+        if (!existing)
+            return 0;
+        const elapsedSeconds = (Date.now() - existing.savedAt) / 1000;
+        if (elapsedSeconds < COOLDOWN_SECONDS) {
+            return Math.ceil(COOLDOWN_SECONDS - elapsedSeconds);
+        }
+        return 0;
+    }
+    /** Save context text for a room. Truncates to MAX_CHARS. Call getCooldownRemaining() first. */
     async saveContext(roomId, text) {
         const truncated = text.slice(0, MAX_CHARS);
+        const data = {
+            text: truncated,
+            savedAt: Date.now()
+        };
         const key = this.key(roomId);
-        await this.redisClient.set(key, truncated);
-        await this.redisClient.expire(key, CONTEXT_ENHANCER_TTL);
+        await this.redisClient.set(key, JSON.stringify(data));
+        await this.redisClient.expire(key, this.ttlSeconds);
     }
-    /** Get context text for a room. Returns null if expired or not set. */
+    /** Get raw context data (internal). */
+    async getContextData(roomId) {
+        const raw = await this.redisClient.get(this.key(roomId));
+        if (!raw)
+            return null;
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            // Legacy plain text format (before JSON migration)
+            return { text: raw, savedAt: Date.now() };
+        }
+    }
+    /** Get context with metadata (text, savedAt, expiresAt, ttlSeconds). */
     async getContext(roomId) {
-        return this.redisClient.get(this.key(roomId));
+        const data = await this.getContextData(roomId);
+        if (!data)
+            return null;
+        const remainingTtl = await this.redisClient.ttl(this.key(roomId));
+        if (remainingTtl < 0)
+            return null; // expired or no TTL
+        return {
+            text: data.text,
+            savedAt: data.savedAt,
+            expiresAt: Date.now() + (remainingTtl * 1000),
+            ttlSeconds: remainingTtl
+        };
+    }
+    /** Get just the text (for pipeline injection, no metadata overhead). */
+    async getContextText(roomId) {
+        const data = await this.getContextData(roomId);
+        return (data === null || data === void 0 ? void 0 : data.text) || null;
     }
     /** Delete context text for a room. */
     async deleteContext(roomId) {

package/dist/redis-client.d.ts

@@ -14,6 +14,8 @@ export declare class RedisClient {
     del(key: string): Promise<number>;
     exists(key: string): Promise<number>;
     expire(key: string, seconds: number): Promise<number>;
+    /** Get remaining TTL in seconds (-1 = no expiry, -2 = key doesn't exist) */
+    ttl(key: string): Promise<number>;
     sadd(key: string, ...values: string[]): Promise<number>;
     srem(key: string, ...values: string[]): Promise<number>;
     smembers(key: string): Promise<string[]>;

package/dist/redis-client.js

@@ -37,6 +37,10 @@ class RedisClient {
     async expire(key, seconds) {
         return this.client.expire(key, seconds);
     }
+    /** Get remaining TTL in seconds (-1 = no expiry, -2 = key doesn't exist) */
+    async ttl(key) {
+        return this.client.ttl(key);
+    }
     async sadd(key, ...values) {
         return this.client.sadd(key, values);
     }

package/package.json

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