@vdegenne/kokoro-proxy 0.0.0-stage → 0.1.2

package/lib/cache.d.ts

@@ -0,0 +1,8 @@
+import { Readable } from 'node:stream';
+import { type SpeechOptions } from './hash.js';
+export interface CachedAudio {
+    body: Buffer | Readable;
+    size: number;
+}
+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,EAAC,QAAQ,EAAC,MAAM,aAAa,CAAA;AAIpC,OAAO,EAAc,KAAK,aAAa,EAAC,MAAM,WAAW,CAAA;AAGzD,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAA;IACvB,IAAI,EAAE,MAAM,CAAA;CACZ;AA+ID,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAsD5E"}

package/lib/cache.js

@@ -0,0 +1,148 @@
+import { randomUUID } from 'node:crypto';
+import { createReadStream, createWriteStream } from 'node:fs';
+import { mkdir, readFile, rename, stat, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { pipeline } from 'node:stream/promises';
+import { config } from './config.js';
+import { getCacheKey } from './hash.js';
+import { recordUsage } from './stats.js';
+const memoryCache = new Map();
+const inFlight = new Map();
+let memoryCacheSize = 0;
+function getDiskPath(hash) {
+    return join(config.cacheDir, 'audio', hash.slice(0, 2), hash.slice(2, 4), `${hash}.mp3`);
+}
+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`;
+    await mkdir(directory, { recursive: true });
+    try {
+        const response = await fetch(`${config.upstreamUrl}/v1/audio/speech`, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+            },
+            body: JSON.stringify({
+                model: 'tts-1',
+                input: options.input,
+                voice: options.voice,
+                speed: options.speed,
+                volume_multiplier: options.volume_multiplier,
+                response_format: 'mp3',
+            }),
+        });
+        if (!response.ok) {
+            const details = await response.text().catch(() => '');
+            throw new Error(`Kokoro returned HTTP ${response.status}` +
+                (details ? `: ${details}` : ''));
+        }
+        if (!response.body) {
+            throw new Error('Kokoro returned an empty response body');
+        }
+        await pipeline(response.body, createWriteStream(tempPath, { flags: 'wx' }));
+        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 = 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,EAAC,UAAU,EAAC,MAAM,aAAa,CAAA;AACtC,OAAO,EAAC,gBAAgB,EAAE,iBAAiB,EAAC,MAAM,SAAS,CAAA;AAC3D,OAAO,EAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAC,MAAM,kBAAkB,CAAA;AACtE,OAAO,EAAC,IAAI,EAAC,MAAM,WAAW,CAAA;AAE9B,OAAO,EAAC,QAAQ,EAAC,MAAM,sBAAsB,CAAA;AAE7C,OAAO,EAAC,MAAM,EAAC,MAAM,aAAa,CAAA;AAClC,OAAO,EAAC,WAAW,EAAqB,MAAM,WAAW,CAAA;AACzD,OAAO,EAAC,WAAW,EAAC,MAAM,YAAY,CAAA;AAWtC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAuB,CAAA;AAClD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAA;AAEjD,IAAI,eAAe,GAAG,CAAC,CAAA;AAEvB,SAAS,WAAW,CAAC,IAAY;IAChC,OAAO,IAAI,CACV,MAAM,CAAC,QAAQ,EACf,OAAO,EACP,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAChB,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAChB,GAAG,IAAI,MAAM,CACb,CAAA;AACF,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,EAAC,IAAI,EAAC,CAAC,CAAA;IAC7B,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,EAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAC,CAAA;IACvC,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,MAAM,KAAK,CAAC,SAAS,EAAE,EAAC,SAAS,EAAE,IAAI,EAAC,CAAC,CAAA;IAEzC,IAAI,CAAC;QACJ,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,MAAM,CAAC,WAAW,kBAAkB,EAAE;YACrE,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACR,cAAc,EAAE,kBAAkB;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACpB,KAAK,EAAE,OAAO;gBACd,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;gBAC5C,eAAe,EAAE,KAAK;aACtB,CAAC;SACF,CAAC,CAAA;QAEF,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YAClB,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAA;YAErD,MAAM,IAAI,KAAK,CACd,wBAAwB,QAAQ,CAAC,MAAM,EAAE;gBACxC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAChC,CAAA;QACF,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAA;QAC1D,CAAC;QAED,MAAM,QAAQ,CACb,QAAQ,CAAC,IAA2D,EACpE,iBAAiB,CAAC,QAAQ,EAAE,EAAC,KAAK,EAAE,IAAI,EAAC,CAAC,CAC1C,CAAA;QAED,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,WAAW,CAAC,OAAO,CAAC,CAAA;IAEjC,IAAI,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAE3B,IAAI,KAAK,EAAE,CAAC;QACX,WAAW,CAAC,IAAI,CAAC,CAAA;QACjB,OAAO,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAC,CAAA;IACzC,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,EAAC,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAC,CAAA;IACzC,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,9 @@
+export declare const config: {
+    readonly host: string;
+    readonly port: number;
+    readonly upstreamUrl: 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":"AA4BA,eAAO,MAAM,MAAM;aAClB,IAAI;aACJ,IAAI;aAEJ,WAAW;aAEX,QAAQ;aAER,mBAAmB;aAEnB,oBAAoB;CACX,CAAA"}

package/lib/config.js

@@ -0,0 +1,30 @@
+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;
+}
+function getUrl(name, fallback) {
+    const value = process.env[name] ?? fallback;
+    try {
+        return new URL(value).toString().replace(/\/$/, '');
+    }
+    catch {
+        throw new Error(`${name} must be a valid URL`);
+    }
+}
+const mib = 1024 * 1024;
+export const config = {
+    host: process.env.HOST ?? '127.0.0.1',
+    port: getPositiveInteger('PORT', 3000),
+    upstreamUrl: getUrl('KOKORO_URL', 'http://127.0.0.1:8880'),
+    cacheDir: resolve(process.env.CACHE_DIR ?? 'data'),
+    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,SAAS,MAAM,CAAC,IAAY,EAAE,QAAgB;IAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAA;IAE3C,IAAI,CAAC;QACJ,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAA;IACpD,CAAC;IAAC,MAAM,CAAC;QACR,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,sBAAsB,CAAC,CAAA;IAC/C,CAAC;AACF,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,WAAW,EAAE,MAAM,CAAC,YAAY,EAAE,uBAAuB,CAAC;IAE1D,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAC;IAElD,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,2 @@
+export { getCacheKey, type SpeechOptions } from './hash.js';
+//# 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,OAAO,EAAC,WAAW,EAAE,KAAK,aAAa,EAAC,MAAM,WAAW,CAAA"}

package/lib/core.js

@@ -0,0 +1,2 @@
+export { getCacheKey } from './hash.js';
+//# 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,OAAO,EAAC,WAAW,EAAqB,MAAM,WAAW,CAAA"}

package/lib/hash.d.ts

@@ -0,0 +1,8 @@
+export interface SpeechOptions {
+    input: string;
+    voice: string;
+    speed: number;
+    volume_multiplier: number;
+}
+export declare function getCacheKey(options: SpeechOptions): string;
+//# sourceMappingURL=hash.d.ts.map

package/lib/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,KAAK,EAAE,MAAM,CAAA;IACb,iBAAiB,EAAE,MAAM,CAAA;CACzB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAS1D"}

package/lib/hash.js

@@ -0,0 +1,11 @@
+import { createHash } from 'node:crypto';
+export function getCacheKey(options) {
+    const payload = JSON.stringify([
+        options.input,
+        options.voice,
+        options.speed,
+        options.volume_multiplier,
+    ]);
+    return createHash('sha256').update(payload).digest('hex');
+}
+//# sourceMappingURL=hash.js.map

package/lib/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../src/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,UAAU,EAAC,MAAM,aAAa,CAAA;AAStC,MAAM,UAAU,WAAW,CAAC,OAAsB;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,OAAO,CAAC,KAAK;QACb,OAAO,CAAC,KAAK;QACb,OAAO,CAAC,KAAK;QACb,OAAO,CAAC,iBAAiB;KACzB,CAAC,CAAA;IAEF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC1D,CAAC"}

package/lib/server.d.ts

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { Hono } from 'hono';
+declare const app: Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+export { app };
+//# sourceMappingURL=server.d.ts.map

package/lib/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":";AAEA,OAAO,EAAC,IAAI,EAAC,MAAM,MAAM,CAAA;AAQzB,QAAA,MAAM,GAAG,4EAAa,CAAA;AAkNtB,OAAO,EAAC,GAAG,EAAC,CAAA"}

package/lib/server.js

@@ -0,0 +1,175 @@
+#!/usr/bin/env node
+import { serve } from '@hono/node-server';
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
+import { Readable } from 'node:stream';
+import { getSpeech } from './cache.js';
+import { config } from './config.js';
+import { closeStats } from './stats.js';
+const app = new Hono();
+app.use('*', cors({
+    origin: [
+        'http://localhost:35107',
+        'https://glaizme.web.app',
+        'https://gl-ai-z.win',
+    ],
+    allowMethods: ['GET', 'POST', 'OPTIONS'],
+    allowHeaders: ['Content-Type', 'Authorization'],
+}));
+app.get('/health', async (c) => {
+    try {
+        const response = await fetch(`${config.upstreamUrl}/health`, {
+            signal: AbortSignal.timeout(3000),
+        });
+        return new Response(response.body, {
+            status: response.status,
+            headers: {
+                'content-type': response.headers.get('content-type') ?? 'application/json',
+            },
+        });
+    }
+    catch {
+        return c.json({ status: 'unhealthy' }, 503);
+    }
+});
+app.get('/v1/voices', async (c) => {
+    try {
+        const response = await fetch(`${config.upstreamUrl}/v1/voices`, {
+            signal: AbortSignal.timeout(10_000),
+        });
+        const body = await response.arrayBuffer();
+        return new Response(body, {
+            status: response.status,
+            headers: {
+                'content-type': response.headers.get('content-type') ?? 'application/json',
+            },
+        });
+    }
+    catch {
+        return c.json({ error: 'Kokoro server unavailable' }, 502);
+    }
+});
+app.get('/v1/audio/speech', async (c) => {
+    const input = c.req.query('input');
+    const voice = c.req.query('voice');
+    const speed = Number(c.req.query('speed') ?? 1);
+    const volumeMultiplier = Number(c.req.query('volume_multiplier') ?? 1);
+    if (!input?.trim() || !voice?.trim()) {
+        return c.json({ error: 'input and voice must be non-empty strings' }, 400);
+    }
+    if (!Number.isFinite(speed) ||
+        speed <= 0 ||
+        !Number.isFinite(volumeMultiplier) ||
+        volumeMultiplier <= 0) {
+        return c.json({ error: 'speed and volume_multiplier must be positive numbers' }, 400);
+    }
+    try {
+        const audio = await getSpeech({
+            input,
+            voice,
+            speed,
+            volume_multiplier: volumeMultiplier,
+        });
+        const stream = audio.body instanceof Readable
+            ? Readable.toWeb(audio.body)
+            : Readable.toWeb(Readable.from([audio.body]));
+        return new Response(stream, {
+            headers: {
+                'content-type': 'audio/mpeg',
+                'content-length': String(audio.size),
+                // 'cache-control': 'private, max-age=86400',
+                'cache-control': 'private, max-age=31536000, immutable',
+            },
+        });
+    }
+    catch (error) {
+        console.error('Speech synthesis failed:', error);
+        return c.json({ error: 'Speech synthesis failed' }, 502);
+    }
+});
+app.post('/v1/audio/speech', async (c) => {
+    let body;
+    try {
+        body = await c.req.json();
+    }
+    catch {
+        return c.json({ error: 'Invalid JSON body' }, 400);
+    }
+    if (body === null || typeof body !== 'object' || Array.isArray(body)) {
+        return c.json({ error: 'Expected a JSON object' }, 400);
+    }
+    const input = body;
+    if (typeof input.input !== 'string' ||
+        input.input.trim().length === 0 ||
+        typeof input.voice !== 'string' ||
+        input.voice.trim().length === 0) {
+        return c.json({ error: 'input and voice must be non-empty strings' }, 400);
+    }
+    const speed = input.speed ?? 1;
+    const volumeMultiplier = input.volume_multiplier ?? 1;
+    if (typeof speed !== 'number' ||
+        !Number.isFinite(speed) ||
+        speed <= 0 ||
+        typeof volumeMultiplier !== 'number' ||
+        !Number.isFinite(volumeMultiplier) ||
+        volumeMultiplier <= 0) {
+        return c.json({ error: 'speed and volume_multiplier must be positive numbers' }, 400);
+    }
+    try {
+        const audio = await getSpeech({
+            input: input.input,
+            voice: input.voice,
+            speed,
+            volume_multiplier: volumeMultiplier,
+        });
+        const stream = audio.body instanceof Readable
+            ? Readable.toWeb(audio.body)
+            : Readable.toWeb(Readable.from([audio.body]));
+        return new Response(stream, {
+            headers: {
+                'content-type': 'audio/mpeg',
+                'content-length': String(audio.size),
+                'cache-control': 'no-store',
+            },
+        });
+    }
+    catch (error) {
+        console.error('Speech synthesis failed:', error);
+        return c.json({ error: 'Speech synthesis failed' }, 502);
+    }
+});
+const server = serve({
+    fetch: app.fetch,
+    hostname: config.host,
+    port: config.port,
+});
+console.log(`
+##############################
+#       Kokoro Proxy         #
+##############################
+# Server:  http://${config.host}:${config.port}
+# Cache:   ${config.cacheDir}
+# Upstream: ${config.upstreamUrl}
+##############################
+`);
+let shuttingDown = false;
+async function shutdown(signal) {
+    if (shuttingDown)
+        return;
+    shuttingDown = true;
+    console.log(`\nReceived ${signal}. Shutting down Kokoro Proxy...`);
+    server.close();
+    try {
+        await closeStats();
+        console.log('Usage stats flushed successfully.');
+    }
+    catch (error) {
+        console.error('Failed to flush usage stats:', error);
+        process.exitCode = 1;
+    }
+    console.log('Kokoro Proxy stopped.');
+}
+process.on('SIGINT', () => void shutdown('SIGINT'));
+process.on('SIGTERM', () => void shutdown('SIGTERM'));
+export { app };
+//# sourceMappingURL=server.js.map

package/lib/server.js.map

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

package/lib/stats.d.ts

@@ -0,0 +1,3 @@
+export declare function recordUsage(hash: string): void;
+export declare function closeStats(): Promise<void>;
+//# sourceMappingURL=stats.d.ts.map

package/lib/stats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stats.d.ts","sourceRoot":"","sources":["../src/stats.ts"],"names":[],"mappings":"AAmCA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAE9C;AAsDD,wBAAsB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAQhD"}

package/lib/stats.js

@@ -0,0 +1,80 @@
+import { randomUUID } from 'node:crypto';
+import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { config } from './config.js';
+const statsPath = join(config.cacheDir, 'stats.json');
+const pending = {};
+let flushPromise;
+async function readStats() {
+    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');
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return {};
+        }
+        throw error;
+    }
+}
+export function recordUsage(hash) {
+    pending[hash] = (pending[hash] ?? 0) + 1;
+}
+async function flushStats() {
+    const snapshot = { ...pending };
+    for (const hash of Object.keys(snapshot)) {
+        delete pending[hash];
+    }
+    if (Object.keys(snapshot).length === 0)
+        return;
+    try {
+        await mkdir(dirname(statsPath), { recursive: true });
+        const stats = await readStats();
+        for (const [hash, count] of Object.entries(snapshot)) {
+            stats[hash] = (stats[hash] ?? 0) + count;
+        }
+        const tempPath = `${statsPath}.${randomUUID()}.tmp`;
+        try {
+            await writeFile(tempPath, JSON.stringify(stats), 'utf8');
+            await rename(tempPath, statsPath);
+        }
+        catch (error) {
+            const { unlink } = await import('node:fs/promises');
+            await unlink(tempPath).catch(() => { });
+            throw error;
+        }
+    }
+    catch (error) {
+        for (const [hash, count] of Object.entries(snapshot)) {
+            pending[hash] = (pending[hash] ?? 0) + count;
+        }
+        throw error;
+    }
+}
+function scheduleFlush() {
+    if (flushPromise)
+        return;
+    flushPromise = flushStats()
+        .catch((error) => {
+        console.error('Failed to persist usage stats:', error);
+    })
+        .finally(() => {
+        flushPromise = undefined;
+    });
+}
+const timer = setInterval(scheduleFlush, config.statsFlushIntervalMs);
+timer.unref();
+export async function closeStats() {
+    clearInterval(timer);
+    if (flushPromise) {
+        await flushPromise;
+    }
+    await flushStats();
+}
+//# sourceMappingURL=stats.js.map

package/lib/stats.js.map

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

package/package.json

@@ -1,6 +1,52 @@
 {
-  "name": "@vdegenne/kokoro-proxy",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+	"name": "@vdegenne/kokoro-proxy",
+	"version": "0.1.2",
+	"description": "A lightweight Kokoro TTS proxy with audio caching and reusable utilities.",
+	"type": "module",
+	"exports": {
+		"./core": {
+			"types": "./lib/core.d.ts",
+			"import": "./lib/core.js"
+		}
+	},
+	"files": [
+		"lib"
+	],
+	"bin": {
+		"kokoro-proxy": "./lib/server.js"
+	},
+	"scripts": {
+		"build": "wireit",
+		"serve": "wireit"
+	},
+	"devDependencies": {
+		"@types/node": "^26.6.5",
+		"typescript": "^7.0.2",
+		"wireit": "^0.15.0"
+	},
+	"wireit": {
+		"build": {
+			"command": "tsc --pretty",
+			"clean": "if-file-deleted",
+			"files": [
+				"./tsconfig.json",
+				"./src"
+			],
+			"output": [
+				"./lib"
+			]
+		},
+		"serve": {
+			"service": true,
+			"command": "node ./lib/server.js",
+			"dependencies": [
+				"build"
+			],
+			"files": []
+		}
+	},
+	"dependencies": {
+		"@hono/node-server": "^2.1.5",
+		"hono": "^4.13.14"
+	}
+}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.