@juspay/neurolink 8.13.1 → 8.14.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [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
+
+- **(sdk):** Replace hardcoded timeouts with class constants ([a34c291](https://github.com/juspay/neurolink/commit/a34c29155e82ef4f498714c031401463351171bd))
+
 ## [8.13.1](https://github.com/juspay/neurolink/compare/v8.13.0...v8.13.1) (2025-12-13)
 
 ### 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/fileDetector.d.ts

@@ -15,6 +15,8 @@ import type { FileInput, FileProcessingResult, FileDetectorOptions } from "../ty
  * ```
  */
 export declare class FileDetector {
+    static readonly DEFAULT_NETWORK_TIMEOUT = 30000;
+    static readonly DEFAULT_HEAD_TIMEOUT = 5000;
     /**
      * Auto-detect file type and process in one call
      *

package/dist/lib/utils/fileDetector.js

@@ -35,6 +35,10 @@ function formatFileSize(bytes) {
  * ```
  */
 export class FileDetector {
+    // FD-017: Replace hardcoded timeouts with constants.
+    // These default ensure consistent timeout behavior across all file-detection logic.
+    static DEFAULT_NETWORK_TIMEOUT = 30000; // 30 seconds
+    static DEFAULT_HEAD_TIMEOUT = 5000; // 5 seconds
     /**
      * Auto-detect file type and process in one call
      *
@@ -144,7 +148,7 @@ export class FileDetector {
      */
     static async loadFromURL(url, options) {
         const maxSize = options?.maxSize || 10 * 1024 * 1024;
-        const timeout = options?.timeout || 30000;
+        const timeout = options?.timeout || this.DEFAULT_NETWORK_TIMEOUT;
         const response = await request(url, {
             dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
             method: "GET",
@@ -273,8 +277,8 @@ class MimeTypeStrategy {
             const response = await request(input, {
                 dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
                 method: "HEAD",
-                headersTimeout: 5000,
-                bodyTimeout: 5000,
+                headersTimeout: FileDetector.DEFAULT_HEAD_TIMEOUT,
+                bodyTimeout: FileDetector.DEFAULT_HEAD_TIMEOUT,
             });
             const contentType = response.headers["content-type"] || "";
             const type = this.mimeToFileType(contentType);

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/fileDetector.d.ts

@@ -15,6 +15,8 @@ import type { FileInput, FileProcessingResult, FileDetectorOptions } from "../ty
  * ```
  */
 export declare class FileDetector {
+    static readonly DEFAULT_NETWORK_TIMEOUT = 30000;
+    static readonly DEFAULT_HEAD_TIMEOUT = 5000;
     /**
      * Auto-detect file type and process in one call
      *

package/dist/utils/fileDetector.js

@@ -35,6 +35,10 @@ function formatFileSize(bytes) {
  * ```
  */
 export class FileDetector {
+    // FD-017: Replace hardcoded timeouts with constants.
+    // These default ensure consistent timeout behavior across all file-detection logic.
+    static DEFAULT_NETWORK_TIMEOUT = 30000; // 30 seconds
+    static DEFAULT_HEAD_TIMEOUT = 5000; // 5 seconds
     /**
      * Auto-detect file type and process in one call
      *
@@ -144,7 +148,7 @@ export class FileDetector {
      */
     static async loadFromURL(url, options) {
         const maxSize = options?.maxSize || 10 * 1024 * 1024;
-        const timeout = options?.timeout || 30000;
+        const timeout = options?.timeout || this.DEFAULT_NETWORK_TIMEOUT;
         const response = await request(url, {
             dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
             method: "GET",
@@ -273,8 +277,8 @@ class MimeTypeStrategy {
             const response = await request(input, {
                 dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
                 method: "HEAD",
-                headersTimeout: 5000,
-                bodyTimeout: 5000,
+                headersTimeout: FileDetector.DEFAULT_HEAD_TIMEOUT,
+                bodyTimeout: FileDetector.DEFAULT_HEAD_TIMEOUT,
             });
             const contentType = response.headers["content-type"] || "";
             const type = this.mimeToFileType(contentType);

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.1",
+  "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",