@pico-brief/speech-services 1.0.0

package/dist/transcribe.js

@@ -0,0 +1,55 @@
+import { SpeechServiceError } from "./errors.js";
+import * as assemblyai from "./providers/assemblyai/index.js";
+import * as azure from "./providers/azure/index.js";
+import * as deepgram from "./providers/deepgram/index.js";
+import * as elevenlabs from "./providers/elevenlabs/index.js";
+import * as google from "./providers/google/index.js";
+import * as openai from "./providers/openai/index.js";
+import * as revai from "./providers/revai/index.js";
+import * as speechmatics from "./providers/speechmatics/index.js";
+export async function transcribe(config, params) {
+    switch (params.provider) {
+        case "assemblyai": {
+            const cfg = requireConfig(config, "assemblyai", "AssemblyAI");
+            return assemblyai.transcribe(cfg, params.audio, params.languages, params.providerOptions);
+        }
+        case "azure": {
+            const cfg = requireConfig(config, "azure", "Azure");
+            return azure.transcribe(cfg, params.audio, params.languages, params.providerOptions);
+        }
+        case "deepgram": {
+            const cfg = requireConfig(config, "deepgram", "Deepgram");
+            return deepgram.transcribe(cfg, params.audio, params.languages, params.providerOptions);
+        }
+        case "elevenlabs": {
+            const cfg = requireConfig(config, "elevenlabs", "ElevenLabs");
+            return elevenlabs.transcribe(cfg, params.audio, params.languages, params.providerOptions);
+        }
+        case "google": {
+            const cfg = requireConfig(config, "google", "Google");
+            return google.transcribe(cfg, params.audio, params.languages, params.providerOptions);
+        }
+        case "openai": {
+            const cfg = requireConfig(config, "openai", "OpenAI");
+            return openai.transcribe(cfg, params.audio, params.languages, params.providerOptions);
+        }
+        case "revai": {
+            const cfg = requireConfig(config, "revai", "Rev.ai");
+            return revai.transcribe(cfg, params.audio, params.languages, params.providerOptions);
+        }
+        case "speechmatics": {
+            const cfg = requireConfig(config, "speechmatics", "Speechmatics");
+            return speechmatics.transcribe(cfg, params.audio, params.languages, params.providerOptions);
+        }
+        default:
+            throw new SpeechServiceError(`Unknown transcription provider: ${params.provider}`, "UNKNOWN_PROVIDER");
+    }
+}
+function requireConfig(config, provider, displayName) {
+    const providerConfig = config[provider];
+    if (!providerConfig) {
+        throw new SpeechServiceError(`${displayName} is not configured. Add "${provider}" to your config.`, "NOT_CONFIGURED", provider);
+    }
+    return providerConfig;
+}
+//# sourceMappingURL=transcribe.js.map

package/dist/transcribe.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,361 @@
+export interface AssemblyAIConfig {
+    apiKey: string;
+}
+export interface AzureConfig {
+    subscriptionKey: string;
+    region: string;
+}
+export interface CartesiaConfig {
+    apiKey: string;
+}
+export interface DeepgramConfig {
+    apiKey: string;
+}
+export interface ElevenLabsConfig {
+    apiKey: string;
+}
+export interface GoogleConfig {
+    apiKey: string;
+}
+export interface OpenAIConfig {
+    apiKey: string;
+}
+export interface PlayHTConfig {
+    apiKey: string;
+    userId: string;
+}
+export interface RevAIConfig {
+    apiKey: string;
+}
+export interface SpeechmaticsConfig {
+    apiKey: string;
+    /** Regional endpoint. Default: "eu1". Options: "eu1", "us1", "au1" */
+    region?: string;
+}
+export interface ClientConfig {
+    assemblyai?: AssemblyAIConfig;
+    azure?: AzureConfig;
+    cartesia?: CartesiaConfig;
+    deepgram?: DeepgramConfig;
+    elevenlabs?: ElevenLabsConfig;
+    google?: GoogleConfig;
+    openai?: OpenAIConfig;
+    playht?: PlayHTConfig;
+    revai?: RevAIConfig;
+    speechmatics?: SpeechmaticsConfig;
+}
+export interface AssemblyAITranscribeOptions {
+    /** Speech model to use. Default: "universal" */
+    speechModel?: string;
+    /** How often to check if transcription is done (ms). Default: 3000 */
+    pollInterval?: number;
+    /** Max time to wait for transcription (ms). Default: 300000 (5 min) */
+    timeout?: number;
+}
+export interface AzureTranscribeOptions {
+    /** Transcription mode. "fast" is synchronous, "batch" requires a URL. Default: "fast" */
+    mode?: "fast" | "batch";
+    /** Profanity handling. Default: "none" */
+    profanityFilter?: "none" | "masked" | "removed";
+    /** How often to check if batch transcription is done (ms). Default: 5000 */
+    pollInterval?: number;
+    /** Max time to wait for batch transcription (ms). Default: 300000 (5 min) */
+    timeout?: number;
+}
+export interface DeepgramTranscribeOptions {
+    /** STT model. Default: "nova-2" */
+    model?: string;
+    /** Enable smart formatting (punctuation, capitalization, numerals). Default: true */
+    smartFormat?: boolean;
+    /** Enable speaker diarization. Default: false */
+    diarize?: boolean;
+}
+export interface ElevenLabsTranscribeOptions {
+    /** Speech-to-text model. Default: "scribe_v2" */
+    model?: string;
+}
+export interface GoogleTranscribeOptions {
+    /** Recognition model. Default: "latest_long" */
+    model?: string;
+    /** Audio encoding (only needed for raw audio without headers). Examples: "LINEAR16", "FLAC", "MP3" */
+    encoding?: string;
+    /** Sample rate in Hz (only needed for raw audio without headers). */
+    sampleRateHertz?: number;
+}
+export interface OpenAITranscribeOptions {
+    /** STT model. Default: "whisper-1". Options: "whisper-1", "gpt-4o-transcribe", "gpt-4o-mini-transcribe" */
+    model?: string;
+    /** Optional prompt to guide the model's style. */
+    prompt?: string;
+    /** Sampling temperature (0 to 1). Default: 0 */
+    temperature?: number;
+}
+export interface RevAITranscribeOptions {
+    /** Skip speaker diarization. Default: false */
+    skipDiarization?: boolean;
+    /** Skip punctuation. Default: false */
+    skipPunctuation?: boolean;
+    /** Filter profanity. Default: false */
+    filterProfanity?: boolean;
+    /** How often to check if transcription is done (ms). Default: 5000 */
+    pollInterval?: number;
+    /** Max time to wait for transcription (ms). Default: 300000 (5 min) */
+    timeout?: number;
+}
+export interface SpeechmaticsTranscribeOptions {
+    /** Operating point. "standard" is faster, "enhanced" is more accurate. Default: "enhanced" */
+    operatingPoint?: "standard" | "enhanced";
+    /** Enable speaker diarization. Default: false */
+    diarization?: "none" | "speaker";
+    /** How often to check if transcription is done (ms). Default: 5000 */
+    pollInterval?: number;
+    /** Max time to wait for transcription (ms). Default: 300000 (5 min) */
+    timeout?: number;
+}
+export type TranscribeProvider = "assemblyai" | "azure" | "deepgram" | "elevenlabs" | "google" | "openai" | "revai" | "speechmatics";
+export type TranscribeParams = ({
+    provider: "assemblyai";
+    audio: Buffer | string;
+    /** BCP-47 language codes. One → sets language, multiple → enables code-switching. Omit for auto-detection. */
+    languages?: string[];
+    providerOptions?: AssemblyAITranscribeOptions;
+}) | ({
+    provider: "azure";
+    audio: Buffer | string;
+    /** BCP-47 language codes. Passed as candidate locales for language identification. Omit for multilingual model. */
+    languages?: string[];
+    providerOptions?: AzureTranscribeOptions;
+}) | ({
+    provider: "deepgram";
+    audio: Buffer | string;
+    /** Language code (e.g. "en", "en-US", "multi"). Default: "en". */
+    languages?: string[];
+    providerOptions?: DeepgramTranscribeOptions;
+}) | ({
+    provider: "elevenlabs";
+    audio: Buffer | string;
+    /** BCP-47 language codes. Only the first one is used (ElevenLabs accepts a single language). Omit for auto-detection. */
+    languages?: string[];
+    providerOptions?: ElevenLabsTranscribeOptions;
+}) | ({
+    provider: "google";
+    audio: Buffer | string;
+    /** BCP-47 language codes. First is primary, rest are alternatives (up to 3 extra). Required by Google — defaults to ["en-US"]. */
+    languages?: string[];
+    providerOptions?: GoogleTranscribeOptions;
+}) | ({
+    provider: "openai";
+    audio: Buffer | string;
+    /** ISO 639-1 language code (e.g. "en", "es"). Omit for auto-detection. Only the first element is used. */
+    languages?: string[];
+    providerOptions?: OpenAITranscribeOptions;
+}) | ({
+    provider: "revai";
+    audio: Buffer | string;
+    /** ISO 639-1 language code. Only the first element is used. Default: "en". */
+    languages?: string[];
+    providerOptions?: RevAITranscribeOptions;
+}) | ({
+    provider: "speechmatics";
+    audio: Buffer | string;
+    /** Language code (e.g. "en", "fr", "auto"). Only the first element is used. Default: "en". */
+    languages?: string[];
+    providerOptions?: SpeechmaticsTranscribeOptions;
+});
+export interface TranscribedWord {
+    text: string;
+    /** Start time in seconds */
+    startTime: number;
+    /** End time in seconds */
+    endTime: number;
+    /** Confidence score (0 to 1). Not all providers return this. */
+    confidence?: number;
+    /** Speaker label, if diarization was enabled. */
+    speaker?: string;
+}
+export interface TranscribeResult {
+    /** Full transcript text */
+    text: string;
+    /** Word-level timestamps */
+    words: TranscribedWord[];
+    /** Detected or specified language (normalized to BCP-47, e.g. "en-US") */
+    language: string;
+    /** Audio duration in seconds */
+    duration: number;
+}
+export interface VoiceInfo {
+    /** The value to pass to the provider (Azure ShortName, ElevenLabs voice_id, Google name) */
+    id: string;
+    /** Human-readable display name */
+    name: string;
+    /** Voice gender, if known */
+    gender?: "male" | "female";
+    /** BCP-47 locale like "en-US" */
+    locale: string;
+    /** Which TTS provider this voice belongs to */
+    provider: SynthesizeProvider;
+}
+export type SynthesizeProvider = "azure" | "cartesia" | "deepgram" | "elevenlabs" | "google" | "openai" | "playht";
+export interface AzureSynthesizeOptions {
+    /** Azure output format string. Default: "audio-24khz-160kbitrate-mono-mp3" */
+    outputFormat?: string;
+    /** Speaking rate. Examples: "-5%", "+10%", "slow", "fast". Default: "-5%" */
+    speed?: string;
+    /** Pitch adjustment. Examples: "+5%", "-10%" */
+    pitch?: string;
+    /** Speaking style. Examples: "cheerful", "sad", "angry" */
+    style?: string;
+}
+export interface CartesiaSynthesizeOptions {
+    /** Model ID. Default: "sonic-3" */
+    modelId?: string;
+    /** Output container format. Default: "wav" */
+    container?: "wav" | "mp3" | "raw";
+    /** PCM encoding (for wav/raw containers). Default: "pcm_s16le" */
+    encoding?: string;
+    /** Sample rate in Hz. Default: 24000 */
+    sampleRate?: number;
+    /** Speech speed (0.6 to 1.5). Default: 1.0 */
+    speed?: number;
+    /** Emotion. Default: "neutral". Options: "neutral", "happy", "sad", "angry", "surprised", etc. */
+    emotion?: string;
+}
+export interface DeepgramSynthesizeOptions {
+    /** Audio encoding. Default: "mp3". Options: "mp3", "linear16", "mulaw", "alaw", "opus", "flac", "aac" */
+    encoding?: string;
+    /** Audio container. Examples: "wav", "ogg". Only needed for certain encodings. */
+    container?: string;
+    /** Sample rate in Hz. */
+    sampleRate?: number;
+}
+export interface ElevenLabsSynthesizeOptions {
+    /** TTS model. Default: "eleven_multilingual_v2" */
+    modelId?: string;
+    /** Output format. Default: "mp3_44100_128" */
+    outputFormat?: string;
+    /** Voice consistency (0 to 1). Lower = more expressive. Default: 0.5 */
+    stability?: number;
+    /** Voice similarity (0 to 1). Higher = closer to original voice. Default: 0.75 */
+    similarityBoost?: number;
+    /** Style exaggeration (0 to 1). Higher = more expressive but slower. Default: 0 */
+    style?: number;
+    /** Speech speed (0.7 to 1.2). Default: 1.0 */
+    speed?: number;
+}
+export interface GoogleSynthesizeOptions {
+    /** Audio encoding. Default: "MP3". Options: "MP3", "LINEAR16", "OGG_OPUS" */
+    audioEncoding?: string;
+    /** Speaking rate (0.25 to 2.0). Default: 1.0 */
+    speakingRate?: number;
+    /** Pitch in semitones (-20 to 20). Default: 0 */
+    pitch?: number;
+}
+export interface OpenAISynthesizeOptions {
+    /** TTS model. Default: "tts-1". Options: "tts-1", "tts-1-hd", "gpt-4o-mini-tts" */
+    model?: string;
+    /** Output format. Default: "mp3". Options: "mp3", "opus", "aac", "flac", "wav", "pcm" */
+    responseFormat?: string;
+    /** Speech speed (0.25 to 4.0). Default: 1.0 */
+    speed?: number;
+    /** Instructions for tone/style. Only works with gpt-4o-mini-tts. */
+    instructions?: string;
+}
+export interface PlayHTSynthesizeOptions {
+    /** Voice engine. Default: "Play3.0-mini" */
+    voiceEngine?: string;
+    /** Output format. Default: "mp3". Options: "mp3", "wav", "ogg", "flac", "mulaw" */
+    outputFormat?: string;
+    /** Speech speed (0.1 to 5.0). Default: 1.0 */
+    speed?: number;
+    /** Sample rate in Hz (8000 to 48000). */
+    sampleRate?: number;
+    /** Audio quality. Options: "draft", "low", "medium", "high", "premium" */
+    quality?: string;
+}
+export type SynthesizeParams = ({
+    provider: "azure";
+    text: string;
+    voice?: string;
+    gender?: "male" | "female";
+    languages?: string[];
+    providerOptions?: AzureSynthesizeOptions;
+}) | ({
+    provider: "cartesia";
+    text: string;
+    voice?: string;
+    gender?: "male" | "female";
+    languages?: string[];
+    providerOptions?: CartesiaSynthesizeOptions;
+}) | ({
+    provider: "deepgram";
+    text: string;
+    voice?: string;
+    gender?: "male" | "female";
+    languages?: string[];
+    providerOptions?: DeepgramSynthesizeOptions;
+}) | ({
+    provider: "elevenlabs";
+    text: string;
+    voice?: string;
+    gender?: "male" | "female";
+    languages?: string[];
+    providerOptions?: ElevenLabsSynthesizeOptions;
+}) | ({
+    provider: "google";
+    text: string;
+    voice?: string;
+    gender?: "male" | "female";
+    languages?: string[];
+    providerOptions?: GoogleSynthesizeOptions;
+}) | ({
+    provider: "openai";
+    text: string;
+    voice?: string;
+    gender?: "male" | "female";
+    languages?: string[];
+    providerOptions?: OpenAISynthesizeOptions;
+}) | ({
+    provider: "playht";
+    text: string;
+    voice?: string;
+    gender?: "male" | "female";
+    languages?: string[];
+    providerOptions?: PlayHTSynthesizeOptions;
+});
+export interface SynthesizeResult {
+    /** Audio data as a Buffer */
+    audio: Buffer;
+    /** Audio format (e.g. "mp3", "wav", "ogg") */
+    format: string;
+    /** The resolved voice ID that was used for synthesis */
+    voice: string;
+}
+export type DetectLocalesProvider = "assemblyai" | "azure" | "deepgram" | "elevenlabs" | "openai" | "speechmatics";
+export interface DetectLocalesParams {
+    /** Audio to analyze. Buffer or URL string. */
+    audio: Buffer | string;
+    /** STT provider to use for language detection. Must support auto-detection. */
+    provider: DetectLocalesProvider;
+    /**
+     * Path to ffmpeg binary. Enables efficient sampling for long audio files.
+     * Short clips (~10s each) are extracted from different positions in the audio
+     * and language detection runs on each clip. ffprobe must be in the same directory.
+     *
+     * Without ffmpeg, only the first portion of the audio is analyzed (see maxBytes).
+     */
+    ffmpegPath?: string;
+    /**
+     * Maximum bytes of audio to analyze when ffmpeg is not available.
+     * Truncates the Buffer to save cost on long files. Only applies to Buffer input.
+     * Default: 500_000 (~30 seconds of 128kbps MP3). Ignored when ffmpegPath is provided.
+     */
+    maxBytes?: number;
+}
+export type FetchVoicesProvider = SynthesizeProvider;
+export interface SpeechClient {
+    transcribe(params: TranscribeParams): Promise<TranscribeResult>;
+    synthesize(params: SynthesizeParams): Promise<SynthesizeResult>;
+    detectLocales(params: DetectLocalesParams): Promise<Map<string, number>>;
+    fetchVoices(provider: FetchVoicesProvider): Promise<VoiceInfo[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,3 @@
+// ─── Provider Configuration ─────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,+EAA+E"}

package/dist/utils.d.ts

@@ -0,0 +1,19 @@
+export declare function poll<T>(fn: () => Promise<T>, isDone: (result: T) => boolean, interval: number, timeout: number, provider: string): Promise<T>;
+/**
+ * Normalizes a language code to BCP-47 format.
+ *
+ * Handles:
+ * - AssemblyAI format: "en_us" → "en-US"
+ * - ElevenLabs ISO 639-3: "eng" → "en"
+ * - Already BCP-47: "en-US" → "en-US" (passthrough)
+ * - Lowercase BCP-47: "en-us" → "en-US"
+ */
+export declare function normalizeLanguageCode(code: string): string;
+/**
+ * Extracts the base language from a BCP-47 code (e.g., "en-US" → "en").
+ */
+export declare function getBaseLanguage(code: string): string;
+export declare function isUrl(input: string): boolean;
+export declare function downloadAudio(url: string): Promise<Buffer>;
+export declare function detectFormatFromString(format: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,wBAAsB,IAAI,CAAC,CAAC,EACxB,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACjB,OAAO,CAAC,CAAC,CAAC,CAcZ;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA6B1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD;AAID,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE5C;AAED,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUhE;AAID,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAS7D"}

package/dist/utils.js

@@ -0,0 +1,101 @@
+import { SpeechServiceError } from "./errors.js";
+// ─── Polling ────────────────────────────────────────────────────────────────
+export async function poll(fn, isDone, interval, timeout, provider) {
+    const start = Date.now();
+    while (true) {
+        const result = await fn();
+        if (isDone(result))
+            return result;
+        if (Date.now() - start > timeout) {
+            throw new SpeechServiceError(`Transcription timed out after ${timeout}ms`, "TIMEOUT", provider);
+        }
+        await new Promise((resolve) => setTimeout(resolve, interval));
+    }
+}
+// ─── Language Code Normalization ────────────────────────────────────────────
+const ISO_639_3_TO_1 = {
+    eng: "en", spa: "es", fra: "fr", deu: "de", ita: "it",
+    por: "pt", nld: "nl", rus: "ru", zho: "zh", jpn: "ja",
+    kor: "ko", ara: "ar", hin: "hi", tur: "tr", pol: "pl",
+    swe: "sv", nor: "no", dan: "da", fin: "fi", ces: "cs",
+    ron: "ro", hun: "hu", ell: "el", heb: "he", tha: "th",
+    vie: "vi", ind: "id", msa: "ms", ukr: "uk", cat: "ca",
+    hrv: "hr", bul: "bg", slk: "sk", slv: "sl", lit: "lt",
+    lav: "lv", est: "et", fil: "fil", tam: "ta", tel: "te",
+    ben: "bn", urd: "ur", fas: "fa", afr: "af", swa: "sw",
+    cmn: "zh", yue: "yue",
+};
+/**
+ * Normalizes a language code to BCP-47 format.
+ *
+ * Handles:
+ * - AssemblyAI format: "en_us" → "en-US"
+ * - ElevenLabs ISO 639-3: "eng" → "en"
+ * - Already BCP-47: "en-US" → "en-US" (passthrough)
+ * - Lowercase BCP-47: "en-us" → "en-US"
+ */
+export function normalizeLanguageCode(code) {
+    if (!code)
+        return code;
+    // ISO 639-3 (3-letter code with no region)
+    const lower = code.toLowerCase();
+    if (lower.length === 3 && ISO_639_3_TO_1[lower]) {
+        return ISO_639_3_TO_1[lower];
+    }
+    // AssemblyAI underscore format: "en_us" → "en-US"
+    if (code.includes("_")) {
+        const parts = code.split("_");
+        if (parts.length === 2) {
+            return `${parts[0].toLowerCase()}-${parts[1].toUpperCase()}`;
+        }
+        return code;
+    }
+    // BCP-47 with region: "en-us" → "en-US"
+    if (code.includes("-")) {
+        const parts = code.split("-");
+        if (parts.length === 2 && parts[1].length === 2) {
+            return `${parts[0].toLowerCase()}-${parts[1].toUpperCase()}`;
+        }
+        return code;
+    }
+    // Just a 2-letter code like "en", return as-is
+    return code.toLowerCase();
+}
+/**
+ * Extracts the base language from a BCP-47 code (e.g., "en-US" → "en").
+ */
+export function getBaseLanguage(code) {
+    if (!code)
+        return code;
+    return code.split("-")[0].split("_")[0].toLowerCase();
+}
+// ─── Audio Input Helpers ────────────────────────────────────────────────────
+export function isUrl(input) {
+    return input.startsWith("http://") || input.startsWith("https://") || input.startsWith("gs://");
+}
+export async function downloadAudio(url) {
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new SpeechServiceError(`Failed to download audio from ${url}: ${response.status} ${response.statusText}`, "DOWNLOAD_FAILED");
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    return Buffer.from(arrayBuffer);
+}
+// ─── Output Format Detection ────────────────────────────────────────────────
+export function detectFormatFromString(format) {
+    const lower = format.toLowerCase();
+    if (lower.includes("mp3") || lower.includes("mpeg"))
+        return "mp3";
+    if (lower.includes("wav") || lower.includes("pcm") || lower.includes("riff") || lower.includes("linear16"))
+        return "wav";
+    if (lower.includes("ogg") || lower.includes("opus"))
+        return "ogg";
+    if (lower.includes("webm"))
+        return "webm";
+    if (lower.includes("flac"))
+        return "flac";
+    if (lower.includes("alaw") || lower.includes("mulaw") || lower.includes("ulaw"))
+        return "wav";
+    return "mp3";
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/dist/voice-cache.d.ts

@@ -0,0 +1,9 @@
+import type { VoiceInfo } from "./types.js";
+export declare class VoiceCache {
+    private cache;
+    private ttl;
+    constructor(ttl?: number);
+    get(key: string): VoiceInfo[] | undefined;
+    set(key: string, voices: VoiceInfo[]): void;
+}
+//# sourceMappingURL=voice-cache.d.ts.map

package/dist/voice-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-cache.d.ts","sourceRoot":"","sources":["../src/voice-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAO5C,qBAAa,UAAU;IACnB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,GAAG,CAAS;gBAER,GAAG,SAAY;IAI3B,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,EAAE,GAAG,SAAS;IAUzC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI;CAG9C"}

package/dist/voice-cache.js

@@ -0,0 +1,21 @@
+export class VoiceCache {
+    cache = new Map();
+    ttl;
+    constructor(ttl = 3_600_000) {
+        this.ttl = ttl;
+    }
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expires) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return entry.voices;
+    }
+    set(key, voices) {
+        this.cache.set(key, { voices, expires: Date.now() + this.ttl });
+    }
+}
+//# sourceMappingURL=voice-cache.js.map

package/dist/voice-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-cache.js","sourceRoot":"","sources":["../src/voice-cache.ts"],"names":[],"mappings":"AAOA,MAAM,OAAO,UAAU;IACX,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;IACtC,GAAG,CAAS;IAEpB,YAAY,GAAG,GAAG,SAAS;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACnB,CAAC;IAED,GAAG,CAAC,GAAW;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAC7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;YAC7B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,KAAK,CAAC,MAAM,CAAC;IACxB,CAAC;IAED,GAAG,CAAC,GAAW,EAAE,MAAmB;QAChC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACpE,CAAC;CACJ"}

package/dist/voice-resolver.d.ts

@@ -0,0 +1,7 @@
+import type { VoiceInfo } from "./types.js";
+export declare function resolveVoice(voices: VoiceInfo[], params: {
+    voice?: string;
+    language?: string;
+    gender?: "male" | "female";
+}): VoiceInfo;
+//# sourceMappingURL=voice-resolver.d.ts.map

package/dist/voice-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"voice-resolver.d.ts","sourceRoot":"","sources":["../src/voice-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,wBAAgB,YAAY,CACxB,MAAM,EAAE,SAAS,EAAE,EACnB,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;CAAE,GAC1E,SAAS,CAKX"}