vidspotai-shared 1.0.67 → 1.0.69-dev.0

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

@@ -1,16 +1,47 @@
 "use strict";
 // openai.service.ts
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
+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;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OpenaiService = void 0;
-const openai_1 = __importDefault(require("openai"));
+const openai_1 = __importStar(require("openai"));
 const aiModels_1 = require("../../../../globals/aiModels");
 const types_1 = require("../../../../globals/types");
 const firebase_1 = require("../../../../libs/firebase");
 const utils_1 = require("../../../../utils");
 const logger_1 = require("../../../../utils/logger");
+const errors_1 = require("../../../../utils/errors");
 const helpers_1 = require("../../helpers");
 const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
 class OpenaiService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
@@ -22,12 +53,27 @@ class OpenaiService extends baseAiGenProvider_service_1.BaseAiGenProviderService
     async generateVideo(params) {
         (0, helpers_1.validateParams)(params);
         const modelId = aiModels_1.aiModelConfigs[params.modelKey]?.modelId || "sora-2";
-        const job = await this.client.videos.create({
+        const request = {
             prompt: params.prompt || "",
             model: modelId,
             seconds: params.duration?.toString() || "4",
             size: params.dimensions || "720x1280",
-        });
+        };
+        // First-frame image-to-video. The Sora API requires the reference image
+        // dimensions to match `size`; the caller is responsible for that.
+        // Note: openai SDK v6.3.0 does NOT yet expose extensions / characters /
+        // edits endpoints — those exist in the REST API but are not surfaced here.
+        if (params.inputImageUrl) {
+            const resp = await fetch(params.inputImageUrl);
+            // fetch() does not throw on 4xx/5xx — surface the HTTP error so we
+            // don't ship an HTML error page to Sora as if it were image bytes.
+            if (!resp.ok) {
+                throw new errors_1.UserFacingError(`Input image could not be downloaded (HTTP ${resp.status}). The image URL may have expired or been deleted.`);
+            }
+            const filename = (params.inputImageUrl.split("?")[0] ?? "reference").split("/").pop() || "reference.png";
+            request.input_reference = await (0, openai_1.toFile)(resp, filename);
+        }
+        const job = await this.client.videos.create(request);
         if (job.status === "failed") {
             throw new Error(`OpenAI video generation failed: ${JSON.stringify(job.error)}`);
         }
@@ -103,8 +149,139 @@ class OpenaiService extends baseAiGenProvider_service_1.BaseAiGenProviderService
             text,
         };
     }
-    getCreditUsed({ modelKey, resolution = "720x1280", duration = 5, multiClip = false, }) {
+    /**
+     * Synchronous image generation. Routes to /v1/images/generations for T2I or
+     * /v1/images/edits when input images are present (edits accepts up to 16
+     * reference images and an optional pixel mask).
+     */
+    async generateImage(params) {
+        const modelConfig = aiModels_1.aiModelConfigs[params.modelKey];
+        const modelId = modelConfig?.modelId;
+        if (!modelId)
+            throw new Error(`Unknown image modelKey: ${params.modelKey}`);
+        const refs = [
+            ...(params.inputImageUrl ? [params.inputImageUrl] : []),
+            ...(params.inputImageUrls ?? []),
+        ].slice(0, 16);
+        const isEdit = refs.length > 0;
+        // gpt-image-1 only accepts `size` (no aspectRatio knob). When the agent
+        // sends aspectRatio but no explicit dimensions, default to the matching
+        // canonical size; otherwise it silently produces a 1024×1024 square even
+        // for 9:16 / 16:9 projects.
+        const size = params.dimensions ??
+            (params.aspectRatio
+                ? params.aspectRatio === "9:16" || params.aspectRatio === "3:4" || params.aspectRatio === "4:5"
+                    ? "1024x1536"
+                    : params.aspectRatio === "16:9" || params.aspectRatio === "4:3"
+                        ? "1536x1024"
+                        : "1024x1024"
+                : undefined);
+        // Cast at assignment site — we never pass `stream: true`, so the
+        // non-streaming overload always applies; TS can't narrow the union
+        // automatically from the absence of a field.
+        let resp;
+        if (isEdit) {
+            const images = await Promise.all(refs.map(async (url) => {
+                const r = await fetch(url);
+                if (!r.ok) {
+                    logger_1.logger.error("openai: ref fetch failed", {
+                        url,
+                        status: r.status,
+                        statusText: r.statusText,
+                    });
+                    throw new Error(`openai ref fetch ${r.status}`);
+                }
+                const name = (url.split("?")[0] ?? "ref").split("/").pop() || "ref.png";
+                return (0, openai_1.toFile)(r, name);
+            }));
+            const mask = params.maskImageUrl
+                ? await (async () => {
+                    const r = await fetch(params.maskImageUrl);
+                    if (!r.ok) {
+                        logger_1.logger.error("openai: mask fetch failed", {
+                            url: params.maskImageUrl,
+                            status: r.status,
+                            statusText: r.statusText,
+                        });
+                        throw new Error(`openai mask fetch ${r.status}`);
+                    }
+                    return (0, openai_1.toFile)(r, "mask.png");
+                })()
+                : undefined;
+            resp = (await this.client.images.edit({
+                model: modelId,
+                prompt: params.prompt,
+                image: images.length === 1 ? images[0] : images,
+                ...(mask ? { mask } : {}),
+                ...(params.numImages ? { n: params.numImages } : {}),
+                ...(size ? { size: size } : {}),
+                ...(params.quality ? { quality: params.quality } : {}),
+                ...(params.background ? { background: params.background } : {}),
+                ...(params.outputFormat ? { output_format: params.outputFormat } : {}),
+            }));
+            if (!resp?.data?.length) {
+                logger_1.logger.error("openai: images endpoint returned no data", {
+                    endpoint: "edit",
+                    responseKeys: resp ? Object.keys(resp) : null,
+                });
+                throw new Error("openai images: empty data[]");
+            }
+        }
+        else {
+            resp = (await this.client.images.generate({
+                model: modelId,
+                prompt: params.prompt,
+                ...(params.numImages ? { n: params.numImages } : {}),
+                ...(size ? { size: size } : {}),
+                ...(params.quality ? { quality: params.quality } : {}),
+                ...(params.background ? { background: params.background } : {}),
+                ...(params.outputFormat ? { output_format: params.outputFormat } : {}),
+            }));
+            if (!resp?.data?.length) {
+                logger_1.logger.error("openai: images endpoint returned no data", {
+                    endpoint: "generate",
+                    responseKeys: resp ? Object.keys(resp) : null,
+                });
+                throw new Error("openai images: empty data[]");
+            }
+        }
+        const data = resp.data ?? [];
+        const bucket = (0, firebase_1.getBucket)();
+        const ts = Date.now();
+        const ext = params.outputFormat ?? "png";
+        const urls = [];
+        for (let i = 0; i < data.length; i++) {
+            const item = data[i];
+            const b64 = item?.b64_json;
+            const remoteUrl = item?.url;
+            let bytes;
+            if (b64)
+                bytes = Buffer.from(b64, "base64");
+            else if (remoteUrl)
+                bytes = Buffer.from(await (await fetch(remoteUrl)).arrayBuffer());
+            else
+                continue;
+            const path = `images/openai/${ts}-${Math.random().toString(36).slice(2, 8)}-${i}.${ext}`;
+            const file = bucket.file(path);
+            await file.save(bytes, { contentType: `image/${ext}` });
+            const [signed] = await file.getSignedUrl({ action: "read", expires: "03-09-2491" });
+            urls.push(signed);
+        }
+        if (!urls.length)
+            throw new Error("OpenAI image API returned no decodable images");
+        return {
+            imageUrl: urls[0],
+            imageUrls: urls.length > 1 ? urls : undefined,
+        };
+    }
+    getCreditUsed({ modelKey, resolution = "720x1280", duration = 5, multiClip = false, numImages = 1, quality, }) {
         const modelConfig = aiModels_1.aiModelConfigs[modelKey];
+        // Image-gen — fixed per-image cost; quality scales gpt-image price (low=0.5×,
+        // medium=1×, high=4×, auto≈medium).
+        if (modelConfig?.cost?.fixed !== undefined) {
+            const qualityMultiplier = quality === "high" ? 4 : quality === "low" ? 0.5 : 1;
+            return (0, utils_1.getCreditsFromCost)(modelConfig.cost.fixed * Math.max(1, numImages) * qualityMultiplier, !multiClip);
+        }
         const cost = modelConfig?.cost?.table?.[resolution]?.[duration];
         if (cost === undefined || cost === null) {
             logger_1.logger.warn(`OpenAI getCreditUsed: no cost entry for modelKey="${modelKey}" resolution="${resolution}" duration=${duration} — returning fallback`, { modelKey, resolution, duration });

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

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

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

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

package/lib/services/aiGen/providers/{azure → pexels}/index.js

@@ -14,4 +14,4 @@ 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);
+__exportStar(require("./pexels.service"), exports);

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

@@ -0,0 +1,11 @@
+import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
+import { CreditUsageParams, StockSearchParams, StockSearchResult } from "../types";
+export declare class PexelsProviderService extends BaseAiGenProviderService {
+    private readonly apiKey;
+    searchStock(params: StockSearchParams): Promise<StockSearchResult>;
+    /** Free assets — registers as 0 credits regardless of model. */
+    getCreditUsed(_params: CreditUsageParams): number;
+    private aspectToOrientation;
+    private pickBestVideoFile;
+}
+//# sourceMappingURL=pexels.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pexels.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pexels/pexels.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AA+DlB,qBAAa,qBAAsB,SAAQ,wBAAwB;IACjE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkD;IAEnE,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmGxE,gEAAgE;IAChE,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAIjD,OAAO,CAAC,mBAAmB;IAS3B,OAAO,CAAC,iBAAiB;CAY1B"}

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

@@ -0,0 +1,150 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PexelsProviderService = void 0;
+const axios_1 = __importDefault(require("axios"));
+const apiUsageCounter_service_1 = require("../../../apiUsageCounter.service");
+const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
+// Pexels free tier: 200 req/h + 20,000 req/month. Cap at 18,000/mo to leave
+// headroom for end-of-month traffic spikes; override per-deploy via env.
+const PEXELS_MONTHLY_CAP = Number(process.env.PEXELS_MONTHLY_CAP ?? 18000);
+// 10s per-call cap so the agent executor doesn't hang on a slow Pexels response
+// — the cascade can fall through to Pixabay / Unsplash instead.
+const PEXELS_TIMEOUT_MS = 10000;
+/**
+ * Pexels stock provider — T0 tier (free).
+ *
+ * Pexels' free API supports video + image search. We deliberately ignore the
+ * music API for now (it's photo-only on the free tier; music comes from a
+ * different stock provider in a later commit).
+ *
+ * Attribution: Pexels' license requires "Photos provided by Pexels" attribution
+ * when used in publication. Producer surfaces (storyboard, finished video page)
+ * must surface this — handled in the UI layer, not here.
+ */
+const PEXELS_VIDEO_URL = "https://api.pexels.com/videos/search";
+const PEXELS_IMAGE_URL = "https://api.pexels.com/v1/search";
+class PexelsProviderService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
+    constructor() {
+        super(...arguments);
+        this.apiKey = process.env.PEXELS_API_KEY;
+    }
+    async searchStock(params) {
+        if (!this.apiKey) {
+            throw new Error("PEXELS_API_KEY not set — pexels provider cannot search");
+        }
+        if (params.kind === "music") {
+            throw new Error("Pexels does not provide stock music");
+        }
+        const allowed = await apiUsageCounter_service_1.ApiUsageCounterService.tryConsume({
+            provider: "pexels",
+            monthlyCap: PEXELS_MONTHLY_CAP,
+        });
+        if (!allowed) {
+            throw new Error(`PEXELS_RATE_LIMITED: monthly cap of ${PEXELS_MONTHLY_CAP} exceeded — back off`);
+        }
+        const headers = { Authorization: this.apiKey };
+        const perPage = Math.min(params.perPage ?? 15, 80);
+        try {
+            if (params.kind === "video") {
+                const { data } = await axios_1.default.get(PEXELS_VIDEO_URL, {
+                    headers,
+                    timeout: PEXELS_TIMEOUT_MS,
+                    params: {
+                        query: params.query,
+                        per_page: perPage,
+                        page: params.page,
+                        orientation: this.aspectToOrientation(params.aspectRatio),
+                        size: params.size,
+                        locale: params.locale,
+                        // Server-side filters — avoid wasting page budget client-side.
+                        min_duration: params.minDurationSec,
+                        max_duration: params.maxDurationSec,
+                        min_width: params.minWidth,
+                        min_height: params.minHeight,
+                    },
+                });
+                return {
+                    assets: data.videos.map((v) => ({
+                        id: String(v.id),
+                        url: this.pickBestVideoFile(v.video_files),
+                        thumbnailUrl: v.image,
+                        width: v.width,
+                        height: v.height,
+                        durationSec: v.duration,
+                        source: "pexels",
+                        attribution: { name: v.user.name, url: v.user.url },
+                    })),
+                    totalAvailable: data.total_results,
+                };
+            }
+            // image
+            const { data } = await axios_1.default.get(PEXELS_IMAGE_URL, {
+                headers,
+                timeout: PEXELS_TIMEOUT_MS,
+                params: {
+                    query: params.query,
+                    per_page: perPage,
+                    page: params.page,
+                    orientation: this.aspectToOrientation(params.aspectRatio),
+                    size: params.size,
+                    color: params.color,
+                    locale: params.locale,
+                },
+            });
+            return {
+                assets: data.photos.map((p) => ({
+                    id: String(p.id),
+                    url: p.src.original,
+                    thumbnailUrl: p.src.medium,
+                    width: p.width,
+                    height: p.height,
+                    source: "pexels",
+                    attribution: { name: p.photographer, url: p.photographer_url },
+                })),
+                totalAvailable: data.total_results,
+            };
+        }
+        catch (err) {
+            // Surface 429 distinctly so upstream can degrade / pick another provider
+            // rather than retrying into the rate-limit wall (200 req/h free tier).
+            if (err?.response?.status === 429) {
+                throw new Error("PEXELS_RATE_LIMITED: 429 from Pexels API — back off");
+            }
+            if (err?.code === "ECONNABORTED" || /timeout/i.test(err?.message ?? "")) {
+                throw new Error(`PEXELS_TIMEOUT: request timed out after ${PEXELS_TIMEOUT_MS}ms`);
+            }
+            throw err;
+        }
+    }
+    /** Free assets — registers as 0 credits regardless of model. */
+    getCreditUsed(_params) {
+        return 0;
+    }
+    aspectToOrientation(aspect) {
+        if (!aspect)
+            return undefined;
+        if (aspect === "9:16" || aspect === "4:5")
+            return "portrait";
+        if (aspect === "1:1")
+            return "square";
+        return "landscape";
+    }
+    pickBestVideoFile(files) {
+        // Prefer .mp4 1080p, fall back to highest-resolution mp4.
+        const mp4 = files.filter((f) => f.file_type === "video/mp4");
+        if (mp4.length === 0) {
+            const first = files[0];
+            if (!first)
+                throw new Error("Pexels video has no files");
+            return first.link;
+        }
+        const hd = mp4.find((f) => f.height >= 1000 && f.height <= 1200);
+        if (hd)
+            return hd.link;
+        return mp4.sort((a, b) => b.height - a.height)[0].link;
+    }
+}
+exports.PexelsProviderService = PexelsProviderService;

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

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

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

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

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

@@ -0,0 +1,17 @@
+"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("./pixabay.service"), exports);

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

@@ -0,0 +1,12 @@
+import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
+import { CreditUsageParams, StockSearchParams, StockSearchResult } from "../types";
+export declare class PixabayProviderService extends BaseAiGenProviderService {
+    private readonly apiKey;
+    searchStock(params: StockSearchParams): Promise<StockSearchResult>;
+    /** Free assets — registers as 0 credits regardless of model. */
+    getCreditUsed(_params: CreditUsageParams): number;
+    private aspectToOrientation;
+    /** Prefer large → medium → small → tiny so we get the best quality available. */
+    private pickBestVideoFile;
+}
+//# sourceMappingURL=pixabay.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pixabay.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pixabay/pixabay.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAyElB,qBAAa,sBAAuB,SAAQ,wBAAwB;IAClE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;IAEpE,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwHxE,gEAAgE;IAChE,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAIjD,OAAO,CAAC,mBAAmB;IAS3B,iFAAiF;IACjF,OAAO,CAAC,iBAAiB;CAO1B"}

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

@@ -0,0 +1,156 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PixabayProviderService = void 0;
+const axios_1 = __importDefault(require("axios"));
+const apiUsageCounter_service_1 = require("../../../apiUsageCounter.service");
+const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
+/**
+ * Pixabay stock provider — T0 tier (free).
+ *
+ * Pixabay's free API supports both photo and video search. We use it as the
+ * second link in the stock-search cascade (Pexels → Pixabay → Unsplash for
+ * images, Pexels → Pixabay for videos). Auth is a query-string `key=...`
+ * parameter — no header.
+ *
+ * Free tier limits: 100 req/min by default, "soft cap" of ~5k req/hr. We
+ * impose a conservative monthly counter for runaway protection (cache layer
+ * absorbs most repeat queries anyway).
+ *
+ * Attribution: Pixabay Content License is permissive but encourages credit
+ * ("Image by ... from Pixabay"). The producer / finished-video UI surfaces
+ * the photographer name via the same `attribution.{name,url}` envelope we
+ * use for Pexels + Unsplash.
+ */
+const PIXABAY_IMAGE_URL = "https://pixabay.com/api/";
+const PIXABAY_VIDEO_URL = "https://pixabay.com/api/videos/";
+const PIXABAY_MONTHLY_CAP = Number(process.env.PIXABAY_MONTHLY_CAP ?? 50000);
+const PIXABAY_TIMEOUT_MS = 10000;
+class PixabayProviderService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
+    constructor() {
+        super(...arguments);
+        this.apiKey = process.env.PIXABAY_API_KEY;
+    }
+    async searchStock(params) {
+        if (!this.apiKey) {
+            throw new Error("PIXABAY_API_KEY not set — pixabay provider cannot search");
+        }
+        if (params.kind === "music") {
+            throw new Error("Pixabay music search not implemented");
+        }
+        const allowed = await apiUsageCounter_service_1.ApiUsageCounterService.tryConsume({
+            provider: "pixabay",
+            monthlyCap: PIXABAY_MONTHLY_CAP,
+        });
+        if (!allowed) {
+            throw new Error(`PIXABAY_RATE_LIMITED: monthly cap of ${PIXABAY_MONTHLY_CAP} exceeded — back off`);
+        }
+        // Pixabay caps per_page at 200 and requires min 3.
+        const perPage = Math.max(3, Math.min(params.perPage ?? 15, 200));
+        const orientation = this.aspectToOrientation(params.aspectRatio);
+        try {
+            if (params.kind === "video") {
+                const { data } = await axios_1.default.get(PIXABAY_VIDEO_URL, {
+                    timeout: PIXABAY_TIMEOUT_MS,
+                    params: {
+                        key: this.apiKey,
+                        q: params.query,
+                        per_page: perPage,
+                        page: params.page ?? 1,
+                        // Pixabay video search has no orientation filter, but supports
+                        // `video_type=film` to filter out animations if needed. Leave
+                        // default.
+                        safesearch: true,
+                    },
+                });
+                const assets = data.hits.map((v) => {
+                    const file = this.pickBestVideoFile(v.videos);
+                    // Filter post-fetch by duration since Pixabay has no server filter.
+                    return {
+                        id: `pixabay-${v.id}`,
+                        url: file.url,
+                        thumbnailUrl: v.picture_id
+                            ? `https://i.vimeocdn.com/video/${v.picture_id}_295x166.jpg`
+                            : undefined,
+                        width: file.width,
+                        height: file.height,
+                        durationSec: v.duration,
+                        source: "pixabay",
+                        attribution: {
+                            name: v.user,
+                            url: `https://pixabay.com/users/${v.user_id}/`,
+                        },
+                    };
+                });
+                const filtered = assets.filter((a) => {
+                    if (params.minDurationSec && a.durationSec < params.minDurationSec)
+                        return false;
+                    if (params.maxDurationSec && a.durationSec > params.maxDurationSec)
+                        return false;
+                    return true;
+                });
+                return { assets: filtered, totalAvailable: data.totalHits };
+            }
+            // image
+            const { data } = await axios_1.default.get(PIXABAY_IMAGE_URL, {
+                timeout: PIXABAY_TIMEOUT_MS,
+                params: {
+                    key: this.apiKey,
+                    q: params.query,
+                    per_page: perPage,
+                    page: params.page ?? 1,
+                    orientation, // "all" | "horizontal" | "vertical"
+                    image_type: "photo",
+                    safesearch: true,
+                },
+            });
+            return {
+                assets: data.hits.map((p) => ({
+                    id: `pixabay-${p.id}`,
+                    url: p.largeImageURL,
+                    thumbnailUrl: p.webformatURL ?? p.previewURL,
+                    width: p.imageWidth,
+                    height: p.imageHeight,
+                    source: "pixabay",
+                    attribution: {
+                        name: p.user,
+                        url: `https://pixabay.com/users/${p.user_id}/`,
+                    },
+                })),
+                totalAvailable: data.totalHits,
+            };
+        }
+        catch (err) {
+            if (err?.response?.status === 429) {
+                throw new Error("PIXABAY_RATE_LIMITED: 429 from Pixabay API — back off");
+            }
+            if (err?.code === "ECONNABORTED" || /timeout/i.test(err?.message ?? "")) {
+                throw new Error(`PIXABAY_TIMEOUT: request timed out after ${PIXABAY_TIMEOUT_MS}ms`);
+            }
+            throw err;
+        }
+    }
+    /** Free assets — registers as 0 credits regardless of model. */
+    getCreditUsed(_params) {
+        return 0;
+    }
+    aspectToOrientation(aspect) {
+        if (!aspect)
+            return "all";
+        if (aspect === "9:16" || aspect === "4:5")
+            return "vertical";
+        if (aspect === "1:1")
+            return "all";
+        return "horizontal";
+    }
+    /** Prefer large → medium → small → tiny so we get the best quality available. */
+    pickBestVideoFile(videos) {
+        const file = videos.large ?? videos.medium ?? videos.small ?? videos.tiny;
+        if (!file)
+            throw new Error("Pixabay video has no playable files");
+        return file;
+    }
+}
+exports.PixabayProviderService = PixabayProviderService;

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

@@ -1 +1 @@
-{"version":3,"file":"pixverse.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pixverse/pixverse.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AASlB,qBAAa,eAAgB,SAAQ,wBAAwB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAKpE,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAqE3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmGjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CA+CjD"}
+{"version":3,"file":"pixverse.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/pixverse/pixverse.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AASlB,qBAAa,eAAgB,SAAQ,wBAAwB;IAC3D,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAkD;IAKpE,aAAa,CACjB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,qBAAqB,CAAC;IAsL3B,gBAAgB,CAAC,EACrB,IAAI,EACJ,cAAc,EACd,cAAyB,GAC1B,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAmGjD,aAAa,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM;CAkDjD"}