@juspay/neurolink 11.26.2 → 11.28.0

package/dist/voice/index.js

@@ -8,12 +8,17 @@
  * Use STTProcessor (src/lib/utils/sttProcessor.ts) for STT.
  * Use RealtimeProcessor for realtime voice sessions.
  *
- * Importing this module also auto-registers every shipped TTS / STT /
- * Realtime handler whose backing API key is present in `process.env`.
- * Registration is idempotent and silently skipped on failure.
+ * Importing this module does NOT register any handlers as a side effect.
+ * Call `registerDefaultTTSHandlers()` / `registerDefaultSTTHandlers()` /
+ * `registerDefaultRealtimeHandlers()` explicitly (or go through
+ * `ProviderRegistry.registerAllProviders()`, which every documented
+ * `NeuroLink` entry point already calls) to register every shipped handler
+ * whose backing API key is present in `process.env`. Registration is
+ * idempotent and silently skipped on failure.
  *
  * @module voice
  */
+import { MEDIA_HANDLER_CATALOG } from "../factories/mediaHandlerCatalog.js";
 import { logger } from "../utils/logger.js";
 import { STTProcessor } from "../utils/sttProcessor.js";
 import { TTSProcessor } from "../utils/ttsProcessor.js";
@@ -76,37 +81,48 @@ import { GoogleSTT } from "./providers/GoogleSTT.js";
 import { OpenAISTT } from "./providers/OpenAISTT.js";
 import { GeminiLive } from "./providers/GeminiLive.js";
 import { OpenAIRealtime } from "./providers/OpenAIRealtime.js";
-const TTS_HANDLER_CANDIDATES = [
-    {
-        // Google TTS doubles as both the AI Studio and Vertex TTS handler.
-        name: "google-ai",
-        aliases: ["vertex"],
-        factory: () => new GoogleTTSHandler(),
-    },
-    { name: "openai-tts", factory: () => new OpenAITTS() },
-    {
-        name: "elevenlabs",
-        aliases: ["elevenlabs-tts"],
-        factory: () => new ElevenLabsTTS(),
-    },
-    { name: "azure-tts", factory: () => new AzureTTS() },
-    { name: "fish-audio", factory: () => new FishAudioTTS() },
-    { name: "cartesia", factory: () => new CartesiaTTS() },
-];
-const STT_HANDLER_CANDIDATES = [
-    {
-        name: "whisper",
-        aliases: ["openai-stt"],
-        factory: () => new OpenAISTT(),
-    },
-    { name: "deepgram", factory: () => new DeepgramSTT() },
-    { name: "google-stt", factory: () => new GoogleSTT() },
-    { name: "azure-stt", factory: () => new AzureSTT() },
-];
-const REALTIME_HANDLER_CANDIDATES = [
-    { name: "openai-realtime", factory: () => new OpenAIRealtime() },
-    { name: "gemini-live", factory: () => new GeminiLive() },
-];
+// Provider names + aliases are the Task-8 catalog's job — only the factory
+// (which needs the imported handler class) stays local to this module.
+const TTS_HANDLER_FACTORIES = {
+    // Google TTS doubles as both the AI Studio and Vertex TTS handler.
+    "google-ai": () => new GoogleTTSHandler(),
+    "openai-tts": () => new OpenAITTS(),
+    elevenlabs: () => new ElevenLabsTTS(),
+    "azure-tts": () => new AzureTTS(),
+    "fish-audio": () => new FishAudioTTS(),
+    cartesia: () => new CartesiaTTS(),
+};
+const TTS_HANDLER_CANDIDATES = MEDIA_HANDLER_CATALOG.filter((entry) => entry.kind === "tts").map((entry) => {
+    const factory = TTS_HANDLER_FACTORIES[entry.name];
+    if (!factory) {
+        throw new Error(`[voice/tts] no handler factory for catalog entry "${entry.name}"`);
+    }
+    return { name: entry.name, aliases: entry.aliases, factory };
+});
+const STT_HANDLER_FACTORIES = {
+    whisper: () => new OpenAISTT(),
+    deepgram: () => new DeepgramSTT(),
+    "google-stt": () => new GoogleSTT(),
+    "azure-stt": () => new AzureSTT(),
+};
+const STT_HANDLER_CANDIDATES = MEDIA_HANDLER_CATALOG.filter((entry) => entry.kind === "stt").map((entry) => {
+    const factory = STT_HANDLER_FACTORIES[entry.name];
+    if (!factory) {
+        throw new Error(`[voice/stt] no handler factory for catalog entry "${entry.name}"`);
+    }
+    return { name: entry.name, aliases: entry.aliases, factory };
+});
+const REALTIME_HANDLER_FACTORIES = {
+    "openai-realtime": () => new OpenAIRealtime(),
+    "gemini-live": () => new GeminiLive(),
+};
+const REALTIME_HANDLER_CANDIDATES = MEDIA_HANDLER_CATALOG.filter((entry) => entry.kind === "realtime").map((entry) => {
+    const factory = REALTIME_HANDLER_FACTORIES[entry.name];
+    if (!factory) {
+        throw new Error(`[voice/realtime] no handler factory for catalog entry "${entry.name}"`);
+    }
+    return { name: entry.name, aliases: entry.aliases, factory };
+});
 function registerCandidates(candidates, supports, getRegistered, register, scope, requireConfigured) {
     for (const { name, aliases, factory } of candidates) {
         // Compute missingName / missingAliases separately so a manually-
@@ -168,9 +184,3 @@ export function registerDefaultSTTHandlers() {
 export function registerDefaultRealtimeHandlers() {
     registerCandidates(REALTIME_HANDLER_CANDIDATES, (name) => RealtimeProcessor.supports(name), (name) => RealtimeProcessor.getHandler(name), (name, handler) => RealtimeProcessor.registerHandler(name, handler), "voice/realtime", false);
 }
-// Run once at module import so consumers who follow the documented
-// `nl.generate(...)` flow get every configured handler without manually
-// calling `registerHandler`.
-registerDefaultTTSHandlers();
-registerDefaultSTTHandlers();
-registerDefaultRealtimeHandlers();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "11.26.2",
+  "version": "11.28.0",
   "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": {
@@ -80,6 +80,7 @@
     "test:mcp:cli": "pnpm exec tsx test/continuous-test-suite-mcp-cli.ts",
     "test:mcp:full": "pnpm run test:mcp:infra && pnpm run test:mcp:spans && pnpm run test:mcp:sdk && pnpm run test:mcp:cli && pnpm run test:mcp:http",
     "test:media": "pnpm exec tsx test/continuous-test-suite-media-gen.ts",
+    "test:media-registry-collisions": "pnpm exec tsx test/continuous-test-suite-media-registry-collisions.ts",
     "test:memory": "pnpm exec tsx test/continuous-test-suite-memory.ts",
     "test:openai-compat-streaming-retry": "pnpm exec tsx test/continuous-test-suite-openai-compat-streaming-retry.ts",
     "test:anthropic-streaming-retry": "pnpm exec tsx test/continuous-test-suite-anthropic-streaming-retry.ts",