@vdegenne/gemini-tts-proxy 0.0.0-stage → 0.1.2

package/lib/access.d.ts

@@ -0,0 +1,6 @@
+export declare class AccessError extends Error {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+export declare function resolveApiKey(clientApiKey?: string, authorization?: string): Promise<string>;
+//# sourceMappingURL=access.d.ts.map

package/lib/access.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.d.ts","sourceRoot":"","sources":["../src/access.ts"],"names":[],"mappings":"AAGA,qBAAa,WAAY,SAAQ,KAAK;aAGpB,MAAM,EAAE,MAAM;IAF/B,YACC,OAAO,EAAE,MAAM,EACC,MAAM,EAAE,MAAM,EAG9B;CACD;AAED,wBAAsB,aAAa,CAClC,YAAY,CAAC,EAAE,MAAM,EACrB,aAAa,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC,CAgCjB"}

package/lib/access.js

@@ -0,0 +1,37 @@
+import { isFirebaseConfigured, verifyPremiumUser } from './auth.js';
+import { config } from './config.js';
+export class AccessError extends Error {
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+    }
+}
+export async function resolveApiKey(clientApiKey, authorization) {
+    const providedKey = clientApiKey?.trim();
+    // A client-provided key takes precedence and bypasses Firebase.
+    if (providedKey)
+        return providedKey;
+    const serverApiKey = config.apiKey?.trim();
+    if (!serverApiKey) {
+        throw new AccessError('Gemini API key required', 401);
+    }
+    // Without Firebase credentials, the server key is sufficient.
+    if (!isFirebaseConfigured())
+        return serverApiKey;
+    if (!authorization?.startsWith('Bearer ')) {
+        throw new AccessError('Authentication required', 401);
+    }
+    try {
+        const isPremium = await verifyPremiumUser(authorization.slice(7));
+        if (!isPremium) {
+            throw new AccessError('Premium subscription required', 403);
+        }
+    }
+    catch (error) {
+        if (error instanceof AccessError)
+            throw error;
+        throw new AccessError('Invalid authentication token', 401);
+    }
+    return serverApiKey;
+}
+//# sourceMappingURL=access.js.map

package/lib/access.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"access.js","sourceRoot":"","sources":["../src/access.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,oBAAoB,EAAE,iBAAiB,EAAC,MAAM,WAAW,CAAA;AACjE,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAA;AAElC,MAAM,OAAO,WAAY,SAAQ,KAAK;IACrC,YACC,OAAe,EACC,MAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAA;sBAFE,MAAM;IAGvB,CAAC;CACD;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAClC,YAAqB,EACrB,aAAsB;IAEtB,MAAM,WAAW,GAAG,YAAY,EAAE,IAAI,EAAE,CAAA;IAExC,gEAAgE;IAChE,IAAI,WAAW;QAAE,OAAO,WAAW,CAAA;IAEnC,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAA;IAE1C,IAAI,CAAC,YAAY,EAAE,CAAC;QACnB,MAAM,IAAI,WAAW,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAA;IACtD,CAAC;IAED,8DAA8D;IAC9D,IAAI,CAAC,oBAAoB,EAAE;QAAE,OAAO,YAAY,CAAA;IAEhD,IAAI,CAAC,aAAa,EAAE,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,WAAW,CAAC,yBAAyB,EAAE,GAAG,CAAC,CAAA;IACtD,CAAC;IAED,IAAI,CAAC;QACJ,MAAM,SAAS,GAAG,MAAM,iBAAiB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;QAEjE,IAAI,CAAC,SAAS,EAAE,CAAC;YAChB,MAAM,IAAI,WAAW,CAAC,+BAA+B,EAAE,GAAG,CAAC,CAAA;QAC5D,CAAC;IACF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,WAAW;YAAE,MAAM,KAAK,CAAA;QAE7C,MAAM,IAAI,WAAW,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAA;IAC3D,CAAC;IAED,OAAO,YAAY,CAAA;AACpB,CAAC"}

package/lib/auth.d.ts

@@ -0,0 +1,3 @@
+export declare function isFirebaseConfigured(): boolean;
+export declare function verifyPremiumUser(token: string): Promise<boolean>;
+//# sourceMappingURL=auth.d.ts.map

package/lib/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAUA,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C;AA2BD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGvE"}

package/lib/auth.js

@@ -0,0 +1,27 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { cert, getApps, initializeApp } from 'firebase-admin/app';
+import { getAuth } from 'firebase-admin/auth';
+import { config } from './config.js';
+let auth;
+export function isFirebaseConfigured() {
+    return existsSync(config.serviceAccountPath);
+}
+function getFirebaseAuth() {
+    if (auth)
+        return auth;
+    if (!isFirebaseConfigured()) {
+        throw new Error('Firebase service account is not configured');
+    }
+    const serviceAccount = JSON.parse(readFileSync(config.serviceAccountPath, 'utf8'));
+    const app = getApps().find((app) => app.name === 'gemini-tts-proxy') ??
+        initializeApp({
+            credential: cert(serviceAccount),
+        }, 'gemini-tts-proxy');
+    auth = getAuth(app);
+    return auth;
+}
+export async function verifyPremiumUser(token) {
+    const decodedToken = await getFirebaseAuth().verifyIdToken(token, true);
+    return decodedToken.premium === true;
+}
+//# sourceMappingURL=auth.js.map

package/lib/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAGlD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACjE,OAAO,EAAE,OAAO,EAAa,MAAM,qBAAqB,CAAA;AAExD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC,IAAI,IAAsB,CAAA;AAE1B,MAAM,UAAU,oBAAoB;IACnC,OAAO,UAAU,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAA;AAC7C,CAAC;AAED,SAAS,eAAe;IACvB,IAAI,IAAI;QAAE,OAAO,IAAI,CAAA;IAErB,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;IAC9D,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAChC,YAAY,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAC7B,CAAA;IAEnB,MAAM,GAAG,GACR,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,kBAAkB,CAAC;QACxD,aAAa,CACZ;YACC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC;SAChC,EACD,kBAAkB,CAClB,CAAA;IAEF,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAA;IAEnB,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAAa;IACpD,MAAM,YAAY,GAAG,MAAM,eAAe,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IACvE,OAAO,YAAY,CAAC,OAAO,KAAK,IAAI,CAAA;AACrC,CAAC"}

package/lib/cache.d.ts

@@ -0,0 +1,9 @@
+import { Readable } from 'node:stream';
+import { type SpeechOptions } from './core.js';
+export interface CachedAudio {
+    body: Buffer | Readable;
+    size: number;
+}
+export declare function getDiskPath(hash: string): string;
+export declare function getSpeech(options: SpeechOptions): Promise<CachedAudio>;
+//# sourceMappingURL=cache.d.ts.map

package/lib/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAKtC,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AAIzE,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;CACZ;AAWD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAkLD,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAsD5E"}

package/lib/cache.js

@@ -0,0 +1,192 @@
+import { randomUUID } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { mkdir, readFile, rename, stat, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { GoogleGenAI } from '@google/genai';
+import { config } from './config.js';
+import { getAudioPath, getCacheKey } from './core.js';
+import { encodePcmToMp3 } from './ffmpeg.js';
+import { recordUsage } from './stats.js';
+const memoryCache = new Map();
+const inFlight = new Map();
+let memoryCacheSize = 0;
+export function getDiskPath(hash) {
+    return join(config.cacheDir, getAudioPath(hash));
+}
+function getMemory(hash) {
+    const entry = memoryCache.get(hash);
+    if (!entry)
+        return undefined;
+    // Refresh insertion order to implement LRU.
+    memoryCache.delete(hash);
+    memoryCache.set(hash, entry);
+    return entry.data;
+}
+function setMemory(hash, data) {
+    if (data.length > config.memoryCacheMaxBytes)
+        return;
+    const previous = memoryCache.get(hash);
+    if (previous) {
+        memoryCacheSize -= previous.data.length;
+        memoryCache.delete(hash);
+    }
+    while (memoryCacheSize + data.length > config.memoryCacheMaxBytes) {
+        const oldest = memoryCache.keys().next().value;
+        if (oldest === undefined)
+            break;
+        const entry = memoryCache.get(oldest);
+        memoryCacheSize -= entry.data.length;
+        memoryCache.delete(oldest);
+    }
+    memoryCache.set(hash, { data });
+    memoryCacheSize += data.length;
+}
+async function getDiskAudio(hash) {
+    const path = getDiskPath(hash);
+    let fileSize;
+    try {
+        fileSize = (await stat(path)).size;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return undefined;
+        }
+        throw error;
+    }
+    if (fileSize <= config.memoryCacheMaxBytes) {
+        const data = await readFile(path);
+        setMemory(hash, data);
+        return { body: data, size: data.length };
+    }
+    return {
+        body: createReadStream(path),
+        size: fileSize,
+    };
+}
+async function synthesize(options, hash) {
+    const path = getDiskPath(hash);
+    const directory = join(path, '..');
+    const tempPath = `${path}.${randomUUID()}.tmp`;
+    if (!options.apiKey) {
+        throw new Error('No Gemini API key was provided');
+    }
+    await mkdir(directory, { recursive: true });
+    try {
+        const ai = new GoogleGenAI({
+            apiKey: options.apiKey,
+            httpOptions: {
+                apiVersion: 'v1beta',
+            },
+        });
+        const response = await ai.models.generateContentStream({
+            model: options.model,
+            contents: [
+                {
+                    role: 'user',
+                    parts: [{ text: options.input }],
+                },
+            ],
+            config: {
+                responseModalities: ['AUDIO'],
+                systemInstruction: options.systemInstruction,
+                speechConfig: {
+                    languageCode: options.languageCode,
+                    voiceConfig: {
+                        voice: options.voice,
+                    },
+                },
+            },
+        });
+        const chunks = [];
+        let pcmFormat;
+        for await (const chunk of response) {
+            const parts = chunk.candidates?.[0]?.content?.parts ?? [];
+            for (const part of parts) {
+                const inlineData = part.inlineData;
+                if (!inlineData?.data)
+                    continue;
+                const mimeType = inlineData.mimeType ?? '';
+                const match = mimeType.match(/^audio\/L(\d+)(?:;rate=(\d+))?/i);
+                if (!match) {
+                    throw new Error(`Unsupported Gemini audio format: ${mimeType}`);
+                }
+                const format = {
+                    bitsPerSample: Number(match[1]),
+                    sampleRate: Number(match[2] ?? 24000),
+                    channels: 1,
+                };
+                if (format.bitsPerSample !== 16) {
+                    throw new Error(`Unsupported PCM bit depth: ${format.bitsPerSample}`);
+                }
+                if (pcmFormat) {
+                    if (pcmFormat.sampleRate !== format.sampleRate ||
+                        pcmFormat.bitsPerSample !== format.bitsPerSample ||
+                        pcmFormat.channels !== format.channels) {
+                        throw new Error('Gemini returned inconsistent audio formats');
+                    }
+                }
+                else {
+                    pcmFormat = format;
+                }
+                chunks.push(Buffer.from(inlineData.data, 'base64'));
+            }
+        }
+        if (chunks.length === 0 || !pcmFormat) {
+            throw new Error('Gemini returned no audio data');
+        }
+        await encodePcmToMp3(Buffer.concat(chunks), tempPath, pcmFormat);
+        await rename(tempPath, path);
+        const fileSize = (await stat(path)).size;
+        if (fileSize <= config.memoryCacheMaxBytes) {
+            try {
+                setMemory(hash, await readFile(path));
+            }
+            catch {
+                // The disk cache remains usable if memory caching fails.
+            }
+        }
+    }
+    finally {
+        await unlink(tempPath).catch(() => { });
+    }
+}
+export async function getSpeech(options) {
+    const hash = await getCacheKey(options);
+    let audio = getMemory(hash);
+    if (audio) {
+        recordUsage(hash);
+        return { body: audio, size: audio.length };
+    }
+    const cached = await getDiskAudio(hash);
+    if (cached) {
+        recordUsage(hash);
+        return cached;
+    }
+    let pending = inFlight.get(hash);
+    if (!pending) {
+        pending = synthesize(options, hash);
+        inFlight.set(hash, pending);
+        void pending.then(() => {
+            if (inFlight.get(hash) === pending) {
+                inFlight.delete(hash);
+            }
+        }, () => {
+            if (inFlight.get(hash) === pending) {
+                inFlight.delete(hash);
+            }
+        });
+    }
+    await pending;
+    audio = getMemory(hash);
+    if (audio) {
+        recordUsage(hash);
+        return { body: audio, size: audio.length };
+    }
+    const result = await getDiskAudio(hash);
+    if (!result) {
+        throw new Error('Audio was generated but is missing from the disk cache');
+    }
+    recordUsage(hash);
+    return result;
+}
+//# sourceMappingURL=cache.js.map

package/lib/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAC1C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACxE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAE3C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAsB,MAAM,WAAW,CAAA;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAWxC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAA;AAClD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAA;AAEjD,IAAI,eAAe,GAAG,CAAC,CAAA;AAEvB,MAAM,UAAU,WAAW,CAAC,IAAY;IACvC,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAA;AACjD,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC9B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAEnC,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAA;IAE5B,4CAA4C;IAC5C,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACxB,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAE5B,OAAO,KAAK,CAAC,IAAI,CAAA;AAClB,CAAC;AAED,SAAS,SAAS,CAAC,IAAY,EAAE,IAAY;IAC5C,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,mBAAmB;QAAE,OAAM;IAEpD,MAAM,QAAQ,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAEtC,IAAI,QAAQ,EAAE,CAAC;QACd,eAAe,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAA;QACvC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;IAED,OAAO,eAAe,GAAG,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;QACnE,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,KAA2B,CAAA;QAEpE,IAAI,MAAM,KAAK,SAAS;YAAE,MAAK;QAE/B,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAE,CAAA;QAEtC,eAAe,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,CAAA;QACpC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;IAED,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;IAC/B,eAAe,IAAI,IAAI,CAAC,MAAM,CAAA;AAC/B,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAE9B,IAAI,QAAgB,CAAA;IAEpB,IAAI,CAAC;QACJ,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IACnC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,SAAS,CAAA;QACjB,CAAC;QAED,MAAM,KAAK,CAAA;IACZ,CAAC;IAED,IAAI,QAAQ,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;QACjC,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAErB,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAA;IACzC,CAAC;IAED,OAAO;QACN,IAAI,EAAE,gBAAgB,CAAC,IAAI,CAAC;QAC5B,IAAI,EAAE,QAAQ;KACd,CAAA;AACF,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,OAAsB,EAAE,IAAY;IAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,UAAU,EAAE,MAAM,CAAA;IAE9C,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;IAClD,CAAC;IAED,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE3C,IAAI,CAAC;QACJ,MAAM,EAAE,GAAG,IAAI,WAAW,CAAC;YAC1B,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW,EAAE;gBACZ,UAAU,EAAE,QAAQ;aACpB;SACD,CAAC,CAAA;QAEF,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC;YACtD,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,QAAQ,EAAE;gBACT;oBACC,IAAI,EAAE,MAAM;oBACZ,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;iBAChC;aACD;YACD,MAAM,EAAE;gBACP,kBAAkB,EAAE,CAAC,OAAO,CAAC;gBAC7B,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,YAAY,EAAE;oBACb,YAAY,EAAE,OAAO,CAAC,YAAY;oBAClC,WAAW,EAAE;wBACZ,KAAK,EAAE,OAAO,CAAC,KAAK;qBACpB;iBACD;aACD;SACD,CAAC,CAAA;QAEF,MAAM,MAAM,GAAa,EAAE,CAAA;QAC3B,IAAI,SAMQ,CAAA;QAEZ,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,IAAI,EAAE,CAAA;YAEzD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;gBAElC,IAAI,CAAC,UAAU,EAAE,IAAI;oBAAE,SAAQ;gBAE/B,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAA;gBAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAA;gBAE/D,IAAI,CAAC,KAAK,EAAE,CAAC;oBACZ,MAAM,IAAI,KAAK,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAA;gBAChE,CAAC;gBAED,MAAM,MAAM,GAAG;oBACd,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBAC/B,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC;oBACrC,QAAQ,EAAE,CAAC;iBACX,CAAA;gBAED,IAAI,MAAM,CAAC,aAAa,KAAK,EAAE,EAAE,CAAC;oBACjC,MAAM,IAAI,KAAK,CAAC,8BAA8B,MAAM,CAAC,aAAa,EAAE,CAAC,CAAA;gBACtE,CAAC;gBAED,IAAI,SAAS,EAAE,CAAC;oBACf,IACC,SAAS,CAAC,UAAU,KAAK,MAAM,CAAC,UAAU;wBAC1C,SAAS,CAAC,aAAa,KAAK,MAAM,CAAC,aAAa;wBAChD,SAAS,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,EACrC,CAAC;wBACF,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAA;oBAC9D,CAAC;gBACF,CAAC;qBAAM,CAAC;oBACP,SAAS,GAAG,MAAM,CAAA;gBACnB,CAAC;gBAED,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAA;YACpD,CAAC;QACF,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;QACjD,CAAC;QAED,MAAM,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;QAEhE,MAAM,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAE5B,MAAM,QAAQ,GAAG,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;QAExC,IAAI,QAAQ,IAAI,MAAM,CAAC,mBAAmB,EAAE,CAAC;YAC5C,IAAI,CAAC;gBACJ,SAAS,CAAC,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAA;YACtC,CAAC;YAAC,MAAM,CAAC;gBACR,yDAAyD;YAC1D,CAAC;QACF,CAAC;IACF,CAAC;YAAS,CAAC;QACV,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACvC,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAsB;IACrD,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAA;IAEvC,IAAI,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAE3B,IAAI,KAAK,EAAE,CAAC;QACX,WAAW,CAAC,IAAI,CAAC,CAAA;QACjB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;IAEvC,IAAI,MAAM,EAAE,CAAC;QACZ,WAAW,CAAC,IAAI,CAAC,CAAA;QACjB,OAAO,MAAM,CAAA;IACd,CAAC;IAED,IAAI,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAEhC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QACnC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAE3B,KAAK,OAAO,CAAC,IAAI,CAChB,GAAG,EAAE;YACJ,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;gBACpC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACtB,CAAC;QACF,CAAC,EACD,GAAG,EAAE;YACJ,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,OAAO,EAAE,CAAC;gBACpC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YACtB,CAAC;QACF,CAAC,CACD,CAAA;IACF,CAAC;IAED,MAAM,OAAO,CAAA;IAEb,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAEvB,IAAI,KAAK,EAAE,CAAC;QACX,WAAW,CAAC,IAAI,CAAC,CAAA;QACjB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,CAAA;IAC3C,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAA;IAEvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IAC1E,CAAC;IAED,WAAW,CAAC,IAAI,CAAC,CAAA;IACjB,OAAO,MAAM,CAAA;AACd,CAAC"}

package/lib/clean-cache.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=clean-cache.d.ts.map

package/lib/clean-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-cache.d.ts","sourceRoot":"","sources":["../src/clean-cache.ts"],"names":[],"mappings":""}

package/lib/clean-cache.js

@@ -0,0 +1,95 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, stat, unlink, writeFile, } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { config } from './config.js';
+const gib = 1024 ** 3;
+const maxBytes = Number(process.env.DISK_CACHE_MAX_BYTES ?? 5 * gib);
+if (!Number.isSafeInteger(maxBytes) || maxBytes <= 0) {
+    throw new Error('DISK_CACHE_MAX_BYTES must be a positive integer');
+}
+const audioDir = join(config.cacheDir, 'audio');
+const statsPath = join(config.cacheDir, 'stats.json');
+function getAudioPath(hash) {
+    return join(audioDir, hash.slice(0, 2), hash.slice(2, 4), `${hash}.mp3`);
+}
+async function main() {
+    let stats;
+    try {
+        const content = await readFile(statsPath, 'utf8');
+        const parsed = JSON.parse(content);
+        if (parsed === null ||
+            typeof parsed !== 'object' ||
+            Array.isArray(parsed)) {
+            throw new Error('Invalid stats.json format');
+        }
+        stats = parsed;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            console.log('No stats.json found. Nothing to clean.');
+            return;
+        }
+        throw error;
+    }
+    const entries = Object.entries(stats).filter(([hash, count]) => /^[a-f0-9]{64}$/.test(hash) && Number.isSafeInteger(count) && count >= 0);
+    const files = [];
+    let totalBytes = 0;
+    for (const [hash, uses] of entries) {
+        const path = getAudioPath(hash);
+        try {
+            const info = await stat(path);
+            if (!info.isFile())
+                continue;
+            files.push({
+                hash,
+                path,
+                size: info.size,
+                uses,
+                mtimeMs: info.mtimeMs,
+            });
+            totalBytes += info.size;
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+            // Remove stale statistics for files that no longer exist.
+            delete stats[hash];
+        }
+    }
+    const initialBytes = totalBytes;
+    // Least-used files first; oldest files break ties.
+    files.sort((a, b) => a.uses - b.uses || a.mtimeMs - b.mtimeMs);
+    let deletedFiles = 0;
+    for (const file of files) {
+        if (totalBytes <= maxBytes)
+            break;
+        await unlink(file.path);
+        totalBytes -= file.size;
+        delete stats[file.hash];
+        deletedFiles++;
+        console.log(`Deleted ${file.hash}.mp3 (${file.size} bytes, ${file.uses} uses)`);
+    }
+    if (deletedFiles > 0 || files.length !== entries.length) {
+        await mkdir(dirname(statsPath), { recursive: true });
+        const tempPath = `${statsPath}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(tempPath, JSON.stringify(stats), 'utf8');
+            await rename(tempPath, statsPath);
+        }
+        finally {
+            await unlink(tempPath).catch(() => { });
+        }
+    }
+    console.log(`Cache: ${(initialBytes / gib).toFixed(2)} GiB → ` +
+        `${(totalBytes / gib).toFixed(2)} GiB`);
+    console.log(`Deleted ${deletedFiles} file(s).`);
+    if (totalBytes > maxBytes) {
+        console.log('Cache remains above the limit. Some audio files may not be tracked in stats.json.');
+    }
+}
+main().catch((error) => {
+    console.error('Cache cleanup failed:', error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=clean-cache.js.map

package/lib/clean-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-cache.js","sourceRoot":"","sources":["../src/clean-cache.ts"],"names":[],"mappings":"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"}

package/lib/config.d.ts

@@ -0,0 +1,10 @@
+export declare const config: {
+    readonly host: string;
+    readonly port: number;
+    readonly apiKey: string | undefined;
+    readonly serviceAccountPath: string;
+    readonly cacheDir: string;
+    readonly memoryCacheMaxBytes: number;
+    readonly statsFlushIntervalMs: number;
+};
+//# sourceMappingURL=config.d.ts.map

package/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAkBA,eAAO,MAAM,MAAM;aAClB,IAAI;aACJ,IAAI;aAEJ,MAAM;aAEN,kBAAkB;aAIlB,QAAQ;aAER,mBAAmB;aAEnB,oBAAoB;CACX,CAAA"}

package/lib/config.js

@@ -0,0 +1,22 @@
+import { resolve } from 'node:path';
+function getPositiveInteger(name, fallback) {
+    const value = process.env[name];
+    if (value === undefined)
+        return fallback;
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed) || parsed <= 0) {
+        throw new Error(`${name} must be a positive integer`);
+    }
+    return parsed;
+}
+const mib = 1024 * 1024;
+export const config = {
+    host: process.env.HOST ?? '127.0.0.1',
+    port: getPositiveInteger('PORT', 3000),
+    apiKey: process.env.GEMINI_API_KEY,
+    serviceAccountPath: resolve(process.env.FIREBASE_SERVICE_ACCOUNT ?? 'serviceAccountKey.json'),
+    cacheDir: resolve(process.env.CACHE_DIR ?? 'data/gemini'),
+    memoryCacheMaxBytes: getPositiveInteger('MEMORY_CACHE_MAX_BYTES', 100 * mib),
+    statsFlushIntervalMs: getPositiveInteger('STATS_FLUSH_INTERVAL_MS', 30_000),
+};
+//# sourceMappingURL=config.js.map

package/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,OAAO,EAAC,MAAM,WAAW,CAAA;AAEjC,SAAS,kBAAkB,CAAC,IAAY,EAAE,QAAgB;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAE/B,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAA;IAExC,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAA;IAE5B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,6BAA6B,CAAC,CAAA;IACtD,CAAC;IAED,OAAO,MAAM,CAAA;AACd,CAAC;AAED,MAAM,GAAG,GAAG,IAAI,GAAG,IAAI,CAAA;AAEvB,MAAM,CAAC,MAAM,MAAM,GAAG;IACrB,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,WAAW;IACrC,IAAI,EAAE,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC;IAEtC,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc;IAElC,kBAAkB,EAAE,OAAO,CAC1B,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,wBAAwB,CAChE;IAED,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,aAAa,CAAC;IAEzD,mBAAmB,EAAE,kBAAkB,CAAC,wBAAwB,EAAE,GAAG,GAAG,GAAG,CAAC;IAE5E,oBAAoB,EAAE,kBAAkB,CAAC,yBAAyB,EAAE,MAAM,CAAC;CAClE,CAAA"}

package/lib/core.d.ts

@@ -0,0 +1,15 @@
+export declare const GEMINI_TTS_MODELS: readonly ['gemini-2.5-flash-preview-tts', 'gemini-2.5-pro-preview-tts', 'gemini-3.1-flash-tts-preview', 'gemini-3.8-flash-tts', 'gemini-3.8-flash-lite-tts'];
+export type GeminiTtsModel = (typeof GEMINI_TTS_MODELS)[number];
+export declare const GEMINI_TTS_VOICES: readonly ['Achernar', 'Achird', 'Algenib', 'Algieba', 'Alnilam', 'Aoede', 'Autonoe', 'Callirrhoe', 'Charon', 'Despina', 'Enceladus', 'Erinome', 'Fenrir', 'Gacrux', 'Iapetus', 'Kore', 'Laomedeia', 'Leda', 'Orus', 'Puck', 'Pulcherrima', 'Rasalgethi', 'Sadachbia', 'Sadaltager', 'Schedar', 'Sulafat', 'Umbriel', 'Vindemiatrix', 'Zephyr', 'Zubenelgenubi'];
+export type GeminiTtsVoice = (typeof GEMINI_TTS_VOICES)[number];
+export interface SpeechOptions {
+    input: string;
+    model: GeminiTtsModel;
+    voice: string;
+    languageCode: string;
+    systemInstruction?: string;
+    apiKey?: string;
+}
+export declare function getCacheKey(options: SpeechOptions): Promise<string>;
+export declare function getAudioPath(hash: string): string;
+//# sourceMappingURL=core.d.ts.map

package/lib/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,YAC7B,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAC9B,sBAAsB,EACtB,2BAA2B,CAClB,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,eAAO,MAAM,iBAAiB,YAC7B,UAAU,EACV,QAAQ,EACR,SAAS,EACT,SAAS,EACT,SAAS,EACT,OAAO,EACP,SAAS,EACT,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,WAAW,EACX,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,MAAM,EACN,MAAM,EACN,MAAM,EACN,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,SAAS,EACT,SAAS,EACT,SAAS,EACT,cAAc,EACd,QAAQ,EACR,eAAe,CACN,CAAA;AAEV,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE/D,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,cAAc,CAAA;IACrB,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAA;CACf;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBzE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD"}

package/lib/core.js

@@ -0,0 +1,59 @@
+export const GEMINI_TTS_MODELS = [
+    'gemini-2.5-flash-preview-tts',
+    'gemini-2.5-pro-preview-tts',
+    'gemini-3.1-flash-tts-preview',
+    'gemini-3.8-flash-tts',
+    'gemini-3.8-flash-lite-tts',
+];
+export const GEMINI_TTS_VOICES = [
+    'Achernar',
+    'Achird',
+    'Algenib',
+    'Algieba',
+    'Alnilam',
+    'Aoede',
+    'Autonoe',
+    'Callirrhoe',
+    'Charon',
+    'Despina',
+    'Enceladus',
+    'Erinome',
+    'Fenrir',
+    'Gacrux',
+    'Iapetus',
+    'Kore',
+    'Laomedeia',
+    'Leda',
+    'Orus',
+    'Puck',
+    'Pulcherrima',
+    'Rasalgethi',
+    'Sadachbia',
+    'Sadaltager',
+    'Schedar',
+    'Sulafat',
+    'Umbriel',
+    'Vindemiatrix',
+    'Zephyr',
+    'Zubenelgenubi',
+];
+export async function getCacheKey(options) {
+    const payload = JSON.stringify([
+        options.input,
+        options.model,
+        options.voice,
+        options.languageCode,
+        options.systemInstruction ?? '',
+    ]);
+    const data = new TextEncoder().encode(payload);
+    const hash = await crypto.subtle.digest('SHA-256', data);
+    return Array.from(new Uint8Array(hash))
+        .map(function (byte) {
+        return byte.toString(16).padStart(2, '0');
+    })
+        .join('');
+}
+export function getAudioPath(hash) {
+    return `audio/${hash.slice(0, 2)}/${hash.slice(2, 4)}/${hash}.mp3`;
+}
+//# sourceMappingURL=core.js.map

package/lib/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,8BAA8B;IAC9B,4BAA4B;IAC5B,8BAA8B;IAC9B,sBAAsB;IACtB,2BAA2B;CAClB,CAAA;AAIV,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAChC,UAAU;IACV,QAAQ;IACR,SAAS;IACT,SAAS;IACT,SAAS;IACT,OAAO;IACP,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,WAAW;IACX,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,SAAS;IACT,MAAM;IACN,WAAW;IACX,MAAM;IACN,MAAM;IACN,MAAM;IACN,aAAa;IACb,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,SAAS;IACT,SAAS;IACT,SAAS;IACT,cAAc;IACd,QAAQ;IACR,eAAe;CACN,CAAA;AAaV,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAsB;IACvD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,OAAO,CAAC,KAAK;QACb,OAAO,CAAC,KAAK;QACb,OAAO,CAAC,KAAK;QACb,OAAO,CAAC,YAAY;QACpB,OAAO,CAAC,iBAAiB,IAAI,EAAE;KAC/B,CAAC,CAAA;IAEF,MAAM,IAAI,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;IAC9C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAExD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;SACrC,GAAG,CAAC,UAAU,IAAI;QAClB,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAC1C,CAAC,CAAC;SACD,IAAI,CAAC,EAAE,CAAC,CAAA;AACX,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,OAAO,SAAS,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,IAAI,MAAM,CAAA;AACnE,CAAC"}

package/lib/ffmpeg.d.ts

@@ -0,0 +1,11 @@
+export interface FFmpegInfo {
+    version: string;
+}
+export interface PcmFormat {
+    sampleRate: number;
+    bitsPerSample: number;
+    channels: number;
+}
+export declare function checkFFmpeg(): Promise<FFmpegInfo>;
+export declare function encodePcmToMp3(pcm: Buffer, outputPath: string, format: PcmFormat): Promise<void>;
+//# sourceMappingURL=ffmpeg.d.ts.map

package/lib/ffmpeg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffmpeg.d.ts","sourceRoot":"","sources":["../src/ffmpeg.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAA;CACf;AACD,MAAM,WAAW,SAAS;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,aAAa,EAAE,MAAM,CAAA;IACrB,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,wBAAsB,WAAW,IAAI,OAAO,CAAC,UAAU,CAAC,CAiFvD;AAED,wBAAsB,cAAc,CACnC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,GACf,OAAO,CAAC,IAAI,CAAC,CAyDf"}