vidspotai-shared 1.0.53 → 1.0.55

package/lib/services/musicGen/providers/curated.service.js

@@ -0,0 +1,171 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CuratedMusicProvider = exports.CURATED_CATALOG = void 0;
+/**
+ * Curated CC0 music catalog — always-on, zero-config, zero licensing risk.
+ *
+ * Seeded with a small spread across the moods/BPMs the 5 personas actually
+ * ask for. Tracks live in our own GCS bucket so we control availability and
+ * never lose the source. Hand-verified BPM means slice-1 (BPM snap) and
+ * slice-3 (onset detection) both have a reliable starting point.
+ *
+ * Add new tracks by appending to CURATED_CATALOG. Re-deploys pick them up
+ * immediately — no DB migration, no provider re-init.
+ *
+ * Sourcing rule for additions: CC0 / Pixabay license / FMA "no rights
+ * reserved" only. No CC-BY without an attribution surface in the UI first.
+ */
+exports.CURATED_CATALOG = [
+    {
+        id: "curated-energetic-120",
+        url: "https://storage.googleapis.com/vidspot-public-music/energetic-pop-120.mp3",
+        durationSec: 134,
+        bpm: 120,
+        mood: "energetic",
+        tags: ["pop", "upbeat", "social-recap", "ugc-ad"],
+        attribution: "Pixabay (CC0)",
+        source: "curated",
+    },
+    {
+        id: "curated-energetic-128",
+        url: "https://storage.googleapis.com/vidspot-public-music/energetic-edm-128.mp3",
+        durationSec: 142,
+        bpm: 128,
+        mood: "energetic",
+        tags: ["edm", "drop", "social-recap"],
+        attribution: "Pixabay (CC0)",
+        source: "curated",
+    },
+    {
+        id: "curated-uplifting-110",
+        url: "https://storage.googleapis.com/vidspot-public-music/uplifting-corp-110.mp3",
+        durationSec: 121,
+        bpm: 110,
+        mood: "uplifting",
+        tags: ["corporate", "ugc-ad", "product-demo"],
+        attribution: "Pixabay (CC0)",
+        source: "curated",
+    },
+    {
+        id: "curated-cinematic-90",
+        url: "https://storage.googleapis.com/vidspot-public-music/cinematic-orch-90.mp3",
+        durationSec: 168,
+        bpm: 90,
+        mood: "cinematic",
+        tags: ["orchestral", "trailer", "talking-head"],
+        attribution: "Pixabay (CC0)",
+        source: "curated",
+    },
+    {
+        id: "curated-calm-80",
+        url: "https://storage.googleapis.com/vidspot-public-music/calm-piano-80.mp3",
+        durationSec: 156,
+        bpm: 80,
+        mood: "calm",
+        tags: ["piano", "ambient", "talking-head"],
+        attribution: "Pixabay (CC0)",
+        source: "curated",
+    },
+    {
+        id: "curated-dark-100",
+        url: "https://storage.googleapis.com/vidspot-public-music/dark-trap-100.mp3",
+        durationSec: 130,
+        bpm: 100,
+        mood: "dark",
+        tags: ["trap", "moody", "social-recap"],
+        attribution: "Pixabay (CC0)",
+        source: "curated",
+    },
+    {
+        id: "curated-acoustic-95",
+        url: "https://storage.googleapis.com/vidspot-public-music/acoustic-folk-95.mp3",
+        durationSec: 144,
+        bpm: 95,
+        mood: "acoustic",
+        tags: ["folk", "guitar", "ugc-ad"],
+        attribution: "Pixabay (CC0)",
+        source: "curated",
+    },
+    {
+        id: "curated-retro-115",
+        url: "https://storage.googleapis.com/vidspot-public-music/retro-synth-115.mp3",
+        durationSec: 138,
+        bpm: 115,
+        mood: "retro",
+        tags: ["synthwave", "80s", "product-demo"],
+        attribution: "Pixabay (CC0)",
+        source: "curated",
+    },
+];
+const MOOD_ALIASES = {
+    energetic: "energetic",
+    upbeat: "energetic",
+    hype: "energetic",
+    cinematic: "cinematic",
+    epic: "cinematic",
+    dramatic: "cinematic",
+    calm: "calm",
+    chill: "calm",
+    ambient: "calm",
+    uplifting: "uplifting",
+    inspirational: "uplifting",
+    dark: "dark",
+    moody: "dark",
+    acoustic: "acoustic",
+    folk: "acoustic",
+    retro: "retro",
+    vintage: "retro",
+    quirky: "retro",
+};
+function tokens(s) {
+    if (!s)
+        return [];
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]+/g, " ")
+        .split(/\s+/)
+        .filter((t) => t.length >= 2);
+}
+function score(track, params) {
+    let s = 0;
+    const wantedMood = params.mood ? MOOD_ALIASES[params.mood.toLowerCase()] : undefined;
+    if (wantedMood && track.mood === wantedMood)
+        s += 50;
+    const queryToks = tokens(params.query);
+    if (queryToks.length) {
+        const hay = [track.mood, ...(track.tags ?? [])].join(" ").toLowerCase();
+        for (const t of queryToks)
+            if (hay.includes(t))
+                s += 5;
+    }
+    if (params.bpmTarget && track.bpm) {
+        const diff = Math.abs(track.bpm - params.bpmTarget);
+        s += Math.max(0, 30 - diff); // perfect match = 30, ±30bpm = 0
+    }
+    if (params.bpmMin && track.bpm && track.bpm < params.bpmMin)
+        s -= 20;
+    if (params.bpmMax && track.bpm && track.bpm > params.bpmMax)
+        s -= 20;
+    if (params.durationSecMin && track.durationSec < params.durationSecMin)
+        s -= 100;
+    return s;
+}
+class CuratedMusicProvider {
+    constructor() {
+        this.source = "curated";
+    }
+    isAvailable() {
+        return exports.CURATED_CATALOG.length > 0;
+    }
+    async search(params) {
+        const limit = params.limit ?? 5;
+        const ranked = exports.CURATED_CATALOG
+            .map((t) => ({ t, s: score(t, params) }))
+            .filter((r) => r.s > -50)
+            .sort((a, b) => b.s - a.s)
+            .slice(0, limit)
+            .map(({ t }) => t);
+        return { tracks: ranked };
+    }
+}
+exports.CuratedMusicProvider = CuratedMusicProvider;

package/lib/services/musicGen/providers/jamendo.service.d.ts

@@ -0,0 +1,8 @@
+import { MusicSearchParams, MusicSearchProvider, MusicSearchResult } from "../types";
+export declare class JamendoMusicProvider implements MusicSearchProvider {
+    readonly source: "jamendo";
+    private readonly clientId;
+    isAvailable(): boolean;
+    search(params: MusicSearchParams): Promise<MusicSearchResult>;
+}
+//# sourceMappingURL=jamendo.service.d.ts.map

package/lib/services/musicGen/providers/jamendo.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jamendo.service.d.ts","sourceRoot":"","sources":["../../../../src/services/musicGen/providers/jamendo.service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAElB,MAAM,UAAU,CAAC;AA6ClB,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,QAAQ,CAAC,MAAM,EAAG,SAAS,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAE1D,WAAW,IAAI,OAAO;IAIhB,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwCpE"}

package/lib/services/musicGen/providers/jamendo.service.js

@@ -0,0 +1,93 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JamendoMusicProvider = void 0;
+const axios_1 = __importDefault(require("axios"));
+/**
+ * Jamendo Music API v3.
+ *
+ * Free for app integration via client_id; per-track commercial use requires
+ * a Pro license purchased through Jamendo Licensing. We surface tracks here
+ * but the host UI must show the license CTA before a user ships a video that
+ * uses the track. Track BPM comes back via `musicinfo.bpm` when we request
+ * `include=musicinfo`.
+ *
+ * Env: JAMENDO_CLIENT_ID — provider is unavailable until set.
+ */
+const JAMENDO_TRACKS_URL = "https://api.jamendo.com/v3.0/tracks";
+const MOOD_TO_TAGS = {
+    energetic: "energetic+upbeat",
+    cinematic: "epic+orchestral",
+    calm: "calm+ambient",
+    uplifting: "uplifting+inspirational",
+    dark: "dark+moody",
+    acoustic: "acoustic+folk",
+    retro: "retro+synthwave",
+    quirky: "quirky+playful",
+};
+class JamendoMusicProvider {
+    constructor() {
+        this.source = "jamendo";
+        this.clientId = process.env.JAMENDO_CLIENT_ID;
+    }
+    isAvailable() {
+        return Boolean(this.clientId);
+    }
+    async search(params) {
+        if (!this.clientId)
+            return { tracks: [] };
+        const tags = params.mood ? MOOD_TO_TAGS[params.mood.toLowerCase()] : undefined;
+        const search = params.query?.trim();
+        const res = await axios_1.default.get(JAMENDO_TRACKS_URL, {
+            params: {
+                client_id: this.clientId,
+                format: "json",
+                limit: Math.min(params.limit ?? 10, 20),
+                include: "musicinfo",
+                // Jamendo prefers `tags` for mood and `search` for free-text.
+                ...(tags ? { tags } : {}),
+                ...(search ? { search } : {}),
+                ...(params.bpmMin ? { speed: bpmToSpeed(params.bpmMin) } : {}),
+                audioformat: "mp32",
+            },
+            timeout: 8000,
+        });
+        const tracks = res.data.results
+            .filter((t) => !!t.audio)
+            .filter((t) => !params.durationSecMin || t.duration >= params.durationSecMin)
+            .map((t) => ({
+            id: `jamendo-${t.id}`,
+            url: t.audio,
+            durationSec: t.duration,
+            bpm: t.musicinfo?.bpm,
+            mood: params.mood,
+            tags: t.musicinfo?.tags?.vartags,
+            attribution: `${t.name} — ${t.artist_name} (Jamendo)`,
+            source: "jamendo",
+        }));
+        if (params.bpmTarget) {
+            tracks.sort((a, b) => bpmDistance(a, params.bpmTarget) - bpmDistance(b, params.bpmTarget));
+        }
+        return { tracks };
+    }
+}
+exports.JamendoMusicProvider = JamendoMusicProvider;
+function bpmDistance(t, target) {
+    if (!t.bpm)
+        return 999;
+    return Math.abs(t.bpm - target);
+}
+// Jamendo's `speed` param is a coarse 5-bucket bin; map BPM ranges to it.
+function bpmToSpeed(bpm) {
+    if (bpm < 70)
+        return "verylow";
+    if (bpm < 95)
+        return "low";
+    if (bpm < 120)
+        return "medium";
+    if (bpm < 145)
+        return "high";
+    return "veryhigh";
+}

package/lib/services/musicGen/providers/mubert.service.d.ts

@@ -0,0 +1,9 @@
+import { MusicSearchParams, MusicSearchProvider, MusicSearchResult } from "../types";
+export declare class MubertMusicProvider implements MusicSearchProvider {
+    readonly source: "mubert";
+    private readonly pat;
+    isAvailable(): boolean;
+    search(params: MusicSearchParams): Promise<MusicSearchResult>;
+    private pollTrackUrl;
+}
+//# sourceMappingURL=mubert.service.d.ts.map

package/lib/services/musicGen/providers/mubert.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mubert.service.d.ts","sourceRoot":"","sources":["../../../../src/services/musicGen/providers/mubert.service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAiDlB,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,QAAQ,CAAC,MAAM,EAAG,QAAQ,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA0B;IAE9C,WAAW,IAAI,OAAO;IAIhB,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YAkDrD,YAAY;CAkB3B"}

package/lib/services/musicGen/providers/mubert.service.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MubertMusicProvider = void 0;
+const axios_1 = __importDefault(require("axios"));
+/**
+ * Mubert generative music — pay-per-call, infinite library, BPM-controllable.
+ *
+ * Conceptually a "search" replacement: instead of looking up an existing
+ * track, we generate one from a prompt + BPM + duration. The provider
+ * presents the same MusicSearchProvider surface so the planner doesn't have
+ * to special-case it.
+ *
+ * Two-step flow (mirrors our video providers):
+ *   1. POST /v3/Public/Tracks  → returns a session id
+ *   2. Poll /v3/Public/Tracks/{id} until the generated MP3 URL is ready
+ *
+ * For latency reasons we cap polling at MUBERT_TIMEOUT_MS; on timeout we
+ * return an empty result and the caller falls back to the next provider.
+ *
+ * Env: MUBERT_PAT (Personal Access Token). Provider is unavailable until set.
+ *
+ * Cost: ~$0.005–0.02/min depending on plan; budget gates live in
+ * estimate_cost upstream — this provider just executes when called.
+ */
+const MUBERT_BASE_URL = "https://music-api.mubert.com/api/v3/Public";
+const MUBERT_TIMEOUT_MS = 25000;
+const POLL_INTERVAL_MS = 1500;
+const MOOD_TO_PROMPT = {
+    energetic: "energetic upbeat pop",
+    cinematic: "cinematic orchestral epic",
+    calm: "calm ambient piano",
+    uplifting: "uplifting inspirational corporate",
+    dark: "dark moody trap",
+    acoustic: "acoustic folk guitar",
+    retro: "retro synthwave 80s",
+    quirky: "quirky playful indie",
+};
+class MubertMusicProvider {
+    constructor() {
+        this.source = "mubert";
+        this.pat = process.env.MUBERT_PAT;
+    }
+    isAvailable() {
+        return Boolean(this.pat);
+    }
+    async search(params) {
+        if (!this.pat)
+            return { tracks: [] };
+        const prompt = params.query
+            ?? (params.mood && MOOD_TO_PROMPT[params.mood.toLowerCase()])
+            ?? "energetic upbeat";
+        const duration = Math.max(30, params.durationSecMin ?? 60);
+        const bpm = params.bpmTarget;
+        try {
+            const startResp = await axios_1.default.post(`${MUBERT_BASE_URL}/Tracks`, {
+                method: "RecordTrack",
+                params: {
+                    pat: this.pat,
+                    prompt,
+                    duration,
+                    ...(bpm ? { bpm } : {}),
+                    bitrate: 128,
+                    mode: "track",
+                },
+            }, { timeout: 8000 });
+            const sessionId = startResp.data?.data?.session_id;
+            if (!sessionId)
+                return { tracks: [] };
+            const trackUrl = await this.pollTrackUrl(sessionId);
+            if (!trackUrl)
+                return { tracks: [] };
+            return {
+                tracks: [
+                    {
+                        id: `mubert-${sessionId}`,
+                        url: trackUrl,
+                        durationSec: duration,
+                        bpm,
+                        mood: params.mood,
+                        attribution: "Mubert (generated)",
+                        source: "mubert",
+                    },
+                ],
+            };
+        }
+        catch {
+            // Provider down or rejected the prompt — caller falls through.
+            return { tracks: [] };
+        }
+    }
+    async pollTrackUrl(sessionId) {
+        const deadline = Date.now() + MUBERT_TIMEOUT_MS;
+        while (Date.now() < deadline) {
+            try {
+                const resp = await axios_1.default.get(`${MUBERT_BASE_URL}/Tracks/${sessionId}`, { params: { pat: this.pat }, timeout: 5000 });
+                const status = resp.data?.data?.status;
+                if (status === "done")
+                    return resp.data?.data?.track_url;
+                if (status === "failed")
+                    return undefined;
+            }
+            catch {
+                // Transient — retry next tick.
+            }
+            await new Promise((r) => setTimeout(r, POLL_INTERVAL_MS));
+        }
+        return undefined;
+    }
+}
+exports.MubertMusicProvider = MubertMusicProvider;

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

@@ -0,0 +1,42 @@
+/**
+ * Music search/generation provider surface used by the agent's `search_music`
+ * tool and the post-planner `selectMusicForPlan` step.
+ *
+ * Three sources ship under one interface deliberately — the planner doesn't
+ * care whether a track is curated, fetched, or generated; it only needs
+ * `{ url, bpm, durationSec }` to drive the beat-snap pass.
+ */
+export type MusicSource = "curated" | "jamendo" | "mubert";
+export interface MusicSearchParams {
+    query?: string;
+    /** "energetic" / "cinematic" / "calm" / "uplifting" / "dark" / "quirky" / "retro" / "acoustic". */
+    mood?: string;
+    /** Soft target — providers prefer matches near this BPM but may return others. */
+    bpmTarget?: number;
+    bpmMin?: number;
+    bpmMax?: number;
+    /** Required minimum length so the track covers the whole video. */
+    durationSecMin?: number;
+    /** Cap result count. */
+    limit?: number;
+}
+export interface MusicTrack {
+    id: string;
+    url: string;
+    durationSec: number;
+    bpm?: number;
+    mood?: string;
+    tags?: string[];
+    attribution?: string;
+    source: MusicSource;
+}
+export interface MusicSearchResult {
+    tracks: MusicTrack[];
+}
+export interface MusicSearchProvider {
+    source: MusicSource;
+    /** True when the provider is configured (env vars / catalog) and ready to call. */
+    isAvailable(): boolean;
+    search(params: MusicSearchParams): Promise<MusicSearchResult>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/musicGen/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mGAAmG;IACnG,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,wBAAwB;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,WAAW,CAAC;IACpB,mFAAmF;IACnF,WAAW,IAAI,OAAO,CAAC;IACvB,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;CAC/D"}

package/lib/services/musicGen/types.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Music search/generation provider surface used by the agent's `search_music`
+ * tool and the post-planner `selectMusicForPlan` step.
+ *
+ * Three sources ship under one interface deliberately — the planner doesn't
+ * care whether a track is curated, fetched, or generated; it only needs
+ * `{ url, bpm, durationSec }` to drive the beat-snap pass.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

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;IA0CrD,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,71 @@
+"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");
+                }
+                throw new Error(`OpenAI TTS ${err.response.status}: ${detail} [voiceId=${voiceId}, textLen=${params.text?.length ?? 0}]`);
+            }
+            throw err;
+        }
+    }
+    getVoices() {
+        return voices_1.OPENAI_VOICES;
+    }
+    mapLanguageCode(_locale) {
+        return undefined;
+    }
+}
+exports.OpenaiTtsService = OpenaiTtsService;

package/lib/utils/helpers.d.ts

@@ -19,6 +19,7 @@ export declare const getCreditsFromCost: (cost: number, applyFloor?: boolean) =>
  */
 export declare const MULTI_CLIP_DISCOUNT_FACTORS: Partial<Record<EVideoDurationType, number>>;
 export declare function getMultiClipDiscountFactor(durationType: EVideoDurationType): number;
+export declare const TRANSLATION_FAILED = "TRANSLATION_FAILED";
 export declare const getTranslationWrapper: (text: string, from: ELANGUAGE_CODE, to?: ELANGUAGE_CODE, version?: "v1" | "v2") => Promise<string>;
 export declare const detectLang: (text: string) => Promise<IDetectLang>;
 export declare function waitForFile(path: string, timeout?: number, interval?: number): Promise<boolean>;

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAElB,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,KACd,mBAAmB,GAAG,IASxB,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,kBAAkB,GAAG,IASlE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,MAAM,mBAAmB,EACzB,OAAM,kBAA+C,WAgBtD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,oBAAiB,KAAG,MASpE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAInF,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,kBAAkB,GAAG,MAAM,CAEnF;AAED,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,MAAM,cAAc,EACpB,KAAI,cAAkC,EACtC,UAAS,IAAI,GAAG,IAAW,KAC1B,OAAO,CAAC,MAAM,CAmBhB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,WAAW,CAqBlE,CAAC;AAEF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,SAAQ,EACf,QAAQ,SAAM,oBAQf;AAGD,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,EAAE,CAAC,CAAC;IACb,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAGxB,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AA+CrB,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAatE"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,cAAc,EACd,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAElB,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,eAAO,MAAM,eAAe,GAC1B,SAAS,MAAM,KACd,mBAAmB,GAAG,IASxB,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,SAAS,MAAM,KAAG,kBAAkB,GAAG,IASlE,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,MAAM,mBAAmB,EACzB,OAAM,kBAA+C,WAgBtD,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,MAAM,MAAM,EAAE,oBAAiB,KAAG,MASpE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,EAAE,OAAO,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAInF,CAAC;AAEF,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,kBAAkB,GAAG,MAAM,CAEnF;AAED,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AAEvD,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,EACZ,MAAM,cAAc,EACpB,KAAI,cAAkC,EACtC,UAAS,IAAI,GAAG,IAAW,KAC1B,OAAO,CAAC,MAAM,CA+BhB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,WAAW,CAqBlE,CAAC;AAEF,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,SAAQ,EACf,QAAQ,SAAM,oBAQf;AAGD,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,EAAE,CAAC,CAAC;IACb,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAGxB,wBAAsB,mBAAmB,CAAC,IAAI,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,GAAG,CAAC;IACjB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AA+CrB,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAatE"}