vidspotai-shared 1.0.68 → 1.0.69-dev.0

package/lib/services/redis.service.d.ts

@@ -1,3 +1,4 @@
+import { Redis as RedisClient } from "ioredis";
 export declare class RedisService {
     private static instance;
     private client?;
@@ -10,6 +11,14 @@ export declare class RedisService {
     connect(): Promise<void>;
     /** Guard helper */
     private ensureClient;
+    /**
+     * Returns the raw ioredis client when initialized, otherwise undefined.
+     * Used by services that need low-level commands (EVAL/Lua, ZADD, etc.)
+     * without going through the JSON-wrapping convenience methods. Callers
+     * MUST fail open when this returns undefined — Redis is optional in
+     * local dev when REDIS_URL is unset.
+     */
+    getClient(): RedisClient | undefined;
     set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
     get<T>(key: string): Promise<T | null>;
     delete(key: string): Promise<void>;

package/lib/services/redis.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis.service.d.ts","sourceRoot":"","sources":["../../src/services/redis.service.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO;WAKO,WAAW,IAAI,YAAY;IAOzC,mDAAmD;IACnD,OAAO,CAAC,UAAU;IA2BlB,uBAAuB;IACV,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAarC,mBAAmB;IACnB,OAAO,CAAC,YAAY;IASP,GAAG,CAAC,CAAC,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAWH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAMtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKnD,mBAAmB,CAAC,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,SAAI,GACV,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKP,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAK1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC;AAGD,eAAO,MAAM,KAAK,cAA6B,CAAC;AAEhD,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/C"}
+{"version":3,"file":"redis.service.d.ts","sourceRoot":"","sources":["../../src/services/redis.service.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,SAAS,CAAC;AAItD,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,MAAM,CAAC,CAAc;IAC7B,OAAO,CAAC,SAAS,CAAS;IAE1B,OAAO;WAKO,WAAW,IAAI,YAAY;IAOzC,mDAAmD;IACnD,OAAO,CAAC,UAAU;IAwBlB,uBAAuB;IACV,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAarC,mBAAmB;IACnB,OAAO,CAAC,YAAY;IAOpB;;;;;;OAMG;IACI,SAAS,IAAI,WAAW,GAAG,SAAS;IAM9B,GAAG,CAAC,CAAC,EAChB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,CAAC,EACR,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC;IAWH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAMtC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlC,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKnD,mBAAmB,CAAC,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,SAAI,GACV,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKP,OAAO,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAK1C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAGvC;AAGD,eAAO,MAAM,KAAK,cAA6B,CAAC;AAEhD,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAE/C"}

package/lib/services/redis.service.js

@@ -6,10 +6,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.redis = exports.RedisService = void 0;
 exports.initRedis = initRedis;
 const ioredis_1 = __importDefault(require("ioredis"));
+const logger_1 = require("../utils/logger");
+const redisOptions_1 = require("./redisOptions");
 class RedisService {
     constructor() {
         this.connected = false;
-        console.log("🔰 RedisService created (lazy init)");
+        logger_1.logger.info("RedisService created (lazy init)");
     }
     // Singleton
     static getInstance() {
@@ -24,20 +26,17 @@ class RedisService {
             return;
         const redisUrl = process.env.REDIS_URL;
         if (!redisUrl) {
-            console.warn("⚠️ REDIS_URL not set — Redis will not be initialized");
+            logger_1.logger.warn("REDIS_URL not set — Redis will not be initialized");
             return;
         }
-        console.log("🔰 Initializing Redis Client with REDIS_URL");
-        this.client = new ioredis_1.default(redisUrl, {
-            maxRetriesPerRequest: null,
-            enableReadyCheck: true,
-        });
-        this.client.on("connect", () => {
+        logger_1.logger.info("Initializing Redis Client with REDIS_URL");
+        this.client = new ioredis_1.default(redisUrl, redisOptions_1.sharedRedisOptions);
+        (0, redisOptions_1.attachRedisListeners)(this.client, "RedisService");
+        this.client.on("ready", () => {
             this.connected = true;
-            console.log("✅ Connected to Redis Cloud");
         });
-        this.client.on("error", (err) => {
-            console.error("❌ Redis Client Error:", err);
+        this.client.on("end", () => {
+            this.connected = false;
         });
     }
     /** Explicit connect */
@@ -58,6 +57,16 @@ class RedisService {
         }
         return this.client;
     }
+    /**
+     * Returns the raw ioredis client when initialized, otherwise undefined.
+     * Used by services that need low-level commands (EVAL/Lua, ZADD, etc.)
+     * without going through the JSON-wrapping convenience methods. Callers
+     * MUST fail open when this returns undefined — Redis is optional in
+     * local dev when REDIS_URL is unset.
+     */
+    getClient() {
+        return this.client;
+    }
     // ------------------ Commands ------------------
     async set(key, value, ttlSeconds) {
         const client = this.ensureClient();

package/lib/services/redisOptions.d.ts

@@ -0,0 +1,22 @@
+import type { RedisOptions } from "ioredis";
+/**
+ * Hardened shared ioredis options for both RedisService (cache) and
+ * BullMQ (queue connections). Both ioredis clients reconnect by default;
+ * this just makes it less chatty during prolonged outages, bounds the
+ * backoff, and handles READONLY errors during Redis Cloud failovers.
+ *
+ * - `maxRetriesPerRequest: null` — REQUIRED for BullMQ stability.
+ * - `retryStrategy` — exponential 200ms → 10s cap; infinite retries.
+ * - `reconnectOnError` — reconnect on READONLY (failover to a replica
+ *   that has since become primary).
+ */
+export declare const sharedRedisOptions: RedisOptions;
+/**
+ * Attach observability + error-dedupe listeners to an ioredis client.
+ * Reduces log spam during prolonged outages (e.g. DNS NXDOMAIN, network
+ * partition) where ioredis would otherwise emit an `error` every retry.
+ */
+export declare function attachRedisListeners(client: {
+    on: (ev: string, fn: (...a: any[]) => void) => void;
+}, label: string): void;
+//# sourceMappingURL=redisOptions.d.ts.map

package/lib/services/redisOptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redisOptions.d.ts","sourceRoot":"","sources":["../../src/services/redisOptions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAG5C;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,YAMhC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE;IAAE,EAAE,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,IAAI,KAAK,IAAI,CAAA;CAAE,EAC/D,KAAK,EAAE,MAAM,GACZ,IAAI,CAwBN"}

package/lib/services/redisOptions.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sharedRedisOptions = void 0;
+exports.attachRedisListeners = attachRedisListeners;
+const logger_1 = require("../utils/logger");
+/**
+ * Hardened shared ioredis options for both RedisService (cache) and
+ * BullMQ (queue connections). Both ioredis clients reconnect by default;
+ * this just makes it less chatty during prolonged outages, bounds the
+ * backoff, and handles READONLY errors during Redis Cloud failovers.
+ *
+ * - `maxRetriesPerRequest: null` — REQUIRED for BullMQ stability.
+ * - `retryStrategy` — exponential 200ms → 10s cap; infinite retries.
+ * - `reconnectOnError` — reconnect on READONLY (failover to a replica
+ *   that has since become primary).
+ */
+exports.sharedRedisOptions = {
+    maxRetriesPerRequest: null,
+    enableReadyCheck: true,
+    enableOfflineQueue: true,
+    retryStrategy: (times) => Math.min(200 * Math.pow(1.5, times), 10000),
+    reconnectOnError: (err) => err.message.includes("READONLY"),
+};
+/**
+ * Attach observability + error-dedupe listeners to an ioredis client.
+ * Reduces log spam during prolonged outages (e.g. DNS NXDOMAIN, network
+ * partition) where ioredis would otherwise emit an `error` every retry.
+ */
+function attachRedisListeners(client, label) {
+    let lastErrCode;
+    let lastErrAt = 0;
+    const ERR_LOG_WINDOW_MS = 60000;
+    client.on("connect", () => logger_1.logger.info(`redis connecting`, { label }));
+    client.on("ready", () => logger_1.logger.info(`redis ready`, { label }));
+    client.on("reconnecting", (delay) => logger_1.logger.info(`redis reconnecting`, { label, delayMs: delay }));
+    client.on("end", () => logger_1.logger.info(`redis connection ended`, { label }));
+    client.on("close", () => logger_1.logger.info(`redis connection closed`, { label }));
+    client.on("error", (err) => {
+        const code = err.code ?? err.message;
+        const now = Date.now();
+        if (code === lastErrCode && now - lastErrAt < ERR_LOG_WINDOW_MS)
+            return;
+        lastErrCode = code;
+        lastErrAt = now;
+        logger_1.logger.error("redis: connection error", {
+            label,
+            code,
+            err: err?.stack ?? err?.message ?? String(err),
+        });
+    });
+}

package/lib/services/tts/index.d.ts

@@ -1,4 +1,6 @@
 export * from "./types";
 export * from "./providers/elevenlabs.service";
+export * from "./providers/minimax.service";
+export * from "./providers/openai.service";
 export * from "./ttsFactory.service";
 //# sourceMappingURL=index.d.ts.map

package/lib/services/tts/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/tts/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/tts/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,gCAAgC,CAAC;AAC/C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sBAAsB,CAAC"}

package/lib/services/tts/index.js

@@ -16,4 +16,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./types"), exports);
 __exportStar(require("./providers/elevenlabs.service"), exports);
+__exportStar(require("./providers/minimax.service"), exports);
+__exportStar(require("./providers/openai.service"), exports);
 __exportStar(require("./ttsFactory.service"), exports);

package/lib/services/tts/providers/elevenlabs.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"elevenlabs.service.d.ts","sourceRoot":"","sources":["../../../../src/services/tts/providers/elevenlabs.service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiBzF,qBAAa,iBAAkB,SAAQ,sBAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAW1B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IA6DrD;;;;;OAKG;YACW,gBAAgB;IAuC9B,SAAS,IAAI,eAAe,EAAE;IAI9B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGpD"}
+{"version":3,"file":"elevenlabs.service.d.ts","sourceRoot":"","sources":["../../../../src/services/tts/providers/elevenlabs.service.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiBzF,qBAAa,iBAAkB,SAAQ,sBAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkC;IAE1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAW1B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAuFrD;;;;;OAKG;YACW,gBAAgB;IAsD9B,SAAS,IAAI,eAAe,EAAE;IAI9B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGpD"}

package/lib/services/tts/providers/elevenlabs.service.js

@@ -39,22 +39,53 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
             ? this.mapLanguageCode(params.languageCode)
             : undefined;
         const modelId = params.modelIdOverride ?? elevenlabs_1.elevenlabsConfig.modelId;
-        const buildBody = (lang) => ({
-            text: params.text,
-            model_id: modelId,
-            language_code: lang,
-            voice_settings: {
-                stability: 0.5,
-                similarity_boost: 0.75,
-            },
-        });
-        try {
-            const audioBuffer = await this.postTtsWithRetry(voiceId, buildBody(languageCode));
-            return {
-                audioBuffer,
-                mimeType: "audio/mpeg",
-                extension: "mp3",
+        // Compose voice_settings only with defined keys so we don't overwrite
+        // server-side defaults for fields the caller didn't touch.
+        const voiceSettings = {
+            stability: params.stability ?? 0.5,
+            similarity_boost: params.similarityBoost ?? 0.75,
+        };
+        if (params.style !== undefined)
+            voiceSettings.style = params.style;
+        if (params.useSpeakerBoost !== undefined)
+            voiceSettings.use_speaker_boost = params.useSpeakerBoost;
+        if (params.speed !== undefined)
+            voiceSettings.speed = params.speed;
+        const buildBody = (lang) => {
+            const body = {
+                text: params.text,
+                model_id: modelId,
+                language_code: lang,
+                voice_settings: voiceSettings,
             };
+            if (params.seed !== undefined)
+                body.seed = params.seed;
+            if (params.previousText)
+                body.previous_text = params.previousText;
+            if (params.nextText)
+                body.next_text = params.nextText;
+            if (params.previousRequestIds?.length)
+                body.previous_request_ids = params.previousRequestIds.slice(0, 3);
+            if (params.nextRequestIds?.length)
+                body.next_request_ids = params.nextRequestIds.slice(0, 3);
+            if (params.applyTextNormalization)
+                body.apply_text_normalization = params.applyTextNormalization;
+            if (params.applyLanguageTextNormalization !== undefined) {
+                body.apply_language_text_normalization = params.applyLanguageTextNormalization;
+            }
+            if (params.pronunciationDictionaryLocators?.length) {
+                body.pronunciation_dictionary_locators = params.pronunciationDictionaryLocators.slice(0, 3);
+            }
+            return body;
+        };
+        const outputFormat = params.outputFormat;
+        const { mimeType, extension } = mimeFromOutputFormat(outputFormat);
+        try {
+            const audioBuffer = await this.postTtsWithRetry(voiceId, buildBody(languageCode), {
+                outputFormat,
+                optimizeStreamingLatency: params.optimizeStreamingLatency,
+            });
+            return { audioBuffer, mimeType, extension };
         }
         catch (err) {
             // responseType:"arraybuffer" causes error bodies to arrive as Buffer/ArrayBuffer,
@@ -75,14 +106,15 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
                 if (err.response.status === 400 &&
                     languageCode &&
                     (detail.includes("language_code") || detail.includes("does not support"))) {
-                    const audioBuffer = await this.postTtsWithRetry(voiceId, buildBody(undefined));
-                    return {
-                        audioBuffer,
-                        mimeType: "audio/mpeg",
-                        extension: "mp3",
-                    };
+                    const audioBuffer = await this.postTtsWithRetry(voiceId, buildBody(undefined), {
+                        outputFormat,
+                        optimizeStreamingLatency: params.optimizeStreamingLatency,
+                    });
+                    return { audioBuffer, mimeType, extension };
                 }
-                throw new Error(`ElevenLabs TTS ${err.response.status}: ${detail} [voiceId=${voiceId}, languageCode=${languageCode ?? "none"}, modelId=${modelId}, textLen=${params.text?.length ?? 0}]`);
+                const wrapped = new Error(`ElevenLabs TTS ${err.response.status}: ${detail} [voiceId=${voiceId}, languageCode=${languageCode ?? "none"}, modelId=${modelId}, textLen=${params.text?.length ?? 0}]`);
+                wrapped.cause = err;
+                throw wrapped;
             }
             throw err;
         }
@@ -93,7 +125,14 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
      * HTTP 429 (rate limit, longer backoff), HTTP 5xx (server errors).
      * Does NOT retry: 400/401/403/404 (caller handles 400 language_code separately).
      */
-    async postTtsWithRetry(voiceId, body) {
+    async postTtsWithRetry(voiceId, body, opts) {
+        const query = {};
+        if (opts?.outputFormat)
+            query.output_format = opts.outputFormat;
+        if (opts?.optimizeStreamingLatency !== undefined) {
+            query.optimize_streaming_latency = opts.optimizeStreamingLatency;
+        }
+        const { mimeType } = mimeFromOutputFormat(opts?.outputFormat);
         let lastErr;
         for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
             try {
@@ -101,8 +140,9 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
                     headers: {
                         "xi-api-key": this.apiKey,
                         "Content-Type": "application/json",
-                        Accept: "audio/mpeg",
+                        Accept: mimeType,
                     },
+                    params: Object.keys(query).length ? query : undefined,
                     responseType: "arraybuffer",
                     timeout: PER_ATTEMPT_TIMEOUT_MS,
                 });
@@ -136,6 +176,33 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
     }
 }
 exports.ElevenLabsService = ElevenLabsService;
+/**
+ * Maps an ElevenLabs `output_format` query value (codec_sampleRate_bitrate)
+ * to the appropriate HTTP Accept header + file extension. Defaults to mp3
+ * when format is omitted so existing callers (no output_format set) keep
+ * the previous mp3_44100_128 behaviour.
+ */
+function mimeFromOutputFormat(fmt) {
+    if (!fmt)
+        return { mimeType: "audio/mpeg", extension: "mp3" };
+    const codec = fmt.split("_", 1)[0];
+    switch (codec) {
+        case "mp3":
+            return { mimeType: "audio/mpeg", extension: "mp3" };
+        case "pcm":
+            return { mimeType: "audio/pcm", extension: "pcm" };
+        case "wav":
+            return { mimeType: "audio/wav", extension: "wav" };
+        case "opus":
+            return { mimeType: "audio/opus", extension: "opus" };
+        case "alaw":
+            return { mimeType: "audio/alaw", extension: "alaw" };
+        case "ulaw":
+            return { mimeType: "audio/basic", extension: "ulaw" };
+        default:
+            return { mimeType: "audio/mpeg", extension: "mp3" };
+    }
+}
 function isTransientHttpError(err) {
     if (!err)
         return false;

package/lib/services/tts/providers/minimax.service.d.ts

@@ -0,0 +1,14 @@
+import { BaseTtsProviderService, ITtsVoiceOption, TtsParams, TtsResult } from "../types";
+/**
+ * MiniMax Speech-02-HD (T2A v2). Sync — POST /v1/t2a_v2 returns hex-encoded audio
+ * inline (decoded into Buffer; same response shape as music-1.5).
+ */
+export declare class MinimaxTtsService extends BaseTtsProviderService {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor();
+    generate(params: TtsParams): Promise<TtsResult>;
+    getVoices(): ITtsVoiceOption[];
+    mapLanguageCode(locale: string): string | undefined;
+}
+//# sourceMappingURL=minimax.service.d.ts.map

package/lib/services/tts/providers/minimax.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"minimax.service.d.ts","sourceRoot":"","sources":["../../../../src/services/tts/providers/minimax.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEzF;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,sBAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAU1B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAuDrD,SAAS,IAAI,eAAe,EAAE;IAI9B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGpD"}

package/lib/services/tts/providers/minimax.service.js

@@ -0,0 +1,78 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MinimaxTtsService = void 0;
+const axios_1 = __importDefault(require("axios"));
+const minimax_1 = require("../../../globals/ttsModels/providers/minimax");
+const voices_1 = require("../../../globals/ttsModels/voices");
+const types_1 = require("../types");
+/**
+ * MiniMax Speech-02-HD (T2A v2). Sync — POST /v1/t2a_v2 returns hex-encoded audio
+ * inline (decoded into Buffer; same response shape as music-1.5).
+ */
+class MinimaxTtsService extends types_1.BaseTtsProviderService {
+    constructor() {
+        super();
+        this.baseUrl = "https://api.minimax.io";
+        if (!process.env.MINIMAX_ACCESS_KEY) {
+            throw new Error("Missing MINIMAX_ACCESS_KEY in environment variables");
+        }
+        this.apiKey = process.env.MINIMAX_ACCESS_KEY;
+    }
+    async generate(params) {
+        const voiceId = params.voiceId ?? minimax_1.minimaxTtsConfig.defaultVoiceId;
+        const body = {
+            model: minimax_1.minimaxTtsConfig.modelId,
+            text: params.text,
+            voice_setting: {
+                voice_id: voiceId,
+                speed: 1.0,
+                vol: 1.0,
+                pitch: 0,
+            },
+            audio_setting: {
+                sample_rate: 32000,
+                bitrate: 128000,
+                format: "mp3",
+                channel: 1,
+            },
+        };
+        const langPair = params.languageCode ? this.mapLanguageCode(params.languageCode) : undefined;
+        if (langPair) {
+            body.language_boost = langPair;
+        }
+        const resp = await axios_1.default.post(`${this.baseUrl}/v1/t2a_v2`, body, {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            timeout: 120000,
+            validateStatus: () => true,
+        });
+        if (resp.status < 200 || resp.status >= 300) {
+            throw new Error(`MiniMax TTS ${resp.status}: ${JSON.stringify(resp.data)}`);
+        }
+        const baseResp = resp.data?.base_resp;
+        if (baseResp && baseResp.status_code !== 0) {
+            throw new Error(`MiniMax TTS error ${baseResp.status_code}: ${baseResp.status_msg}`);
+        }
+        const audioHex = resp.data?.data?.audio;
+        if (!audioHex) {
+            throw new Error("MiniMax TTS returned no audio data");
+        }
+        return {
+            audioBuffer: Buffer.from(audioHex, "hex"),
+            mimeType: "audio/mpeg",
+            extension: "mp3",
+        };
+    }
+    getVoices() {
+        return voices_1.MINIMAX_VOICES;
+    }
+    mapLanguageCode(locale) {
+        return voices_1.LANG_TO_MINIMAX_CODE[locale.toLowerCase()];
+    }
+}
+exports.MinimaxTtsService = MinimaxTtsService;

package/lib/services/tts/providers/openai.service.d.ts

@@ -0,0 +1,14 @@
+import { BaseTtsProviderService, ITtsVoiceOption, TtsParams, TtsResult } from "../types";
+/**
+ * OpenAI gpt-4o-mini-tts. Sync — POST /v1/audio/speech returns mp3 binary.
+ * Note: OpenAI auto-detects language from input text; no language_code field.
+ */
+export declare class OpenaiTtsService extends BaseTtsProviderService {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor();
+    generate(params: TtsParams): Promise<TtsResult>;
+    getVoices(): ITtsVoiceOption[];
+    mapLanguageCode(_locale: string): string | undefined;
+}
+//# sourceMappingURL=openai.service.d.ts.map

package/lib/services/tts/providers/openai.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.service.d.ts","sourceRoot":"","sources":["../../../../src/services/tts/providers/openai.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEzF;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,sBAAsB;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IAEvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAU1B,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IA8CrD,SAAS,IAAI,eAAe,EAAE;IAI9B,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGrD"}

package/lib/services/tts/providers/openai.service.js

@@ -0,0 +1,73 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenaiTtsService = void 0;
+const axios_1 = __importDefault(require("axios"));
+const openai_1 = require("../../../globals/ttsModels/providers/openai");
+const voices_1 = require("../../../globals/ttsModels/voices");
+const types_1 = require("../types");
+/**
+ * OpenAI gpt-4o-mini-tts. Sync — POST /v1/audio/speech returns mp3 binary.
+ * Note: OpenAI auto-detects language from input text; no language_code field.
+ */
+class OpenaiTtsService extends types_1.BaseTtsProviderService {
+    constructor() {
+        super();
+        this.baseUrl = "https://api.openai.com/v1";
+        if (!process.env.OPENAI_API_KEY) {
+            throw new Error("Missing OPENAI_API_KEY in environment variables");
+        }
+        this.apiKey = process.env.OPENAI_API_KEY;
+    }
+    async generate(params) {
+        const voiceId = params.voiceId ?? openai_1.openaiTtsConfig.defaultVoiceId;
+        const body = {
+            model: openai_1.openaiTtsConfig.modelId,
+            input: params.text,
+            voice: voiceId,
+            response_format: "mp3",
+        };
+        try {
+            const resp = await axios_1.default.post(`${this.baseUrl}/audio/speech`, body, {
+                headers: {
+                    Authorization: `Bearer ${this.apiKey}`,
+                    "Content-Type": "application/json",
+                    Accept: "audio/mpeg",
+                },
+                responseType: "arraybuffer",
+                timeout: 120000,
+            });
+            return {
+                audioBuffer: Buffer.from(resp.data),
+                mimeType: "audio/mpeg",
+                extension: "mp3",
+            };
+        }
+        catch (err) {
+            if (err.response?.data) {
+                let detail = "";
+                try {
+                    const bodyStr = Buffer.from(err.response.data).toString("utf8");
+                    const parsed = JSON.parse(bodyStr);
+                    detail = parsed?.error?.message ?? bodyStr;
+                }
+                catch {
+                    detail = Buffer.from(err.response.data).toString("utf8");
+                }
+                const wrapped = new Error(`OpenAI TTS ${err.response.status}: ${detail} [voiceId=${voiceId}, textLen=${params.text?.length ?? 0}]`);
+                wrapped.cause = err;
+                throw wrapped;
+            }
+            throw err;
+        }
+    }
+    getVoices() {
+        return voices_1.OPENAI_VOICES;
+    }
+    mapLanguageCode(_locale) {
+        return undefined;
+    }
+}
+exports.OpenaiTtsService = OpenaiTtsService;

package/lib/services/tts/ttsFactory.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ttsFactory.service.d.ts","sourceRoot":"","sources":["../../../src/services/tts/ttsFactory.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAE5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,sBAAsB,CAOnF"}
+{"version":3,"file":"ttsFactory.service.d.ts","sourceRoot":"","sources":["../../../src/services/tts/ttsFactory.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAI5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAEjD,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,WAAW,GAAG,sBAAsB,CAWnF"}

package/lib/services/tts/ttsFactory.service.js

@@ -2,10 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getTtsProviderService = getTtsProviderService;
 const elevenlabs_service_1 = require("./providers/elevenlabs.service");
+const minimax_service_1 = require("./providers/minimax.service");
+const openai_service_1 = require("./providers/openai.service");
 function getTtsProviderService(provider) {
     switch (provider) {
         case "elevenlabs":
             return new elevenlabs_service_1.ElevenLabsService();
+        case "minimax":
+            return new minimax_service_1.MinimaxTtsService();
+        case "openai":
+            return new openai_service_1.OpenaiTtsService();
         default:
             throw new Error(`Unknown TTS provider: ${provider}`);
     }

package/lib/services/tts/types.d.ts

@@ -8,6 +8,39 @@ export interface TtsParams {
      * Providers that don't support overrides ignore this field.
      */
     modelIdOverride?: string;
+    /** Provider-specific output container/codec (e.g. ElevenLabs "mp3_44100_192"). */
+    outputFormat?: string;
+    /** ElevenLabs voice_settings.stability (0–1). Lower = more emotional range; higher = more consistent. */
+    stability?: number;
+    /** ElevenLabs voice_settings.similarity_boost (0–1). How closely to mimic the original voice. */
+    similarityBoost?: number;
+    /** ElevenLabs voice_settings.style — exaggeration (0–1). 0 = neutral; higher = amplified delivery. */
+    style?: number;
+    /** ElevenLabs voice_settings.use_speaker_boost. */
+    useSpeakerBoost?: boolean;
+    /** ElevenLabs voice_settings.speed (0.7–1.2). 1.0 = natural pace. */
+    speed?: number;
+    /** Deterministic seed when provider supports it. */
+    seed?: number;
+    /** Preceding scene's text — prosody continuity hint (ElevenLabs). */
+    previousText?: string;
+    /** Following scene's text — prosody continuity hint (ElevenLabs). */
+    nextText?: string;
+    /** Up to 3 request IDs of preceding generations — strongest cross-scene continuity (ElevenLabs). */
+    previousRequestIds?: string[];
+    /** Up to 3 request IDs of following generations (ElevenLabs). */
+    nextRequestIds?: string[];
+    /** "auto" | "on" | "off" — controls spelling out numbers, symbols, etc. */
+    applyTextNormalization?: "auto" | "on" | "off";
+    /** Apply language-specific text normalisation (currently Japanese only). */
+    applyLanguageTextNormalization?: boolean;
+    /** 0–4. Higher = lower latency at small quality cost. 4 also disables text normaliser. */
+    optimizeStreamingLatency?: 0 | 1 | 2 | 3 | 4;
+    /** Custom pronunciation overrides — up to 3 locators per request. */
+    pronunciationDictionaryLocators?: Array<{
+        pronunciation_dictionary_id: string;
+        version_id?: string;
+    }>;
 }
 export interface TtsResult {
     audioBuffer: Buffer;

package/lib/services/tts/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/tts/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8BAAsB,sBAAsB;IAC1C,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAExD;;;OAGG;IACH,QAAQ,CAAC,SAAS,IAAI,eAAe,EAAE;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAC7D"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/tts/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,yGAAyG;IACzG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iGAAiG;IACjG,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sGAAsG;IACtG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;IAGf,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oGAAoG;IACpG,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAG1B,2EAA2E;IAC3E,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,KAAK,CAAC;IAC/C,4EAA4E;IAC5E,8BAA8B,CAAC,EAAE,OAAO,CAAC;IAGzC,0FAA0F;IAC1F,wBAAwB,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAE7C,qEAAqE;IACrE,+BAA+B,CAAC,EAAE,KAAK,CAAC;QACtC,2BAA2B,EAAE,MAAM,CAAC;QACpC,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,8BAAsB,sBAAsB;IAC1C,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IAExD;;;OAGG;IACH,QAAQ,CAAC,SAAS,IAAI,eAAe,EAAE;IAEvC;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAC7D"}

package/lib/utils/errors.d.ts

@@ -30,6 +30,14 @@ export declare const USER_FACING_ERROR_CODES: {
     readonly PROMPT_INVALID: "PROMPT_INVALID";
     readonly INPUT_IMAGE_REJECTED: "INPUT_IMAGE_REJECTED";
     readonly CONTENT_POLICY_VIOLATION: "CONTENT_POLICY_VIOLATION";
+    /** Provider returned auth / config error (401, missing key) — deploy bug, fail fast. */
+    readonly PROVIDER_AUTH_ERROR: "PROVIDER_AUTH_ERROR";
+    /** Account-level quota is exhausted (vs. transient rate limit on a short window). */
+    readonly ACCOUNT_QUOTA_EXCEEDED: "ACCOUNT_QUOTA_EXCEEDED";
+    /** Provider is up but cannot fulfil the request (e.g. unsupported aspect ratio / duration). */
+    readonly CAPABILITY_MISMATCH: "CAPABILITY_MISMATCH";
+    /** Provider classified the request as unavailable (general service degradation, 5xx persistent). */
+    readonly PROVIDER_UNAVAILABLE: "PROVIDER_UNAVAILABLE";
 };
 export type UserFacingErrorCode = keyof typeof USER_FACING_ERROR_CODES;
 //# sourceMappingURL=errors.d.ts.map

package/lib/utils/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,iBAAiB,QAAQ;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAM1C,qEAAqE;IACrE,MAAM,IAAI;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAG7C;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;CAU1B,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,uBAAuB,CAAC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,iBAAiB,QAAQ;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;gBAEX,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAM1C,qEAAqE;IACrE,MAAM,IAAI;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAG7C;AAED;;;GAGG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;IAUlC,wFAAwF;;IAExF,qFAAqF;;IAErF,+FAA+F;;IAE/F,oGAAoG;;CAE5F,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,uBAAuB,CAAC"}