@loonylabs/tts-middleware 0.1.1

package/dist/middleware/services/tts/providers/base-tts-provider.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * Base TTS Provider Abstract Class
+ *
+ * All TTS providers must extend this class and implement the abstract methods.
+ * This ensures consistency across all providers.
+ *
+ * @abstract
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseTTSProvider = exports.NetworkError = exports.SynthesisFailedError = exports.ProviderUnavailableError = exports.QuotaExceededError = exports.InvalidVoiceError = exports.InvalidConfigError = exports.TTSError = void 0;
+const logger_utils_1 = require("../utils/logger.utils");
+/**
+ * Base error class for all TTS errors
+ */
+class TTSError extends Error {
+    /**
+     * Creates a new TTS error
+     *
+     * @param provider - The provider that threw the error
+     * @param code - Error code for categorization
+     * @param message - Human-readable error message
+     * @param cause - Optional underlying error that caused this error
+     */
+    constructor(provider, code, message, cause) {
+        super(message);
+        this.provider = provider;
+        this.code = code;
+        this.cause = cause;
+        this.name = 'TTSError';
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, TTSError);
+        }
+    }
+    /**
+     * Returns a formatted error message with context
+     */
+    toString() {
+        return `[${this.provider}] ${this.code}: ${this.message}${this.cause ? ` (caused by: ${this.cause.message})` : ''}`;
+    }
+}
+exports.TTSError = TTSError;
+/**
+ * Error thrown when TTS configuration is invalid or missing
+ */
+class InvalidConfigError extends TTSError {
+    constructor(provider, message, cause) {
+        super(provider, 'INVALID_CONFIG', message, cause);
+        this.name = 'InvalidConfigError';
+    }
+}
+exports.InvalidConfigError = InvalidConfigError;
+/**
+ * Error thrown when voice ID is invalid or not found
+ */
+class InvalidVoiceError extends TTSError {
+    constructor(provider, voiceId, message, cause) {
+        super(provider, 'INVALID_VOICE', message || `Voice not found: ${voiceId}`, cause);
+        this.name = 'InvalidVoiceError';
+    }
+}
+exports.InvalidVoiceError = InvalidVoiceError;
+/**
+ * Error thrown when provider quota/rate limit is exceeded
+ */
+class QuotaExceededError extends TTSError {
+    constructor(provider, message, cause) {
+        super(provider, 'QUOTA_EXCEEDED', message || 'Provider quota or rate limit exceeded', cause);
+        this.name = 'QuotaExceededError';
+    }
+}
+exports.QuotaExceededError = QuotaExceededError;
+/**
+ * Error thrown when provider service is unavailable
+ */
+class ProviderUnavailableError extends TTSError {
+    constructor(provider, message, cause) {
+        super(provider, 'PROVIDER_UNAVAILABLE', message || 'Provider service is temporarily unavailable', cause);
+        this.name = 'ProviderUnavailableError';
+    }
+}
+exports.ProviderUnavailableError = ProviderUnavailableError;
+/**
+ * Error thrown when synthesis fails for unknown reasons
+ */
+class SynthesisFailedError extends TTSError {
+    constructor(provider, message, cause) {
+        super(provider, 'SYNTHESIS_FAILED', message, cause);
+        this.name = 'SynthesisFailedError';
+    }
+}
+exports.SynthesisFailedError = SynthesisFailedError;
+/**
+ * Error thrown when network operation fails
+ */
+class NetworkError extends TTSError {
+    constructor(provider, message, cause) {
+        super(provider, 'NETWORK_ERROR', message, cause);
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Abstract base class for all TTS providers
+ *
+ * @abstract
+ *
+ * @description All provider implementations must:
+ * - Extend this class
+ * - Implement the abstract synthesize() method
+ * - Call super() in constructor with the provider name
+ * - Use the provided error classes for consistent error handling
+ *
+ * @example
+ * ```typescript
+ * class AzureProvider extends BaseTTSProvider {
+ *   constructor() {
+ *     super(TTSProvider.AZURE);
+ *   }
+ *
+ *   async synthesize(text: string, voiceId: string, request: TTSSynthesizeRequest): Promise<TTSResponse> {
+ *     this.validateConfig(request);
+ *     // ... implementation
+ *   }
+ * }
+ * ```
+ */
+class BaseTTSProvider {
+    /**
+     * Creates a new TTS provider
+     *
+     * @param providerName - The provider identifier
+     */
+    constructor(providerName) {
+        this.providerName = providerName;
+    }
+    /**
+     * Get the provider name
+     *
+     * @returns The provider identifier
+     */
+    getProviderName() {
+        return this.providerName;
+    }
+    /**
+     * Validate provider configuration
+     *
+     * @protected
+     * @param request - The synthesis request to validate
+     * @throws {InvalidConfigError} If configuration is invalid
+     *
+     * @description Subclasses should override this to validate provider-specific
+     * configuration (e.g., API keys, region settings)
+     */
+    validateConfig(request) {
+        if (!request.text || request.text.trim().length === 0) {
+            throw new InvalidConfigError(this.providerName, 'Text cannot be empty');
+        }
+        if (!request.voice || !request.voice.id) {
+            throw new InvalidConfigError(this.providerName, 'Voice ID is required');
+        }
+    }
+    /**
+     * Count characters in text for billing purposes
+     *
+     * @protected
+     * @param text - The input text to count
+     * @returns The number of characters (including spaces and punctuation)
+     *
+     * @description This is the base implementation that counts all characters.
+     * Providers that use SSML or have special character counting rules
+     * should override this method.
+     *
+     * @example
+     * ```typescript
+     * const count = this.countCharacters("Hello World!"); // returns 12
+     * ```
+     */
+    countCharacters(text) {
+        return text.length;
+    }
+    /**
+     * Validate that a voice exists
+     *
+     * @protected
+     * @param _voiceId - The voice identifier to validate (unused in base implementation)
+     * @returns Promise resolving to true if voice exists
+     * @throws {InvalidVoiceError} If voice does not exist
+     *
+     * @description Base implementation always returns true. Providers should
+     * override this to validate voice IDs against their voice catalogs.
+     */
+    async validateVoiceExists(_voiceId) {
+        // Base implementation: assume voice exists
+        // Subclasses should override to validate against provider's voice catalog
+        return true;
+    }
+    /**
+     * Create a standardized error from a provider-specific error
+     *
+     * @protected
+     * @param error - The original error
+     * @param context - Additional context for debugging
+     * @returns A standardized TTS error
+     *
+     * @description Wraps provider-specific errors in our error classes
+     * for consistent error handling across providers.
+     */
+    handleError(error, context) {
+        // If it's already a TTSError, return it
+        if (error instanceof TTSError) {
+            return error;
+        }
+        // Check for common HTTP error codes
+        const errorMessage = error.message.toLowerCase();
+        if (errorMessage.includes('401') || errorMessage.includes('403')) {
+            return new InvalidConfigError(this.providerName, `Authentication failed${context ? `: ${context}` : ''}`, error);
+        }
+        if (errorMessage.includes('429')) {
+            return new QuotaExceededError(this.providerName, `Rate limit exceeded${context ? `: ${context}` : ''}`, error);
+        }
+        if (errorMessage.includes('503') ||
+            errorMessage.includes('504') ||
+            errorMessage.includes('502')) {
+            return new ProviderUnavailableError(this.providerName, `Service temporarily unavailable${context ? `: ${context}` : ''}`, error);
+        }
+        if (errorMessage.includes('timeout') ||
+            errorMessage.includes('econnrefused') ||
+            errorMessage.includes('enotfound')) {
+            return new NetworkError(this.providerName, `Network error${context ? `: ${context}` : ''}`, error);
+        }
+        // Default to SynthesisFailedError for unknown errors
+        return new SynthesisFailedError(this.providerName, `Synthesis failed${context ? `: ${context}` : ''}: ${error.message}`, error);
+    }
+    /**
+     * Log a message using the pluggable logger
+     *
+     * @protected
+     * @param level - Log level
+     * @param message - Log message
+     * @param meta - Optional metadata
+     *
+     * @description Uses the global TTS logger which can be customized via setLogger().
+     * By default uses console logging, but can be replaced with any logger (Winston, Pino, etc.)
+     *
+     * @example
+     * ```typescript
+     * // In application code:
+     * import { setLogger, silentLogger } from '@loonylabs/tts-middleware';
+     *
+     * // Disable all logging
+     * setLogger(silentLogger);
+     *
+     * // Use custom logger
+     * setLogger({
+     *   info: (msg, meta) => myLogger.info(msg, meta),
+     *   // ...
+     * });
+     * ```
+     */
+    log(level, message, meta) {
+        (0, logger_utils_1.log)(this.providerName, level, message, meta);
+    }
+}
+exports.BaseTTSProvider = BaseTTSProvider;
+//# sourceMappingURL=base-tts-provider.js.map

package/dist/middleware/services/tts/providers/base-tts-provider.js.map

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

package/dist/middleware/services/tts/providers/edenai-provider.d.ts

@@ -0,0 +1,112 @@
+/**
+ * EdenAI TTS Provider
+ *
+ * @description Provider for EdenAI TTS API (multi-provider aggregator)
+ * EdenAI acts as an aggregator, providing access to multiple TTS providers
+ * (Amazon, Google, IBM, Microsoft, OpenAI, ElevenLabs) through a single API.
+ *
+ * @see https://docs.edenai.co/reference/text_to_speech_create
+ */
+import type { TTSSynthesizeRequest, TTSResponse } from '../types';
+import { BaseTTSProvider } from './base-tts-provider';
+/**
+ * EdenAI-specific configuration
+ */
+interface EdenAIConfig {
+    apiKey: string;
+    apiUrl?: string;
+}
+/**
+ * EdenAI provider implementation
+ *
+ * @description Provides TTS synthesis using EdenAI's multi-provider aggregator API.
+ * EdenAI routes requests to underlying providers (Amazon, Google, IBM, Microsoft, OpenAI, ElevenLabs).
+ *
+ * @example
+ * ```typescript
+ * const provider = new EdenAIProvider();
+ * const response = await provider.synthesize(
+ *   "Hello World",
+ *   "en-US",
+ *   {
+ *     text: "Hello World",
+ *     voice: { id: "en-US-JennyNeural" },
+ *     audio: { speed: 1.0, format: "mp3" },
+ *     providerOptions: { provider: "google" }
+ *   }
+ * );
+ * ```
+ */
+export declare class EdenAIProvider extends BaseTTSProvider {
+    private config;
+    private readonly apiUrl;
+    /**
+     * Creates a new EdenAI TTS provider
+     *
+     * @param config - Optional EdenAI configuration (uses env vars if not provided)
+     * @throws {InvalidConfigError} If API key is missing
+     */
+    constructor(config?: Partial<EdenAIConfig>);
+    /**
+     * Validate EdenAI-specific configuration
+     *
+     * @private
+     * @throws {InvalidConfigError} If configuration is invalid
+     */
+    private validateEdenAIConfig;
+    /**
+     * Synthesize text to speech using EdenAI
+     *
+     * @param text - The input text to synthesize
+     * @param voiceId - The voice identifier (language code or voice name)
+     * @param request - The full synthesis request with options
+     * @returns Promise resolving to the synthesis response
+     * @throws {InvalidConfigError} If configuration is invalid
+     * @throws {SynthesisFailedError} If synthesis fails
+     */
+    synthesize(text: string, voiceId: string, request: TTSSynthesizeRequest): Promise<TTSResponse>;
+    /**
+     * Build EdenAI API request payload
+     *
+     * @private
+     * @param text - The input text
+     * @param voiceId - The voice identifier
+     * @param request - The synthesis request
+     * @param options - EdenAI-specific options
+     * @returns Request payload for EdenAI API
+     */
+    private buildEdenAIRequest;
+    /**
+     * Call EdenAI API
+     *
+     * @private
+     * @param requestBody - The request payload
+     * @returns Promise resolving to audio buffer
+     * @throws {SynthesisFailedError} If API call fails
+     */
+    private callEdenAIAPI;
+    /**
+     * Extract audio buffer from EdenAI response
+     *
+     * @private
+     * @param data - The EdenAI API response
+     * @returns Audio buffer or null
+     */
+    private extractAudioFromResponse;
+    /**
+     * Extract language code from voice ID
+     *
+     * @private
+     * @param voiceId - The voice identifier
+     * @returns Language code (e.g., 'en-US', 'de-DE')
+     *
+     * @description Extracts language code from voice IDs like:
+     * - 'en-US-JennyNeural' -> 'en-US'
+     * - 'de-DE-KatjaNeural' -> 'de-DE'
+     * - 'en-US' -> 'en-US'
+     * - 'en' -> 'en'
+     */
+    private extractLanguage;
+}
+export {};
+//# sourceMappingURL=edenai-provider.d.ts.map

package/dist/middleware/services/tts/providers/edenai-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"edenai-provider.d.ts","sourceRoot":"","sources":["../../../../../src/middleware/services/tts/providers/edenai-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAElE,OAAO,EACL,eAAe,EAEhB,MAAM,qBAAqB,CAAC;AAG7B;;GAEG;AACH,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAeD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,cAAe,SAAQ,eAAe;IACjD,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAEhC;;;;;OAKG;gBACS,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC;IAqB1C;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAS5B;;;;;;;;;OASG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC;IA2DvB;;;;;;;;;OASG;IACH,OAAO,CAAC,kBAAkB;IAgE1B;;;;;;;OAOG;YACW,aAAa;IAmC3B;;;;;;OAMG;YACW,wBAAwB;IA2CtC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,eAAe;CAWxB"}

package/dist/middleware/services/tts/providers/edenai-provider.js

@@ -0,0 +1,289 @@
+"use strict";
+/**
+ * EdenAI TTS Provider
+ *
+ * @description Provider for EdenAI TTS API (multi-provider aggregator)
+ * EdenAI acts as an aggregator, providing access to multiple TTS providers
+ * (Amazon, Google, IBM, Microsoft, OpenAI, ElevenLabs) through a single API.
+ *
+ * @see https://docs.edenai.co/reference/text_to_speech_create
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EdenAIProvider = void 0;
+const types_1 = require("../types");
+const base_tts_provider_1 = require("./base-tts-provider");
+/**
+ * EdenAI provider implementation
+ *
+ * @description Provides TTS synthesis using EdenAI's multi-provider aggregator API.
+ * EdenAI routes requests to underlying providers (Amazon, Google, IBM, Microsoft, OpenAI, ElevenLabs).
+ *
+ * @example
+ * ```typescript
+ * const provider = new EdenAIProvider();
+ * const response = await provider.synthesize(
+ *   "Hello World",
+ *   "en-US",
+ *   {
+ *     text: "Hello World",
+ *     voice: { id: "en-US-JennyNeural" },
+ *     audio: { speed: 1.0, format: "mp3" },
+ *     providerOptions: { provider: "google" }
+ *   }
+ * );
+ * ```
+ */
+class EdenAIProvider extends base_tts_provider_1.BaseTTSProvider {
+    /**
+     * Creates a new EdenAI TTS provider
+     *
+     * @param config - Optional EdenAI configuration (uses env vars if not provided)
+     * @throws {InvalidConfigError} If API key is missing
+     */
+    constructor(config) {
+        super(types_1.TTSProvider.EDENAI);
+        // Load configuration from environment or provided config
+        this.config = {
+            apiKey: config?.apiKey || process.env.EDENAI_API_KEY || '',
+            apiUrl: config?.apiUrl,
+        };
+        this.apiUrl =
+            this.config.apiUrl || 'https://api.edenai.run/v2/audio/text_to_speech';
+        // Validate configuration
+        this.validateEdenAIConfig();
+        this.log('info', 'EdenAI provider initialized', {
+            hasApiKey: !!this.config.apiKey,
+            apiUrl: this.apiUrl,
+        });
+    }
+    /**
+     * Validate EdenAI-specific configuration
+     *
+     * @private
+     * @throws {InvalidConfigError} If configuration is invalid
+     */
+    validateEdenAIConfig() {
+        if (!this.config.apiKey) {
+            throw new base_tts_provider_1.InvalidConfigError(this.providerName, 'EdenAI API key is required (EDENAI_API_KEY)');
+        }
+    }
+    /**
+     * Synthesize text to speech using EdenAI
+     *
+     * @param text - The input text to synthesize
+     * @param voiceId - The voice identifier (language code or voice name)
+     * @param request - The full synthesis request with options
+     * @returns Promise resolving to the synthesis response
+     * @throws {InvalidConfigError} If configuration is invalid
+     * @throws {SynthesisFailedError} If synthesis fails
+     */
+    async synthesize(text, voiceId, request) {
+        // Validate configuration
+        this.validateConfig(request);
+        const startTime = Date.now();
+        // Extract options (use as EdenAIProviderOptions if it looks like it, otherwise empty)
+        const options = (request.providerOptions || {});
+        // Build EdenAI request
+        const edenaiRequest = this.buildEdenAIRequest(text, voiceId, request, options);
+        this.log('debug', 'Synthesizing with EdenAI', {
+            voiceId,
+            provider: options.provider || 'auto',
+            textLength: text.length,
+        });
+        try {
+            // Call EdenAI API
+            const audioBuffer = await this.callEdenAIAPI(edenaiRequest);
+            // Calculate duration
+            const duration = Date.now() - startTime;
+            // Count billable characters (original text)
+            const characters = this.countCharacters(text);
+            this.log('info', 'Synthesis successful', {
+                voiceId,
+                characters,
+                duration,
+                audioSize: audioBuffer.length,
+            });
+            // Return response
+            return {
+                audio: audioBuffer,
+                metadata: {
+                    provider: this.providerName,
+                    voice: voiceId,
+                    duration,
+                    audioFormat: request.audio?.format || options.audio_format || 'mp3',
+                    sampleRate: request.audio?.sampleRate || options.sampling_rate || 24000,
+                },
+                billing: {
+                    characters,
+                },
+            };
+        }
+        catch (error) {
+            this.log('error', 'Synthesis failed', {
+                voiceId,
+                error: error.message,
+            });
+            throw this.handleError(error, 'during EdenAI API call');
+        }
+    }
+    /**
+     * Build EdenAI API request payload
+     *
+     * @private
+     * @param text - The input text
+     * @param voiceId - The voice identifier
+     * @param request - The synthesis request
+     * @param options - EdenAI-specific options
+     * @returns Request payload for EdenAI API
+     */
+    buildEdenAIRequest(text, voiceId, request, options) {
+        // Extract language from voice ID (e.g., 'en-US-JennyNeural' -> 'en-US', 'en-US' -> 'en-US')
+        const language = this.extractLanguage(voiceId);
+        // Base request
+        const edenaiRequest = {
+            text,
+            language,
+            option: voiceId, // Use voiceId as option for voice selection
+            providers: options.provider || 'google', // Top-level providers field
+        };
+        // Build settings object for provider-specific options
+        const settings = {};
+        // Speaking rate (maps to speed)
+        const speakingRate = options.speaking_rate ?? request.audio?.speed;
+        if (speakingRate !== undefined) {
+            settings.speaking_rate = speakingRate;
+        }
+        // Speaking pitch
+        if (options.speaking_pitch !== undefined) {
+            settings.speaking_pitch = options.speaking_pitch;
+        }
+        // Speaking volume
+        if (options.speaking_volume !== undefined) {
+            settings.speaking_volume = options.speaking_volume;
+        }
+        // Audio format
+        if (options.audio_format !== undefined) {
+            settings.audio_format = options.audio_format;
+        }
+        // Sampling rate
+        if (options.sampling_rate !== undefined) {
+            settings.sampling_rate = options.sampling_rate;
+        }
+        // Add providers to settings if provider is explicitly specified
+        if (options.provider) {
+            settings.providers = options.provider;
+        }
+        // Add settings to request if any settings were specified
+        if (Object.keys(settings).length > 0) {
+            edenaiRequest.settings = settings;
+        }
+        // Fallback providers (top-level)
+        if (options.fallback_providers && options.fallback_providers.length > 0) {
+            edenaiRequest.fallback_providers = options.fallback_providers;
+        }
+        return edenaiRequest;
+    }
+    /**
+     * Call EdenAI API
+     *
+     * @private
+     * @param requestBody - The request payload
+     * @returns Promise resolving to audio buffer
+     * @throws {SynthesisFailedError} If API call fails
+     */
+    async callEdenAIAPI(requestBody) {
+        try {
+            const response = await fetch(this.apiUrl, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.config.apiKey}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(requestBody),
+            });
+            if (!response.ok) {
+                const errorText = await response.text();
+                throw new Error(`EdenAI API error (${response.status}): ${errorText}`);
+            }
+            const data = (await response.json());
+            // Extract audio from response
+            // EdenAI returns provider-specific results
+            const audioBuffer = await this.extractAudioFromResponse(data);
+            if (!audioBuffer) {
+                throw new Error('No audio data in EdenAI response');
+            }
+            return audioBuffer;
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error(`EdenAI API call failed: ${error}`);
+        }
+    }
+    /**
+     * Extract audio buffer from EdenAI response
+     *
+     * @private
+     * @param data - The EdenAI API response
+     * @returns Audio buffer or null
+     */
+    async extractAudioFromResponse(data) {
+        // EdenAI returns results keyed by provider name
+        // Find the first successful provider response
+        for (const providerName of Object.keys(data)) {
+            const providerResult = data[providerName];
+            // Check for errors
+            if (providerResult.error || providerResult.status === 'fail') {
+                this.log('warn', `Provider ${providerName} failed`, {
+                    error: providerResult.error,
+                });
+                continue;
+            }
+            // Check for base64-encoded audio
+            if (providerResult.audio) {
+                this.log('debug', `Using audio from provider: ${providerName}`);
+                return Buffer.from(providerResult.audio, 'base64');
+            }
+            // Check for audio URL
+            if (providerResult.audio_resource_url) {
+                this.log('debug', `Downloading audio from URL (provider: ${providerName})`);
+                const audioResponse = await fetch(providerResult.audio_resource_url);
+                if (!audioResponse.ok) {
+                    this.log('warn', `Failed to download audio from URL`, {
+                        provider: providerName,
+                        url: providerResult.audio_resource_url,
+                    });
+                    continue;
+                }
+                const arrayBuffer = await audioResponse.arrayBuffer();
+                return Buffer.from(arrayBuffer);
+            }
+        }
+        return null;
+    }
+    /**
+     * Extract language code from voice ID
+     *
+     * @private
+     * @param voiceId - The voice identifier
+     * @returns Language code (e.g., 'en-US', 'de-DE')
+     *
+     * @description Extracts language code from voice IDs like:
+     * - 'en-US-JennyNeural' -> 'en-US'
+     * - 'de-DE-KatjaNeural' -> 'de-DE'
+     * - 'en-US' -> 'en-US'
+     * - 'en' -> 'en'
+     */
+    extractLanguage(voiceId) {
+        // Match language code patterns: en-US, de-DE, etc.
+        const match = voiceId.match(/^([a-z]{2}(-[A-Z]{2})?)/);
+        if (match) {
+            return match[1];
+        }
+        // If no match, assume voice ID is already a language code
+        return voiceId;
+    }
+}
+exports.EdenAIProvider = EdenAIProvider;
+//# sourceMappingURL=edenai-provider.js.map