vidspotai-shared 1.0.69-dev.0 → 1.0.69

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

@@ -1,150 +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.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

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

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

@@ -1 +0,0 @@
-{"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

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

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

@@ -1,12 +0,0 @@
-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

@@ -1 +0,0 @@
-{"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

@@ -1,156 +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.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/runway/cameraAdapter.d.ts

@@ -1,3 +0,0 @@
-import type { CameraControl } from "../../canonicalAdapters/cameraControl.types";
-export declare function applyRunwayCameraControl(prompt: string | undefined, c: CameraControl): string;
-//# sourceMappingURL=cameraAdapter.d.ts.map

package/lib/services/aiGen/providers/runway/cameraAdapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cameraAdapter.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/runway/cameraAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EAEd,MAAM,6CAA6C,CAAC;AAmCrD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,CAAC,EAAE,aAAa,GACf,MAAM,CAMR"}

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

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.applyRunwayCameraControl = applyRunwayCameraControl;
-/**
- * Runway gen4 doesn't expose a structured camera-control field — moves are
- * inferred from prompt text. We translate the canonical preset/intensity into
- * a short bracketed clause prepended to the prompt. Matches Runway's own
- * cinematography vocabulary so the model parses it reliably.
- */
-const PRESET_TO_PHRASE = {
-    static: "static camera",
-    pan_left: "camera pans left",
-    pan_right: "camera pans right",
-    tilt_up: "camera tilts up",
-    tilt_down: "camera tilts down",
-    zoom_in: "camera zooms in",
-    zoom_out: "camera zooms out",
-    dolly_in: "camera dollies in",
-    dolly_out: "camera dollies out",
-    orbit_left: "camera orbits left around subject",
-    orbit_right: "camera orbits right around subject",
-    roll_left: "camera rolls counter-clockwise",
-    roll_right: "camera rolls clockwise",
-    tracking: "tracking shot following subject",
-    handheld: "handheld camera",
-    push_in: "slow push in",
-    pull_out: "slow pull out",
-};
-function intensityWord(i) {
-    if (i === undefined)
-        return "";
-    if (i <= 0.33)
-        return "subtle ";
-    if (i >= 0.67)
-        return "strong ";
-    return "";
-}
-function applyRunwayCameraControl(prompt, c) {
-    if (!c.preset)
-        return prompt ?? "";
-    const phrase = PRESET_TO_PHRASE[c.preset];
-    if (!phrase)
-        return prompt ?? "";
-    const clause = `[${intensityWord(c.intensity)}${phrase}]`;
-    return prompt ? `${clause} ${prompt}` : clause;
-}

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

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

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

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

package/lib/services/aiGen/providers/unsplash/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("./unsplash.service"), exports);

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

@@ -1,16 +0,0 @@
-import { BaseAiGenProviderService } from "../baseAiGenProvider.service";
-import { CreditUsageParams, StockSearchParams, StockSearchResult } from "../types";
-export declare class UnsplashProviderService extends BaseAiGenProviderService {
-    private readonly accessKey;
-    searchStock(params: StockSearchParams): Promise<StockSearchResult>;
-    /**
-     * Fire the Unsplash download-tracking endpoint. MUST be called once when
-     * an Unsplash photo is committed to a render (per their API guidelines).
-     * Errors swallowed — failure to ping doesn't break the user's render.
-     */
-    pingDownload(trackingUrl: string): Promise<void>;
-    /** Free assets — registers as 0 credits regardless of model. */
-    getCreditUsed(_params: CreditUsageParams): number;
-    private aspectToOrientation;
-}
-//# sourceMappingURL=unsplash.service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"unsplash.service.d.ts","sourceRoot":"","sources":["../../../../../src/services/aiGen/providers/unsplash/unsplash.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AACxE,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AA0DlB,qBAAa,uBAAwB,SAAQ,wBAAwB;IACnE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAuD;IAE3E,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA+DxE;;;;OAIG;IACG,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYtD,gEAAgE;IAChE,aAAa,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM;IAIjD,OAAO,CAAC,mBAAmB;CAQ5B"}

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

@@ -1,131 +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.UnsplashProviderService = void 0;
-const axios_1 = __importDefault(require("axios"));
-const apiUsageCounter_service_1 = require("../../../apiUsageCounter.service");
-const baseAiGenProvider_service_1 = require("../baseAiGenProvider.service");
-/**
- * Unsplash image-search provider (T0 — free).
- *
- * Photos-only. Pairs with Pexels for image queries; we race both and merge
- * results so the agent picks from a wider catalog. Video and music queries
- * delegate to other providers.
- *
- * Auth: `Authorization: Client-ID {access_key}` header (no OAuth needed for
- * read endpoints). Free dev tier: 50 req/h; 1000 req/h after production
- * approval (see https://unsplash.com/documentation#rate-limiting).
- *
- * Attribution: Unsplash guidelines require attributing the photographer and
- * Unsplash (e.g. "Photo by {name} on Unsplash") wherever the photo appears.
- * We surface `attribution.{name,url}` so the producer UI / finished video
- * watermark can render the credit.
- *
- * Download tracking: when an Unsplash photo is actually used in a render,
- * the API requires a fire-and-forget GET to `links.download_location`. We
- * pass that through as `StockAsset.trackingUrl`; callers fire it via
- * `pingDownload()` at scene-commit time.
- */
-const UNSPLASH_SEARCH_URL = "https://api.unsplash.com/search/photos";
-// 10s per-call cap so the agent executor stays responsive when Unsplash is
-// slow — the search_stock cascade can drop us cleanly.
-const UNSPLASH_TIMEOUT_MS = 10000;
-// Cap below 1000 req/h × 24h × 30d = ~720k theoretical max; the realistic
-// cap is the per-hour throttle. We set a conservative monthly upper bound
-// to surface runaway usage early. Override via env if needed.
-const UNSPLASH_MONTHLY_CAP = Number(process.env.UNSPLASH_MONTHLY_CAP ?? 50000);
-class UnsplashProviderService extends baseAiGenProvider_service_1.BaseAiGenProviderService {
-    constructor() {
-        super(...arguments);
-        this.accessKey = process.env.UNSPLASH_ACCESS_KEY;
-    }
-    async searchStock(params) {
-        if (!this.accessKey) {
-            throw new Error("UNSPLASH_ACCESS_KEY not set — unsplash provider cannot search");
-        }
-        if (params.kind !== "image") {
-            // Photos-only. Caller falls back to the appropriate provider.
-            return { assets: [] };
-        }
-        const allowed = await apiUsageCounter_service_1.ApiUsageCounterService.tryConsume({
-            provider: "unsplash",
-            monthlyCap: UNSPLASH_MONTHLY_CAP,
-        });
-        if (!allowed) {
-            throw new Error(`UNSPLASH_RATE_LIMITED: monthly cap of ${UNSPLASH_MONTHLY_CAP} exceeded — back off`);
-        }
-        const perPage = Math.min(params.perPage ?? 15, 30); // Unsplash caps at 30
-        try {
-            const { data } = await axios_1.default.get(UNSPLASH_SEARCH_URL, {
-                headers: { Authorization: `Client-ID ${this.accessKey}` },
-                timeout: UNSPLASH_TIMEOUT_MS,
-                params: {
-                    query: params.query,
-                    per_page: perPage,
-                    page: params.page ?? 1,
-                    orientation: this.aspectToOrientation(params.aspectRatio),
-                    color: params.color, // black_and_white, black, white, yellow, orange, red, purple, magenta, green, teal, blue
-                },
-            });
-            return {
-                assets: data.results.map((p) => ({
-                    id: `unsplash-${p.id}`,
-                    url: p.urls.regular,
-                    thumbnailUrl: p.urls.small,
-                    width: p.width,
-                    height: p.height,
-                    source: "unsplash",
-                    attribution: {
-                        name: p.user.name,
-                        url: p.user.links?.html,
-                    },
-                    trackingUrl: p.links.download_location,
-                })),
-                totalAvailable: data.total,
-            };
-        }
-        catch (err) {
-            if (err?.response?.status === 429) {
-                throw new Error("UNSPLASH_RATE_LIMITED: 429 from Unsplash API — back off");
-            }
-            if (err?.code === "ECONNABORTED" || /timeout/i.test(err?.message ?? "")) {
-                throw new Error(`UNSPLASH_TIMEOUT: request timed out after ${UNSPLASH_TIMEOUT_MS}ms`);
-            }
-            throw err;
-        }
-    }
-    /**
-     * Fire the Unsplash download-tracking endpoint. MUST be called once when
-     * an Unsplash photo is committed to a render (per their API guidelines).
-     * Errors swallowed — failure to ping doesn't break the user's render.
-     */
-    async pingDownload(trackingUrl) {
-        if (!this.accessKey || !trackingUrl)
-            return;
-        try {
-            await axios_1.default.get(trackingUrl, {
-                headers: { Authorization: `Client-ID ${this.accessKey}` },
-                timeout: 5000,
-            });
-        }
-        catch {
-            // Intentional — ToS-required best-effort signal, not a hard dependency.
-        }
-    }
-    /** 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 "squarish";
-        return "landscape";
-    }
-}
-exports.UnsplashProviderService = UnsplashProviderService;

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

@@ -1,20 +0,0 @@
-export interface ConsumeOptions {
-    /** Provider key, e.g. "pexels" or "jamendo". One doc per provider per month. */
-    provider: string;
-    /** Hard monthly cap. Below this the call is allowed. */
-    monthlyCap: number;
-    /** Optional: how many calls this consumes. Defaults to 1. */
-    count?: number;
-}
-export declare class ApiUsageCounterService {
-    /**
-     * Atomically increments the monthly counter for `provider` and returns
-     * whether the call is allowed (i.e. the *new* total is ≤ monthlyCap).
-     *
-     * Fails open on Firestore error — the call goes through and we log.
-     */
-    static tryConsume(opts: ConsumeOptions): Promise<boolean>;
-    /** Read-only — used by ops dashboards / soft-cap warnings. */
-    static getUsed(provider: string): Promise<number>;
-}
-//# sourceMappingURL=apiUsageCounter.service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"apiUsageCounter.service.d.ts","sourceRoot":"","sources":["../../src/services/apiUsageCounter.service.ts"],"names":[],"mappings":"AA+BA,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,sBAAsB;IACjC;;;;;OAKG;WACU,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IAiC/D,8DAA8D;WACjD,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAexD"}