vidspotai-shared 1.0.69-dev.0 → 1.0.69

package/lib/services/apiUsageCounter.service.js

@@ -1,84 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ApiUsageCounterService = void 0;
-const firebase_1 = require("../libs/firebase");
-const logger_1 = require("../utils/logger");
-/**
- * Cheap monthly-call counter for free-tier external APIs (Pexels, Jamendo,
- * Mubert, etc.). Lives at `apiUsage/{provider}-{YYYY-MM}` — one doc per
- * provider per month — so a single transactional increment per call is the
- * hottest write the system needs. Reset cost is zero (new month = new doc).
- *
- * `tryConsume()` is fail-open: any Firestore error returns `true` so a
- * transient outage doesn't take down provider calls. Wrong direction on
- * over-spend is preferable to false outages on these free tiers.
- *
- * Wired into providers right before their external HTTP call. The provider
- * is responsible for throwing a `*_RATE_LIMITED` error so upstream can swap
- * to a fallback provider.
- */
-const COLLECTION = "apiUsage";
-function currentMonthKey() {
-    const d = new Date();
-    const y = d.getUTCFullYear();
-    const m = String(d.getUTCMonth() + 1).padStart(2, "0");
-    return `${y}-${m}`;
-}
-function docId(provider) {
-    return `${provider}-${currentMonthKey()}`;
-}
-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 async tryConsume(opts) {
-        const ref = firebase_1.firestore.collection(COLLECTION).doc(docId(opts.provider));
-        const count = opts.count ?? 1;
-        try {
-            const allowed = await firebase_1.firestore.runTransaction(async (tx) => {
-                const snap = await tx.get(ref);
-                const used = (snap.data()?.used ?? 0) + count;
-                if (used > opts.monthlyCap) {
-                    // Don't write — leave the counter as-is so the next reset is clean.
-                    return false;
-                }
-                tx.set(ref, {
-                    used: firebase_1.FieldValue.increment(count),
-                    cap: opts.monthlyCap,
-                    updatedAt: firebase_1.FieldValue.serverTimestamp(),
-                }, { merge: true });
-                return true;
-            });
-            return allowed;
-        }
-        catch (err) {
-            // Fail open: prefer over-spend to false outages on free tiers.
-            logger_1.logger.error("apiUsageCounter: tryConsume fail-open", {
-                provider: opts.provider,
-                err: err instanceof Error ? err.stack ?? err.message : String(err),
-            });
-            return true;
-        }
-    }
-    /** Read-only — used by ops dashboards / soft-cap warnings. */
-    static async getUsed(provider) {
-        try {
-            const snap = await firebase_1.firestore
-                .collection(COLLECTION)
-                .doc(docId(provider))
-                .get();
-            return snap.data()?.used ?? 0;
-        }
-        catch (err) {
-            logger_1.logger.error("apiUsageCounter: getUsed failed", {
-                provider,
-                err: err instanceof Error ? err.stack ?? err.message : String(err),
-            });
-            return 0;
-        }
-    }
-}
-exports.ApiUsageCounterService = ApiUsageCounterService;

package/lib/services/asr/assemblyai.service.d.ts

@@ -1,72 +0,0 @@
-/**
- * AssemblyAI ASR client. Supports submit + poll-to-completion (sync caller flow).
- *
- * Pricing: Universal-2 model is $0.15/hr (verified 2026-05-11 against
- * https://www.assemblyai.com/pricing). Diarization (`speaker_labels`) adds
- * ~$0.02/hr (≈ +13%). Long audio (>3 min) should go through the BullMQ async
- * path; the inline poll here is bounded at 3 min to stay inside Firebase
- * Functions HTTP timeout budgets.
- */
-export interface TranscribeParams {
-    audioUrl: string;
-    /** Hint to AssemblyAI for language autodetect short-circuit (e.g. "en", "es"). */
-    languageCode?: string;
-    /** Diarization (speaker labels). Adds ~30% latency. */
-    speakerLabels?: boolean;
-    /** Auto-redact PII (SSN, credit cards, etc.). */
-    redactPii?: boolean;
-    /** Word-level timestamps in result. */
-    wordTimestamps?: boolean;
-}
-export interface TranscribeResult {
-    id: string;
-    status: "completed" | "queued" | "processing" | "error";
-    text?: string;
-    /** Audio duration in seconds; populated on completion. */
-    audioDuration?: number;
-    /** Per-word timestamps (start/end ms). */
-    words?: Array<{
-        text: string;
-        start: number;
-        end: number;
-        confidence: number;
-        speaker?: string;
-    }>;
-    /** Per-utterance segments when speakerLabels=true. */
-    utterances?: Array<{
-        text: string;
-        start: number;
-        end: number;
-        speaker: string;
-        confidence: number;
-    }>;
-    errorMessage?: string;
-}
-export declare class AssemblyAIService {
-    private readonly baseUrl;
-    private readonly apiKey;
-    constructor();
-    private request;
-    /** Submit a transcription job. Returns the transcript id immediately. */
-    submit(params: TranscribeParams): Promise<{
-        id: string;
-    }>;
-    checkStatus(id: string): Promise<TranscribeResult>;
-    /**
-     * Submit and poll inline until completion. Use for short-to-medium audio.
-     * Bounded at `timeoutMs` (default 3 min) — caller should fall back to async
-     * BullMQ flow for longer audio.
-     */
-    transcribe(params: TranscribeParams, { timeoutMs, intervalMs }?: {
-        timeoutMs?: number;
-        intervalMs?: number;
-    }): Promise<TranscribeResult>;
-    /**
-     * Credit cost for transcription. Universal-2 = $0.15/hr; diarization
-     * (speakerLabels) adds $0.02/hr (≈ +13%). Routes through the same
-     * `getCreditsFromCost` helper as every other endpoint so the credit ↔ USD
-     * ratio (1 credit = $0.10) and the per-call floor stay consistent.
-     */
-    getCreditUsed(audioDurationSec: number, speakerLabels?: boolean): number;
-}
-//# sourceMappingURL=assemblyai.service.d.ts.map

package/lib/services/asr/assemblyai.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"assemblyai.service.d.ts","sourceRoot":"","sources":["../../../src/services/asr/assemblyai.service.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,iDAAiD;IACjD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uCAAuC;IACvC,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,CAAC;IACxD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0DAA0D;IAC1D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,KAAK,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAClG,sDAAsD;IACtD,UAAU,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtG,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;IAC3D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;YASlB,OAAO;IAyBrB,yEAAyE;IACnE,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAWzD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAaxD;;;;OAIG;IACG,UAAU,CACd,MAAM,EAAE,gBAAgB,EACxB,EAAE,SAAmB,EAAE,UAAiB,EAAE,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO,GAC3F,OAAO,CAAC,gBAAgB,CAAC;IAc5B;;;;;OAKG;IACH,aAAa,CAAC,gBAAgB,EAAE,MAAM,EAAE,aAAa,UAAQ,GAAG,MAAM;CAMvE"}

package/lib/services/asr/assemblyai.service.js

@@ -1,89 +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.AssemblyAIService = void 0;
-const axios_1 = __importDefault(require("axios"));
-const logger_1 = require("../../utils/logger");
-const helpers_1 = require("../../utils/helpers");
-class AssemblyAIService {
-    constructor() {
-        this.baseUrl = "https://api.assemblyai.com/v2";
-        if (!process.env.ASSEMBLYAI_API_KEY) {
-            throw new Error("Missing ASSEMBLYAI_API_KEY in environment variables");
-        }
-        this.apiKey = process.env.ASSEMBLYAI_API_KEY;
-    }
-    async request(endpoint, method, body) {
-        const config = {
-            method,
-            url: `${this.baseUrl}${endpoint}`,
-            headers: {
-                Authorization: this.apiKey,
-                "Content-Type": "application/json",
-            },
-            data: body,
-            timeout: 60000,
-            validateStatus: () => true,
-        };
-        const resp = await axios_1.default.request(config);
-        if (resp.status < 200 || resp.status >= 300) {
-            throw new Error(`AssemblyAI API Error: ${resp.status} ${resp.statusText} — ${JSON.stringify(resp.data)}`);
-        }
-        return resp.data;
-    }
-    /** Submit a transcription job. Returns the transcript id immediately. */
-    async submit(params) {
-        const body = {
-            audio_url: params.audioUrl,
-            ...(params.languageCode ? { language_code: params.languageCode } : { language_detection: true }),
-            ...(params.speakerLabels ? { speaker_labels: true } : {}),
-            ...(params.redactPii ? { redact_pii: true, redact_pii_policies: ["us_social_security_number", "credit_card_number", "email_address", "phone_number"] } : {}),
-        };
-        const resp = await this.request("/transcript", "POST", body);
-        return { id: resp.id };
-    }
-    async checkStatus(id) {
-        const resp = await this.request(`/transcript/${id}`, "GET");
-        return {
-            id: resp.id,
-            status: resp.status,
-            text: resp.text,
-            audioDuration: resp.audio_duration,
-            words: resp.words,
-            utterances: resp.utterances,
-            errorMessage: resp.error,
-        };
-    }
-    /**
-     * Submit and poll inline until completion. Use for short-to-medium audio.
-     * Bounded at `timeoutMs` (default 3 min) — caller should fall back to async
-     * BullMQ flow for longer audio.
-     */
-    async transcribe(params, { timeoutMs = 180000, intervalMs = 3000 } = {}) {
-        const { id } = await this.submit(params);
-        const deadline = Date.now() + timeoutMs;
-        while (Date.now() < deadline) {
-            await new Promise((r) => setTimeout(r, intervalMs));
-            const status = await this.checkStatus(id);
-            if (status.status === "completed" || status.status === "error")
-                return status;
-        }
-        logger_1.logger.warn("AssemblyAI transcribe timed out — returning processing status", { id });
-        return { id, status: "processing", errorMessage: "Transcription exceeded inline poll budget; use checkStatus(id) to fetch later." };
-    }
-    /**
-     * Credit cost for transcription. Universal-2 = $0.15/hr; diarization
-     * (speakerLabels) adds $0.02/hr (≈ +13%). Routes through the same
-     * `getCreditsFromCost` helper as every other endpoint so the credit ↔ USD
-     * ratio (1 credit = $0.10) and the per-call floor stay consistent.
-     */
-    getCreditUsed(audioDurationSec, speakerLabels = false) {
-        const ratePerSecond = 0.15 / 3600;
-        const multiplier = speakerLabels ? 1.133 : 1.0;
-        const cost = ratePerSecond * audioDurationSec * multiplier;
-        return (0, helpers_1.getCreditsFromCost)(cost);
-    }
-}
-exports.AssemblyAIService = AssemblyAIService;

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

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

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

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

package/lib/services/asr/index.js

@@ -1,18 +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("./assemblyai.service"), exports);
-__exportStar(require("./whisper.service"), exports);

package/lib/services/asr/whisper.service.d.ts

@@ -1,18 +0,0 @@
-import type { TranscribeParams, TranscribeResult } from "./assemblyai.service";
-export declare class WhisperAsrService {
-    private readonly client;
-    constructor();
-    /**
-     * Transcribe a remote audio URL. Whisper has no URL-submission endpoint
-     * (unlike AssemblyAI), so we fetch the bytes into memory first. Subject
-     * to the 25 MB hard limit — long media should stay on the primary path.
-     */
-    transcribe(params: TranscribeParams): Promise<TranscribeResult>;
-    /**
-     * Credit cost for Whisper. $0.006/min — routes through the shared
-     * credit helper to keep the credit↔USD ratio consistent with every
-     * other endpoint.
-     */
-    getCreditUsed(audioDurationSec: number): number;
-}
-//# sourceMappingURL=whisper.service.d.ts.map

package/lib/services/asr/whisper.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"whisper.service.d.ts","sourceRoot":"","sources":["../../../src/services/asr/whisper.service.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AA2B/E,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;;IAShC;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAwDrE;;;;OAIG;IACH,aAAa,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM;CAIhD"}

package/lib/services/asr/whisper.service.js

@@ -1,151 +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 __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;
-    };
-})();
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.WhisperAsrService = void 0;
-const axios_1 = __importDefault(require("axios"));
-const openai_1 = __importStar(require("openai"));
-const logger_1 = require("../../utils/logger");
-const helpers_1 = require("../../utils/helpers");
-/**
- * OpenAI Whisper (`whisper-1`) fallback ASR provider.
- *
- * Why this is the fallback rather than the primary:
- *   - More expensive per minute than AssemblyAI ($0.006/min vs $0.0025/min).
- *   - No native diarization (`speaker_labels`) — caller will get an empty
- *     `utterances` array when requested. We still log it so the agent can
- *     decide to drop diarized features rather than silently mis-render.
- *   - 25 MB file upload limit per request — long-form audio MUST go through
- *     AssemblyAI's URL submission path.
- *
- * Why it earns the fallback slot:
- *   - Zero new infra: reuses the OPENAI_API_KEY already wired for text-gen.
- *   - Single synchronous call (no polling) → easier failure semantics.
- *   - Word-level timestamps via `response_format: verbose_json` +
- *     `timestamp_granularities: ["word"]`.
- *   - Strong multilingual coverage out of the box.
- *
- * Pricing (verified 2026-05-16 against https://openai.com/api/pricing):
- *   whisper-1 = $0.006/min ≈ $0.36/hr (≈ 2.4× AssemblyAI Universal-2).
- */
-const WHISPER_MAX_BYTES = 25 * 1024 * 1024;
-const DOWNLOAD_TIMEOUT_MS = 60000;
-class WhisperAsrService {
-    constructor() {
-        if (!process.env.OPENAI_API_KEY) {
-            throw new Error("Missing OPENAI_API_KEY in environment variables — Whisper ASR unavailable");
-        }
-        this.client = new openai_1.default({ apiKey: process.env.OPENAI_API_KEY });
-    }
-    /**
-     * Transcribe a remote audio URL. Whisper has no URL-submission endpoint
-     * (unlike AssemblyAI), so we fetch the bytes into memory first. Subject
-     * to the 25 MB hard limit — long media should stay on the primary path.
-     */
-    async transcribe(params) {
-        if (params.speakerLabels) {
-            logger_1.logger.warn("Whisper fallback requested with speakerLabels=true — diarization not supported, returning text only");
-        }
-        if (params.redactPii) {
-            logger_1.logger.warn("Whisper fallback requested with redactPii=true — Whisper has no native PII redaction, returning unredacted transcript");
-        }
-        const { data: audioBuf, headers } = await axios_1.default.get(params.audioUrl, {
-            responseType: "arraybuffer",
-            timeout: DOWNLOAD_TIMEOUT_MS,
-            maxContentLength: WHISPER_MAX_BYTES,
-            maxBodyLength: WHISPER_MAX_BYTES,
-        });
-        if (audioBuf.byteLength > WHISPER_MAX_BYTES) {
-            throw new Error(`WHISPER_PAYLOAD_TOO_LARGE: ${audioBuf.byteLength} bytes > 25 MB cap — re-route to primary ASR for long audio`);
-        }
-        const mime = headers["content-type"] ?? "audio/mpeg";
-        const ext = guessExtension(mime, params.audioUrl);
-        const file = await (0, openai_1.toFile)(Buffer.from(audioBuf), `audio.${ext}`, { type: mime });
-        const resp = await this.client.audio.transcriptions.create({
-            file,
-            model: "whisper-1",
-            response_format: "verbose_json",
-            timestamp_granularities: params.wordTimestamps !== false ? ["word"] : undefined,
-            language: params.languageCode,
-        });
-        const data = resp;
-        return {
-            id: `whisper-${Date.now().toString(36)}`,
-            status: "completed",
-            text: data.text,
-            audioDuration: data.duration,
-            words: (data.words ?? []).map((w) => ({
-                // AssemblyAI returns word offsets in ms; Whisper returns seconds.
-                // Normalise to ms so downstream caption renderers don't have to
-                // know which provider produced the transcript.
-                text: w.word,
-                start: Math.round(w.start * 1000),
-                end: Math.round(w.end * 1000),
-                confidence: 1,
-            })),
-            utterances: [],
-        };
-    }
-    /**
-     * Credit cost for Whisper. $0.006/min — routes through the shared
-     * credit helper to keep the credit↔USD ratio consistent with every
-     * other endpoint.
-     */
-    getCreditUsed(audioDurationSec) {
-        const ratePerSecond = 0.006 / 60;
-        return (0, helpers_1.getCreditsFromCost)(ratePerSecond * audioDurationSec);
-    }
-}
-exports.WhisperAsrService = WhisperAsrService;
-function guessExtension(mime, url) {
-    if (mime.includes("mpeg") || mime.includes("mp3"))
-        return "mp3";
-    if (mime.includes("wav"))
-        return "wav";
-    if (mime.includes("ogg"))
-        return "ogg";
-    if (mime.includes("webm"))
-        return "webm";
-    if (mime.includes("m4a") || mime.includes("mp4"))
-        return "m4a";
-    if (mime.includes("flac"))
-        return "flac";
-    const urlExt = url.split("?")[0]?.split(".").pop()?.toLowerCase();
-    if (urlExt && /^(mp3|wav|ogg|webm|m4a|mp4|flac)$/.test(urlExt))
-        return urlExt;
-    return "mp3";
-}

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

@@ -1,54 +0,0 @@
-import { ICachedAssetModel } from "../models/cachedAsset.model";
-import { ICachedRawAssetModel } from "../models/cachedRawAsset.model";
-/**
- * Asset cache + dedupe.
- *
- * Many agent runs ask for similar things — same VO line, same stock query,
- * similar image prompt. Caching by a content-hashed key turns the second
- * request into an instant lookup, which is a massive cost lever for bulk runs
- * (where the same template variant is generated 100×) and serial creators.
- *
- * The cache is content-addressed: hash(provider + normalized-input) → the
- * resulting asset URL + metadata. Any input change produces a different hash,
- * so stale results are impossible.
- *
- * Backed by Firestore for V1; can move to Redis / GCS metadata index later
- * without changing the API.
- */
-export type CachedAsset = ICachedAssetModel;
-export interface AssetCacheKeyParts {
-    provider: string;
-    /** Stable input identity — must capture every parameter that affects output. */
-    input: Record<string, unknown>;
-}
-export declare class AssetCacheService {
-    /**
-     * Compute a stable cache key. Same input → same key, regardless of object
-     * key order. Use externally to derive the idempotency key for the upstream
-     * provider call so retries dedupe naturally.
-     */
-    static hashKey(parts: AssetCacheKeyParts): string;
-    static lookup(parts: AssetCacheKeyParts): Promise<CachedAsset | null>;
-    static store(parts: AssetCacheKeyParts, asset: Omit<CachedAsset, "key" | "createdAt" | "lastAccessedAt" | "hitCount">): Promise<CachedAsset>;
-}
-/**
- * Raw payload cache — sibling to the asset URL cache for things that aren't
- * a single asset URL: stock-search responses (lists), VO bytes, etc.
- *
- * Same content-hash key strategy. TTL is optional — stock results expire
- * after 30 min, VOs are immutable so they live until evicted.
- *
- * Firestore doc cap is 1MB. Callers that may exceed it (VO base64) are
- * responsible for skipping the store call when payloads get big.
- */
-export interface RawCacheKeyParts extends AssetCacheKeyParts {
-    kind: ICachedRawAssetModel["kind"];
-}
-export declare class RawAssetCacheService {
-    static hashKey(parts: RawCacheKeyParts): string;
-    static lookup<T = unknown>(parts: RawCacheKeyParts): Promise<T | null>;
-    static store(parts: RawCacheKeyParts, payload: unknown, options?: {
-        ttlMs?: number;
-    }): Promise<void>;
-}
-//# sourceMappingURL=assetCache.service.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"assetCache.service.d.ts","sourceRoot":"","sources":["../../src/services/assetCache.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAItE;;;;;;;;;;;;;;GAcG;AAEH,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,qBAAa,iBAAiB;IAC5B;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,GAAG,MAAM;WAQpC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;WA0B9D,KAAK,CAChB,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,IAAI,CACT,WAAW,EACX,KAAK,GAAG,WAAW,GAAG,gBAAgB,GAAG,UAAU,CACpD,GACA,OAAO,CAAC,WAAW,CAAC;CAaxB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IAC1D,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;CACpC;AAED,qBAAa,oBAAoB;IAC/B,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM;WAIlC,MAAM,CAAC,CAAC,GAAG,OAAO,EAC7B,KAAK,EAAE,gBAAgB,GACtB,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;WA2BP,KAAK,CAChB,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAC/B,OAAO,CAAC,IAAI,CAAC;CAoBjB"}

package/lib/services/assetCache.service.js

@@ -1,109 +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.RawAssetCacheService = exports.AssetCacheService = void 0;
-const crypto_1 = __importDefault(require("crypto"));
-const logger_1 = require("../utils/logger");
-const firestore_service_1 = require("./firestore.service");
-class AssetCacheService {
-    /**
-     * Compute a stable cache key. Same input → same key, regardless of object
-     * key order. Use externally to derive the idempotency key for the upstream
-     * provider call so retries dedupe naturally.
-     */
-    static hashKey(parts) {
-        const normalized = JSON.stringify({
-            p: parts.provider,
-            i: sortedClone(parts.input),
-        });
-        return crypto_1.default.createHash("sha256").update(normalized).digest("hex");
-    }
-    static async lookup(parts) {
-        const key = AssetCacheService.hashKey(parts);
-        const doc = await firestore_service_1.FirestoreService.getDataById(firestore_service_1.FirestoreService.assetCacheCol, key);
-        if (!doc)
-            return null;
-        // Best-effort hit-count update; don't block on it.
-        void firestore_service_1.FirestoreService.updateData(firestore_service_1.FirestoreService.assetCacheCol, key, {
-            lastAccessedAt: new Date().toISOString(),
-            hitCount: (doc.hitCount ?? 0) + 1,
-        }).catch((err) => {
-            logger_1.logger.warn("assetCache: hit-count update failed", {
-                cacheKey: key,
-                err: err instanceof Error ? err.stack ?? err.message : String(err),
-            });
-            return undefined;
-        });
-        const { id: _id, ...stripped } = doc;
-        return stripped;
-    }
-    static async store(parts, asset) {
-        const key = AssetCacheService.hashKey(parts);
-        const now = new Date().toISOString();
-        const entry = {
-            ...asset,
-            key,
-            createdAt: now,
-            lastAccessedAt: now,
-            hitCount: 0,
-        };
-        await firestore_service_1.FirestoreService.addData(firestore_service_1.FirestoreService.assetCacheCol, key, entry);
-        return entry;
-    }
-}
-exports.AssetCacheService = AssetCacheService;
-class RawAssetCacheService {
-    static hashKey(parts) {
-        return AssetCacheService.hashKey(parts);
-    }
-    static async lookup(parts) {
-        const key = RawAssetCacheService.hashKey(parts);
-        const doc = await firestore_service_1.FirestoreService.getDataById(firestore_service_1.FirestoreService.assetCacheRawCol, key);
-        if (!doc)
-            return null;
-        if (doc.expiresAt && new Date(doc.expiresAt).getTime() < Date.now()) {
-            return null;
-        }
-        void firestore_service_1.FirestoreService.updateData(firestore_service_1.FirestoreService.assetCacheRawCol, key, {
-            lastAccessedAt: new Date().toISOString(),
-            hitCount: (doc.hitCount ?? 0) + 1,
-        }).catch((err) => {
-            logger_1.logger.warn("assetCache: hit-count update failed", {
-                cacheKey: key,
-                err: err instanceof Error ? err.stack ?? err.message : String(err),
-            });
-            return undefined;
-        });
-        return doc.payload;
-    }
-    static async store(parts, payload, options = {}) {
-        const key = RawAssetCacheService.hashKey(parts);
-        const now = new Date();
-        const entry = {
-            key,
-            kind: parts.kind,
-            payload,
-            createdAt: now.toISOString(),
-            lastAccessedAt: now.toISOString(),
-            hitCount: 0,
-        };
-        if (options.ttlMs) {
-            entry.expiresAt = new Date(now.getTime() + options.ttlMs).toISOString();
-        }
-        await firestore_service_1.FirestoreService.addData(firestore_service_1.FirestoreService.assetCacheRawCol, key, entry);
-    }
-}
-exports.RawAssetCacheService = RawAssetCacheService;
-function sortedClone(value) {
-    if (value === null || typeof value !== "object")
-        return value;
-    if (Array.isArray(value))
-        return value.map(sortedClone);
-    const sorted = {};
-    for (const k of Object.keys(value).sort()) {
-        sorted[k] = sortedClone(value[k]);
-    }
-    return sorted;
-}

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

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

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

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

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