@juspay/neurolink 8.10.1 → 8.11.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [8.11.0](https://github.com/juspay/neurolink/compare/v8.10.1...v8.11.0) (2025-12-12)
+
+### Features
+
+- **(tts):** implement TTSProcessor skeleton class with handler registry ([8dc63d1](https://github.com/juspay/neurolink/commit/8dc63d15d8b71845145349b932651980aef61aa8))
+
 ## [8.10.1](https://github.com/juspay/neurolink/compare/v8.10.0...v8.10.1) (2025-12-12)
 
 ### Bug Fixes

package/dist/lib/types/ttsTypes.d.ts

@@ -85,6 +85,35 @@ export declare const VALID_TTS_QUALITIES: readonly TTSQuality[];
  * Type guard to check if an object is a TTSResult
  */
 export declare function isTTSResult(value: unknown): value is TTSResult;
+/**
+ * TTS Handler type for provider-specific implementations
+ *
+ * Each provider (Google AI, OpenAI, etc.) implements this type
+ * to provide TTS generation capabilities using their respective APIs.
+ */
+export type TTSHandler = {
+    /**
+     * Generate audio from text using provider-specific TTS API
+     *
+     * @param text - Text to convert to speech
+     * @param options - TTS configuration options
+     * @returns Audio buffer with metadata
+     */
+    synthesize(text: string, options: TTSOptions): Promise<TTSResult>;
+    /**
+     * Get available voices for the provider
+     *
+     * @param languageCode - Optional language filter (e.g., "en-US")
+     * @returns List of available voices
+     */
+    getVoices(languageCode?: string): Promise<TTSVoice[]>;
+    /**
+     * Validate that the provider is properly configured
+     *
+     * @returns True if provider can generate TTS
+     */
+    isConfigured(): boolean;
+};
 /**
  * Type guard to check if TTSOptions are valid
  */

package/dist/lib/utils/ttsProcessor.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Text-to-Speech (TTS) Processing Utility
+ *
+ * Central orchestrator for all TTS operations across providers.
+ * Manages provider-specific TTS handlers and audio generation.
+ *
+ * @module utils/ttsProcessor
+ */
+import type { TTSHandler } from "../types/ttsTypes.js";
+/**
+ * TTS processor class for orchestrating text-to-speech operations
+ *
+ * Follows the same pattern as CSVProcessor, ImageProcessor, and PDFProcessor.
+ * Provides a unified interface for TTS generation across multiple providers.
+ *
+ * @example
+ * ```typescript
+ * // Register a handler
+ * TTSProcessor.registerHandler('google-ai', googleAIHandler);
+ *
+ * // Check if provider is supported
+ * if (TTSProcessor.supports('google-ai')) {
+ *   // Provider is registered
+ * }
+ * ```
+ */
+export declare class TTSProcessor {
+    /**
+     * Handler registry mapping provider names to TTS handlers
+     * Uses Map for O(1) lookups and better type safety
+     *
+     * @private
+     */
+    private static readonly handlers;
+    /**
+     * Register a TTS handler for a specific provider
+     *
+     * Allows providers to register their TTS implementation at runtime.
+     *
+     * @param providerName - Provider identifier (e.g., 'google-ai', 'openai')
+     * @param handler - TTS handler implementation
+     *
+     * @example
+     * ```typescript
+     * const googleHandler: TTSHandler = {
+     *   synthesize: async (text, options) => { ... },
+     *   getVoices: async (languageCode) => { ... },
+     *   isConfigured: () => true
+     * };
+     *
+     * TTSProcessor.registerHandler('google-ai', googleHandler);
+     * ```
+     */
+    static registerHandler(providerName: string, handler: TTSHandler): void;
+    /**
+     * Get a registered TTS handler by provider name
+     *
+     * @private
+     * @param providerName - Provider identifier
+     * @returns Handler instance or undefined if not registered
+     */
+    private static getHandler;
+    /**
+     * Check if a provider is supported (has a registered TTS handler)
+     *
+     * @param providerName - Provider identifier
+     * @returns True if handler is registered
+     *
+     * @example
+     * ```typescript
+     * if (TTSProcessor.supports('google-ai')) {
+     *   console.log('Google AI TTS is supported');
+     * }
+     * ```
+     */
+    static supports(providerName: string): boolean;
+}

package/dist/lib/utils/ttsProcessor.js

@@ -0,0 +1,105 @@
+/**
+ * Text-to-Speech (TTS) Processing Utility
+ *
+ * Central orchestrator for all TTS operations across providers.
+ * Manages provider-specific TTS handlers and audio generation.
+ *
+ * @module utils/ttsProcessor
+ */
+import { logger } from "./logger.js";
+/**
+ * TTS processor class for orchestrating text-to-speech operations
+ *
+ * Follows the same pattern as CSVProcessor, ImageProcessor, and PDFProcessor.
+ * Provides a unified interface for TTS generation across multiple providers.
+ *
+ * @example
+ * ```typescript
+ * // Register a handler
+ * TTSProcessor.registerHandler('google-ai', googleAIHandler);
+ *
+ * // Check if provider is supported
+ * if (TTSProcessor.supports('google-ai')) {
+ *   // Provider is registered
+ * }
+ * ```
+ */
+export class TTSProcessor {
+    /**
+     * Handler registry mapping provider names to TTS handlers
+     * Uses Map for O(1) lookups and better type safety
+     *
+     * @private
+     */
+    static handlers = new Map();
+    /**
+     * Register a TTS handler for a specific provider
+     *
+     * Allows providers to register their TTS implementation at runtime.
+     *
+     * @param providerName - Provider identifier (e.g., 'google-ai', 'openai')
+     * @param handler - TTS handler implementation
+     *
+     * @example
+     * ```typescript
+     * const googleHandler: TTSHandler = {
+     *   synthesize: async (text, options) => { ... },
+     *   getVoices: async (languageCode) => { ... },
+     *   isConfigured: () => true
+     * };
+     *
+     * TTSProcessor.registerHandler('google-ai', googleHandler);
+     * ```
+     */
+    static registerHandler(providerName, handler) {
+        if (!providerName) {
+            throw new Error("Provider name is required");
+        }
+        if (!handler) {
+            throw new Error("Handler is required");
+        }
+        const normalizedName = providerName.toLowerCase();
+        if (this.handlers.has(normalizedName)) {
+            logger.warn(`[TTSProcessor] Overwriting existing handler for provider: ${normalizedName}`);
+        }
+        this.handlers.set(normalizedName, handler);
+        logger.debug(`[TTSProcessor] Registered TTS handler for provider: ${normalizedName}`);
+    }
+    /**
+     * Get a registered TTS handler by provider name
+     *
+     * @private
+     * @param providerName - Provider identifier
+     * @returns Handler instance or undefined if not registered
+     */
+    static getHandler(providerName) {
+        const normalizedName = providerName.toLowerCase();
+        return this.handlers.get(normalizedName);
+    }
+    /**
+     * Check if a provider is supported (has a registered TTS handler)
+     *
+     * @param providerName - Provider identifier
+     * @returns True if handler is registered
+     *
+     * @example
+     * ```typescript
+     * if (TTSProcessor.supports('google-ai')) {
+     *   console.log('Google AI TTS is supported');
+     * }
+     * ```
+     */
+    static supports(providerName) {
+        if (!providerName) {
+            logger.error("[TTSProcessor] Provider name is required for supports check");
+            return false;
+        }
+        const normalizedName = providerName.toLowerCase();
+        const isSupported = this.handlers.has(normalizedName);
+        if (!isSupported) {
+            logger.debug(`[TTSProcessor] Provider ${providerName} is not supported`);
+        }
+        return isSupported;
+    }
+}
+//# sourceMappingURL=ttsProcessor.js.map

package/dist/types/ttsTypes.d.ts

@@ -85,6 +85,35 @@ export declare const VALID_TTS_QUALITIES: readonly TTSQuality[];
  * Type guard to check if an object is a TTSResult
  */
 export declare function isTTSResult(value: unknown): value is TTSResult;
+/**
+ * TTS Handler type for provider-specific implementations
+ *
+ * Each provider (Google AI, OpenAI, etc.) implements this type
+ * to provide TTS generation capabilities using their respective APIs.
+ */
+export type TTSHandler = {
+    /**
+     * Generate audio from text using provider-specific TTS API
+     *
+     * @param text - Text to convert to speech
+     * @param options - TTS configuration options
+     * @returns Audio buffer with metadata
+     */
+    synthesize(text: string, options: TTSOptions): Promise<TTSResult>;
+    /**
+     * Get available voices for the provider
+     *
+     * @param languageCode - Optional language filter (e.g., "en-US")
+     * @returns List of available voices
+     */
+    getVoices(languageCode?: string): Promise<TTSVoice[]>;
+    /**
+     * Validate that the provider is properly configured
+     *
+     * @returns True if provider can generate TTS
+     */
+    isConfigured(): boolean;
+};
 /**
  * Type guard to check if TTSOptions are valid
  */

package/dist/utils/ttsProcessor.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Text-to-Speech (TTS) Processing Utility
+ *
+ * Central orchestrator for all TTS operations across providers.
+ * Manages provider-specific TTS handlers and audio generation.
+ *
+ * @module utils/ttsProcessor
+ */
+import type { TTSHandler } from "../types/ttsTypes.js";
+/**
+ * TTS processor class for orchestrating text-to-speech operations
+ *
+ * Follows the same pattern as CSVProcessor, ImageProcessor, and PDFProcessor.
+ * Provides a unified interface for TTS generation across multiple providers.
+ *
+ * @example
+ * ```typescript
+ * // Register a handler
+ * TTSProcessor.registerHandler('google-ai', googleAIHandler);
+ *
+ * // Check if provider is supported
+ * if (TTSProcessor.supports('google-ai')) {
+ *   // Provider is registered
+ * }
+ * ```
+ */
+export declare class TTSProcessor {
+    /**
+     * Handler registry mapping provider names to TTS handlers
+     * Uses Map for O(1) lookups and better type safety
+     *
+     * @private
+     */
+    private static readonly handlers;
+    /**
+     * Register a TTS handler for a specific provider
+     *
+     * Allows providers to register their TTS implementation at runtime.
+     *
+     * @param providerName - Provider identifier (e.g., 'google-ai', 'openai')
+     * @param handler - TTS handler implementation
+     *
+     * @example
+     * ```typescript
+     * const googleHandler: TTSHandler = {
+     *   synthesize: async (text, options) => { ... },
+     *   getVoices: async (languageCode) => { ... },
+     *   isConfigured: () => true
+     * };
+     *
+     * TTSProcessor.registerHandler('google-ai', googleHandler);
+     * ```
+     */
+    static registerHandler(providerName: string, handler: TTSHandler): void;
+    /**
+     * Get a registered TTS handler by provider name
+     *
+     * @private
+     * @param providerName - Provider identifier
+     * @returns Handler instance or undefined if not registered
+     */
+    private static getHandler;
+    /**
+     * Check if a provider is supported (has a registered TTS handler)
+     *
+     * @param providerName - Provider identifier
+     * @returns True if handler is registered
+     *
+     * @example
+     * ```typescript
+     * if (TTSProcessor.supports('google-ai')) {
+     *   console.log('Google AI TTS is supported');
+     * }
+     * ```
+     */
+    static supports(providerName: string): boolean;
+}

package/dist/utils/ttsProcessor.js

@@ -0,0 +1,104 @@
+/**
+ * Text-to-Speech (TTS) Processing Utility
+ *
+ * Central orchestrator for all TTS operations across providers.
+ * Manages provider-specific TTS handlers and audio generation.
+ *
+ * @module utils/ttsProcessor
+ */
+import { logger } from "./logger.js";
+/**
+ * TTS processor class for orchestrating text-to-speech operations
+ *
+ * Follows the same pattern as CSVProcessor, ImageProcessor, and PDFProcessor.
+ * Provides a unified interface for TTS generation across multiple providers.
+ *
+ * @example
+ * ```typescript
+ * // Register a handler
+ * TTSProcessor.registerHandler('google-ai', googleAIHandler);
+ *
+ * // Check if provider is supported
+ * if (TTSProcessor.supports('google-ai')) {
+ *   // Provider is registered
+ * }
+ * ```
+ */
+export class TTSProcessor {
+    /**
+     * Handler registry mapping provider names to TTS handlers
+     * Uses Map for O(1) lookups and better type safety
+     *
+     * @private
+     */
+    static handlers = new Map();
+    /**
+     * Register a TTS handler for a specific provider
+     *
+     * Allows providers to register their TTS implementation at runtime.
+     *
+     * @param providerName - Provider identifier (e.g., 'google-ai', 'openai')
+     * @param handler - TTS handler implementation
+     *
+     * @example
+     * ```typescript
+     * const googleHandler: TTSHandler = {
+     *   synthesize: async (text, options) => { ... },
+     *   getVoices: async (languageCode) => { ... },
+     *   isConfigured: () => true
+     * };
+     *
+     * TTSProcessor.registerHandler('google-ai', googleHandler);
+     * ```
+     */
+    static registerHandler(providerName, handler) {
+        if (!providerName) {
+            throw new Error("Provider name is required");
+        }
+        if (!handler) {
+            throw new Error("Handler is required");
+        }
+        const normalizedName = providerName.toLowerCase();
+        if (this.handlers.has(normalizedName)) {
+            logger.warn(`[TTSProcessor] Overwriting existing handler for provider: ${normalizedName}`);
+        }
+        this.handlers.set(normalizedName, handler);
+        logger.debug(`[TTSProcessor] Registered TTS handler for provider: ${normalizedName}`);
+    }
+    /**
+     * Get a registered TTS handler by provider name
+     *
+     * @private
+     * @param providerName - Provider identifier
+     * @returns Handler instance or undefined if not registered
+     */
+    static getHandler(providerName) {
+        const normalizedName = providerName.toLowerCase();
+        return this.handlers.get(normalizedName);
+    }
+    /**
+     * Check if a provider is supported (has a registered TTS handler)
+     *
+     * @param providerName - Provider identifier
+     * @returns True if handler is registered
+     *
+     * @example
+     * ```typescript
+     * if (TTSProcessor.supports('google-ai')) {
+     *   console.log('Google AI TTS is supported');
+     * }
+     * ```
+     */
+    static supports(providerName) {
+        if (!providerName) {
+            logger.error("[TTSProcessor] Provider name is required for supports check");
+            return false;
+        }
+        const normalizedName = providerName.toLowerCase();
+        const isSupported = this.handlers.has(normalizedName);
+        if (!isSupported) {
+            logger.debug(`[TTSProcessor] Provider ${providerName} is not supported`);
+        }
+        return isSupported;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "8.10.1",
+  "version": "8.11.0",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",