vidspotai-shared 1.0.50 → 1.0.51

package/lib/globals/aiModels/providers/google.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.googleConfigs = void 0;
 exports.googleConfigs = {
     "google-veo-3.1": {
-        modelId: "veo-3.1-generate-001",
+        modelId: "veo-3.1-generate-preview",
         type: ["text-to-video", "image-to-video"],
         fields: {
             prompt: { required: true },
@@ -20,7 +20,7 @@ exports.googleConfigs = {
         },
     },
     "google-veo-3.1-fast": {
-        modelId: "veo-3.1-fast-generate-001",
+        modelId: "veo-3.1-fast-generate-preview",
         type: ["text-to-video", "image-to-video"],
         fields: {
             prompt: { required: true },
@@ -37,7 +37,7 @@ exports.googleConfigs = {
         },
     },
     "google-veo-3.1-lite": {
-        modelId: "veo-3.1-lite-generate-001",
+        modelId: "veo-3.1-lite-generate-preview",
         type: ["text-to-video", "image-to-video"],
         fields: {
             prompt: { required: true },

package/lib/globals/schemas.d.ts

@@ -1,3 +1,4 @@
 import { z } from "zod";
 export declare const urlSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+export declare const imageUrlSchema: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
 //# sourceMappingURL=schemas.d.ts.map

package/lib/globals/schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/globals/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,SAAS,wDAWpB,CAAC"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/globals/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,eAAO,MAAM,SAAS,wDAiBpB,CAAC;AAYH,eAAO,MAAM,cAAc,wDA2BzB,CAAC"}

package/lib/globals/schemas.js

@@ -1,18 +1,65 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.urlSchema = void 0;
+exports.imageUrlSchema = exports.urlSchema = void 0;
 const zod_1 = require("zod");
+// Accepts only http(s) URLs. Rejects blob:, data:, file:, javascript:, etc.
+// `new URL()` alone treats blob:https://… as valid, so we explicitly check protocol.
 exports.urlSchema = zod_1.z.string().transform((val, ctx) => {
     try {
         if (!val)
             throw new Error("No URL");
-        return new URL(val).toString(); // validates and normalizes
+        const parsed = new URL(val);
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            throw new Error(`Unsupported URL scheme: ${parsed.protocol}`);
+        }
+        return parsed.toString();
     }
-    catch {
+    catch (err) {
         ctx.addIssue({
             code: "custom",
-            message: "Invalid URL",
+            message: err?.message?.startsWith("Unsupported URL scheme")
+                ? "URL must start with http:// or https:// (blob: and data: URLs are not supported — please re-upload the file)"
+                : "Invalid URL",
         });
         return zod_1.z.NEVER;
     }
 });
+// File extensions our image-input pipeline accepts. Must match common formats
+// supported by all image-input video providers (ByteDance, MiniMax, Runway, etc.).
+const ALLOWED_IMAGE_EXTENSIONS = new Set([
+    "jpg", "jpeg", "png", "webp", "gif", "bmp",
+]);
+// Stricter URL schema for fields that must point to an image file. Validates
+// http(s) and file extension. Use this for inputImageUrl, avatarImageUrl, etc.
+// to reject PDFs, audio, video, and other accidental wrong-type uploads at the
+// API boundary instead of relying on each provider's error path.
+exports.imageUrlSchema = zod_1.z.string().transform((val, ctx) => {
+    try {
+        if (!val)
+            throw new Error("No URL");
+        const parsed = new URL(val);
+        if (parsed.protocol !== "http:" && parsed.protocol !== "https:") {
+            ctx.addIssue({
+                code: "custom",
+                message: "Image URL must start with http:// or https:// (please re-upload the file)",
+            });
+            return zod_1.z.NEVER;
+        }
+        // Strip query string (e.g. Firebase Storage tokens) before checking extension
+        const pathname = parsed.pathname.toLowerCase();
+        const lastDot = pathname.lastIndexOf(".");
+        const extension = lastDot >= 0 ? pathname.slice(lastDot + 1) : "";
+        if (!extension || !ALLOWED_IMAGE_EXTENSIONS.has(extension)) {
+            ctx.addIssue({
+                code: "custom",
+                message: `Image must be one of: ${[...ALLOWED_IMAGE_EXTENSIONS].join(", ").toUpperCase()}. Please upload a valid image file.`,
+            });
+            return zod_1.z.NEVER;
+        }
+        return parsed.toString();
+    }
+    catch {
+        ctx.addIssue({ code: "custom", message: "Invalid image URL" });
+        return zod_1.z.NEVER;
+    }
+});

package/lib/models/script.model.js

@@ -8,8 +8,8 @@ const scriptModelBase = zod_1.z.object({
     userId: zod_1.z.string(),
     prompt: zod_1.z.string(), // original if en other wise en translated
     originalPrompt: zod_1.z.string().optional(),
-    durationType: zod_1.z.enum(types_1.EVideoDurationType),
-    videoModelKey: zod_1.z.enum(aiModels_1.EVideoGenModels),
+    durationType: zod_1.z.nativeEnum(types_1.EVideoDurationType),
+    videoModelKey: zod_1.z.nativeEnum(aiModels_1.EVideoGenModels),
     translatedSummary: zod_1.z.string().min(1).optional(), // translated summary
     createdAt: zod_1.z.date(),
     updatedAt: zod_1.z.date(),

package/lib/services/aiGen/providers/bytedance/bytedance.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bytedance.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/bytedance/bytedance.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAUlB,qBAAa,gBAAiB,SAAQ,wBAAwB;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CACsD;IAI9E,OAAO,CAAC,cAAc;IAOhB,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA6G3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA8FjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAoCjD"}
+{"version":3,"file":"bytedance.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/bytedance/bytedance.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAUlB,qBAAa,gBAAiB,SAAQ,wBAAwB;IAC5D,OAAO,CAAC,QAAQ,CAAC,OAAO,CACsD;IAI9E,OAAO,CAAC,cAAc;IAOhB,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA6G3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA2HjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAoCjD"}

package/lib/services/aiGen/providers/bytedance/bytedance.service.js

@@ -127,13 +127,37 @@ class ByteDanceService extends baseAiGenProvider_service_1.BaseAiGenProviderServ
                 return { status: types_1.EVideoSceneStatus.PENDING };
             case "failed":
             case "expired":
-            case "cancelled":
+            case "cancelled": {
+                const errCode = data.error?.code;
+                const errMessage = data.error?.message ?? "";
+                // Sensitive content (matches sceneMonitor.isContentPolicyError so Slack stays quiet).
+                if (errCode?.startsWith("OutputVideoSensitiveContentDetected") ||
+                    errCode?.startsWith("OutputImageSensitiveContentDetected") ||
+                    errCode?.startsWith("InputVideoSensitiveContentDetected") ||
+                    errCode?.startsWith("InputImageSensitiveContentDetected") ||
+                    errCode?.startsWith("InputTextSensitiveContentDetected")) {
+                    // Keep raw JSON so the monitor's classifier still matches.
+                    return {
+                        status: types_1.EVideoSceneStatus.FAILED,
+                        errorMessage: JSON.stringify(data.error),
+                    };
+                }
+                // Generic InvalidParameter on content.text — ByteDance's moderation pipeline
+                // rejects the prompt asynchronously without a more specific code. Preserve the
+                // raw error so the classifier can suppress Slack alerts, but flag it clearly.
+                if (errCode === "InvalidParameter" && /content\.text/i.test(errMessage)) {
+                    return {
+                        status: types_1.EVideoSceneStatus.FAILED,
+                        errorMessage: JSON.stringify(data.error),
+                    };
+                }
                 return {
                     status: types_1.EVideoSceneStatus.FAILED,
                     errorMessage: data.error
                         ? JSON.stringify(data.error)
                         : "ByteDance video generation failed",
                 };
+            }
             case "succeeded":
                 break;
             default:

package/lib/services/aiGen/providers/google/google.service.d.ts

@@ -2,7 +2,14 @@ import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
 import { CreditUsageParams, VideoGenerationParams, VideoGenerationResult, VideoStatusParams, VideoStatusResult } from "../types";
 export declare class GoogleService extends BaseAiGenProviderService {
     private ai;
+    private static readonly MAX_RETRY_ATTEMPTS;
     constructor();
+    /**
+     * Retries `fn` on transient network errors (undici "fetch failed", ECONNRESET, ETIMEDOUT,
+     * DNS hiccups, etc.) with exponential backoff: 1s → 2s → 4s. Non-network errors
+     * (auth, validation, quota) bypass retry and surface immediately.
+     */
+    private withTransientRetry;
     generateVideo(params: VideoGenerationParams): Promise<VideoGenerationResult>;
     checkVideoStatus({ task, outputFilename, outputFilePath, }: VideoStatusParams): Promise<VideoStatusResult>;
     getCreditUsed({ modelKey, duration, resolution, multiClip }: CreditUsageParams): number;

package/lib/services/aiGen/providers/google/google.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"google.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/google/google.service.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAIlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,EAAE,CAAc;;IAOlB,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAqC3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmEjD,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,UAAmB,EAAE,SAAiB,EAAE,EAAE,iBAAiB,GAAG,MAAM;CAiB7G"}
+{"version":3,"file":"google.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/google/google.service.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AA6BlB,qBAAa,aAAc,SAAQ,wBAAwB;IACzD,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAK;;IAO/C;;;;OAIG;YACW,kBAAkB;IA0B1B,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAyC3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuEjD,aAAa,CAAC,EAAE,QAAQ,EAAE,QAAY,EAAE,UAAmB,EAAE,SAAiB,EAAE,EAAE,iBAAiB,GAAG,MAAM;CAiB7G"}

package/lib/services/aiGen/providers/google/google.service.js

@@ -16,16 +16,71 @@ const helpers_2 = require("../../helpers");
 const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
 const fs_1 = require("fs");
 const promises_2 = require("stream/promises");
+// Codes from undici / Node net layer that indicate a transient network failure
+// the request never reached the server, or the server hung up mid-flight.
+// Retrying these is safe (idempotent at the API layer for our use cases) and usually succeeds.
+const TRANSIENT_NETWORK_CODES = new Set([
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+    "EPIPE",
+    "UND_ERR_SOCKET",
+    "UND_ERR_CONNECT_TIMEOUT",
+    "UND_ERR_HEADERS_TIMEOUT",
+    "UND_ERR_BODY_TIMEOUT",
+]);
+function isTransientFetchError(err) {
+    if (!err)
+        return false;
+    // undici wraps low-level errors as `TypeError: fetch failed` with the real
+    // reason on `err.cause`. Treat that exact shape as transient.
+    if (err.message === "fetch failed")
+        return true;
+    const code = err.code ?? err.cause?.code;
+    return !!code && TRANSIENT_NETWORK_CODES.has(code);
+}
 class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
     constructor() {
         super();
         this.ai = new genai_1.GoogleGenAI({ apiKey: process.env.GOOGLE_API_KEY });
     }
+    /**
+     * Retries `fn` on transient network errors (undici "fetch failed", ECONNRESET, ETIMEDOUT,
+     * DNS hiccups, etc.) with exponential backoff: 1s → 2s → 4s. Non-network errors
+     * (auth, validation, quota) bypass retry and surface immediately.
+     */
+    async withTransientRetry(label, fn) {
+        let lastErr;
+        for (let attempt = 1; attempt <= GoogleService.MAX_RETRY_ATTEMPTS; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (err) {
+                lastErr = err;
+                const transient = isTransientFetchError(err);
+                if (!transient || attempt === GoogleService.MAX_RETRY_ATTEMPTS) {
+                    throw err;
+                }
+                const backoffMs = 1000 * 2 ** (attempt - 1); // 1s, 2s, 4s
+                logger_1.logger.warn(`Google ${label} transient network error — retrying`, {
+                    attempt,
+                    maxAttempts: GoogleService.MAX_RETRY_ATTEMPTS,
+                    backoffMs,
+                    message: err.message,
+                    causeCode: err.cause?.code,
+                    causeSyscall: err.cause?.syscall,
+                });
+                await new Promise((r) => setTimeout(r, backoffMs));
+            }
+        }
+        throw lastErr;
+    }
     async generateVideo(params) {
         (0, helpers_2.validateParams)(params);
         const modelConfig = aiModels_1.aiModelConfigs[params.modelKey];
         const modelId = modelConfig.modelId;
-        // console.log("GoogleService.generateVideo - modelId:", modelId, params);
         const request = {
             model: modelId,
             prompt: params.prompt,
@@ -37,14 +92,14 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
             },
         };
         if (params.inputImageUrl) {
-            const imgResp = await fetch(params.inputImageUrl);
+            const imgResp = await this.withTransientRetry("input-image fetch", () => fetch(params.inputImageUrl));
             const imgBuffer = Buffer.from(await imgResp.arrayBuffer());
             request.image = {
                 mimeType: "image/png", // or infer from URL (jpg/png)
                 imageBytes: imgBuffer.toString("base64"),
             };
         }
-        const operation = await this.ai.models.generateVideos(request);
+        const operation = await this.withTransientRetry("generateVideos", () => this.ai.models.generateVideos(request));
         if (!operation || !operation.name) {
             throw new Error("Failed to initiate video generation task");
         }
@@ -53,9 +108,7 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
     async checkVideoStatus({ task, outputFilename, outputFilePath = "videos", }) {
         const operation = new genai_1.GenerateVideosOperation();
         operation.name = task;
-        const result = await this.ai.operations.getVideosOperation({
-            operation,
-        });
+        const result = await this.withTransientRetry("getVideosOperation", () => this.ai.operations.getVideosOperation({ operation }));
         if (result.done) {
             if (result.error) {
                 return {
@@ -74,10 +127,10 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
             const localPath = `${outputFilename}.mp4`; // use /tmp for cloud functions
             const filePath = `${outputFilePath}/${outputFilename}.mp4`;
             const file = (0, firebase_1.getBucket)().file(filePath);
-            await this.ai.files.download({
+            await this.withTransientRetry("files.download", () => this.ai.files.download({
                 file: video,
                 downloadPath: localPath,
-            });
+            }));
             await (0, helpers_1.waitForFile)(localPath, 20000, 500);
             const readStream = (0, fs_1.createReadStream)(localPath);
             const writeStream = file.createWriteStream({ contentType: "video/mp4" });
@@ -118,3 +171,4 @@ class GoogleService extends baseAiGenProvider_service_1.BaseAiGenProviderService
     }
 }
 exports.GoogleService = GoogleService;
+GoogleService.MAX_RETRY_ATTEMPTS = 3;

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

@@ -1,5 +1,10 @@
 import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
 import { CreditUsageParams, VideoGenerationParams, VideoGenerationResult, VideoStatusParams, VideoStatusResult } from "../types";
+/**
+ * Maps Minimax base_resp status codes to user-facing error messages.
+ * Raw codes like "1026 input new_sensitive" are never shown to users.
+ */
+export declare const MINIMAX_USER_INPUT_ERROR_PREFIX = "user_input_error: ";
 export declare class MinimaxService extends BaseAiGenProviderService {
     private readonly baseUrl;
     private readonly apiKey;

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

@@ -1 +1 @@
-{"version":3,"file":"minimax.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/minimax/minimax.service.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAiClB,qBAAa,cAAe,SAAQ,wBAAwB;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YAUlB,OAAO;IAiCf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA4B3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6EjD,aAAa,CAAC,EACZ,QAAQ,EACR,UAAmB,EACnB,QAAY,EACZ,SAAiB,GAClB,EAAE,iBAAiB,GAAG,MAAM;CAW9B"}
+{"version":3,"file":"minimax.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/minimax/minimax.service.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAUlB;;;GAGG;AAGH,eAAO,MAAM,+BAA+B,uBAAuB,CAAC;AAmEpE,qBAAa,cAAe,SAAQ,wBAAwB;IAC1D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YAUlB,OAAO;IAuDf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAmD3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6EjD,aAAa,CAAC,EACZ,QAAQ,EACR,UAAmB,EACnB,QAAY,EACZ,SAAiB,GAClB,EAAE,iBAAiB,GAAG,MAAM;CAW9B"}

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

@@ -3,12 +3,13 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MinimaxService = void 0;
+exports.MinimaxService = exports.MINIMAX_USER_INPUT_ERROR_PREFIX = void 0;
 const axios_1 = __importDefault(require("axios"));
 const aiModels_1 = require("../../../../globals/aiModels");
 const firebase_1 = require("../../../../libs/firebase");
 const types_1 = require("../../../../globals/types");
 const helpers_1 = require("../../helpers");
+const errors_1 = require("../../../../utils/errors");
 const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
 const helpers_2 = require("../../../../utils/helpers");
 const logger_1 = require("../../../../utils/logger");
@@ -16,15 +17,33 @@ const logger_1 = require("../../../../utils/logger");
  * Maps Minimax base_resp status codes to user-facing error messages.
  * Raw codes like "1026 input new_sensitive" are never shown to users.
  */
+// Marker prefix on errorMessage so sceneMonitor's classifier can suppress Slack
+// alerts for user-input failures (image too small, unsupported format, etc.).
+exports.MINIMAX_USER_INPUT_ERROR_PREFIX = "user_input_error: ";
 function minimaxStatusToUserMessage(code, msg) {
-    const lower = msg.toLowerCase();
+    const lower = (msg || "").toLowerCase();
+    // Input-validation errors — user can fix these by changing their input.
+    // Detected by message text because Minimax does not give a stable code for these.
+    if (lower.includes("first_frame_image") || lower.includes("last_frame_image") || lower.includes("subject_reference")) {
+        if (lower.includes("minimum pixel") || lower.includes("short side")) {
+            return `${exports.MINIMAX_USER_INPUT_ERROR_PREFIX}Your input image is too small. Please upload an image at least 300px on the short side.`;
+        }
+        if (lower.includes("aspect ratio") || lower.includes("ratio")) {
+            return `${exports.MINIMAX_USER_INPUT_ERROR_PREFIX}Your input image's aspect ratio is not supported. Please use a more standard ratio (e.g. 16:9, 9:16, 1:1).`;
+        }
+        if (lower.includes("format") || lower.includes("type")) {
+            return `${exports.MINIMAX_USER_INPUT_ERROR_PREFIX}Your input image format is not supported. Please use JPEG or PNG.`;
+        }
+        if (lower.includes("size") || lower.includes("too large")) {
+            return `${exports.MINIMAX_USER_INPUT_ERROR_PREFIX}Your input image is too large. Please upload a smaller image.`;
+        }
+        return `${exports.MINIMAX_USER_INPUT_ERROR_PREFIX}Your input image was rejected by the provider: ${msg}`;
+    }
     switch (code) {
         case 1026:
-            // Input (prompt or image) flagged by content moderation
-            return "Your request was declined because the prompt or input image contains content that violates the content policy. Please modify your prompt or use a different image and try again.";
+            return `${exports.MINIMAX_USER_INPUT_ERROR_PREFIX}Your request was declined because the prompt or input image contains content that violates the content policy. Please modify your prompt or use a different image and try again.`;
         case 1027:
-            // Generated output flagged by content moderation
-            return "Your request was declined because the generated content was flagged for sensitive material. Please adjust your prompt and try again.";
+            return `${exports.MINIMAX_USER_INPUT_ERROR_PREFIX}Your request was declined because the generated content was flagged for sensitive material. Please adjust your prompt and try again.`;
         case 1002:
             return "The request was rejected due to a rate limit or quota issue. Please try again in a moment.";
         case 1004:
@@ -34,6 +53,39 @@ function minimaxStatusToUserMessage(code, msg) {
             return msg || `Generation failed (code ${code})`;
     }
 }
+// Transient axios/network failures that warrant a retry.
+const MINIMAX_TRANSIENT_NETWORK_CODES = new Set([
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+    "ERR_NETWORK",
+    "EPIPE",
+    "ECONNABORTED",
+]);
+const MINIMAX_MAX_ATTEMPTS = 3;
+function isMinimaxTransientError(err) {
+    if (!err)
+        return false;
+    if (err.code === "ECONNABORTED")
+        return true;
+    const code = err.code ?? err.cause?.code;
+    if (code && MINIMAX_TRANSIENT_NETWORK_CODES.has(code))
+        return true;
+    if (typeof err.message === "string" && err.message.toLowerCase().includes("timeout"))
+        return true;
+    // Retry 429 and 5xx — but only when the upstream is reachable enough to
+    // give us a status. Note: our request() uses validateStatus:()=>true so
+    // non-2xx is thrown via Error message; check the message string.
+    if (typeof err.message === "string") {
+        if (err.message.startsWith("Minimax API Error: 429"))
+            return true;
+        if (/^Minimax API Error: 5\d\d/.test(err.message))
+            return true;
+    }
+    return false;
+}
 class MinimaxService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
     constructor() {
         super();
@@ -57,11 +109,34 @@ class MinimaxService extends baseAiGenProvider_service_1.BaseAiGenProviderServic
             timeout: 120000, // 2 minutes timeout
             validateStatus: () => true, // we'll manually handle non-2xx
         };
-        const response = await axios_1.default.request(config);
-        if (response.status < 200 || response.status >= 300) {
-            throw new Error(`Minimax API Error: ${response.status} ${response.statusText} — ${JSON.stringify(response.data)}`);
+        let lastErr;
+        for (let attempt = 1; attempt <= MINIMAX_MAX_ATTEMPTS; attempt++) {
+            try {
+                const response = await axios_1.default.request(config);
+                if (response.status < 200 || response.status >= 300) {
+                    throw new Error(`Minimax API Error: ${response.status} ${response.statusText} — ${JSON.stringify(response.data)}`);
+                }
+                return response.data;
+            }
+            catch (err) {
+                lastErr = err;
+                if (!isMinimaxTransientError(err) || attempt === MINIMAX_MAX_ATTEMPTS) {
+                    throw err;
+                }
+                const backoffMs = 500 * Math.pow(2, attempt - 1); // 500ms, 1s
+                logger_1.logger.warn(`Minimax request failed transiently — retrying`, {
+                    attempt,
+                    maxAttempts: MINIMAX_MAX_ATTEMPTS,
+                    backoffMs,
+                    endpoint,
+                    method,
+                    code: err.code,
+                    message: err.message,
+                });
+                await new Promise((r) => setTimeout(r, backoffMs));
+            }
         }
-        return response.data;
+        throw lastErr;
     }
     async generateVideo(params) {
         (0, helpers_1.validateParams)(params);
@@ -77,9 +152,26 @@ class MinimaxService extends baseAiGenProvider_service_1.BaseAiGenProviderServic
             duration: params.duration || 6,
         };
         const response = await this.request("/v1/video_generation", "POST", requestBody);
-        logger_1.logger.info("Minimax video generation task response", { taskId: response.task_id });
-        const taskId = response.task_id;
-        return { task: taskId, status: types_1.EVideoSceneStatus.TRIGGERED };
+        logger_1.logger.info("Minimax video generation task response", {
+            taskId: response.task_id,
+            statusCode: response.base_resp?.status_code,
+            statusMsg: response.base_resp?.status_msg,
+        });
+        // Minimax returns HTTP 200 with a non-zero base_resp.status_code on soft
+        // failures (sensitive content, invalid params, auth issues). In that case
+        // task_id is missing — surface a clear error rather than persisting a
+        // half-triggered scene with no task handle.
+        const baseStatus = response.base_resp?.status_code ?? 0;
+        if (baseStatus !== 0 || !response.task_id) {
+            const userMessage = minimaxStatusToUserMessage(baseStatus, response.base_resp?.status_msg ?? "");
+            const isUserInput = userMessage.startsWith(exports.MINIMAX_USER_INPUT_ERROR_PREFIX);
+            const cleaned = userMessage.replace(exports.MINIMAX_USER_INPUT_ERROR_PREFIX, "");
+            if (isUserInput) {
+                throw new errors_1.UserFacingError(cleaned);
+            }
+            throw new Error(`Minimax video_generation returned no task_id (code ${baseStatus}): ${cleaned}`);
+        }
+        return { task: response.task_id, status: types_1.EVideoSceneStatus.TRIGGERED };
     }
     async checkVideoStatus({ task, outputFilename, outputFilePath = "videos", }) {
         const result = await this.request(`/v1/query/video_generation`, "GET", undefined, { task_id: `${task}` });

package/lib/services/aiGen/providers/runway/runway.service.js

@@ -67,7 +67,7 @@ class RunwayService extends baseAiGenProvider_service_1.BaseAiGenProviderService
                 ratio: params.aspectRatio,
                 duration: params.duration,
             };
-            run = await this.request("/image-to-video", "POST", body);
+            run = await this.request("/image_to_video", "POST", body);
         }
         // VIDEO → VIDEO (gen4_aleph)
         else if (modelId === "gen4_aleph") {
@@ -77,7 +77,7 @@ class RunwayService extends baseAiGenProvider_service_1.BaseAiGenProviderService
                 videoUri: params.inputVideoUrl,
                 ratio: params.aspectRatio,
             };
-            run = await this.request("/video-to-video", "POST", body);
+            run = await this.request("/video_to_video", "POST", body);
         }
         else {
             throw new Error(`Invalid params: Model ${params.modelKey} does not support this generation type`);

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

@@ -4,6 +4,13 @@ export declare class ElevenLabsService extends BaseTtsProviderService {
     private readonly apiKey;
     constructor();
     generate(params: TtsParams): Promise<TtsResult>;
+    /**
+     * POST to ElevenLabs with bounded timeout + retry on transient failures.
+     * Retries: axios timeout (ECONNABORTED), network errors (ECONNRESET/ETIMEDOUT/etc.),
+     * HTTP 429 (rate limit, longer backoff), HTTP 5xx (server errors).
+     * Does NOT retry: 400/401/403/404 (caller handles 400 language_code separately).
+     */
+    private postTtsWithRetry;
     getVoices(): ITtsVoiceOption[];
     mapLanguageCode(locale: string): string | undefined;
 }

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":"AAGA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEzF,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,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;IA4DrD;;;;;OAKG;YACW,gBAAgB;IAuC9B,SAAS,IAAI,eAAe,EAAE;IAI9B,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGpD"}

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

@@ -7,7 +7,22 @@ exports.ElevenLabsService = void 0;
 const axios_1 = __importDefault(require("axios"));
 const elevenlabs_1 = require("../../../globals/ttsModels/providers/elevenlabs");
 const voices_1 = require("../../../globals/ttsModels/voices");
+const logger_1 = require("../../../utils/logger");
 const types_1 = require("../types");
+// Per-attempt axios timeout. The Firebase Functions `api` umbrella runs on a 60s
+// budget, so we cap a single attempt at 25s — leaves room for one retry plus
+// post-TTS work (Storage upload, signed URL) inside the function window.
+const PER_ATTEMPT_TIMEOUT_MS = 25000;
+const MAX_ATTEMPTS = 2;
+const TRANSIENT_NETWORK_CODES = new Set([
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ETIMEDOUT",
+    "ENOTFOUND",
+    "EAI_AGAIN",
+    "ERR_NETWORK",
+    "EPIPE",
+]);
 class ElevenLabsService extends types_1.BaseTtsProviderService {
     constructor() {
         super();
@@ -23,26 +38,19 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
         const languageCode = params.languageCode
             ? this.mapLanguageCode(params.languageCode)
             : undefined;
+        const buildBody = (lang) => ({
+            text: params.text,
+            model_id: elevenlabs_1.elevenlabsConfig.modelId,
+            language_code: lang,
+            voice_settings: {
+                stability: 0.5,
+                similarity_boost: 0.75,
+            },
+        });
         try {
-            const response = await axios_1.default.post(`${this.baseUrl}/text-to-speech/${voiceId}`, {
-                text: params.text,
-                model_id: elevenlabs_1.elevenlabsConfig.modelId,
-                language_code: languageCode,
-                voice_settings: {
-                    stability: 0.5,
-                    similarity_boost: 0.75,
-                },
-            }, {
-                headers: {
-                    "xi-api-key": this.apiKey,
-                    "Content-Type": "application/json",
-                    Accept: "audio/mpeg",
-                },
-                responseType: "arraybuffer",
-                timeout: 60000,
-            });
+            const audioBuffer = await this.postTtsWithRetry(voiceId, buildBody(languageCode));
             return {
-                audioBuffer: Buffer.from(response.data),
+                audioBuffer,
                 mimeType: "audio/mpeg",
                 extension: "mp3",
             };
@@ -66,21 +74,9 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
                 if (err.response.status === 400 &&
                     languageCode &&
                     (detail.includes("language_code") || detail.includes("does not support"))) {
-                    const response = await axios_1.default.post(`${this.baseUrl}/text-to-speech/${voiceId}`, {
-                        text: params.text,
-                        model_id: elevenlabs_1.elevenlabsConfig.modelId,
-                        voice_settings: { stability: 0.5, similarity_boost: 0.75 },
-                    }, {
-                        headers: {
-                            "xi-api-key": this.apiKey,
-                            "Content-Type": "application/json",
-                            Accept: "audio/mpeg",
-                        },
-                        responseType: "arraybuffer",
-                        timeout: 60000,
-                    });
+                    const audioBuffer = await this.postTtsWithRetry(voiceId, buildBody(undefined));
                     return {
-                        audioBuffer: Buffer.from(response.data),
+                        audioBuffer,
                         mimeType: "audio/mpeg",
                         extension: "mp3",
                     };
@@ -90,6 +86,47 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
             throw err;
         }
     }
+    /**
+     * POST to ElevenLabs with bounded timeout + retry on transient failures.
+     * Retries: axios timeout (ECONNABORTED), network errors (ECONNRESET/ETIMEDOUT/etc.),
+     * 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) {
+        let lastErr;
+        for (let attempt = 1; attempt <= MAX_ATTEMPTS; attempt++) {
+            try {
+                const response = await axios_1.default.post(`${this.baseUrl}/text-to-speech/${voiceId}`, body, {
+                    headers: {
+                        "xi-api-key": this.apiKey,
+                        "Content-Type": "application/json",
+                        Accept: "audio/mpeg",
+                    },
+                    responseType: "arraybuffer",
+                    timeout: PER_ATTEMPT_TIMEOUT_MS,
+                });
+                return Buffer.from(response.data);
+            }
+            catch (err) {
+                lastErr = err;
+                if (!isTransientHttpError(err) || attempt === MAX_ATTEMPTS) {
+                    throw err;
+                }
+                const status = err.response?.status;
+                const backoffMs = status === 429 ? 2000 : 500;
+                logger_1.logger.warn("ElevenLabs TTS request failed — retrying", {
+                    attempt,
+                    maxAttempts: MAX_ATTEMPTS,
+                    backoffMs,
+                    status,
+                    code: err.code,
+                    message: err.message,
+                });
+                await new Promise((r) => setTimeout(r, backoffMs));
+            }
+        }
+        throw lastErr;
+    }
     getVoices() {
         return voices_1.ELEVENLABS_VOICES;
     }
@@ -98,3 +135,25 @@ class ElevenLabsService extends types_1.BaseTtsProviderService {
     }
 }
 exports.ElevenLabsService = ElevenLabsService;
+function isTransientHttpError(err) {
+    if (!err)
+        return false;
+    // Axios timeout
+    if (err.code === "ECONNABORTED")
+        return true;
+    if (typeof err.message === "string" && err.message.toLowerCase().includes("timeout"))
+        return true;
+    // Network-level codes (top-level or wrapped via cause)
+    const code = err.code ?? err.cause?.code;
+    if (code && TRANSIENT_NETWORK_CODES.has(code))
+        return true;
+    if (err.name === "AggregateError")
+        return true;
+    // Server errors / rate limit
+    const status = err.response?.status;
+    if (status === 429)
+        return true;
+    if (typeof status === "number" && status >= 500 && status < 600)
+        return true;
+    return false;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vidspotai-shared",
-  "version": "1.0.50",
+  "version": "1.0.51",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "exports": {