vidspotai-shared 1.0.80 → 1.0.82-dev.0

package/lib/services/aiGen/transientRetry.d.ts

@@ -0,0 +1,35 @@
+/**
+ * True when an error from `fetch()` / SDK call is a transient network failure
+ * worth retrying. False for application-layer errors (4xx, validation, etc.).
+ */
+export declare function isTransientFetchError(err: unknown): boolean;
+/**
+ * Marker thrown by callers when they detect a transient HTTP response (5xx /
+ * 429 / opt-in 404) and want `withTransientRetry` to retry it. Caller is
+ * responsible for the classification — this util is response-shape agnostic.
+ */
+export declare class TransientHttpError extends Error {
+    readonly isTransientHttpError = true;
+    readonly status: number;
+    constructor(status: number, message: string);
+}
+export interface TransientRetryOptions {
+    /** Max attempts including the first try. Defaults to 3. */
+    maxAttempts?: number;
+    /** Base backoff in ms; doubled each retry. Defaults to 1000 (1s → 2s → 4s). */
+    baseBackoffMs?: number;
+    /** Logger function for warn-level retry notices. */
+    onRetry?: (info: {
+        attempt: number;
+        maxAttempts: number;
+        backoffMs: number;
+        err: Error;
+    }) => void;
+}
+/**
+ * Wraps `fn` with retry on transient errors. UserFacingError ALWAYS short-
+ * circuits (no retry, no logging — caller's responsibility to log appropriately).
+ * Non-transient errors short-circuit on the first attempt.
+ */
+export declare function withTransientRetry<T>(label: string, fn: () => Promise<T>, opts?: TransientRetryOptions): Promise<T>;
+//# sourceMappingURL=transientRetry.d.ts.map

package/lib/services/aiGen/transientRetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transientRetry.d.ts","sourceRoot":"","sources":["../../../src/services/aiGen/transientRetry.ts"],"names":[],"mappings":"AAwCA;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAQ3D;AAED;;;;GAIG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,oBAAoB,QAAQ;IACrC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBACZ,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK5C;AAED,MAAM,WAAW,qBAAqB;IACpC,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oDAAoD;IACpD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,KAAK,CAAA;KAAE,KAAK,IAAI,CAAC;CACnG;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EACxC,KAAK,EAAE,MAAM,EACb,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,IAAI,GAAE,qBAA0B,GAC/B,OAAO,CAAC,CAAC,CAAC,CA2BZ"}

package/lib/services/aiGen/transientRetry.js

@@ -0,0 +1,106 @@
+"use strict";
+// Shared transient-error retry primitive for provider service calls.
+//
+// Background: every provider (Google, PixVerse, Alibaba, ...) makes outbound
+// HTTP/SDK calls that can drop on transient network failures (TCP resets,
+// undici fetch hiccups, upstream 5xx, CloudFlare edge 404 misroutes, etc.).
+// Before this util each provider classified transient errors inline or not at
+// all, so the same edge hiccup that retried OK on Google would fail-fast on
+// PixVerse — fan-out inconsistency that bit us with the 2026-06-06 PixVerse
+// 404 (the request body was valid, the account had a real account-level
+// problem, but the response shape was an HTML "404 page not found" from the
+// edge layer — a one-shot we'd have absorbed silently with a retry).
+//
+// Policy:
+//  - retry on undici "fetch failed" + the network-code allowlist below
+//  - retry on HTTP 5xx + 429 + 404 (404 ONLY when the URL is known-good and the
+//    caller opted in via `retryHttp4xx404`; otherwise 4xx is permanent)
+//  - never retry UserFacingError — those are deterministic by construction
+//    (content moderation, validation, missing input) and a retry just burns
+//    a provider credit for the same outcome
+//
+// Backoff: exponential 1s → 2s → 4s by default. Override via `backoffMs`.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransientHttpError = void 0;
+exports.isTransientFetchError = isTransientFetchError;
+exports.withTransientRetry = withTransientRetry;
+const errors_1 = require("../../utils/errors");
+// Codes from undici / Node net layer that indicate a transient network failure
+// (request never reached server, or server hung up mid-flight). Retrying these
+// is safe at the API layer for our use cases.
+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",
+]);
+/**
+ * True when an error from `fetch()` / SDK call is a transient network failure
+ * worth retrying. False for application-layer errors (4xx, validation, etc.).
+ */
+function isTransientFetchError(err) {
+    if (!err)
+        return false;
+    const e = err;
+    // undici wraps low-level errors as `TypeError: fetch failed` with the real
+    // reason on `err.cause`. Treat that exact shape as transient.
+    if (e.message === "fetch failed")
+        return true;
+    const code = e.code ?? e.cause?.code;
+    return !!code && TRANSIENT_NETWORK_CODES.has(code);
+}
+/**
+ * Marker thrown by callers when they detect a transient HTTP response (5xx /
+ * 429 / opt-in 404) and want `withTransientRetry` to retry it. Caller is
+ * responsible for the classification — this util is response-shape agnostic.
+ */
+class TransientHttpError extends Error {
+    constructor(status, message) {
+        super(message);
+        this.isTransientHttpError = true;
+        this.name = "TransientHttpError";
+        this.status = status;
+    }
+}
+exports.TransientHttpError = TransientHttpError;
+/**
+ * Wraps `fn` with retry on transient errors. UserFacingError ALWAYS short-
+ * circuits (no retry, no logging — caller's responsibility to log appropriately).
+ * Non-transient errors short-circuit on the first attempt.
+ */
+async function withTransientRetry(label, fn, opts = {}) {
+    const maxAttempts = opts.maxAttempts ?? 3;
+    const baseBackoffMs = opts.baseBackoffMs ?? 1000;
+    let lastErr;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastErr = err;
+            // UserFacingError is by-construction deterministic — never retry.
+            if (err instanceof errors_1.UserFacingError)
+                throw err;
+            const transient = isTransientFetchError(err) ||
+                (err instanceof TransientHttpError);
+            if (!transient || attempt === maxAttempts)
+                throw err;
+            const backoffMs = baseBackoffMs * 2 ** (attempt - 1);
+            opts.onRetry?.({
+                attempt,
+                maxAttempts,
+                backoffMs,
+                err: err,
+            });
+            void label; // label is for tracing in caller's onRetry; intentionally unused here
+            await new Promise((r) => setTimeout(r, backoffMs));
+        }
+    }
+    throw lastErr;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vidspotai-shared",
-  "version": "1.0.80",
+  "version": "1.0.82-dev.0",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "exports": {

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

@@ -1,14 +0,0 @@
-import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
-import { CreditUsageParams, VideoGenerationParams, VideoGenerationResult, VideoStatusParams, VideoStatusResult } from "../types";
-export declare class AzureService extends BaseAiGenProviderService {
-    private readonly baseUrl;
-    private readonly apiKey;
-    private readonly apiVersion;
-    private readonly timeout;
-    constructor();
-    private request;
-    generateVideo(params: VideoGenerationParams): Promise<VideoGenerationResult>;
-    checkVideoStatus({ task, outputFilename, outputFilePath, }: VideoStatusParams): Promise<VideoStatusResult>;
-    getCreditUsed({ modelKey, dimensions, duration, multiClip, }: CreditUsageParams): number;
-}
-//# sourceMappingURL=azure.service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"azure.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/azure/azure.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAElB,qBAAa,YAAa,SAAQ,wBAAwB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;;YAiBnB,OAAO;IAwBf,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IA6B3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgDjD,aAAa,CAAC,EACZ,QAAQ,EACR,UAAsB,EACtB,QAAY,EACZ,SAAiB,GAClB,EAAE,iBAAiB,GAAG,MAAM;CAS9B"}

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

@@ -1,108 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AzureService = void 0;
-const axios_1 = __importDefault(require("axios"));
-const aiModels_1 = require("../../../../globals/aiModels");
-const types_1 = require("../../../../globals/types");
-const firebase_1 = require("../../../../libs/firebase");
-const helpers_1 = require("../../../../utils/helpers");
-const logger_1 = require("../../../../utils/logger");
-const helpers_2 = require("../../helpers");
-const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
-class AzureService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
-    constructor() {
-        super();
-        this.apiVersion = "preview";
-        this.timeout = 60000; // 60 seconds
-        if (!process.env.AZURE_OPENAI_ENDPOINT ||
-            !process.env.AZURE_OPENAI_API_KEY) {
-            throw new Error("Missing AZURE_OPENAI_ENDPOINT or AZURE_OPENAI_API_KEY in environment variables");
-        }
-        this.baseUrl = process.env.AZURE_OPENAI_ENDPOINT;
-        this.apiKey = process.env.AZURE_OPENAI_API_KEY;
-    }
-    async request(endpoint, method, body) {
-        const url = `${this.baseUrl}${endpoint}${endpoint.includes("?") ? "&" : "?"}api-version=${this.apiVersion}`;
-        const config = {
-            method,
-            url,
-            headers: {
-                "api-key": this.apiKey,
-                "Content-Type": "application/json",
-            },
-            timeout: this.timeout,
-            data: body,
-        };
-        const res = await axios_1.default.request(config);
-        return res.data;
-    }
-    async generateVideo(params) {
-        (0, helpers_2.validateParams)(params);
-        const modelId = aiModels_1.aiModelConfigs[params.modelKey]?.modelId || "sora";
-        const body = {
-            prompt: params.prompt,
-            width: params.dimensions?.split("x")[0]
-                ? parseInt(params.dimensions.split("x")[0] ?? "480", 10)
-                : 480,
-            height: params.dimensions?.split("x")[1]
-                ? parseInt(params.dimensions.split("x")[1] ?? "480", 10)
-                : 480,
-            n_seconds: params.duration || 5,
-            model: modelId,
-        };
-        const job = await this.request(`/openai/v1/video/generations/jobs?`, "POST", body);
-        return {
-            task: job.id,
-            status: types_1.EVideoSceneStatus.TRIGGERED,
-        };
-    }
-    async checkVideoStatus({ task, outputFilename, outputFilePath = "videos", }) {
-        const result = await this.request(`/openai/v1/video/generations/jobs/${task}?`, "GET");
-        if (result.status === "succeeded") {
-            if (!result.generations || !(result.generations.length > 0)) {
-                return {
-                    status: types_1.EVideoSceneStatus.FAILED,
-                    errorMessage: "No video returned from API",
-                };
-            }
-            const generationId = result.generations[0].id;
-            const videoUrl = `${this.baseUrl}/openai/v1/video/generations/${generationId}/content/video?api-version=${this.apiVersion}`;
-            const videoResp = await axios_1.default.get(videoUrl, {
-                headers: { "api-key": this.apiKey },
-                responseType: "arraybuffer",
-                timeout: this.timeout,
-            });
-            if (!videoResp.data)
-                throw new Error("No video data received from Azure API");
-            const filePath = `${outputFilePath}/${outputFilename}.mp4`;
-            const file = (0, firebase_1.getBucket)().file(filePath);
-            const buffer = Buffer.from(videoResp.data);
-            await file.save(buffer, { contentType: "video/mp4" });
-            const [signedUrl] = await file.getSignedUrl({
-                action: "read",
-                expires: "03-09-2491",
-            });
-            return { videoUrl: signedUrl, status: types_1.EVideoSceneStatus.COMPLETED };
-        }
-        else if (result.status === "failed") {
-            return {
-                status: types_1.EVideoSceneStatus.FAILED,
-                errorMessage: `Task failed: ${result.failure_reason || "unknown"}`,
-            };
-        }
-        return { status: types_1.EVideoSceneStatus.PENDING };
-    }
-    getCreditUsed({ modelKey, dimensions = "480x480", duration = 5, multiClip = false, }) {
-        const modelConfig = aiModels_1.aiModelConfigs[modelKey];
-        const cost = modelConfig.cost?.table?.[dimensions]?.[duration];
-        if (cost === undefined || cost === null) {
-            logger_1.logger.warn(`Azure getCreditUsed: no cost entry for modelKey="${modelKey}" dimensions="${dimensions}" duration=${duration} — returning fallback`, { modelKey, dimensions, duration });
-            return (0, helpers_1.getCreditsFromCost)(1.0, !multiClip);
-        }
-        return (0, helpers_1.getCreditsFromCost)(cost, !multiClip);
-    }
-}
-exports.AzureService = AzureService;

package/lib/services/aiGen/providers/azure/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./azure.service";
-//# sourceMappingURL=index.d.ts.map

package/lib/services/aiGen/providers/azure/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/azure/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/lib/services/aiGen/providers/azure/index.js

@@ -1,17 +0,0 @@
-"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./azure.service"), exports);