@voice-kit/core 0.1.2 → 0.1.3

package/dist/tts.d.ts

@@ -1,151 +0,0 @@
-import { e as TTSProvider, f as TTSConfig } from './index-D3KfRXMP.js';
-import 'ai';
-
-/**
- * @voice-kit/core — Cartesia TTS Provider
- *
- * Ultra-low-latency streaming TTS via @cartesia/cartesia-js.
- * Target first chunk: < 90ms. Best for latency-critical applications.
- */
-
-/**
- * Cartesia ultra-low-latency TTS provider.
- * @internal — obtained via createTTS('cartesia', config)
- */
-declare class CartesiaTTSProvider implements TTSProvider {
-    readonly name = "cartesia";
-    readonly outputSampleRate = 22050;
-    readonly outputFormat: "pcm";
-    private readonly client;
-    private readonly config;
-    constructor(config: TTSConfig);
-    /**
-     * Stream audio from Cartesia. Typically delivers first chunk in < 90ms.
-     *
-     * @example
-     * ```ts
-     * const tts = createTTS('cartesia', { voiceId: 'your-voice-id' })
-     * for await (const chunk of tts.synthesizeStream('Hello!')) {
-     *   sendToTelephony(chunk)
-     * }
-     * ```
-     */
-    synthesizeStream(text: string, config?: TTSConfig): AsyncIterable<Buffer>;
-    /** Synthesize complete audio. */
-    synthesizeFull(text: string, config?: TTSConfig): Promise<Buffer>;
-}
-
-/**
- * @voice-kit/core — ElevenLabs TTS Provider
- *
- * Streaming TTS using ElevenLabs SDK. Features:
- * - 100ms lookahead jitter buffer to smooth burst delivery
- * - Voice clone support
- * - Sub-300ms first chunk target
- */
-
-/**
- * ElevenLabs streaming TTS provider.
- * @internal — obtained via createTTS('elevenlabs', config)
- */
-declare class ElevenLabsTTSProvider implements TTSProvider {
-    readonly name = "elevenlabs";
-    readonly outputSampleRate = 24000;
-    readonly outputFormat: "pcm";
-    private readonly client;
-    private readonly config;
-    constructor(config: TTSConfig);
-    /**
-     * Stream synthesized audio from ElevenLabs.
-     * First chunk target: < 300ms. Uses streaming API endpoint.
-     *
-     * A 100ms jitter buffer smooths burst packet delivery without adding
-     * perceptible latency.
-     *
-     * @param text    Text to synthesize (should be a sentence boundary chunk)
-     * @param config  Per-call config overrides
-     *
-     * @example
-     * ```ts
-     * const tts = createTTS('elevenlabs', { voiceId: 'your-voice-id' })
-     * for await (const chunk of tts.synthesizeStream('Hello, how can I help?')) {
-     *   telephony.sendAudio(chunk)
-     * }
-     * ```
-     */
-    synthesizeStream(text: string, config?: TTSConfig): AsyncIterable<Buffer>;
-    /**
-     * Synthesize full audio (for pre-caching greetings, IVR prompts).
-     * Collects all streaming chunks into a single buffer.
-     *
-     * @param text    Text to synthesize
-     * @param config  Per-call config overrides
-     */
-    synthesizeFull(text: string, config?: TTSConfig): Promise<Buffer>;
-}
-
-/**
- * @voice-kit/core — Sarvam AI TTS Provider
- *
- * Sarvam AI TTS for Hindi/Hinglish and regional Indian languages.
- * Supports natural-sounding Indian voices with regional accents.
- */
-
-/**
- * Sarvam AI TTS provider for Indic languages.
- * @internal — obtained via createTTS('sarvam', config)
- */
-declare class SarvamTTSProvider implements TTSProvider {
-    readonly name = "sarvam";
-    readonly outputSampleRate = 22050;
-    readonly outputFormat: "mp3";
-    private readonly http;
-    private readonly config;
-    constructor(config: TTSConfig);
-    /**
-     * Synthesize text in an Indic language and stream audio chunks.
-     * Sarvam returns full audio segments — we chunk them for streaming compatibility.
-     *
-     * @example
-     * ```ts
-     * const tts = createTTS('sarvam', { targetLanguage: 'hi-IN' })
-     * for await (const chunk of tts.synthesizeStream('नमस्ते, मैं आपकी कैसे मदद कर सकता हूँ?')) {
-     *   telephony.sendAudio(chunk)
-     * }
-     * ```
-     */
-    synthesizeStream(text: string, config?: TTSConfig): AsyncIterable<Buffer>;
-    /** Synthesize complete audio buffer. */
-    synthesizeFull(text: string, config?: TTSConfig): Promise<Buffer>;
-}
-
-/**
- * @voice-kit/core — TTS factory
- *
- * createTTS() is the ONLY public API for text-to-speech.
- * Never instantiate provider classes directly.
- */
-
-/**
- * Create a TTS provider instance.
- *
- * Provider selection guide:
- * - 'elevenlabs'  → Best voice quality, cloning support, en-IN
- * - 'cartesia'    → Lowest latency (< 90ms TTFB), good for fast-paced agents
- * - 'sarvam'      → Best for Indic languages (hi-IN, ta-IN, kn-IN, te-IN, mr-IN)
- *
- * @example
- * ```ts
- * // English with voice cloning
- * const tts = createTTS('elevenlabs', { voiceId: 'your-cloned-voice-id' })
- *
- * // Ultra-low latency English
- * const tts = createTTS('cartesia', { voiceId: 'your-voice-id' })
- *
- * // Hindi
- * const tts = createTTS('sarvam', { targetLanguage: 'hi-IN', voiceId: 'meera' })
- * ```
- */
-declare function createTTS(provider: 'elevenlabs' | 'cartesia' | 'sarvam', config?: TTSConfig): TTSProvider;
-
-export { CartesiaTTSProvider, ElevenLabsTTSProvider, SarvamTTSProvider, createTTS };

package/dist/tts.js

@@ -1,418 +0,0 @@
-import Cartesia from '@cartesia/cartesia-js';
-import pino from 'pino';
-import { ElevenLabsClient } from 'elevenlabs';
-import axios from 'axios';
-
-// src/tts/cartesia/index.ts
-
-// src/errors/base.ts
-var VoiceKitError = class extends Error {
-  code;
-  callId;
-  provider;
-  retryable;
-  severity;
-  cause;
-  constructor(params) {
-    super(params.message);
-    this.name = this.constructor.name;
-    this.code = params.code;
-    this.callId = params.callId;
-    this.provider = params.provider;
-    this.retryable = params.retryable ?? false;
-    this.severity = params.severity ?? "medium";
-    this.cause = params.cause;
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-  toJSON() {
-    return {
-      name: this.name,
-      code: this.code,
-      message: this.message,
-      callId: this.callId,
-      provider: this.provider,
-      retryable: this.retryable,
-      severity: this.severity
-    };
-  }
-};
-
-// src/errors/tts.errors.ts
-var TTSError = class extends VoiceKitError {
-};
-var TTSConnectionError = class extends TTSError {
-  constructor(provider, cause, callId) {
-    super({
-      code: "TTS_CONNECTION_FAILED",
-      message: `Failed to connect to ${provider} TTS service`,
-      provider,
-      callId,
-      retryable: true,
-      severity: "high",
-      cause
-    });
-  }
-};
-var TTSStreamError = class extends TTSError {
-  constructor(provider, cause, callId) {
-    super({
-      code: "TTS_STREAM_ERROR",
-      message: `TTS stream error from ${provider}`,
-      provider,
-      callId,
-      retryable: true,
-      severity: "medium",
-      cause
-    });
-  }
-};
-var TTSVoiceNotFoundError = class extends TTSError {
-  constructor(provider, voiceId) {
-    super({
-      code: "TTS_VOICE_NOT_FOUND",
-      message: `Voice '${voiceId}' not found on ${provider}`,
-      provider,
-      retryable: false,
-      severity: "low"
-    });
-  }
-};
-var logger = pino({ name: "@voice-kit/core:tts:cartesia" });
-var DEFAULT_VOICE_ID = "a0e99841-438c-4a64-b679-ae501e7d6091";
-var CartesiaTTSProvider = class {
-  name = "cartesia";
-  outputSampleRate = 22050;
-  // Cartesia default
-  outputFormat = "pcm";
-  client;
-  config;
-  constructor(config) {
-    const apiKey = config.apiKey ?? process.env["CARTESIA_API_KEY"];
-    if (!apiKey) throw new TTSConnectionError("cartesia", new Error("CARTESIA_API_KEY not set"));
-    this.client = new Cartesia({ apiKey });
-    this.config = {
-      voiceId: config.voiceId ?? DEFAULT_VOICE_ID,
-      sampleRate: config.sampleRate ?? 22050,
-      speed: config.speed ?? 1,
-      pitch: config.pitch ?? 0,
-      apiKey,
-      modelId: config.modelId ?? "sonic-english",
-      emotion: config.emotion ?? "",
-      targetLanguage: config.targetLanguage ?? "en"
-    };
-  }
-  /**
-   * Stream audio from Cartesia. Typically delivers first chunk in < 90ms.
-   *
-   * @example
-   * ```ts
-   * const tts = createTTS('cartesia', { voiceId: 'your-voice-id' })
-   * for await (const chunk of tts.synthesizeStream('Hello!')) {
-   *   sendToTelephony(chunk)
-   * }
-   * ```
-   */
-  async *synthesizeStream(text, config) {
-    const voiceId = config?.voiceId ?? this.config.voiceId;
-    const startMs = Date.now();
-    logger.debug({ voiceId, chars: text.length }, "Cartesia TTS stream start");
-    try {
-      const stream = await this.client.tts.generateSse({
-        model_id: config?.modelId ?? this.config.modelId,
-        transcript: text,
-        voice: {
-          mode: "id",
-          id: voiceId,
-          ...this.config.emotion && {
-            __experimental_controls: {
-              emotion: [this.config.emotion]
-            }
-          }
-        },
-        output_format: {
-          container: "raw",
-          encoding: "pcm_s16le",
-          sample_rate: toValidSampleRate(config?.sampleRate ?? this.config.sampleRate)
-        }
-      });
-      let firstChunk = true;
-      for await (const event of stream) {
-        if (!event.data || event.data === "[DONE]") continue;
-        let payload;
-        try {
-          payload = JSON.parse(event.data);
-        } catch {
-          continue;
-        }
-        if (!payload.chunk?.audio) continue;
-        const buf = Buffer.from(payload.chunk.audio, "base64");
-        if (firstChunk) {
-          firstChunk = false;
-          logger.debug({ ttfb: Date.now() - startMs, voiceId }, "Cartesia first audio chunk");
-        }
-        yield buf;
-      }
-    } catch (err) {
-      throw new TTSStreamError("cartesia", err);
-    }
-  }
-  /** Synthesize complete audio. */
-  async synthesizeFull(text, config) {
-    const chunks = [];
-    for await (const chunk of this.synthesizeStream(text, config)) {
-      chunks.push(chunk);
-    }
-    return Buffer.concat(chunks);
-  }
-};
-var VALID_SAMPLE_RATES = [22050, 8e3, 16e3, 24e3, 44100, 48e3];
-function toValidSampleRate(rate) {
-  return VALID_SAMPLE_RATES.includes(rate) ? rate : 8e3;
-}
-var logger2 = pino({ name: "@voice-kit/core:tts:elevenlabs" });
-var DEFAULT_VOICE_ID2 = "21m00Tcm4TlvDq8ikWAM";
-var JITTER_BUFFER_MS = 100;
-var ElevenLabsTTSProvider = class {
-  name = "elevenlabs";
-  outputSampleRate = 24e3;
-  // ElevenLabs default: 24kHz
-  outputFormat = "pcm";
-  client;
-  config;
-  constructor(config) {
-    const apiKey = config.apiKey ?? process.env["ELEVENLABS_API_KEY"];
-    if (!apiKey) throw new TTSConnectionError("elevenlabs", new Error("ELEVENLABS_API_KEY not set"));
-    this.client = new ElevenLabsClient({ apiKey });
-    this.config = {
-      voiceId: config.voiceId ?? DEFAULT_VOICE_ID2,
-      sampleRate: config.sampleRate ?? 24e3,
-      speed: config.speed ?? 1,
-      pitch: config.pitch ?? 0,
-      apiKey,
-      modelId: config.modelId ?? "eleven_turbo_v2_5",
-      emotion: config.emotion ?? "",
-      targetLanguage: config.targetLanguage ?? "en-IN"
-    };
-  }
-  /**
-   * Stream synthesized audio from ElevenLabs.
-   * First chunk target: < 300ms. Uses streaming API endpoint.
-   *
-   * A 100ms jitter buffer smooths burst packet delivery without adding
-   * perceptible latency.
-   *
-   * @param text    Text to synthesize (should be a sentence boundary chunk)
-   * @param config  Per-call config overrides
-   *
-   * @example
-   * ```ts
-   * const tts = createTTS('elevenlabs', { voiceId: 'your-voice-id' })
-   * for await (const chunk of tts.synthesizeStream('Hello, how can I help?')) {
-   *   telephony.sendAudio(chunk)
-   * }
-   * ```
-   */
-  async *synthesizeStream(text, config) {
-    const voiceId = config?.voiceId ?? this.config.voiceId;
-    const modelId = config?.modelId ?? this.config.modelId;
-    const startMs = Date.now();
-    logger2.debug({ voiceId, modelId, chars: text.length }, "ElevenLabs TTS stream start");
-    try {
-      const audioStream = await this.client.generate({
-        voice: voiceId,
-        text,
-        model_id: modelId,
-        voice_settings: {
-          stability: 0.5,
-          similarity_boost: 0.8,
-          speed: config?.speed ?? this.config.speed
-        },
-        output_format: "pcm_24000",
-        stream: true
-      });
-      let firstChunk = true;
-      let jitterBuffer = [];
-      let jitterTimer = null;
-      const flushJitterBuffer = function* () {
-        for (const chunk of jitterBuffer) {
-          yield chunk;
-        }
-        jitterBuffer = [];
-      };
-      for await (const chunk of audioStream) {
-        const buf = chunk instanceof Buffer ? chunk : Buffer.from(chunk);
-        if (firstChunk) {
-          firstChunk = false;
-          const ttfb = Date.now() - startMs;
-          logger2.debug({ ttfb, voiceId }, "ElevenLabs first audio chunk");
-        }
-        jitterBuffer.push(buf);
-        if (jitterTimer === null) {
-          jitterTimer = setTimeout(() => {
-          }, JITTER_BUFFER_MS);
-        }
-        const totalBytes = jitterBuffer.reduce((sum, b) => sum + b.length, 0);
-        if (totalBytes >= 4800) {
-          if (jitterTimer !== null) {
-            clearTimeout(jitterTimer);
-            jitterTimer = null;
-          }
-          yield* flushJitterBuffer();
-        }
-      }
-      if (jitterTimer !== null) {
-        clearTimeout(jitterTimer);
-      }
-      yield* flushJitterBuffer();
-      logger2.debug({ voiceId, totalMs: Date.now() - startMs }, "ElevenLabs TTS stream complete");
-    } catch (err) {
-      if (err.statusCode === 404) {
-        throw new TTSVoiceNotFoundError("elevenlabs", voiceId);
-      }
-      throw new TTSStreamError("elevenlabs", err);
-    }
-  }
-  /**
-   * Synthesize full audio (for pre-caching greetings, IVR prompts).
-   * Collects all streaming chunks into a single buffer.
-   *
-   * @param text    Text to synthesize
-   * @param config  Per-call config overrides
-   */
-  async synthesizeFull(text, config) {
-    const chunks = [];
-    for await (const chunk of this.synthesizeStream(text, config)) {
-      chunks.push(chunk);
-    }
-    return Buffer.concat(chunks);
-  }
-};
-var logger3 = pino({ name: "@voice-kit/core:tts:sarvam" });
-var SARVAM_API_BASE = "https://api.sarvam.ai";
-var DEFAULT_VOICES = {
-  "hi-IN": "meera",
-  "kn-IN": "pavithra",
-  "ta-IN": "pavithra",
-  "te-IN": "pavithra",
-  "mr-IN": "meera",
-  "bn-IN": "meera",
-  "gu-IN": "meera",
-  "pa-IN": "meera"
-};
-var SarvamTTSProvider = class {
-  name = "sarvam";
-  outputSampleRate = 22050;
-  // Sarvam default
-  outputFormat = "mp3";
-  http;
-  config;
-  constructor(config) {
-    const apiKey = config.apiKey ?? process.env["SARVAM_API_KEY"];
-    if (!apiKey) throw new TTSConnectionError("sarvam", new Error("SARVAM_API_KEY not set"));
-    const targetLanguage = config.targetLanguage ?? "hi-IN";
-    const defaultVoice = DEFAULT_VOICES[targetLanguage] ?? "meera";
-    this.http = axios.create({
-      baseURL: SARVAM_API_BASE,
-      headers: {
-        "API-Subscription-Key": apiKey,
-        "Content-Type": "application/json"
-      },
-      timeout: 15e3
-    });
-    this.config = {
-      voiceId: config.voiceId ?? defaultVoice,
-      sampleRate: config.sampleRate ?? 22050,
-      speed: config.speed ?? 1,
-      pitch: config.pitch ?? 0,
-      apiKey,
-      modelId: config.modelId ?? "bulbul:v1",
-      emotion: "",
-      targetLanguage
-    };
-  }
-  /**
-   * Synthesize text in an Indic language and stream audio chunks.
-   * Sarvam returns full audio segments — we chunk them for streaming compatibility.
-   *
-   * @example
-   * ```ts
-   * const tts = createTTS('sarvam', { targetLanguage: 'hi-IN' })
-   * for await (const chunk of tts.synthesizeStream('नमस्ते, मैं आपकी कैसे मदद कर सकता हूँ?')) {
-   *   telephony.sendAudio(chunk)
-   * }
-   * ```
-   */
-  async *synthesizeStream(text, config) {
-    const startMs = Date.now();
-    const targetLanguage = config?.targetLanguage ?? this.config.targetLanguage;
-    const speaker = config?.voiceId ?? this.config.voiceId;
-    logger3.debug({ targetLanguage, speaker, chars: text.length }, "Sarvam TTS request");
-    try {
-      const response = await this.http.post("/text-to-speech", {
-        inputs: [text],
-        target_language_code: targetLanguage,
-        speaker,
-        model: config?.modelId ?? this.config.modelId,
-        pitch: config?.pitch ?? this.config.pitch,
-        pace: config?.speed ?? this.config.speed,
-        loudness: 1,
-        speech_sample_rate: config?.sampleRate ?? this.config.sampleRate,
-        enable_preprocessing: true
-      });
-      const audioSegments = response.data.audios;
-      if (!audioSegments || audioSegments.length === 0) {
-        throw new TTSStreamError("sarvam", new Error("No audio returned from Sarvam TTS"));
-      }
-      logger3.debug(
-        { segments: audioSegments.length, latencyMs: Date.now() - startMs },
-        "Sarvam TTS response received"
-      );
-      for (const segment of audioSegments) {
-        const buf = Buffer.from(segment, "base64");
-        const CHUNK_SIZE = 4096;
-        let offset = 0;
-        while (offset < buf.length) {
-          yield buf.subarray(offset, Math.min(offset + CHUNK_SIZE, buf.length));
-          offset += CHUNK_SIZE;
-        }
-      }
-    } catch (err) {
-      if (axios.isAxiosError(err)) {
-        throw new TTSStreamError(
-          "sarvam",
-          new Error(`Sarvam TTS API error: ${err.response?.status} ${JSON.stringify(err.response?.data)}`)
-        );
-      }
-      throw new TTSStreamError("sarvam", err);
-    }
-  }
-  /** Synthesize complete audio buffer. */
-  async synthesizeFull(text, config) {
-    const chunks = [];
-    for await (const chunk of this.synthesizeStream(text, config)) {
-      chunks.push(chunk);
-    }
-    return Buffer.concat(chunks);
-  }
-};
-
-// src/tts/TTS-factory.ts
-function createTTS(provider, config) {
-  const cfg = config ?? {};
-  switch (provider) {
-    case "elevenlabs":
-      return new ElevenLabsTTSProvider(cfg);
-    case "cartesia":
-      return new CartesiaTTSProvider(cfg);
-    case "sarvam":
-      return new SarvamTTSProvider(cfg);
-    default: {
-      const _exhaustive = provider;
-      throw new Error(`Unknown TTS provider: ${String(_exhaustive)}`);
-    }
-  }
-}
-
-export { CartesiaTTSProvider, ElevenLabsTTSProvider, SarvamTTSProvider, createTTS };
-//# sourceMappingURL=tts.js.map
-//# sourceMappingURL=tts.js.map

package/dist/tts.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/errors/base.ts","../src/errors/tts.errors.ts","../src/tts/cartesia/index.ts","../src/tts/elevenlabs/index.ts","../src/tts/sarvam/index.ts","../src/tts/TTS-factory.ts"],"names":["logger","pino","DEFAULT_VOICE_ID"],"mappings":"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","file":"tts.js","sourcesContent":["/**\r\n * @voice-kit/core — Typed error hierarchy\r\n *\r\n * All VoiceKit errors extend VoiceKitError. Never throw raw Error.\r\n * Every error carries: code, message, provider, callId, retryable, severity.\r\n */\r\n\r\nimport type { ErrorSeverity } from '../types'\r\n\r\n// ─── Base Error ───────────────────────────────────────────────────────────────\r\n\r\n/**\r\n * Base class for all VoiceKit errors. Provides structured context for\r\n * logging, alerting, and programmatic error handling.\r\n *\r\n * @example\r\n * ```ts\r\n * try {\r\n *   await stt.transcribeBatch(audio)\r\n * } catch (err) {\r\n *   if (err instanceof STTError) {\r\n *     console.error(err.code, err.provider, err.retryable)\r\n *   }\r\n * }\r\n * ```\r\n */\r\nexport class VoiceKitError extends Error {\r\n    readonly code: string\r\n    readonly callId?: string\r\n    readonly provider?: string\r\n    readonly retryable: boolean\r\n    readonly severity: ErrorSeverity\r\n    override readonly cause?: unknown\r\n\r\n    constructor(params: {\r\n        code: string\r\n        message: string\r\n        callId?: string\r\n        provider?: string\r\n        retryable?: boolean\r\n        severity?: ErrorSeverity\r\n        cause?: unknown\r\n    }) {\r\n        super(params.message)\r\n        this.name = this.constructor.name\r\n        this.code = params.code\r\n        this.callId = params.callId\r\n        this.provider = params.provider\r\n        this.retryable = params.retryable ?? false\r\n        this.severity = params.severity ?? 'medium'\r\n        this.cause = params.cause\r\n\r\n        // Maintains proper prototype chain for `instanceof` in transpiled code\r\n        Object.setPrototypeOf(this, new.target.prototype)\r\n    }\r\n\r\n    toJSON() {\r\n        return {\r\n            name: this.name,\r\n            code: this.code,\r\n            message: this.message,\r\n            callId: this.callId,\r\n            provider: this.provider,\r\n            retryable: this.retryable,\r\n            severity: this.severity,\r\n        }\r\n    }\r\n}","\r\n// ─── TTS Errors ───────────────────────────────────────────────────────────────\r\n\r\nimport { VoiceKitError } from \"./base\"\r\n\r\n/**\r\n * Errors from text-to-speech providers.\r\n */\r\nexport class TTSError extends VoiceKitError { }\r\n\r\nexport class TTSConnectionError extends TTSError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'TTS_CONNECTION_FAILED',\r\n            message: `Failed to connect to ${provider} TTS service`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'high',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class TTSStreamError extends TTSError {\r\n    constructor(provider: string, cause?: unknown, callId?: string) {\r\n        super({\r\n            code: 'TTS_STREAM_ERROR',\r\n            message: `TTS stream error from ${provider}`,\r\n            provider,\r\n            callId,\r\n            retryable: true,\r\n            severity: 'medium',\r\n            cause,\r\n        })\r\n    }\r\n}\r\n\r\nexport class TTSVoiceNotFoundError extends TTSError {\r\n    constructor(provider: string, voiceId: string) {\r\n        super({\r\n            code: 'TTS_VOICE_NOT_FOUND',\r\n            message: `Voice '${voiceId}' not found on ${provider}`,\r\n            provider,\r\n            retryable: false,\r\n            severity: 'low',\r\n        })\r\n    }\r\n}\r\n","/**\r\n * @voice-kit/core — Cartesia TTS Provider\r\n *\r\n * Ultra-low-latency streaming TTS via @cartesia/cartesia-js.\r\n * Target first chunk: < 90ms. Best for latency-critical applications.\r\n */\r\n\r\nimport Cartesia from '@cartesia/cartesia-js'\r\nimport { TTSConnectionError, TTSStreamError } from '../../errors'\r\nimport type { TTSProvider, TTSConfig } from '../../types'\r\nimport pino from 'pino'\r\n\r\nconst logger = pino({ name: '@voice-kit/core:tts:cartesia' })\r\n\r\n/** Cartesia default voice: Barbershop Man — clear and neutral */\r\nconst DEFAULT_VOICE_ID = 'a0e99841-438c-4a64-b679-ae501e7d6091'\r\n\r\n/**\r\n * Cartesia ultra-low-latency TTS provider.\r\n * @internal — obtained via createTTS('cartesia', config)\r\n */\r\nexport class CartesiaTTSProvider implements TTSProvider {\r\n    readonly name = 'cartesia'\r\n    readonly outputSampleRate = 22_050  // Cartesia default\r\n    readonly outputFormat = 'pcm' as const\r\n\r\n    private readonly client: Cartesia\r\n    private readonly config: Required<TTSConfig>\r\n\r\n    constructor(config: TTSConfig) {\r\n        const apiKey = config.apiKey ?? process.env['CARTESIA_API_KEY']\r\n        if (!apiKey) throw new TTSConnectionError('cartesia', new Error('CARTESIA_API_KEY not set'))\r\n\r\n        this.client = new Cartesia({ apiKey })\r\n        this.config = {\r\n            voiceId: config.voiceId ?? DEFAULT_VOICE_ID,\r\n            sampleRate: config.sampleRate ?? 22_050,\r\n            speed: config.speed ?? 1.0,\r\n            pitch: config.pitch ?? 0,\r\n            apiKey,\r\n            modelId: config.modelId ?? 'sonic-english',\r\n            emotion: config.emotion ?? '',\r\n            targetLanguage: config.targetLanguage ?? 'en',\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Stream audio from Cartesia. Typically delivers first chunk in < 90ms.\r\n     *\r\n     * @example\r\n     * ```ts\r\n     * const tts = createTTS('cartesia', { voiceId: 'your-voice-id' })\r\n     * for await (const chunk of tts.synthesizeStream('Hello!')) {\r\n     *   sendToTelephony(chunk)\r\n     * }\r\n     * ```\r\n     */\r\n    async *synthesizeStream(text: string, config?: TTSConfig): AsyncIterable<Buffer> {\r\n        const voiceId = config?.voiceId ?? this.config.voiceId\r\n        const startMs = Date.now()\r\n\r\n        logger.debug({ voiceId, chars: text.length }, 'Cartesia TTS stream start')\r\n\r\n        try {\r\n            const stream = await this.client.tts.generateSse({\r\n                model_id: config?.modelId ?? this.config.modelId,\r\n                transcript: text,\r\n                voice: {\r\n                    mode: 'id',\r\n                    id: voiceId,\r\n                    ...(this.config.emotion && {\r\n                        __experimental_controls: {\r\n                            emotion: [this.config.emotion as `${string}:${string}`],\r\n                        },\r\n                    }),\r\n                },\r\n                output_format: {\r\n                    container: 'raw',\r\n                    encoding: 'pcm_s16le',\r\n                    sample_rate: toValidSampleRate(config?.sampleRate ?? this.config.sampleRate),\r\n                },\r\n            })\r\n\r\n            let firstChunk = true\r\n            for await (const event of stream as any) {\r\n                // v3 Stainless Stream yields ServerSentEvent objects: { data: string }\r\n                // Parse the JSON payload and extract the base64 audio chunk\r\n                if (!event.data || event.data === '[DONE]') continue\r\n\r\n                let payload: { chunk?: { audio?: string }, type?: string }\r\n                try {\r\n                    payload = JSON.parse(event.data)\r\n                } catch {\r\n                    continue\r\n                }\r\n\r\n                // Skip non-audio events (e.g. { type: \"timestamps\" })\r\n                if (!payload.chunk?.audio) continue\r\n\r\n                const buf = Buffer.from(payload.chunk.audio, 'base64')\r\n\r\n                if (firstChunk) {\r\n                    firstChunk = false\r\n                    logger.debug({ ttfb: Date.now() - startMs, voiceId }, 'Cartesia first audio chunk')\r\n                }\r\n\r\n                yield buf\r\n            }\r\n        } catch (err) {\r\n            throw new TTSStreamError('cartesia', err)\r\n        }\r\n    }\r\n\r\n    /** Synthesize complete audio. */\r\n    async synthesizeFull(text: string, config?: TTSConfig): Promise<Buffer> {\r\n        const chunks: Buffer[] = []\r\n        for await (const chunk of this.synthesizeStream(text, config)) {\r\n            chunks.push(chunk)\r\n        }\r\n        return Buffer.concat(chunks)\r\n    }\r\n}\r\n\r\nconst VALID_SAMPLE_RATES = [22050, 8000, 16000, 24000, 44100, 48000] as const\r\ntype ValidSampleRate = typeof VALID_SAMPLE_RATES[number]\r\n\r\nfunction toValidSampleRate(rate: number): ValidSampleRate {\r\n    return (VALID_SAMPLE_RATES as readonly number[]).includes(rate)\r\n        ? rate as ValidSampleRate\r\n        : 8000\r\n}","/**\r\n * @voice-kit/core — ElevenLabs TTS Provider\r\n *\r\n * Streaming TTS using ElevenLabs SDK. Features:\r\n * - 100ms lookahead jitter buffer to smooth burst delivery\r\n * - Voice clone support\r\n * - Sub-300ms first chunk target\r\n */\r\n\r\nimport { ElevenLabsClient } from 'elevenlabs'\r\nimport { TTSConnectionError, TTSStreamError, TTSVoiceNotFoundError } from '../../errors'\r\nimport type { TTSProvider, TTSConfig } from '../../types'\r\nimport pino from 'pino'\r\n\r\nconst logger = pino({ name: '@voice-kit/core:tts:elevenlabs' })\r\n\r\n/** Default voice: Rachel (neutral, clear, works well for en-IN) */\r\nconst DEFAULT_VOICE_ID = '21m00Tcm4TlvDq8ikWAM'\r\n\r\n/** Lookahead jitter buffer window in ms. Smooths burst packet delivery. */\r\nconst JITTER_BUFFER_MS = 100\r\n\r\n/**\r\n * ElevenLabs streaming TTS provider.\r\n * @internal — obtained via createTTS('elevenlabs', config)\r\n */\r\nexport class ElevenLabsTTSProvider implements TTSProvider {\r\n    readonly name = 'elevenlabs'\r\n    readonly outputSampleRate = 24_000  // ElevenLabs default: 24kHz\r\n    readonly outputFormat = 'pcm' as const\r\n\r\n    private readonly client: ElevenLabsClient\r\n    private readonly config: Required<TTSConfig>\r\n\r\n    constructor(config: TTSConfig) {\r\n        const apiKey = config.apiKey ?? process.env['ELEVENLABS_API_KEY']\r\n        if (!apiKey) throw new TTSConnectionError('elevenlabs', new Error('ELEVENLABS_API_KEY not set'))\r\n\r\n        this.client = new ElevenLabsClient({ apiKey })\r\n        this.config = {\r\n            voiceId: config.voiceId ?? DEFAULT_VOICE_ID,\r\n            sampleRate: config.sampleRate ?? 24_000,\r\n            speed: config.speed ?? 1.0,\r\n            pitch: config.pitch ?? 0,\r\n            apiKey,\r\n            modelId: config.modelId ?? 'eleven_turbo_v2_5',\r\n            emotion: config.emotion ?? '',\r\n            targetLanguage: config.targetLanguage ?? 'en-IN',\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Stream synthesized audio from ElevenLabs.\r\n     * First chunk target: < 300ms. Uses streaming API endpoint.\r\n     *\r\n     * A 100ms jitter buffer smooths burst packet delivery without adding\r\n     * perceptible latency.\r\n     *\r\n     * @param text    Text to synthesize (should be a sentence boundary chunk)\r\n     * @param config  Per-call config overrides\r\n     *\r\n     * @example\r\n     * ```ts\r\n     * const tts = createTTS('elevenlabs', { voiceId: 'your-voice-id' })\r\n     * for await (const chunk of tts.synthesizeStream('Hello, how can I help?')) {\r\n     *   telephony.sendAudio(chunk)\r\n     * }\r\n     * ```\r\n     */\r\n    async *synthesizeStream(text: string, config?: TTSConfig): AsyncIterable<Buffer> {\r\n        const voiceId = config?.voiceId ?? this.config.voiceId\r\n        const modelId = config?.modelId ?? this.config.modelId\r\n        const startMs = Date.now()\r\n\r\n        logger.debug({ voiceId, modelId, chars: text.length }, 'ElevenLabs TTS stream start')\r\n\r\n        try {\r\n            const audioStream = await this.client.generate({\r\n                voice: voiceId,\r\n                text,\r\n                model_id: modelId,\r\n                voice_settings: {\r\n                    stability: 0.5,\r\n                    similarity_boost: 0.8,\r\n                    speed: config?.speed ?? this.config.speed,\r\n                },\r\n                output_format: 'pcm_24000',\r\n                stream: true,\r\n            })\r\n\r\n            let firstChunk = true\r\n            let jitterBuffer: Buffer[] = []\r\n            let jitterTimer: ReturnType<typeof setTimeout> | null = null\r\n\r\n            const flushJitterBuffer = function* () {\r\n                for (const chunk of jitterBuffer) {\r\n                    yield chunk\r\n                }\r\n                jitterBuffer = []\r\n            }\r\n\r\n            for await (const chunk of audioStream) {\r\n                const buf = chunk instanceof Buffer ? chunk : Buffer.from(chunk as ArrayBuffer)\r\n\r\n                if (firstChunk) {\r\n                    firstChunk = false\r\n                    const ttfb = Date.now() - startMs\r\n                    logger.debug({ ttfb, voiceId }, 'ElevenLabs first audio chunk')\r\n                }\r\n\r\n                // Jitter buffer: collect for 100ms, then flush\r\n                jitterBuffer.push(buf)\r\n\r\n                if (jitterTimer === null) {\r\n                    jitterTimer = setTimeout(() => {\r\n                        // Flush is handled below in the generator — timer signals readiness\r\n                    }, JITTER_BUFFER_MS)\r\n                }\r\n\r\n                // Flush if buffer is large enough (avoid holding too much audio)\r\n                const totalBytes = jitterBuffer.reduce((sum, b) => sum + b.length, 0)\r\n                if (totalBytes >= 4_800) { // 100ms worth of 24kHz 16-bit PCM\r\n                    if (jitterTimer !== null) {\r\n                        clearTimeout(jitterTimer)\r\n                        jitterTimer = null\r\n                    }\r\n                    yield* flushJitterBuffer()\r\n                }\r\n            }\r\n\r\n            // Final flush\r\n            if (jitterTimer !== null) {\r\n                clearTimeout(jitterTimer)\r\n            }\r\n            yield* flushJitterBuffer()\r\n\r\n            logger.debug({ voiceId, totalMs: Date.now() - startMs }, 'ElevenLabs TTS stream complete')\r\n        } catch (err) {\r\n            if ((err as { statusCode?: number }).statusCode === 404) {\r\n                throw new TTSVoiceNotFoundError('elevenlabs', voiceId)\r\n            }\r\n            throw new TTSStreamError('elevenlabs', err)\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Synthesize full audio (for pre-caching greetings, IVR prompts).\r\n     * Collects all streaming chunks into a single buffer.\r\n     *\r\n     * @param text    Text to synthesize\r\n     * @param config  Per-call config overrides\r\n     */\r\n    async synthesizeFull(text: string, config?: TTSConfig): Promise<Buffer> {\r\n        const chunks: Buffer[] = []\r\n        for await (const chunk of this.synthesizeStream(text, config)) {\r\n            chunks.push(chunk)\r\n        }\r\n        return Buffer.concat(chunks)\r\n    }\r\n}","/**\r\n * @voice-kit/core — Sarvam AI TTS Provider\r\n *\r\n * Sarvam AI TTS for Hindi/Hinglish and regional Indian languages.\r\n * Supports natural-sounding Indian voices with regional accents.\r\n */\r\n\r\nimport axios, { type AxiosInstance } from 'axios'\r\nimport { TTSConnectionError, TTSStreamError } from '../../errors'\r\nimport type { TTSProvider, TTSConfig } from '../../types'\r\nimport pino from 'pino'\r\n\r\nconst logger = pino({ name: '@voice-kit/core:tts:sarvam' })\r\n\r\nconst SARVAM_API_BASE = 'https://api.sarvam.ai'\r\n\r\n/** Available Sarvam TTS voices per language. */\r\nconst SARVAM_VOICES: Record<string, string[]> = {\r\n    'hi-IN': ['meera', 'pavithra', 'maitreyi', 'arvind', 'amol', 'amartya'],\r\n    'kn-IN': ['pavithra', 'meera'],\r\n    'ta-IN': ['pavithra', 'meera'],\r\n    'te-IN': ['pavithra', 'meera'],\r\n    'mr-IN': ['pavithra', 'meera'],\r\n    'bn-IN': ['meera'],\r\n    'gu-IN': ['meera'],\r\n    'pa-IN': ['meera'],\r\n}\r\n\r\n/** Default voices per language. */\r\nconst DEFAULT_VOICES: Record<string, string> = {\r\n    'hi-IN': 'meera',\r\n    'kn-IN': 'pavithra',\r\n    'ta-IN': 'pavithra',\r\n    'te-IN': 'pavithra',\r\n    'mr-IN': 'meera',\r\n    'bn-IN': 'meera',\r\n    'gu-IN': 'meera',\r\n    'pa-IN': 'meera',\r\n}\r\n\r\ninterface SarvamTTSResponse {\r\n    audios: string[]  // base64 encoded audio segments\r\n}\r\n\r\n/**\r\n * Sarvam AI TTS provider for Indic languages.\r\n * @internal — obtained via createTTS('sarvam', config)\r\n */\r\nexport class SarvamTTSProvider implements TTSProvider {\r\n    readonly name = 'sarvam'\r\n    readonly outputSampleRate = 22_050  // Sarvam default\r\n    readonly outputFormat = 'mp3' as const\r\n\r\n    private readonly http: AxiosInstance\r\n    private readonly config: Required<TTSConfig>\r\n\r\n    constructor(config: TTSConfig) {\r\n        const apiKey = config.apiKey ?? process.env['SARVAM_API_KEY']\r\n        if (!apiKey) throw new TTSConnectionError('sarvam', new Error('SARVAM_API_KEY not set'))\r\n\r\n        const targetLanguage = config.targetLanguage ?? 'hi-IN'\r\n        const defaultVoice = DEFAULT_VOICES[targetLanguage] ?? 'meera'\r\n\r\n        this.http = axios.create({\r\n            baseURL: SARVAM_API_BASE,\r\n            headers: {\r\n                'API-Subscription-Key': apiKey,\r\n                'Content-Type': 'application/json',\r\n            },\r\n            timeout: 15_000,\r\n        })\r\n\r\n        this.config = {\r\n            voiceId: config.voiceId ?? defaultVoice,\r\n            sampleRate: config.sampleRate ?? 22_050,\r\n            speed: config.speed ?? 1.0,\r\n            pitch: config.pitch ?? 0,\r\n            apiKey,\r\n            modelId: config.modelId ?? 'bulbul:v1',\r\n            emotion: '',\r\n            targetLanguage,\r\n        }\r\n    }\r\n\r\n    /**\r\n     * Synthesize text in an Indic language and stream audio chunks.\r\n     * Sarvam returns full audio segments — we chunk them for streaming compatibility.\r\n     *\r\n     * @example\r\n     * ```ts\r\n     * const tts = createTTS('sarvam', { targetLanguage: 'hi-IN' })\r\n     * for await (const chunk of tts.synthesizeStream('नमस्ते, मैं आपकी कैसे मदद कर सकता हूँ?')) {\r\n     *   telephony.sendAudio(chunk)\r\n     * }\r\n     * ```\r\n     */\r\n    async *synthesizeStream(text: string, config?: TTSConfig): AsyncIterable<Buffer> {\r\n        const startMs = Date.now()\r\n        const targetLanguage = config?.targetLanguage ?? this.config.targetLanguage\r\n        const speaker = config?.voiceId ?? this.config.voiceId\r\n\r\n        logger.debug({ targetLanguage, speaker, chars: text.length }, 'Sarvam TTS request')\r\n\r\n        try {\r\n            const response = await this.http.post<SarvamTTSResponse>('/text-to-speech', {\r\n                inputs: [text],\r\n                target_language_code: targetLanguage,\r\n                speaker,\r\n                model: config?.modelId ?? this.config.modelId,\r\n                pitch: config?.pitch ?? this.config.pitch,\r\n                pace: config?.speed ?? this.config.speed,\r\n                loudness: 1.0,\r\n                speech_sample_rate: config?.sampleRate ?? this.config.sampleRate,\r\n                enable_preprocessing: true,\r\n            })\r\n\r\n            const audioSegments = response.data.audios\r\n            if (!audioSegments || audioSegments.length === 0) {\r\n                throw new TTSStreamError('sarvam', new Error('No audio returned from Sarvam TTS'))\r\n            }\r\n\r\n            logger.debug(\r\n                { segments: audioSegments.length, latencyMs: Date.now() - startMs },\r\n                'Sarvam TTS response received'\r\n            )\r\n\r\n            // Decode base64 segments and stream as chunks\r\n            for (const segment of audioSegments) {\r\n                const buf = Buffer.from(segment, 'base64')\r\n\r\n                // Stream in 4KB chunks for smooth playback\r\n                const CHUNK_SIZE = 4_096\r\n                let offset = 0\r\n                while (offset < buf.length) {\r\n                    yield buf.subarray(offset, Math.min(offset + CHUNK_SIZE, buf.length))\r\n                    offset += CHUNK_SIZE\r\n                }\r\n            }\r\n        } catch (err) {\r\n            if (axios.isAxiosError(err)) {\r\n                throw new TTSStreamError(\r\n                    'sarvam',\r\n                    new Error(`Sarvam TTS API error: ${err.response?.status} ${JSON.stringify(err.response?.data)}`)\r\n                )\r\n            }\r\n            throw new TTSStreamError('sarvam', err)\r\n        }\r\n    }\r\n\r\n    /** Synthesize complete audio buffer. */\r\n    async synthesizeFull(text: string, config?: TTSConfig): Promise<Buffer> {\r\n        const chunks: Buffer[] = []\r\n        for await (const chunk of this.synthesizeStream(text, config)) {\r\n            chunks.push(chunk)\r\n        }\r\n        return Buffer.concat(chunks)\r\n    }\r\n}","/**\r\n * @voice-kit/core — TTS factory\r\n *\r\n * createTTS() is the ONLY public API for text-to-speech.\r\n * Never instantiate provider classes directly.\r\n */\r\n\r\nimport type { TTSProvider, TTSConfig } from '../types'\r\nimport { ElevenLabsTTSProvider } from './elevenlabs'\r\nimport { CartesiaTTSProvider } from './cartesia'\r\nimport { SarvamTTSProvider } from './sarvam'\r\n\r\n/**\r\n * Create a TTS provider instance.\r\n *\r\n * Provider selection guide:\r\n * - 'elevenlabs'  → Best voice quality, cloning support, en-IN\r\n * - 'cartesia'    → Lowest latency (< 90ms TTFB), good for fast-paced agents\r\n * - 'sarvam'      → Best for Indic languages (hi-IN, ta-IN, kn-IN, te-IN, mr-IN)\r\n *\r\n * @example\r\n * ```ts\r\n * // English with voice cloning\r\n * const tts = createTTS('elevenlabs', { voiceId: 'your-cloned-voice-id' })\r\n *\r\n * // Ultra-low latency English\r\n * const tts = createTTS('cartesia', { voiceId: 'your-voice-id' })\r\n *\r\n * // Hindi\r\n * const tts = createTTS('sarvam', { targetLanguage: 'hi-IN', voiceId: 'meera' })\r\n * ```\r\n */\r\nexport function createTTS(\r\n    provider: 'elevenlabs' | 'cartesia' | 'sarvam',\r\n    config?: TTSConfig\r\n): TTSProvider {\r\n    const cfg = config ?? {}\r\n\r\n    switch (provider) {\r\n        case 'elevenlabs':\r\n            return new ElevenLabsTTSProvider(cfg)\r\n        case 'cartesia':\r\n            return new CartesiaTTSProvider(cfg)\r\n        case 'sarvam':\r\n            return new SarvamTTSProvider(cfg)\r\n        default: {\r\n            const _exhaustive: never = provider\r\n            throw new Error(`Unknown TTS provider: ${String(_exhaustive)}`)\r\n        }\r\n    }\r\n}"]}