vidspotai-shared 1.0.82-dev.0 → 1.0.83

package/lib/services/stock/realPersonSafety.js

@@ -0,0 +1,248 @@
+"use strict";
+/**
+ * S-1 — real-person safety screening for the internal stock library.
+ *
+ * The stock catalog (S-1/S-2/S-3) may surface free-tier user output as public
+ * "made on VidSpot" / inspiration content. Per ToS we must NEVER surface a
+ * video whose prompt or input imagery involves a *real, identifiable person*
+ * (privacy / likeness exposure). This module is the safety gate the candidate
+ * scanner (and later the S-2 tagger) runs before a video is even eligible for
+ * human review.
+ *
+ * Two independent signals, both via Gemini Flash (cheap, ~$0.00002/image):
+ *   1. `detectRealPersonNamesInText` — LLM scan of all prompt/title/VO text for
+ *      proper names of real people (celebrities, politicians, public figures,
+ *      or a specific named private individual). Generic descriptors
+ *      ("a woman", "the CEO", "a doctor"), brand names, and clearly-fictional
+ *      character names are NOT flagged.
+ *   2. `detectRealPersonInImage` — vision pass over an input/reference/poster
+ *      image asking whether it shows a real *photographic* human person (an
+ *      actual individual's likeness) vs. an illustration / 3D-render / clearly
+ *      AI-generated synthetic face.
+ *
+ * Fail-safe posture: any check that errors is reported with `error` set and
+ * `incomplete: true` on the combined result — the caller treats "could not
+ * confirm safe" as NOT cleared (never silently passes a video through).
+ *
+ * Pure + side-effect-free apart from the network call to Gemini. No Firestore,
+ * no writes — see `scripts/scanStockCandidates.ts` for orchestration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRealPersonNamesInText = detectRealPersonNamesInText;
+exports.detectRealPersonInImage = detectRealPersonInImage;
+exports.screenForRealPerson = screenForRealPerson;
+const genai_1 = require("@google/genai");
+const logger_1 = require("../../utils/logger");
+const DEFAULT_MODEL = "gemini-2.5-flash";
+const DEFAULT_TIMEOUT_MS = 30000;
+/** Strip ```json fences / prose and parse the first JSON object in a model reply. */
+function parseJsonLoose(raw) {
+    if (!raw)
+        return null;
+    const fenced = raw.replace(/```(?:json)?/gi, "").trim();
+    const start = fenced.indexOf("{");
+    const end = fenced.lastIndexOf("}");
+    if (start === -1 || end === -1 || end < start)
+        return null;
+    try {
+        return JSON.parse(fenced.slice(start, end + 1));
+    }
+    catch {
+        return null;
+    }
+}
+function newClient(config) {
+    return {
+        ai: new genai_1.GoogleGenAI({ apiKey: config.apiKey }),
+        model: config.model ?? DEFAULT_MODEL,
+        timeoutMs: config.timeoutMs ?? DEFAULT_TIMEOUT_MS,
+    };
+}
+const NAME_SCAN_PROMPT = [
+    "You are a content-safety classifier for a stock-video library.",
+    "Given the combined text written for a generated video, decide whether it references a REAL, IDENTIFIABLE PERSON.",
+    "Flag ONLY proper names of real people: celebrities, athletes, musicians, politicians, business figures,",
+    "other public figures, or a specific named private individual.",
+    "Do NOT flag: generic role/descriptor phrases (e.g. 'a woman', 'the CEO', 'a doctor', 'a young man'),",
+    "company/brand/product names, place names, or clearly fictional or generic character names.",
+    'Reply with STRICT JSON only, no prose: {"flagged": boolean, "names": string[], "reason": string}.',
+    "names = the exact real-person names you found (empty array if none).",
+].join(" ");
+/**
+ * Scan all of a video's free text for references to real, identifiable people.
+ * Returns `flagged:false` for empty input. On error returns `flagged:false`
+ * with `error` set — the caller must treat a set `error` as not-cleared.
+ */
+async function detectRealPersonNamesInText(texts, config) {
+    const joined = texts
+        .map((t) => (t ?? "").trim())
+        .filter(Boolean)
+        .join("\n---\n")
+        .slice(0, 12000);
+    if (!joined) {
+        return { flagged: false, names: [], reason: "no text to scan" };
+    }
+    const { ai, model, timeoutMs } = newClient(config);
+    const controller = new AbortController();
+    const t = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const resp = await ai.models.generateContent({
+            model,
+            contents: [
+                {
+                    role: "user",
+                    parts: [{ text: `${NAME_SCAN_PROMPT}\n\nTEXT:\n${joined}` }],
+                },
+            ],
+            config: { abortSignal: controller.signal },
+        });
+        const parsed = parseJsonLoose(resp.text ?? "");
+        if (!parsed || typeof parsed.flagged !== "boolean") {
+            return {
+                flagged: false,
+                names: [],
+                reason: "unparseable model reply",
+                error: "parse_failed",
+            };
+        }
+        return {
+            flagged: parsed.flagged,
+            names: Array.isArray(parsed.names) ? parsed.names.filter(Boolean) : [],
+            reason: typeof parsed.reason === "string" ? parsed.reason : "",
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger_1.logger.warn("detectRealPersonNamesInText: failed", { error: message });
+        return { flagged: false, names: [], reason: "scan failed", error: message };
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+const IMAGE_SCAN_PROMPT = [
+    "You are a content-safety classifier for a stock-video library.",
+    "Decide whether this image shows a REAL, IDENTIFIABLE HUMAN PERSON — i.e. a genuine photograph of a real",
+    "individual whose likeness is recognizable (a real face).",
+    "Answer containsRealPerson=true ONLY for photographic real humans whose face is visible/identifiable.",
+    "Answer false for: illustrations, cartoons, 3D renders, clearly AI-generated or synthetic faces,",
+    "mannequins, statues, silhouettes, heavily-obscured faces, distant crowds with no identifiable face,",
+    "or images with no person at all.",
+    'Reply with STRICT JSON only, no prose: {"containsRealPerson": boolean, "confidence": number, "reason": string}.',
+    "confidence is 0..1.",
+].join(" ");
+function pickImageMimeType(contentType, url) {
+    if (contentType && contentType.startsWith("image/")) {
+        return contentType.split(";")[0].trim();
+    }
+    const lower = url.toLowerCase();
+    if (lower.endsWith(".png"))
+        return "image/png";
+    if (lower.endsWith(".webp"))
+        return "image/webp";
+    if (lower.endsWith(".gif"))
+        return "image/gif";
+    return "image/jpeg";
+}
+/**
+ * Vision pass: does this single image show a real, identifiable photographic
+ * person? On any fetch/model error returns `containsRealPerson:false` with
+ * `error` set — caller treats a set `error` as not-cleared.
+ */
+async function detectRealPersonInImage(imageUrl, config) {
+    const { ai, model, timeoutMs } = newClient(config);
+    const controller = new AbortController();
+    const t = setTimeout(() => controller.abort(), timeoutMs);
+    try {
+        const r = await fetch(imageUrl, { signal: controller.signal });
+        if (!r.ok)
+            throw new Error(`fetch ${r.status} ${r.statusText}`);
+        const bytes = Buffer.from(await r.arrayBuffer());
+        const mimeType = pickImageMimeType(r.headers.get("content-type"), imageUrl);
+        const resp = await ai.models.generateContent({
+            model,
+            contents: [
+                {
+                    role: "user",
+                    parts: [
+                        { text: IMAGE_SCAN_PROMPT },
+                        { inlineData: { mimeType, data: bytes.toString("base64") } },
+                    ],
+                },
+            ],
+            config: { abortSignal: controller.signal },
+        });
+        const parsed = parseJsonLoose(resp.text ?? "");
+        if (!parsed || typeof parsed.containsRealPerson !== "boolean") {
+            return {
+                imageUrl,
+                containsRealPerson: false,
+                confidence: 0,
+                reason: "unparseable model reply",
+                error: "parse_failed",
+            };
+        }
+        return {
+            imageUrl,
+            containsRealPerson: parsed.containsRealPerson,
+            confidence: typeof parsed.confidence === "number" ? parsed.confidence : 0,
+            reason: typeof parsed.reason === "string" ? parsed.reason : "",
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger_1.logger.warn("detectRealPersonInImage: failed", { imageUrl, error: message });
+        return {
+            imageUrl,
+            containsRealPerson: false,
+            confidence: 0,
+            reason: "image check failed",
+            error: message,
+        };
+    }
+    finally {
+        clearTimeout(t);
+    }
+}
+/**
+ * Run the full real-person screen for one video: name scan + per-image vision.
+ *
+ * `involvesRealPerson` is the OR of every positive signal. `incomplete` is true
+ * when any signal errored — callers must require `checked && !involvesRealPerson
+ * && !incomplete` before treating a video as a cleared stock candidate.
+ */
+async function screenForRealPerson(input, config, opts = {}) {
+    const maxImages = opts.maxImages ?? 4;
+    const images = Array.from(new Set(input.imageUrls.filter(Boolean))).slice(0, maxImages);
+    const [nameScan, imageScans] = await Promise.all([
+        detectRealPersonNamesInText(input.texts, config),
+        Promise.all(images.map((url) => detectRealPersonInImage(url, config))),
+    ]);
+    const reasons = [];
+    if (nameScan.flagged) {
+        reasons.push(`prompt references real person(s): ${nameScan.names.join(", ") || nameScan.reason}`);
+    }
+    for (const scan of imageScans) {
+        if (scan.containsRealPerson) {
+            reasons.push(`image shows a real person (${scan.confidence.toFixed(2)}): ${scan.imageUrl}`);
+        }
+    }
+    const incomplete = Boolean(nameScan.error) || imageScans.some((s) => Boolean(s.error));
+    if (incomplete) {
+        if (nameScan.error)
+            reasons.push(`name scan incomplete: ${nameScan.error}`);
+        for (const scan of imageScans) {
+            if (scan.error)
+                reasons.push(`image check incomplete: ${scan.imageUrl}`);
+        }
+    }
+    const involvesRealPerson = nameScan.flagged || imageScans.some((s) => s.containsRealPerson);
+    return {
+        checked: true,
+        nameScan,
+        imageScans,
+        involvesRealPerson,
+        incomplete,
+        reasons,
+    };
+}

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

@@ -0,0 +1,2 @@
+export { translationService } from "./translation.service";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/translation/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/lib/services/translation/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.translationService = void 0;
+// Only the new API is exported from the services barrel. The legacy aliases
+// (getTranslationWrapper / detectLang / TRANSLATION_FAILED) are re-exported via
+// utils/helpers instead, so each name reaches the package root through exactly
+// one star-export path (no ambiguous duplicate re-export).
+var translation_service_1 = require("./translation.service");
+Object.defineProperty(exports, "translationService", { enumerable: true, get: function () { return translation_service_1.translationService; } });

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

@@ -0,0 +1,50 @@
+import { ELANGUAGE_CODE, IDetectLang } from "../../globals/types";
+/**
+ * Translation service — single abstraction over language detection + translation.
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * Translation used to be a bare axios call to a custom Cloud Function
+ * (`translation-service-3931b`). That endpoint times out constantly
+ * (`timeout of 8000ms exceeded`, ~24s of retries), and every exhaustion threw
+ * `TRANSLATION_FAILED` — which broke /v1/video and /v1/text prompt generation
+ * AND flooded Slack with `error`-level alerts.
+ *
+ * Now there are TWO layers behind one interface:
+ *   1. PRIMARY  — the existing Cloud Function (free; just flaky).
+ *   2. FALLBACK — a cheap, reliable LLM (gpt-4o-mini) via our own provider
+ *      factory. It is NOT on the Google quota that the video pipeline competes
+ *      for, costs a fraction of a cent per short prompt, and is a single API we
+ *      already operate.
+ *
+ * A primary timeout that the LLM recovers from logs at WARN (Console + Loki, no
+ * Slack) — so the common flaky-primary case no longer floods the channel. Only
+ * when BOTH layers fail do we log ERROR (→ Slack) and throw, so the alert that
+ * survives is a real, rare outage rather than noise.
+ *
+ * Callers should use `translationService.translate()` / `.detectLanguage()`.
+ * The legacy `getTranslationWrapper` / `detectLang` names are kept as thin
+ * aliases (re-exported from utils/helpers) so existing callsites keep working.
+ */
+export declare const TRANSLATION_FAILED = "TRANSLATION_FAILED";
+/**
+ * Translate `text` from → to (default English). Primary CF first (with a couple
+ * of quick retries), then a cheap LLM. Throws Error(TRANSLATION_FAILED) only if
+ * BOTH layers fail; `.cause` carries the last error.
+ */
+declare function translate(text: string, from: ELANGUAGE_CODE, to?: ELANGUAGE_CODE, version?: "v1" | "v2"): Promise<string>;
+/**
+ * Detect the language of `text`. Primary CF; on failure fails OPEN to English
+ * (matches prior behavior — language detection must never block generation).
+ */
+declare function detectLanguage(text: string): Promise<IDetectLang>;
+export declare const translationService: {
+    translate: typeof translate;
+    detectLanguage: typeof detectLanguage;
+};
+/** @deprecated use `translationService.translate` */
+export declare const getTranslationWrapper: typeof translate;
+/** @deprecated use `translationService.detectLanguage` */
+export declare const detectLang: typeof detectLanguage;
+export {};
+//# sourceMappingURL=translation.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"translation.service.d.ts","sourceRoot":"","sources":["../../../src/services/translation/translation.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGlE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,eAAO,MAAM,kBAAkB,uBAAuB,CAAC;AA+EvD;;;;GAIG;AACH,iBAAe,SAAS,CACtB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,EACpB,EAAE,GAAE,cAAkC,EACtC,OAAO,GAAE,IAAI,GAAG,IAAW,GAC1B,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;;GAGG;AACH,iBAAe,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAwBhE;AAOD,eAAO,MAAM,kBAAkB;;;CAG9B,CAAC;AAGF,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,kBAAY,CAAC;AAC/C,0DAA0D;AAC1D,eAAO,MAAM,UAAU,uBAAiB,CAAC"}

package/lib/services/translation/translation.service.js

@@ -0,0 +1,211 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectLang = exports.getTranslationWrapper = exports.translationService = exports.TRANSLATION_FAILED = void 0;
+const axios_1 = __importDefault(require("axios"));
+const enums_1 = require("../../globals/aiModels/enums");
+const types_1 = require("../../globals/types");
+const logger_1 = require("../../utils/logger");
+/**
+ * Translation service — single abstraction over language detection + translation.
+ *
+ * WHY THIS EXISTS
+ * ---------------
+ * Translation used to be a bare axios call to a custom Cloud Function
+ * (`translation-service-3931b`). That endpoint times out constantly
+ * (`timeout of 8000ms exceeded`, ~24s of retries), and every exhaustion threw
+ * `TRANSLATION_FAILED` — which broke /v1/video and /v1/text prompt generation
+ * AND flooded Slack with `error`-level alerts.
+ *
+ * Now there are TWO layers behind one interface:
+ *   1. PRIMARY  — the existing Cloud Function (free; just flaky).
+ *   2. FALLBACK — a cheap, reliable LLM (gpt-4o-mini) via our own provider
+ *      factory. It is NOT on the Google quota that the video pipeline competes
+ *      for, costs a fraction of a cent per short prompt, and is a single API we
+ *      already operate.
+ *
+ * A primary timeout that the LLM recovers from logs at WARN (Console + Loki, no
+ * Slack) — so the common flaky-primary case no longer floods the channel. Only
+ * when BOTH layers fail do we log ERROR (→ Slack) and throw, so the alert that
+ * survives is a real, rare outage rather than noise.
+ *
+ * Callers should use `translationService.translate()` / `.detectLanguage()`.
+ * The legacy `getTranslationWrapper` / `detectLang` names are kept as thin
+ * aliases (re-exported from utils/helpers) so existing callsites keep working.
+ */
+exports.TRANSLATION_FAILED = "TRANSLATION_FAILED";
+const PRIMARY_BASE = "https://us-central1-translation-service-3931b.cloudfunctions.net";
+// Shorter than the old 8s so we fail over to the LLM faster (the old 3×8s =
+// 24s user-facing stall was itself part of the problem).
+const PRIMARY_TIMEOUT_MS = 6000;
+const PRIMARY_MAX_ATTEMPTS = 2;
+// gpt-4o-mini: cheap (~$0.15/1M in, $0.60/1M out → fractions of a cent per
+// prompt), reliable, and independent of the Google video quota. Swap here if a
+// cheaper effective model becomes available.
+const FALLBACK_MODEL = enums_1.ETextGenModels.OPENAI_GPT_4O_MINI;
+/** Human-readable target name for the LLM prompt; falls back to the raw code. */
+const LANGUAGE_NAMES = {
+    en: "English",
+};
+function languageLabel(code) {
+    return LANGUAGE_NAMES[code] ?? `the language with ISO code "${code}"`;
+}
+/** PRIMARY: one POST to the custom translation Cloud Function. Throws on error. */
+async function callPrimaryTranslate(text, from, to, version) {
+    const res = await axios_1.default.post(`${PRIMARY_BASE}/translate`, { text, from, to, version }, {
+        headers: { "internal-key": process.env.TRANSLATION_SERVICE_KEY || "" },
+        timeout: PRIMARY_TIMEOUT_MS,
+    });
+    const translated = res.data?.translated;
+    if (typeof translated !== "string" || !translated.length) {
+        throw new Error("primary translation returned empty payload");
+    }
+    return translated;
+}
+/**
+ * FALLBACK: translate via a cheap LLM. Lazy-imports the provider factory so this
+ * module stays light (utils/helpers re-exports it) and to avoid an import cycle
+ * with the aiGen layer.
+ */
+async function callLlmTranslate(text, from, to) {
+    const { getAiGenProviderService } = await Promise.resolve().then(() => __importStar(require("../aiGen/aiGenFactory.service")));
+    const service = getAiGenProviderService(FALLBACK_MODEL);
+    const target = languageLabel(to);
+    const system = `You are a professional translation engine. Translate the user's text into ${target}. ` +
+        `Preserve meaning, tone, names, numbers, hashtags, emojis and line breaks. ` +
+        `Output ONLY the translated text — no quotes, no language labels, no commentary. ` +
+        `If the text is already in ${target}, return it unchanged.`;
+    const { text: out } = await service.generateText({
+        input: [
+            { role: "system", content: system },
+            { role: "user", content: text },
+        ],
+        modelKey: FALLBACK_MODEL,
+        options: { temperature: 0 },
+    });
+    const trimmed = (out ?? "").trim();
+    if (!trimmed || trimmed === "No response") {
+        throw new Error("LLM fallback returned empty translation");
+    }
+    return trimmed;
+}
+/**
+ * Translate `text` from → to (default English). Primary CF first (with a couple
+ * of quick retries), then a cheap LLM. Throws Error(TRANSLATION_FAILED) only if
+ * BOTH layers fail; `.cause` carries the last error.
+ */
+async function translate(text, from, to = types_1.ELANGUAGE_CODE.en, version = "v2") {
+    if (!text || !text.trim())
+        return text;
+    // ── Layer 1: primary Cloud Function ──────────────────────────────────────
+    let primaryErr;
+    for (let attempt = 1; attempt <= PRIMARY_MAX_ATTEMPTS; attempt++) {
+        try {
+            return await callPrimaryTranslate(text, from, to, version);
+        }
+        catch (err) {
+            primaryErr = err;
+            if (attempt < PRIMARY_MAX_ATTEMPTS) {
+                await new Promise((r) => setTimeout(r, 200 * attempt));
+            }
+        }
+    }
+    // ── Layer 2: LLM fallback (the common recovery path — WARN, not Slack) ────
+    logger_1.logger.warn("translation: primary failed, falling back to LLM", {
+        sourceLang: from,
+        targetLang: to,
+        primaryAttempts: PRIMARY_MAX_ATTEMPTS,
+        fallbackModel: FALLBACK_MODEL,
+        err: errMsg(primaryErr),
+    });
+    try {
+        return await callLlmTranslate(text, from, to);
+    }
+    catch (fallbackErr) {
+        // Both layers down — this is the only case worth a Slack alert.
+        logger_1.logger.error("translation failed on BOTH primary and LLM fallback", {
+            sourceLang: from,
+            targetLang: to,
+            primaryErr: errMsg(primaryErr),
+            fallbackErr: errMsg(fallbackErr),
+        });
+        const e = new Error(exports.TRANSLATION_FAILED);
+        e.cause = fallbackErr;
+        throw e;
+    }
+}
+/**
+ * Detect the language of `text`. Primary CF; on failure fails OPEN to English
+ * (matches prior behavior — language detection must never block generation).
+ */
+async function detectLanguage(text) {
+    try {
+        const res = await axios_1.default.post(`${PRIMARY_BASE}/detectLang`, { text }, {
+            headers: { "internal-key": process.env.TRANSLATION_SERVICE_KEY || "" },
+            timeout: PRIMARY_TIMEOUT_MS,
+        });
+        return res.data;
+    }
+    catch (err) {
+        logger_1.logger.warn("translation: detectLang failed, defaulting to en", {
+            err: errMsg(err),
+        });
+        return {
+            reliable: false,
+            textBytes: 0,
+            languages: [
+                { name: "English", code: types_1.ELANGUAGE_CODE.en, percent: 100, score: 0 },
+            ],
+            chunks: [],
+        };
+    }
+}
+function errMsg(err) {
+    if (err instanceof Error)
+        return err.stack ?? err.message;
+    return String(err);
+}
+exports.translationService = {
+    translate,
+    detectLanguage,
+};
+// ── Legacy aliases (kept so existing callsites need no change) ──────────────
+/** @deprecated use `translationService.translate` */
+exports.getTranslationWrapper = translate;
+/** @deprecated use `translationService.detectLanguage` */
+exports.detectLang = detectLanguage;

package/lib/utils/helpers.d.ts

@@ -1,4 +1,4 @@
-import { ELANGUAGE_CODE, ERENEWAL_FREQUENCY, ESUBSCRIPTION_PLANS, EVideoDurationType, IDetectLang } from "../globals/types";
+import { ERENEWAL_FREQUENCY, ESUBSCRIPTION_PLANS, EVideoDurationType } from "../globals/types";
 import z from "zod";
 import { ETextGenModels } from "../globals";
 export declare const getPlanTypeById: (priceId: string) => ESUBSCRIPTION_PLANS | null;
@@ -32,9 +32,7 @@ export declare const assertCostFound: (modelKey: string, cost: number | undefine
  */
 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 { TRANSLATION_FAILED, getTranslationWrapper, detectLang, } from "../services/translation/translation.service";
 export declare function waitForFile(path: string, timeout?: number, interval?: number): Promise<boolean>;
 export declare function generateAndValidate<T extends z.ZodSchema<any>>(args: {
     userPrompt: string;

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

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAGA,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;AAG5C,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,MAQpE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,MAAM,MAAM,GAAG,SAAS,EACxB,UAAU,MAAM,KACf,MASF,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,CAwChB,CAAC;AAEF,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,WAAW,CAuBlE,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;AA0DrB,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,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAEnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAG5C,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,MAQpE,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,eAAe,GAC1B,UAAU,MAAM,EAChB,MAAM,MAAM,GAAG,SAAS,EACxB,UAAU,MAAM,KACf,MASF,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;AAOD,OAAO,EACL,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,GACX,MAAM,6CAA6C,CAAC;AAErD,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;AA0DrB,wBAAgB,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAatE"}

package/lib/utils/helpers.js

@@ -8,7 +8,6 @@ exports.getMultiClipDiscountFactor = getMultiClipDiscountFactor;
 exports.waitForFile = waitForFile;
 exports.generateAndValidate = generateAndValidate;
 exports.getVideoDurationRangeText = getVideoDurationRangeText;
-const axios_1 = __importDefault(require("axios"));
 const logger_1 = require("./logger");
 const plans_1 = require("../globals/plans");
 const types_1 = require("../globals/types");
@@ -104,68 +103,15 @@ exports.MULTI_CLIP_DISCOUNT_FACTORS = {
 function getMultiClipDiscountFactor(durationType) {
     return exports.MULTI_CLIP_DISCOUNT_FACTORS[durationType] ?? 1.0;
 }
-exports.TRANSLATION_FAILED = "TRANSLATION_FAILED";
-const getTranslationWrapper = async (text, from, to = types_1.ELANGUAGE_CODE.en, version = "v2") => {
-    const MAX_ATTEMPTS = 3;
-    const PER_ATTEMPT_TIMEOUT_MS = 8000;
-    let lastErr;
-    for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
-        try {
-            const res = await axios_1.default.post("https://us-central1-translation-service-3931b.cloudfunctions.net/translate", { text, from, to, version }, {
-                headers: {
-                    "internal-key": process.env.TRANSLATION_SERVICE_KEY || "",
-                },
-                timeout: PER_ATTEMPT_TIMEOUT_MS,
-            });
-            return res.data.translated;
-        }
-        catch (err) {
-            lastErr = err;
-            const isLast = attempt === MAX_ATTEMPTS;
-            if (isLast) {
-                logger_1.logger.error("translation retry exhausted", {
-                    sourceLang: from,
-                    targetLang: to,
-                    attempts: attempt,
-                    err: lastErr?.stack ?? lastErr?.message ?? String(lastErr),
-                });
-                break;
-            }
-            logger_1.logger.warn("getTranslationWrapper attempt failed, retrying", {
-                attempt,
-                maxAttempts: MAX_ATTEMPTS,
-                err: err?.stack ?? err?.message ?? String(err),
-            });
-            await new Promise((r) => setTimeout(r, 200 * attempt));
-        }
-    }
-    const e = new Error(exports.TRANSLATION_FAILED);
-    e.cause = lastErr;
-    throw e;
-};
-exports.getTranslationWrapper = getTranslationWrapper;
-const detectLang = async (text) => {
-    try {
-        const res = await axios_1.default.post("https://us-central1-translation-service-3931b.cloudfunctions.net/detectLang", { text }, {
-            headers: { "internal-key": process.env.TRANSLATION_SERVICE_KEY || "" },
-            timeout: 8000,
-        });
-        return res.data;
-    }
-    catch (err) {
-        // External service failure — default to English so video generation is not blocked
-        logger_1.logger.warn("detectLang: failed, defaulting to en", {
-            err: err?.stack ?? err?.message ?? String(err),
-        });
-        return {
-            reliable: false,
-            textBytes: 0,
-            languages: [{ name: "English", code: types_1.ELANGUAGE_CODE.en, percent: 100, score: 0 }],
-            chunks: [],
-        };
-    }
-};
-exports.detectLang = detectLang;
+// Translation + language detection moved into a dedicated, fallback-capable
+// service (primary Cloud Function → cheap LLM). Re-exported here so existing
+// callers importing `getTranslationWrapper` / `detectLang` / `TRANSLATION_FAILED`
+// from the package root keep working unchanged. New code should prefer
+// `translationService` from the services barrel.
+var translation_service_1 = require("../services/translation/translation.service");
+Object.defineProperty(exports, "TRANSLATION_FAILED", { enumerable: true, get: function () { return translation_service_1.TRANSLATION_FAILED; } });
+Object.defineProperty(exports, "getTranslationWrapper", { enumerable: true, get: function () { return translation_service_1.getTranslationWrapper; } });
+Object.defineProperty(exports, "detectLang", { enumerable: true, get: function () { return translation_service_1.detectLang; } });
 async function waitForFile(path, timeout = 10000, interval = 300) {
     const start = Date.now();
     while (Date.now() - start < timeout) {

package/lib/utils/index.d.ts

@@ -1,5 +1,6 @@
 export * from "./errors";
 export * from "./helpers";
 export * from "./logger";
+export * from "./renderTier";
 export * from "./ttsUtils";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/lib/utils/index.js

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./errors"), exports);
 __exportStar(require("./helpers"), exports);
 __exportStar(require("./logger"), exports);
+__exportStar(require("./renderTier"), exports);
 __exportStar(require("./ttsUtils"), exports);