vidspotai-shared 1.0.68 → 1.0.69-dev.0

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

@@ -1,3 +1,4 @@
 export * from "./gcp.service";
 export * from "./gsheet.service";
+export * from "./uploadAudioBuffer";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/gcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/gcp/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/lib/services/gcp/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./gcp.service"), exports);
 __exportStar(require("./gsheet.service"), exports);
+__exportStar(require("./uploadAudioBuffer"), exports);

package/lib/services/gcp/uploadAudioBuffer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Uploads an audio buffer to the project's Firebase Storage bucket and
+ * returns a public download URL. Used by the agent VO pipeline: ElevenLabs
+ * returns base64 inline and would blow Firestore's 1 MiB doc cap, so the
+ * worker flips base64 → URL before persisting projectJson.
+ *
+ * The download token follows the same `firebasestorageDownloadTokens`
+ * pattern as handleUploadFile so the resulting URL is publicly fetchable
+ * without a signed-URL refresh dance — matches how generated visual assets
+ * are exposed today.
+ */
+export declare function uploadAudioBufferToGcs(buffer: Buffer, destination: string, contentType?: string): Promise<string>;
+//# sourceMappingURL=uploadAudioBuffer.d.ts.map

package/lib/services/gcp/uploadAudioBuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadAudioBuffer.d.ts","sourceRoot":"","sources":["../../../src/services/gcp/uploadAudioBuffer.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAqB,GACjC,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/lib/services/gcp/uploadAudioBuffer.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.uploadAudioBufferToGcs = uploadAudioBufferToGcs;
+const node_crypto_1 = require("node:crypto");
+const firebase_1 = require("../../libs/firebase");
+/**
+ * Uploads an audio buffer to the project's Firebase Storage bucket and
+ * returns a public download URL. Used by the agent VO pipeline: ElevenLabs
+ * returns base64 inline and would blow Firestore's 1 MiB doc cap, so the
+ * worker flips base64 → URL before persisting projectJson.
+ *
+ * The download token follows the same `firebasestorageDownloadTokens`
+ * pattern as handleUploadFile so the resulting URL is publicly fetchable
+ * without a signed-URL refresh dance — matches how generated visual assets
+ * are exposed today.
+ */
+async function uploadAudioBufferToGcs(buffer, destination, contentType = "audio/mpeg") {
+    const bucket = (0, firebase_1.getBucket)();
+    const file = bucket.file(destination);
+    const downloadToken = (0, node_crypto_1.randomUUID)();
+    await file.save(buffer, {
+        metadata: {
+            contentType,
+            metadata: { firebaseStorageDownloadTokens: downloadToken },
+        },
+    });
+    return `https://firebasestorage.googleapis.com/v0/b/${bucket.name}/o/${encodeURIComponent(destination)}?alt=media&token=${downloadToken}`;
+}

package/lib/services/index.d.ts

@@ -1,9 +1,22 @@
 export * from "./redis.service";
+export * from "./redisOptions";
+export * from "./rateLimiter";
 export * from "./firestore.service";
 export * from "./aiGen";
 export * from "./bullmq.service";
 export * from "./gcp";
 export * from "./credit.service";
+export * from "./notification.service";
+export * from "./credits/pricing";
 export * from "./analytics.service";
 export * from "./tts";
+export * from "./musicGen";
+export * from "./audioAnalysis";
+export * from "./asr";
+export * from "./agent";
+export * from "./assetCache.service";
+export * from "./apiUsageCounter.service";
+export * from "./editor/designToProject";
+export * from "./editor/projectToDesign";
+export * from "./editor/planToProject";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,OAAO,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,OAAO,CAAC;AACtB,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,OAAO,CAAC;AACtB,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,wBAAwB,CAAC"}

package/lib/services/index.js

@@ -15,10 +15,23 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./redis.service"), exports);
+__exportStar(require("./redisOptions"), exports);
+__exportStar(require("./rateLimiter"), exports);
 __exportStar(require("./firestore.service"), exports);
 __exportStar(require("./aiGen"), exports);
 __exportStar(require("./bullmq.service"), exports);
 __exportStar(require("./gcp"), exports);
 __exportStar(require("./credit.service"), exports);
+__exportStar(require("./notification.service"), exports);
+__exportStar(require("./credits/pricing"), exports);
 __exportStar(require("./analytics.service"), exports);
 __exportStar(require("./tts"), exports);
+__exportStar(require("./musicGen"), exports);
+__exportStar(require("./audioAnalysis"), exports);
+__exportStar(require("./asr"), exports);
+__exportStar(require("./agent"), exports);
+__exportStar(require("./assetCache.service"), exports);
+__exportStar(require("./apiUsageCounter.service"), exports);
+__exportStar(require("./editor/designToProject"), exports);
+__exportStar(require("./editor/projectToDesign"), exports);
+__exportStar(require("./editor/planToProject"), exports);

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

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./musicSearchFactory.service";
+export { CURATED_CATALOG, CuratedMusicProvider } from "./providers/curated.service";
+export { JamendoMusicProvider } from "./providers/jamendo.service";
+export { MubertMusicProvider } from "./providers/mubert.service";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/musicGen/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,8BAA8B,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC"}

package/lib/services/musicGen/index.js

@@ -0,0 +1,26 @@
+"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 });
+exports.MubertMusicProvider = exports.JamendoMusicProvider = exports.CuratedMusicProvider = exports.CURATED_CATALOG = void 0;
+__exportStar(require("./types"), exports);
+__exportStar(require("./musicSearchFactory.service"), exports);
+var curated_service_1 = require("./providers/curated.service");
+Object.defineProperty(exports, "CURATED_CATALOG", { enumerable: true, get: function () { return curated_service_1.CURATED_CATALOG; } });
+Object.defineProperty(exports, "CuratedMusicProvider", { enumerable: true, get: function () { return curated_service_1.CuratedMusicProvider; } });
+var jamendo_service_1 = require("./providers/jamendo.service");
+Object.defineProperty(exports, "JamendoMusicProvider", { enumerable: true, get: function () { return jamendo_service_1.JamendoMusicProvider; } });
+var mubert_service_1 = require("./providers/mubert.service");
+Object.defineProperty(exports, "MubertMusicProvider", { enumerable: true, get: function () { return mubert_service_1.MubertMusicProvider; } });

package/lib/services/musicGen/musicSearchFactory.service.d.ts

@@ -0,0 +1,14 @@
+import { MusicSearchParams, MusicSearchProvider, MusicSearchResult, MusicSource } from "./types";
+export declare function getMusicSearchProvider(source: MusicSource): MusicSearchProvider;
+export declare function listAvailableMusicSources(): MusicSource[];
+/**
+ * Walk providers in priority order; stop at the first one that returns a
+ * track. Skips providers that aren't configured. Caller chooses one of the
+ * tracks — usually the first.
+ */
+export declare function searchAllMusicSources(params: MusicSearchParams, opts?: {
+    preferred?: MusicSource;
+}): Promise<MusicSearchResult & {
+    sourceUsed?: MusicSource;
+}>;
+//# sourceMappingURL=musicSearchFactory.service.d.ts.map

package/lib/services/musicGen/musicSearchFactory.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"musicSearchFactory.service.d.ts","sourceRoot":"","sources":["../../../src/services/musicGen/musicSearchFactory.service.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,WAAW,EACZ,MAAM,SAAS,CAAC;AA4BjB,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,WAAW,GAAG,mBAAmB,CAI/E;AAED,wBAAgB,yBAAyB,IAAI,WAAW,EAAE,CAEzD;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,iBAAiB,EACzB,IAAI,GAAE;IAAE,SAAS,CAAC,EAAE,WAAW,CAAA;CAAO,GACrC,OAAO,CAAC,iBAAiB,GAAG;IAAE,UAAU,CAAC,EAAE,WAAW,CAAA;CAAE,CAAC,CAY3D"}

package/lib/services/musicGen/musicSearchFactory.service.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMusicSearchProvider = getMusicSearchProvider;
+exports.listAvailableMusicSources = listAvailableMusicSources;
+exports.searchAllMusicSources = searchAllMusicSources;
+const curated_service_1 = require("./providers/curated.service");
+const jamendo_service_1 = require("./providers/jamendo.service");
+const mubert_service_1 = require("./providers/mubert.service");
+/**
+ * Factory + multi-source dispatcher for music search.
+ *
+ * Resolution rules:
+ *   - When a specific source is requested, return its provider (even if not
+ *     available — caller can branch on isAvailable() for clearer errors).
+ *   - `searchAll(params)` walks the priority list (curated → jamendo → mubert)
+ *     and returns the first non-empty result. Curated is always first because
+ *     it ships zero-latency, zero-cost; Mubert is last because it generates
+ *     and bills per call.
+ */
+const PRIORITY = ["curated", "jamendo", "mubert"];
+let providerCache;
+function providers() {
+    if (providerCache)
+        return providerCache;
+    providerCache = new Map([
+        ["curated", new curated_service_1.CuratedMusicProvider()],
+        ["jamendo", new jamendo_service_1.JamendoMusicProvider()],
+        ["mubert", new mubert_service_1.MubertMusicProvider()],
+    ]);
+    return providerCache;
+}
+function getMusicSearchProvider(source) {
+    const p = providers().get(source);
+    if (!p)
+        throw new Error(`Unknown music source: ${source}`);
+    return p;
+}
+function listAvailableMusicSources() {
+    return PRIORITY.filter((s) => providers().get(s)?.isAvailable());
+}
+/**
+ * Walk providers in priority order; stop at the first one that returns a
+ * track. Skips providers that aren't configured. Caller chooses one of the
+ * tracks — usually the first.
+ */
+async function searchAllMusicSources(params, opts = {}) {
+    const order = opts.preferred
+        ? [opts.preferred, ...PRIORITY.filter((s) => s !== opts.preferred)]
+        : PRIORITY;
+    for (const source of order) {
+        const provider = providers().get(source);
+        if (!provider?.isAvailable())
+            continue;
+        const result = await provider.search(params);
+        if (result.tracks.length)
+            return { ...result, sourceUsed: source };
+    }
+    return { tracks: [] };
+}

package/lib/services/musicGen/providers/curated.service.d.ts

@@ -0,0 +1,24 @@
+import { MusicSearchParams, MusicSearchProvider, MusicSearchResult, MusicTrack } from "../types";
+/**
+ * Curated music catalog — always-on, zero-config.
+ *
+ * Tracks are sourced from Pixabay's free music library (Pixabay Content
+ * License: free for commercial use, no attribution required). URLs point
+ * at cdn.pixabay.com directly to avoid us hosting / paying egress.
+ * AG-36 (2026-05-17): previously pointed at a never-created GCS bucket
+ * (vidspot-public-music) so every selection 404'd; replaced with verified
+ * pixabay CDN URLs scraped via scrapePixabayMusic.py.
+ *
+ * If the CDN proves unreliable later, mirror these to our own bucket via
+ * the same script + a gsutil cp pass; the catalog shape doesn't change.
+ *
+ * BPM values are approximate (eyeballed from the Pixabay listing's
+ * tempo band). Refine when AG-39 onset-detection picks them up.
+ */
+export declare const CURATED_CATALOG: MusicTrack[];
+export declare class CuratedMusicProvider implements MusicSearchProvider {
+    readonly source: "curated";
+    isAvailable(): boolean;
+    search(params: MusicSearchParams): Promise<MusicSearchResult>;
+}
+//# sourceMappingURL=curated.service.d.ts.map

package/lib/services/musicGen/providers/curated.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curated.service.d.ts","sourceRoot":"","sources":["../../../../src/services/musicGen/providers/curated.service.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACX,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;GAeG;AAEH,eAAO,MAAM,eAAe,EAAE,UAAU,EAiFvC,CAAC;AAsDF,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,QAAQ,CAAC,MAAM,EAAG,SAAS,CAAU;IACrC,WAAW,IAAI,OAAO;IAIhB,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAUpE"}

package/lib/services/musicGen/providers/curated.service.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CuratedMusicProvider = exports.CURATED_CATALOG = void 0;
+/**
+ * Curated music catalog — always-on, zero-config.
+ *
+ * Tracks are sourced from Pixabay's free music library (Pixabay Content
+ * License: free for commercial use, no attribution required). URLs point
+ * at cdn.pixabay.com directly to avoid us hosting / paying egress.
+ * AG-36 (2026-05-17): previously pointed at a never-created GCS bucket
+ * (vidspot-public-music) so every selection 404'd; replaced with verified
+ * pixabay CDN URLs scraped via scrapePixabayMusic.py.
+ *
+ * If the CDN proves unreliable later, mirror these to our own bucket via
+ * the same script + a gsutil cp pass; the catalog shape doesn't change.
+ *
+ * BPM values are approximate (eyeballed from the Pixabay listing's
+ * tempo band). Refine when AG-39 onset-detection picks them up.
+ */
+exports.CURATED_CATALOG = [
+    {
+        id: "curated-energetic-120",
+        url: "https://cdn.pixabay.com/audio/2026/04/23/audio_8593d985e3.mp3",
+        durationSec: 100,
+        bpm: 120,
+        mood: "energetic",
+        tags: ["pop", "upbeat", "social-recap", "ugc-ad"],
+        attribution: "Pixabay (Pixabay Content License)",
+        source: "curated",
+    },
+    {
+        id: "curated-energetic-128",
+        url: "https://cdn.pixabay.com/audio/2026/04/23/audio_044dad33c3.mp3",
+        durationSec: 117,
+        bpm: 128,
+        mood: "energetic",
+        tags: ["edm", "drop", "social-recap"],
+        attribution: "Pixabay (Pixabay Content License)",
+        source: "curated",
+    },
+    {
+        id: "curated-uplifting-110",
+        url: "https://cdn.pixabay.com/audio/2026/04/23/audio_50f1e7f615.mp3",
+        durationSec: 218,
+        bpm: 110,
+        mood: "uplifting",
+        tags: ["corporate", "ugc-ad", "product-demo"],
+        attribution: "Pixabay (Pixabay Content License)",
+        source: "curated",
+    },
+    {
+        id: "curated-cinematic-90",
+        url: "https://cdn.pixabay.com/audio/2026/04/24/audio_0ea6bfb236.mp3",
+        durationSec: 236,
+        bpm: 90,
+        mood: "cinematic",
+        tags: ["orchestral", "trailer", "talking-head"],
+        attribution: "Pixabay (Pixabay Content License)",
+        source: "curated",
+    },
+    {
+        id: "curated-calm-80",
+        url: "https://cdn.pixabay.com/audio/2026/04/24/audio_f485b72a9c.mp3",
+        durationSec: 169,
+        bpm: 80,
+        mood: "calm",
+        tags: ["piano", "ambient", "talking-head"],
+        attribution: "Pixabay (Pixabay Content License)",
+        source: "curated",
+    },
+    {
+        id: "curated-dark-100",
+        url: "https://cdn.pixabay.com/audio/2026/05/07/audio_e11ff00f80.mp3",
+        durationSec: 141,
+        bpm: 100,
+        mood: "dark",
+        tags: ["trap", "moody", "social-recap"],
+        attribution: "Pixabay (Pixabay Content License)",
+        source: "curated",
+    },
+    {
+        id: "curated-acoustic-95",
+        url: "https://cdn.pixabay.com/audio/2026/04/24/audio_be8fac0c2b.mp3",
+        durationSec: 187,
+        bpm: 95,
+        mood: "acoustic",
+        tags: ["folk", "guitar", "ugc-ad"],
+        attribution: "Pixabay (Pixabay Content License)",
+        source: "curated",
+    },
+    {
+        id: "curated-retro-115",
+        url: "https://cdn.pixabay.com/audio/2026/04/22/audio_1364f85847.mp3",
+        durationSec: 108,
+        bpm: 115,
+        mood: "retro",
+        tags: ["synthwave", "80s", "product-demo"],
+        attribution: "Pixabay (Pixabay Content License)",
+        source: "curated",
+    },
+];
+const MOOD_ALIASES = {
+    energetic: "energetic",
+    upbeat: "energetic",
+    hype: "energetic",
+    cinematic: "cinematic",
+    epic: "cinematic",
+    dramatic: "cinematic",
+    calm: "calm",
+    chill: "calm",
+    ambient: "calm",
+    uplifting: "uplifting",
+    inspirational: "uplifting",
+    dark: "dark",
+    moody: "dark",
+    acoustic: "acoustic",
+    folk: "acoustic",
+    retro: "retro",
+    vintage: "retro",
+    quirky: "retro",
+};
+function tokens(s) {
+    if (!s)
+        return [];
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]+/g, " ")
+        .split(/\s+/)
+        .filter((t) => t.length >= 2);
+}
+function score(track, params) {
+    let s = 0;
+    const wantedMood = params.mood ? MOOD_ALIASES[params.mood.toLowerCase()] : undefined;
+    if (wantedMood && track.mood === wantedMood)
+        s += 50;
+    const queryToks = tokens(params.query);
+    if (queryToks.length) {
+        const hay = [track.mood, ...(track.tags ?? [])].join(" ").toLowerCase();
+        for (const t of queryToks)
+            if (hay.includes(t))
+                s += 5;
+    }
+    if (params.bpmTarget && track.bpm) {
+        const diff = Math.abs(track.bpm - params.bpmTarget);
+        s += Math.max(0, 30 - diff); // perfect match = 30, ±30bpm = 0
+    }
+    if (params.bpmMin && track.bpm && track.bpm < params.bpmMin)
+        s -= 20;
+    if (params.bpmMax && track.bpm && track.bpm > params.bpmMax)
+        s -= 20;
+    if (params.durationSecMin && track.durationSec < params.durationSecMin)
+        s -= 100;
+    return s;
+}
+class CuratedMusicProvider {
+    constructor() {
+        this.source = "curated";
+    }
+    isAvailable() {
+        return exports.CURATED_CATALOG.length > 0;
+    }
+    async search(params) {
+        const limit = params.limit ?? 5;
+        const ranked = exports.CURATED_CATALOG
+            .map((t) => ({ t, s: score(t, params) }))
+            .filter((r) => r.s > -50)
+            .sort((a, b) => b.s - a.s)
+            .slice(0, limit)
+            .map(({ t }) => t);
+        return { tracks: ranked };
+    }
+}
+exports.CuratedMusicProvider = CuratedMusicProvider;

package/lib/services/musicGen/providers/jamendo.service.d.ts

@@ -0,0 +1,8 @@
+import { MusicSearchParams, MusicSearchProvider, MusicSearchResult } from "../types";
+export declare class JamendoMusicProvider implements MusicSearchProvider {
+    readonly source: "jamendo";
+    private readonly clientId;
+    isAvailable(): boolean;
+    search(params: MusicSearchParams): Promise<MusicSearchResult>;
+}
+//# sourceMappingURL=jamendo.service.d.ts.map

package/lib/services/musicGen/providers/jamendo.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jamendo.service.d.ts","sourceRoot":"","sources":["../../../../src/services/musicGen/providers/jamendo.service.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAElB,MAAM,UAAU,CAAC;AAiDlB,qBAAa,oBAAqB,YAAW,mBAAmB;IAC9D,QAAQ,CAAC,MAAM,EAAG,SAAS,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAE1D,WAAW,IAAI,OAAO;IAIhB,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;CA8DpE"}

package/lib/services/musicGen/providers/jamendo.service.js

@@ -0,0 +1,113 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JamendoMusicProvider = void 0;
+const axios_1 = __importDefault(require("axios"));
+const apiUsageCounter_service_1 = require("../../apiUsageCounter.service");
+// Jamendo free tier: 35,000 req/month per client_id. Cap at 30,000 to leave
+// headroom; override via env.
+const JAMENDO_MONTHLY_CAP = Number(process.env.JAMENDO_MONTHLY_CAP ?? 30000);
+/**
+ * Jamendo Music API v3.
+ *
+ * Free for app integration via client_id; per-track commercial use requires
+ * a Pro license purchased through Jamendo Licensing. We surface tracks here
+ * but the host UI must show the license CTA before a user ships a video that
+ * uses the track. Track BPM comes back via `musicinfo.bpm` when we request
+ * `include=musicinfo`.
+ *
+ * Env: JAMENDO_CLIENT_ID — provider is unavailable until set.
+ */
+const JAMENDO_TRACKS_URL = "https://api.jamendo.com/v3.0/tracks";
+const MOOD_TO_TAGS = {
+    energetic: "energetic+upbeat",
+    cinematic: "epic+orchestral",
+    calm: "calm+ambient",
+    uplifting: "uplifting+inspirational",
+    dark: "dark+moody",
+    acoustic: "acoustic+folk",
+    retro: "retro+synthwave",
+    quirky: "quirky+playful",
+};
+class JamendoMusicProvider {
+    constructor() {
+        this.source = "jamendo";
+        this.clientId = process.env.JAMENDO_CLIENT_ID;
+    }
+    isAvailable() {
+        return Boolean(this.clientId);
+    }
+    async search(params) {
+        if (!this.clientId)
+            return { tracks: [] };
+        const allowed = await apiUsageCounter_service_1.ApiUsageCounterService.tryConsume({
+            provider: "jamendo",
+            monthlyCap: JAMENDO_MONTHLY_CAP,
+        });
+        if (!allowed) {
+            throw new Error(`JAMENDO_RATE_LIMITED: monthly cap of ${JAMENDO_MONTHLY_CAP} exceeded — back off`);
+        }
+        const tags = params.mood ? MOOD_TO_TAGS[params.mood.toLowerCase()] : undefined;
+        const search = params.query?.trim();
+        // Pick a single `speed` bucket: prefer explicit bpmTarget, then bpmMin/Max midpoint.
+        const speedSeed = params.bpmTarget
+            ?? (params.bpmMin && params.bpmMax ? (params.bpmMin + params.bpmMax) / 2 : params.bpmMin);
+        // Jamendo server-side `durationbetween=min_max` (seconds). Send both bounds
+        // when we have them so the page budget isn't wasted on out-of-range tracks.
+        const durationBetween = params.durationSecMin || params.durationSecMax
+            ? `${params.durationSecMin ?? 0}_${params.durationSecMax ?? 3600}`
+            : undefined;
+        const res = await axios_1.default.get(JAMENDO_TRACKS_URL, {
+            params: {
+                client_id: this.clientId,
+                format: "json",
+                limit: Math.min(params.limit ?? 10, 20),
+                include: "musicinfo",
+                // Jamendo prefers `tags` for mood and `search` for free-text.
+                ...(tags ? { tags } : {}),
+                ...(search ? { search } : {}),
+                ...(speedSeed ? { speed: bpmToSpeed(speedSeed) } : {}),
+                ...(durationBetween ? { durationbetween: durationBetween } : {}),
+                ...(params.vocalInstrumental ? { vocalinstrumental: params.vocalInstrumental } : {}),
+                audioformat: "mp32",
+            },
+            timeout: 8000,
+        });
+        const tracks = res.data.results
+            .filter((t) => !!t.audio)
+            .map((t) => ({
+            id: `jamendo-${t.id}`,
+            url: t.audio,
+            durationSec: t.duration,
+            bpm: t.musicinfo?.bpm,
+            mood: params.mood,
+            tags: t.musicinfo?.tags?.vartags,
+            attribution: `${t.name} — ${t.artist_name} (Jamendo)`,
+            source: "jamendo",
+        }));
+        if (params.bpmTarget) {
+            tracks.sort((a, b) => bpmDistance(a, params.bpmTarget) - bpmDistance(b, params.bpmTarget));
+        }
+        return { tracks };
+    }
+}
+exports.JamendoMusicProvider = JamendoMusicProvider;
+function bpmDistance(t, target) {
+    if (!t.bpm)
+        return 999;
+    return Math.abs(t.bpm - target);
+}
+// Jamendo's `speed` param is a coarse 5-bucket bin; map BPM ranges to it.
+function bpmToSpeed(bpm) {
+    if (bpm < 70)
+        return "verylow";
+    if (bpm < 95)
+        return "low";
+    if (bpm < 120)
+        return "medium";
+    if (bpm < 145)
+        return "high";
+    return "veryhigh";
+}

package/lib/services/musicGen/providers/mubert.service.d.ts

@@ -0,0 +1,10 @@
+import { MusicSearchParams, MusicSearchProvider, MusicSearchResult } from "../types";
+export declare class MubertMusicProvider implements MusicSearchProvider {
+    readonly source: "mubert";
+    private readonly customerId;
+    private readonly accessToken;
+    isAvailable(): boolean;
+    search(params: MusicSearchParams): Promise<MusicSearchResult>;
+    private pollTrackUrl;
+}
+//# sourceMappingURL=mubert.service.d.ts.map

package/lib/services/musicGen/providers/mubert.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mubert.service.d.ts","sourceRoot":"","sources":["../../../../src/services/musicGen/providers/mubert.service.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,UAAU,CAAC;AAuDlB,qBAAa,mBAAoB,YAAW,mBAAmB;IAC7D,QAAQ,CAAC,MAAM,EAAG,QAAQ,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkC;IAC7D,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmC;IAE/D,WAAW,IAAI,OAAO;IAIhB,MAAM,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;YA0DrD,YAAY;CAyB3B"}