@loonylabs/tts-middleware 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 LoonyLabs Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,201 @@
+# @loonylabs/tts-middleware
+
+[![npm version](https://img.shields.io/npm/v/@loonylabs/tts-middleware.svg)](https://www.npmjs.com/package/@loonylabs/tts-middleware)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Build Status](https://img.shields.io/badge/build-passing-brightgreen)]()
+[![Coverage](https://img.shields.io/badge/coverage-94%25-brightgreen)]()
+
+**Provider-agnostic Text-to-Speech (TTS) middleware infrastructure.**
+
+Build voice-enabled applications that switch seamlessly between Azure, EdenAI, OpenAI, ElevenLabs, and more without changing your application logic. Includes standardized error handling, accurate character counting for billing, and uniform audio output.
+
+---
+
+## ✨ Key Features
+
+- **🔌 Provider Agnostic:** Unified API for all TTS providers. Switch providers by changing one config parameter.
+- **☁️ Multi-Provider Support:**
+  - **Azure Speech Services:** Full support for Neural voices, emotions, and speaking styles.
+  - **EdenAI:** Access to 6+ providers (Google, OpenAI, Amazon, IBM, etc.) via a single aggregator API.
+  - **Ready for:** OpenAI, ElevenLabs, Google, Deepgram (interfaces prepared).
+- **📝 SSML Abstraction:** Auto-generates provider-specific SSML markup (e.g., for Azure prosody/styles) from simple JSON options.
+- **💰 Character Counting:** Precise character counting logic for billing estimation.
+- **🛡️ Robust Error Handling:** Standardized error types (`InvalidConfigError`, `QuotaExceededError`, `NetworkError`) across all providers.
+- **📐 TypeScript First:** Fully typed request/response objects and provider options.
+- **🇪🇺 GDPR/DSGVO Ready:** Configurable region support (e.g., Azure Germany/Europe regions).
+
+---
+
+## 📦 Installation
+
+```bash
+npm install @loonylabs/tts-middleware
+```
+
+## 🚀 Quick Start
+
+### 1. Configure Environment
+
+Create a `.env` file in your project root:
+
+```env
+# Default Provider
+TTS_DEFAULT_PROVIDER=azure
+
+# Azure Speech Services
+AZURE_SPEECH_KEY=your_azure_key
+AZURE_SPEECH_REGION=germanywestcentral
+
+# EdenAI (Optional)
+EDENAI_API_KEY=your_edenai_key
+```
+
+### 2. Basic Usage
+
+```typescript
+import { ttsService, TTSProvider } from '@loonylabs/tts-middleware';
+import fs from 'fs';
+
+async function generateSpeech() {
+  try {
+    // Synthesize speech
+    const response = await ttsService.synthesize({
+      text: "Hello! This is a test of the LoonyLabs TTS middleware.",
+      voice: { id: "en-US-JennyNeural" }, // Provider-specific voice ID
+      audio: {
+        format: "mp3",
+        speed: 1.0
+      }
+    });
+
+    // Save to file
+    fs.writeFileSync('output.mp3', response.audio);
+    
+    console.log(`Generated audio: ${response.metadata.duration}ms`);
+    console.log(`Billed characters: ${response.billing.characters}`);
+
+  } catch (error) {
+    console.error("Synthesis failed:", error);
+  }
+}
+
+generateSpeech();
+```
+
+---
+
+## 🛠️ Advanced Usage
+
+### Using Provider-Specific Features (e.g., Azure Emotions)
+
+```typescript
+const response = await ttsService.synthesize({
+  text: "I am so excited to tell you this!",
+  provider: TTSProvider.AZURE,
+  voice: { id: "en-US-JennyNeural" },
+  providerOptions: {
+    emotion: "cheerful", // Azure-specific
+    style: "chat",       // Azure-specific
+    styleDegree: 1.5
+  }
+});
+```
+
+### Switching Providers Dynamically
+
+```typescript
+// Use EdenAI to access Google's TTS engine
+const response = await ttsService.synthesize({
+  text: "Hello from Google via EdenAI",
+  provider: TTSProvider.EDENAI,
+  voice: { id: "en-US" },
+  providerOptions: {
+    provider: "google" // Select underlying provider
+  }
+});
+```
+
+---
+
+## 🏗️ Architecture
+
+The middleware uses a singleton orchestrator pattern to manage provider instances.
+
+```mermaid
+graph TD
+    App[Your Application] -->|synthesize()| Service[TTSService]
+    Service -->|getProvider()| Registry{Provider Registry}
+    
+    Registry -->|Select| Azure[AzureProvider]
+    Registry -->|Select| Eden[EdenAIProvider]
+    
+    Azure -->|SSML/SDK| AzureAPI[Azure Speech API]
+    Eden -->|REST| EdenAPI[EdenAI API]
+    
+    EdenAPI -.-> Google[Google TTS]
+    EdenAPI -.-> OpenAI[OpenAI TTS]
+    EdenAPI -.-> Amazon[Amazon Polly]
+```
+
+---
+
+## 🧩 Supported Providers
+
+| Provider | Status | Key Features |
+|----------|--------|--------------|
+| **Azure** | ✅ Stable | Neural Voices, Emotions, Styles, SSML, Visemes (planned) |
+| **EdenAI** | ✅ Stable | Aggregator for Google, OpenAI, Amazon, IBM, Microsoft |
+| **OpenAI** | 🔮 Planned | HD Audio, Simple API |
+| **ElevenLabs** | 🔮 Planned | Voice Cloning, High Expressivity |
+| **Google** | 🔮 Planned | WaveNet Voices, Pitch/Volume control |
+
+---
+
+## 🔧 Logging Configuration
+
+The middleware includes a pluggable logger interface. By default, it uses `console`, but you can replace it with any logger (Winston, Pino, etc.).
+
+```typescript
+import { setLogger, silentLogger, setLogLevel } from '@loonylabs/tts-middleware';
+
+// Disable all logging (useful for tests)
+setLogger(silentLogger);
+
+// Set minimum log level (debug, info, warn, error)
+setLogLevel('warn'); // Only show warnings and errors
+
+// Use custom logger (e.g., Winston)
+setLogger({
+  info: (msg, meta) => winston.info(msg, meta),
+  warn: (msg, meta) => winston.warn(msg, meta),
+  error: (msg, meta) => winston.error(msg, meta),
+  debug: (msg, meta) => winston.debug(msg, meta),
+});
+```
+
+---
+
+## 🧪 Testing
+
+The project maintains high code coverage (>94%) using Jest.
+
+```bash
+# Run unit & integration tests
+npm test
+
+# Run manual verification script (requires .env)
+npx ts-node scripts/manual-test-edenai.ts
+```
+
+## 🤝 Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
+
+Contributions are welcome! Please ensure:
+1.  **Tests:** Add tests for new features.
+2.  **Linting:** Run `npm run lint` before committing.
+3.  **Conventions:** Follow the existing project structure.
+
+## 📄 License
+
+[MIT](LICENSE) © 2026 LoonyLabs Team

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @loonylabs/tts-middleware
+ *
+ * Provider-agnostic Text-to-Speech middleware for Azure, EdenAI, OpenAI,
+ * ElevenLabs, Google Cloud, and Deepgram.
+ *
+ * @example
+ * ```typescript
+ * import { ttsService, TTSProvider } from '@loonylabs/tts-middleware';
+ *
+ * const response = await ttsService.synthesize({
+ *   text: "Hello World",
+ *   provider: TTSProvider.AZURE,
+ *   voice: { id: "en-US-JennyNeural" },
+ *   audio: { speed: 1.0, format: "mp3" }
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export * from './middleware/services/tts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,cAAc,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/**
+ * @loonylabs/tts-middleware
+ *
+ * Provider-agnostic Text-to-Speech middleware for Azure, EdenAI, OpenAI,
+ * ElevenLabs, Google Cloud, and Deepgram.
+ *
+ * @example
+ * ```typescript
+ * import { ttsService, TTSProvider } from '@loonylabs/tts-middleware';
+ *
+ * const response = await ttsService.synthesize({
+ *   text: "Hello World",
+ *   provider: TTSProvider.AZURE,
+ *   voice: { id: "en-US-JennyNeural" },
+ *   audio: { speed: 1.0, format: "mp3" }
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Re-export everything from the TTS middleware
+__exportStar(require("./middleware/services/tts"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;;;;;;;;;;;;;;AAEH,+CAA+C;AAC/C,4DAA0C"}

package/dist/middleware/services/tts/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * TTS Middleware - Public API
+ *
+ * @description Main entry point for the TTS middleware.
+ * Exports all public types, providers, and the main service.
+ *
+ * @example
+ * ```typescript
+ * import { ttsService, TTSProvider } from '@loonylabs/tts-middleware';
+ *
+ * const response = await ttsService.synthesize({
+ *   text: "Hello World",
+ *   provider: TTSProvider.AZURE,
+ *   voice: { id: "en-US-JennyNeural" },
+ *   audio: { speed: 1.0, format: "mp3" }
+ * });
+ * ```
+ *
+ * @module @loonylabs/tts-middleware
+ */
+export { TTSService, ttsService } from './tts.service';
+export { TTSProvider, TTSErrorCode, AudioFormat, } from './types';
+export type { AudioOptions, VoiceConfig, TTSSynthesizeRequest, TTSResponse, TTSResponseMetadata, TTSBillingInfo, TTSVoice, TTSVoiceMetadata, AzureProviderOptions, OpenAIProviderOptions, ElevenLabsProviderOptions, GoogleCloudProviderOptions, DeepgramProviderOptions, EdenAIProviderOptions, ProviderOptions, } from './types';
+export { isAzureOptions, isOpenAIOptions, isElevenLabsOptions, isGoogleCloudOptions, isDeepgramOptions, isEdenAIOptions, } from './types';
+export { BaseTTSProvider, AzureProvider, EdenAIProvider, } from './providers';
+export { TTSError, InvalidConfigError, InvalidVoiceError, QuotaExceededError, ProviderUnavailableError, SynthesisFailedError, NetworkError, } from './providers';
+export { countCharacters, countCharactersWithoutSSML, validateCharacterCount, countBillableCharacters, estimateAudioDuration, formatCharacterCount, } from './utils';
+export { setLogger, getLogger, resetLogger, setLogLevel, getLogLevel, silentLogger, } from './utils';
+export type { TTSLogger, LogLevel } from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/middleware/services/tts/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/middleware/services/tts/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGvD,OAAO,EACL,WAAW,EACX,YAAY,EACZ,WAAW,GACZ,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,WAAW,EACX,mBAAmB,EACnB,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,eAAe,GAChB,MAAM,SAAS,CAAC;AAEjB,OAAO,EACL,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAChB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,eAAe,EACf,aAAa,EACb,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,QAAQ,EACR,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,YAAY,GACb,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,eAAe,EACf,0BAA0B,EAC1B,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,SAAS,CAAC;AAGjB,OAAO,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,WAAW,EACX,WAAW,EACX,YAAY,GACb,MAAM,SAAS,CAAC;AAEjB,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC"}

package/dist/middleware/services/tts/index.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * TTS Middleware - Public API
+ *
+ * @description Main entry point for the TTS middleware.
+ * Exports all public types, providers, and the main service.
+ *
+ * @example
+ * ```typescript
+ * import { ttsService, TTSProvider } from '@loonylabs/tts-middleware';
+ *
+ * const response = await ttsService.synthesize({
+ *   text: "Hello World",
+ *   provider: TTSProvider.AZURE,
+ *   voice: { id: "en-US-JennyNeural" },
+ *   audio: { speed: 1.0, format: "mp3" }
+ * });
+ * ```
+ *
+ * @module @loonylabs/tts-middleware
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.silentLogger = exports.getLogLevel = exports.setLogLevel = exports.resetLogger = exports.getLogger = exports.setLogger = exports.formatCharacterCount = exports.estimateAudioDuration = exports.countBillableCharacters = exports.validateCharacterCount = exports.countCharactersWithoutSSML = exports.countCharacters = exports.NetworkError = exports.SynthesisFailedError = exports.ProviderUnavailableError = exports.QuotaExceededError = exports.InvalidVoiceError = exports.InvalidConfigError = exports.TTSError = exports.EdenAIProvider = exports.AzureProvider = exports.BaseTTSProvider = exports.isEdenAIOptions = exports.isDeepgramOptions = exports.isGoogleCloudOptions = exports.isElevenLabsOptions = exports.isOpenAIOptions = exports.isAzureOptions = exports.TTSErrorCode = exports.TTSProvider = exports.ttsService = exports.TTSService = void 0;
+// ===== Main Service =====
+var tts_service_1 = require("./tts.service");
+Object.defineProperty(exports, "TTSService", { enumerable: true, get: function () { return tts_service_1.TTSService; } });
+Object.defineProperty(exports, "ttsService", { enumerable: true, get: function () { return tts_service_1.ttsService; } });
+// ===== Types =====
+var types_1 = require("./types");
+Object.defineProperty(exports, "TTSProvider", { enumerable: true, get: function () { return types_1.TTSProvider; } });
+Object.defineProperty(exports, "TTSErrorCode", { enumerable: true, get: function () { return types_1.TTSErrorCode; } });
+var types_2 = require("./types");
+Object.defineProperty(exports, "isAzureOptions", { enumerable: true, get: function () { return types_2.isAzureOptions; } });
+Object.defineProperty(exports, "isOpenAIOptions", { enumerable: true, get: function () { return types_2.isOpenAIOptions; } });
+Object.defineProperty(exports, "isElevenLabsOptions", { enumerable: true, get: function () { return types_2.isElevenLabsOptions; } });
+Object.defineProperty(exports, "isGoogleCloudOptions", { enumerable: true, get: function () { return types_2.isGoogleCloudOptions; } });
+Object.defineProperty(exports, "isDeepgramOptions", { enumerable: true, get: function () { return types_2.isDeepgramOptions; } });
+Object.defineProperty(exports, "isEdenAIOptions", { enumerable: true, get: function () { return types_2.isEdenAIOptions; } });
+// ===== Providers =====
+var providers_1 = require("./providers");
+Object.defineProperty(exports, "BaseTTSProvider", { enumerable: true, get: function () { return providers_1.BaseTTSProvider; } });
+Object.defineProperty(exports, "AzureProvider", { enumerable: true, get: function () { return providers_1.AzureProvider; } });
+Object.defineProperty(exports, "EdenAIProvider", { enumerable: true, get: function () { return providers_1.EdenAIProvider; } });
+// ===== Errors =====
+var providers_2 = require("./providers");
+Object.defineProperty(exports, "TTSError", { enumerable: true, get: function () { return providers_2.TTSError; } });
+Object.defineProperty(exports, "InvalidConfigError", { enumerable: true, get: function () { return providers_2.InvalidConfigError; } });
+Object.defineProperty(exports, "InvalidVoiceError", { enumerable: true, get: function () { return providers_2.InvalidVoiceError; } });
+Object.defineProperty(exports, "QuotaExceededError", { enumerable: true, get: function () { return providers_2.QuotaExceededError; } });
+Object.defineProperty(exports, "ProviderUnavailableError", { enumerable: true, get: function () { return providers_2.ProviderUnavailableError; } });
+Object.defineProperty(exports, "SynthesisFailedError", { enumerable: true, get: function () { return providers_2.SynthesisFailedError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return providers_2.NetworkError; } });
+// ===== Utilities =====
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "countCharacters", { enumerable: true, get: function () { return utils_1.countCharacters; } });
+Object.defineProperty(exports, "countCharactersWithoutSSML", { enumerable: true, get: function () { return utils_1.countCharactersWithoutSSML; } });
+Object.defineProperty(exports, "validateCharacterCount", { enumerable: true, get: function () { return utils_1.validateCharacterCount; } });
+Object.defineProperty(exports, "countBillableCharacters", { enumerable: true, get: function () { return utils_1.countBillableCharacters; } });
+Object.defineProperty(exports, "estimateAudioDuration", { enumerable: true, get: function () { return utils_1.estimateAudioDuration; } });
+Object.defineProperty(exports, "formatCharacterCount", { enumerable: true, get: function () { return utils_1.formatCharacterCount; } });
+// ===== Logger =====
+var utils_2 = require("./utils");
+Object.defineProperty(exports, "setLogger", { enumerable: true, get: function () { return utils_2.setLogger; } });
+Object.defineProperty(exports, "getLogger", { enumerable: true, get: function () { return utils_2.getLogger; } });
+Object.defineProperty(exports, "resetLogger", { enumerable: true, get: function () { return utils_2.resetLogger; } });
+Object.defineProperty(exports, "setLogLevel", { enumerable: true, get: function () { return utils_2.setLogLevel; } });
+Object.defineProperty(exports, "getLogLevel", { enumerable: true, get: function () { return utils_2.getLogLevel; } });
+Object.defineProperty(exports, "silentLogger", { enumerable: true, get: function () { return utils_2.silentLogger; } });
+//# sourceMappingURL=index.js.map

package/dist/middleware/services/tts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/middleware/services/tts/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;GAmBG;;;AAEH,2BAA2B;AAC3B,6CAAuD;AAA9C,yGAAA,UAAU,OAAA;AAAE,yGAAA,UAAU,OAAA;AAE/B,oBAAoB;AACpB,iCAIiB;AAHf,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA;AAsBd,iCAOiB;AANf,uGAAA,cAAc,OAAA;AACd,wGAAA,eAAe,OAAA;AACf,4GAAA,mBAAmB,OAAA;AACnB,6GAAA,oBAAoB,OAAA;AACpB,0GAAA,iBAAiB,OAAA;AACjB,wGAAA,eAAe,OAAA;AAGjB,wBAAwB;AACxB,yCAIqB;AAHnB,4GAAA,eAAe,OAAA;AACf,0GAAA,aAAa,OAAA;AACb,2GAAA,cAAc,OAAA;AAGhB,qBAAqB;AACrB,yCAQqB;AAPnB,qGAAA,QAAQ,OAAA;AACR,+GAAA,kBAAkB,OAAA;AAClB,8GAAA,iBAAiB,OAAA;AACjB,+GAAA,kBAAkB,OAAA;AAClB,qHAAA,wBAAwB,OAAA;AACxB,iHAAA,oBAAoB,OAAA;AACpB,yGAAA,YAAY,OAAA;AAGd,wBAAwB;AACxB,iCAOiB;AANf,wGAAA,eAAe,OAAA;AACf,mHAAA,0BAA0B,OAAA;AAC1B,+GAAA,sBAAsB,OAAA;AACtB,gHAAA,uBAAuB,OAAA;AACvB,8GAAA,qBAAqB,OAAA;AACrB,6GAAA,oBAAoB,OAAA;AAGtB,qBAAqB;AACrB,iCAOiB;AANf,kGAAA,SAAS,OAAA;AACT,kGAAA,SAAS,OAAA;AACT,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,oGAAA,WAAW,OAAA;AACX,qGAAA,YAAY,OAAA"}

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

@@ -0,0 +1,131 @@
+/**
+ * Azure Speech Services TTS Provider
+ *
+ * @description Implementation of TTS provider for Microsoft Azure Speech Services.
+ * This is the MVP provider for EU-compliant TTS synthesis.
+ *
+ * @see https://learn.microsoft.com/en-us/azure/ai-services/speech-service/
+ */
+import type { TTSSynthesizeRequest, TTSResponse } from '../types';
+import { BaseTTSProvider } from './base-tts-provider';
+/**
+ * Azure-specific configuration
+ */
+interface AzureConfig {
+    subscriptionKey: string;
+    region: string;
+    endpoint?: string;
+}
+/**
+ * Azure Speech Services provider implementation
+ *
+ * @description Provides TTS synthesis using Microsoft Azure Speech Services.
+ * Supports emotion, style, and multiple audio formats.
+ *
+ * @example
+ * ```typescript
+ * const provider = new AzureProvider();
+ * const response = await provider.synthesize(
+ *   "Hello World",
+ *   "en-US-JennyNeural",
+ *   {
+ *     text: "Hello World",
+ *     voice: { id: "en-US-JennyNeural" },
+ *     audio: { speed: 1.0, format: "mp3" },
+ *     providerOptions: { emotion: "cheerful" }
+ *   }
+ * );
+ * ```
+ */
+export declare class AzureProvider extends BaseTTSProvider {
+    private config;
+    private speechConfig;
+    /**
+     * Creates a new Azure TTS provider
+     *
+     * @param config - Optional Azure configuration (uses env vars if not provided)
+     * @throws {InvalidConfigError} If required configuration is missing
+     */
+    constructor(config?: Partial<AzureConfig>);
+    /**
+     * Validate Azure-specific configuration
+     *
+     * @private
+     * @throws {InvalidConfigError} If configuration is invalid
+     */
+    private validateAzureConfig;
+    /**
+     * Initialize Azure Speech SDK configuration
+     *
+     * @private
+     */
+    private initializeSpeechConfig;
+    /**
+     * Synthesize text to speech using Azure Speech Services
+     *
+     * @param text - The input text to synthesize
+     * @param voiceId - The voice identifier (e.g., "en-US-JennyNeural")
+     * @param request - The full synthesis request with options
+     * @returns Promise resolving to the synthesis response
+     * @throws {InvalidConfigError} If configuration is invalid
+     * @throws {InvalidVoiceError} If voice is not found
+     * @throws {SynthesisFailedError} If synthesis fails
+     */
+    synthesize(text: string, voiceId: string, request: TTSSynthesizeRequest): Promise<TTSResponse>;
+    /**
+     * Set audio output format for Azure Speech SDK
+     *
+     * @private
+     * @param format - The audio format (mp3, wav, opus)
+     * @param sampleRate - The sample rate in Hz
+     */
+    private setAudioFormat;
+    /**
+     * Map audio format and sample rate to Azure format enum
+     *
+     * @private
+     * @param format - The audio format
+     * @param sampleRate - The sample rate in Hz
+     * @returns Azure audio format enum value
+     */
+    private getAzureAudioFormat;
+    /**
+     * Generate SSML from plain text and options
+     *
+     * @private
+     * @param text - The input text
+     * @param voiceId - The voice identifier
+     * @param request - The synthesis request with options
+     * @returns SSML string
+     */
+    private generateSSML;
+    /**
+     * Convert speed multiplier to SSML prosody rate value
+     *
+     * @private
+     * @param speed - Speed multiplier (0.5 - 2.0)
+     * @returns SSML rate value
+     */
+    private speedToProsodyRate;
+    /**
+     * Escape XML special characters
+     *
+     * @private
+     * @param text - The text to escape
+     * @returns Escaped text
+     */
+    private escapeXML;
+    /**
+     * Synthesize SSML using Azure Speech SDK
+     *
+     * @private
+     * @param synthesizer - The speech synthesizer
+     * @param ssml - The SSML to synthesize
+     * @returns Promise resolving to audio buffer
+     * @throws {InvalidVoiceError} If voice is not found
+     * @throws {SynthesisFailedError} If synthesis fails
+     */
+    private synthesizeSSML;
+}
+export {};
+//# sourceMappingURL=azure-provider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"azure-provider.d.ts","sourceRoot":"","sources":["../../../../../src/middleware/services/tts/providers/azure-provider.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,WAAW,EAAe,MAAM,UAAU,CAAC;AAE/E,OAAO,EACL,eAAe,EAIhB,MAAM,qBAAqB,CAAC;AAE7B;;GAEG;AACH,UAAU,WAAW;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,aAAc,SAAQ,eAAe;IAChD,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,YAAY,CAAiC;IAErD;;;;;OAKG;gBACS,MAAM,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC;IAkBzC;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IA2B9B;;;;;;;;;;OAUG;IACG,UAAU,CACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,WAAW,CAAC;IA4EvB;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAoBtB;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IA0C3B;;;;;;;;OAQG;IACH,OAAO,CAAC,YAAY;IAgDpB;;;;;;OAMG;IACH,OAAO,CAAC,kBAAkB;IAa1B;;;;;;OAMG;IACH,OAAO,CAAC,SAAS;IASjB;;;;;;;;;OASG;YACW,cAAc;CA0D7B"}