@juspay/neurolink 11.24.0 → 11.24.1

package/dist/core/baseProvider.d.ts

@@ -220,6 +220,17 @@ export declare abstract class BaseProvider implements AIProvider {
     private handleVideoFrameGeneration;
     private executeStandardGenerateFlow;
     protected synthesizeAIResponseIfNeeded(enhancedResult: EnhancedGenerateResult, options: TextGenerationOptions): Promise<EnhancedGenerateResult>;
+    /**
+     * Build the public TTS failure detail.
+     *
+     * The message is redacted through the shared `sanitizeErrorCause` before it
+     * leaves this method. It used to be an internal value that only reached the
+     * logger; it is now carried on `result.ttsMetadata` and therefore reaches
+     * SDK callers, who may forward it to an end user. Provider errors quote the
+     * request URL often enough that a key in a query string is a real vector —
+     * `redactUrlsInText` strips exactly that while leaving a bare URL readable,
+     * so the diagnosis survives and the credential does not.
+     */
     private getTTSErrorDetails;
     /**
      * BACKWARD COMPATIBILITY: Legacy generateText method

package/dist/core/baseProvider.js

@@ -5,6 +5,7 @@ import { MiddlewareFactory } from "../middleware/factory.js";
 import { modelSupports } from "../models/modelRegistry.js";
 import { ATTR, tracers } from "../telemetry/index.js";
 import { ERROR_CODES, isAbortError, NeuroLinkError, } from "../utils/errorHandling.js";
+import { sanitizeErrorCause } from "../utils/logSanitize.js";
 import { createAnalytics as buildAnalytics } from "./analytics.js";
 import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
 import { duckTypedStatusCode, extractRetryAfterMsFromError, } from "../utils/providerRetry.js";
@@ -1224,24 +1225,36 @@ export class BaseProvider {
             };
         }
     }
+    /**
+     * Build the public TTS failure detail.
+     *
+     * The message is redacted through the shared `sanitizeErrorCause` before it
+     * leaves this method. It used to be an internal value that only reached the
+     * logger; it is now carried on `result.ttsMetadata` and therefore reaches
+     * SDK callers, who may forward it to an end user. Provider errors quote the
+     * request URL often enough that a key in a query string is a real vector —
+     * `redactUrlsInText` strips exactly that while leaving a bare URL readable,
+     * so the diagnosis survives and the credential does not.
+     */
     getTTSErrorDetails(error) {
+        const safeMessage = sanitizeErrorCause(error).message;
         if (error instanceof AsyncTimeoutError) {
             return {
                 code: TTS_ERROR_CODES.SYNTHESIS_FAILED,
-                message: error.message,
+                message: safeMessage,
                 retriable: true,
             };
         }
         if (error instanceof NeuroLinkError) {
             return {
                 code: error.code,
-                message: error.message,
+                message: safeMessage,
                 retriable: error.retriable,
             };
         }
         return {
             code: TTS_ERROR_CODES.SYNTHESIS_FAILED,
-            message: error instanceof Error ? error.message : String(error),
+            message: safeMessage,
         };
     }
     /**

package/dist/neurolink.js

@@ -4237,6 +4237,7 @@ Current user's request: ${currentInput}`;
                 }
                 : undefined,
             audio: textResult.audio,
+            ttsMetadata: textResult.ttsMetadata,
             transcription: textResult.transcription,
             video: textResult.video,
             avatar: textResult.avatar,
@@ -5719,6 +5720,7 @@ Current user's request: ${currentInput}`;
             enhancedWithTools: Boolean(hasToolExecutions),
             availableTools: transformToolsForMCP(transformToolsToExpectedFormat(availableTools)),
             audio: result.audio,
+            ttsMetadata: result.ttsMetadata,
             video: result.video,
             avatar: result.avatar,
             music: result.music,
@@ -5867,6 +5869,7 @@ Current user's request: ${currentInput}`;
                         analytics: poolResult.analytics,
                         evaluation: poolResult.evaluation,
                         audio: poolResult.audio,
+                        ttsMetadata: poolResult.ttsMetadata,
                         video: poolResult.video,
                         avatar: poolResult.avatar,
                         music: poolResult.music,
@@ -6149,6 +6152,7 @@ Current user's request: ${currentInput}`;
                     analytics: result.analytics,
                     evaluation: result.evaluation,
                     audio: result.audio,
+                    ttsMetadata: result.ttsMetadata,
                     video: result.video,
                     avatar: result.avatar,
                     music: result.music,

package/dist/types/generate.d.ts

@@ -848,6 +848,20 @@ export type GenerateResult = {
      * ```
      */
     audio?: TTSResult;
+    /**
+     * What happened during TTS synthesis, including why it failed.
+     *
+     * `generate()` degrades gracefully when synthesis fails: it returns the text
+     * and omits `audio`. Without this field a caller cannot tell a request that
+     * never asked for audio from one whose provider rejected the credentials —
+     * an invalid key produces a silent, indistinguishable absence.
+     *
+     * BaseProvider has always recorded this on EnhancedGenerateResult; it was
+     * declared there but never forwarded by the result builders, so callers
+     * reading it got `undefined`. Same defect the `reasoning` comment in
+     * neurolink.ts describes, on a different field.
+     */
+    ttsMetadata?: TTSMetadata;
     /**
      * Video generation result
      *
@@ -1454,6 +1468,8 @@ export type TextGenerationResult = {
     analytics?: AnalyticsData;
     evaluation?: EvaluationData;
     audio?: TTSResult;
+    /** Outcome of TTS synthesis, including the failure reason. */
+    ttsMetadata?: TTSMetadata;
     /** STT transcription result (present when stt input was processed) */
     transcription?: STTResult;
     /** Video generation result */
@@ -1502,8 +1518,6 @@ export type TTSMetadata = {
 export type EnhancedGenerateResult = GenerateResult & {
     analytics?: AnalyticsData;
     evaluation?: EvaluationData;
-    /** Outcome metadata when TTS was enabled for this generation. */
-    ttsMetadata?: TTSMetadata;
 };
 /**
  * NL-004: Model alias/deprecation configuration.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "11.24.0",
+  "version": "11.24.1",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {