@juspay/neurolink 8.13.2 → 8.14.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [8.14.0](https://github.com/juspay/neurolink/compare/v8.13.2...v8.14.0) (2025-12-14)
+
+### Features
+
+- **(tts):** Create GoogleTTSHandler skeleton structure ([60db6a8](https://github.com/juspay/neurolink/commit/60db6a813d350756dad9a7baeee3ff5ad35141e2))
+
 ## [8.13.2](https://github.com/juspay/neurolink/compare/v8.13.1...v8.13.2) (2025-12-14)
 
 ### Bug Fixes

package/dist/adapters/tts/googleTTSHandler.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Google Cloud Text-to-Speech Handler
+ *
+ * Handler for Google Cloud Text-to-Speech API integration.
+ * Supports Neural2 and WaveNet voice models with 220+ voices across 40+ languages.
+ *
+ * @module adapters/tts/googleTTSHandler
+ * @see https://cloud.google.com/text-to-speech/docs
+ */
+import type { TTSHandler } from "../../utils/ttsProcessor.js";
+import type { TTSOptions, TTSResult, TTSVoice } from "../../types/ttsTypes.js";
+/**
+ * Google Cloud TTS handler implementation
+ *
+ * Integrates with Google Cloud Text-to-Speech API for voice synthesis.
+ * Supports authentication via:
+ *   - Explicit service account JSON key path
+ *   - GOOGLE_APPLICATION_CREDENTIALS environment variable
+ */
+export declare class GoogleTTSHandler implements TTSHandler {
+    private client;
+    /**
+     * Maximum text length supported by Google Cloud TTS (5000 bytes)
+     * Different providers have different limits
+     */
+    private static readonly DEFAULT_MAX_TEXT_LENGTH;
+    maxTextLength: number;
+    /**
+     * Constructor for GoogleTTSHandler
+     *
+     * @param credentialsPath - Optional path to Google Cloud credentials JSON file
+     */
+    constructor(credentialsPath?: string);
+    /**
+     * Validate that the provider is properly configured
+     *
+     * @returns True if provider can generate TTS
+     */
+    isConfigured(): boolean;
+    /**
+     * Get available voices for the provider
+     *
+     * Note: This method is optional in the TTSHandler interface, but Google Cloud TTS
+     * fully implements it to provide comprehensive voice discovery capabilities.
+     *
+     * @param languageCode - Optional language filter (e.g., "en-US")
+     * @returns List of available voices
+     */
+    getVoices(_languageCode?: string): Promise<TTSVoice[]>;
+    /**
+     * 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>;
+}

package/dist/adapters/tts/googleTTSHandler.js

@@ -0,0 +1,68 @@
+/**
+ * Google Cloud Text-to-Speech Handler
+ *
+ * Handler for Google Cloud Text-to-Speech API integration.
+ * Supports Neural2 and WaveNet voice models with 220+ voices across 40+ languages.
+ *
+ * @module adapters/tts/googleTTSHandler
+ * @see https://cloud.google.com/text-to-speech/docs
+ */
+import { TextToSpeechClient } from "@google-cloud/text-to-speech";
+/**
+ * Google Cloud TTS handler implementation
+ *
+ * Integrates with Google Cloud Text-to-Speech API for voice synthesis.
+ * Supports authentication via:
+ *   - Explicit service account JSON key path
+ *   - GOOGLE_APPLICATION_CREDENTIALS environment variable
+ */
+export class GoogleTTSHandler {
+    client = null;
+    /**
+     * Maximum text length supported by Google Cloud TTS (5000 bytes)
+     * Different providers have different limits
+     */
+    static DEFAULT_MAX_TEXT_LENGTH = 5000;
+    maxTextLength = GoogleTTSHandler.DEFAULT_MAX_TEXT_LENGTH;
+    /**
+     * Constructor for GoogleTTSHandler
+     *
+     * @param credentialsPath - Optional path to Google Cloud credentials JSON file
+     */
+    constructor(credentialsPath) {
+        const path = credentialsPath ?? process.env.GOOGLE_APPLICATION_CREDENTIALS;
+        if (path) {
+            this.client = new TextToSpeechClient({ keyFilename: path });
+        }
+    }
+    /**
+     * Validate that the provider is properly configured
+     *
+     * @returns True if provider can generate TTS
+     */
+    isConfigured() {
+        throw new Error("Not implemented yet");
+    }
+    /**
+     * Get available voices for the provider
+     *
+     * Note: This method is optional in the TTSHandler interface, but Google Cloud TTS
+     * fully implements it to provide comprehensive voice discovery capabilities.
+     *
+     * @param languageCode - Optional language filter (e.g., "en-US")
+     * @returns List of available voices
+     */
+    async getVoices(_languageCode) {
+        throw new Error("Not implemented yet");
+    }
+    /**
+     * 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
+     */
+    async synthesize(_text, _options) {
+        throw new Error("Not implemented yet");
+    }
+}

package/dist/lib/adapters/tts/googleTTSHandler.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Google Cloud Text-to-Speech Handler
+ *
+ * Handler for Google Cloud Text-to-Speech API integration.
+ * Supports Neural2 and WaveNet voice models with 220+ voices across 40+ languages.
+ *
+ * @module adapters/tts/googleTTSHandler
+ * @see https://cloud.google.com/text-to-speech/docs
+ */
+import type { TTSHandler } from "../../utils/ttsProcessor.js";
+import type { TTSOptions, TTSResult, TTSVoice } from "../../types/ttsTypes.js";
+/**
+ * Google Cloud TTS handler implementation
+ *
+ * Integrates with Google Cloud Text-to-Speech API for voice synthesis.
+ * Supports authentication via:
+ *   - Explicit service account JSON key path
+ *   - GOOGLE_APPLICATION_CREDENTIALS environment variable
+ */
+export declare class GoogleTTSHandler implements TTSHandler {
+    private client;
+    /**
+     * Maximum text length supported by Google Cloud TTS (5000 bytes)
+     * Different providers have different limits
+     */
+    private static readonly DEFAULT_MAX_TEXT_LENGTH;
+    maxTextLength: number;
+    /**
+     * Constructor for GoogleTTSHandler
+     *
+     * @param credentialsPath - Optional path to Google Cloud credentials JSON file
+     */
+    constructor(credentialsPath?: string);
+    /**
+     * Validate that the provider is properly configured
+     *
+     * @returns True if provider can generate TTS
+     */
+    isConfigured(): boolean;
+    /**
+     * Get available voices for the provider
+     *
+     * Note: This method is optional in the TTSHandler interface, but Google Cloud TTS
+     * fully implements it to provide comprehensive voice discovery capabilities.
+     *
+     * @param languageCode - Optional language filter (e.g., "en-US")
+     * @returns List of available voices
+     */
+    getVoices(_languageCode?: string): Promise<TTSVoice[]>;
+    /**
+     * 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>;
+}

package/dist/lib/adapters/tts/googleTTSHandler.js

@@ -0,0 +1,69 @@
+/**
+ * Google Cloud Text-to-Speech Handler
+ *
+ * Handler for Google Cloud Text-to-Speech API integration.
+ * Supports Neural2 and WaveNet voice models with 220+ voices across 40+ languages.
+ *
+ * @module adapters/tts/googleTTSHandler
+ * @see https://cloud.google.com/text-to-speech/docs
+ */
+import { TextToSpeechClient } from "@google-cloud/text-to-speech";
+/**
+ * Google Cloud TTS handler implementation
+ *
+ * Integrates with Google Cloud Text-to-Speech API for voice synthesis.
+ * Supports authentication via:
+ *   - Explicit service account JSON key path
+ *   - GOOGLE_APPLICATION_CREDENTIALS environment variable
+ */
+export class GoogleTTSHandler {
+    client = null;
+    /**
+     * Maximum text length supported by Google Cloud TTS (5000 bytes)
+     * Different providers have different limits
+     */
+    static DEFAULT_MAX_TEXT_LENGTH = 5000;
+    maxTextLength = GoogleTTSHandler.DEFAULT_MAX_TEXT_LENGTH;
+    /**
+     * Constructor for GoogleTTSHandler
+     *
+     * @param credentialsPath - Optional path to Google Cloud credentials JSON file
+     */
+    constructor(credentialsPath) {
+        const path = credentialsPath ?? process.env.GOOGLE_APPLICATION_CREDENTIALS;
+        if (path) {
+            this.client = new TextToSpeechClient({ keyFilename: path });
+        }
+    }
+    /**
+     * Validate that the provider is properly configured
+     *
+     * @returns True if provider can generate TTS
+     */
+    isConfigured() {
+        throw new Error("Not implemented yet");
+    }
+    /**
+     * Get available voices for the provider
+     *
+     * Note: This method is optional in the TTSHandler interface, but Google Cloud TTS
+     * fully implements it to provide comprehensive voice discovery capabilities.
+     *
+     * @param languageCode - Optional language filter (e.g., "en-US")
+     * @returns List of available voices
+     */
+    async getVoices(_languageCode) {
+        throw new Error("Not implemented yet");
+    }
+    /**
+     * 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
+     */
+    async synthesize(_text, _options) {
+        throw new Error("Not implemented yet");
+    }
+}
+//# sourceMappingURL=googleTTSHandler.js.map

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

@@ -62,7 +62,7 @@ export interface TTSHandler {
      */
     isConfigured(): boolean;
     /**
-     * Maximum text length supported by this provider (in characters)
+     * Maximum text length supported by this provider (in bytes)
      * Different providers have different limits
      *
      * @default 3000 if not specified
@@ -95,7 +95,7 @@ export declare class TTSProcessor {
      */
     private static readonly handlers;
     /**
-     * Default maximum text length for TTS synthesis (characters)
+     * Default maximum text length for TTS synthesis (in bytes)
      *
      * Providers can override this value by specifying the `maxTextLength` property
      * in their respective `TTSHandler` implementation. If not specified, this default

package/dist/lib/utils/ttsProcessor.js

@@ -62,7 +62,7 @@ export class TTSProcessor {
      */
     static handlers = new Map();
     /**
-     * Default maximum text length for TTS synthesis (characters)
+     * Default maximum text length for TTS synthesis (in bytes)
      *
      * Providers can override this value by specifying the `maxTextLength` property
      * in their respective `TTSHandler` implementation. If not specified, this default

package/dist/utils/ttsProcessor.d.ts

@@ -62,7 +62,7 @@ export interface TTSHandler {
      */
     isConfigured(): boolean;
     /**
-     * Maximum text length supported by this provider (in characters)
+     * Maximum text length supported by this provider (in bytes)
      * Different providers have different limits
      *
      * @default 3000 if not specified
@@ -95,7 +95,7 @@ export declare class TTSProcessor {
      */
     private static readonly handlers;
     /**
-     * Default maximum text length for TTS synthesis (characters)
+     * Default maximum text length for TTS synthesis (in bytes)
      *
      * Providers can override this value by specifying the `maxTextLength` property
      * in their respective `TTSHandler` implementation. If not specified, this default

package/dist/utils/ttsProcessor.js

@@ -62,7 +62,7 @@ export class TTSProcessor {
      */
     static handlers = new Map();
     /**
-     * Default maximum text length for TTS synthesis (characters)
+     * Default maximum text length for TTS synthesis (in bytes)
      *
      * Providers can override this value by specifying the `maxTextLength` property
      * in their respective `TTSHandler` implementation. If not specified, this default

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "8.13.2",
+  "version": "8.14.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",
@@ -164,6 +164,7 @@
     "@aws-sdk/client-sagemaker-runtime": "^3.886.0",
     "@aws-sdk/credential-provider-node": "^3.886.0",
     "@aws-sdk/types": "^3.862.0",
+    "@google-cloud/text-to-speech": "^5.0.0",
     "@google-cloud/vertexai": "^1.10.0",
     "@google/genai": "^1.19.0",
     "@google/generative-ai": "^0.24.1",