@juspay/neurolink 11.27.0 → 11.28.0

package/dist/neurolink.js

@@ -4382,6 +4382,13 @@ Current user's request: ${currentInput}`;
         if (!providerName) {
             throw new Error('output.music.provider is required (e.g. "beatoven", "elevenlabs-music", "lyria", "replicate").');
         }
+        // This early-dispatch path never creates an AI provider, so
+        // ProviderRegistry.registerAllProviders() has NOT necessarily run —
+        // with the module-scope auto-registration retired, the handlers must
+        // be registered here explicitly. registerDefaultMusicHandlers() is
+        // idempotent (skip-if-registered), so the repeat call is free.
+        const { registerDefaultMusicHandlers } = await import("./music/index.js");
+        registerDefaultMusicHandlers();
         const { MusicProcessor } = await import("./utils/musicProcessor.js");
         const musicResult = await MusicProcessor.generate(providerName, {
             ...musicOptions,
@@ -4414,6 +4421,11 @@ Current user's request: ${currentInput}`;
         if (!providerName) {
             throw new Error('output.avatar.provider is required (e.g. "d-id", "heygen", "replicate").');
         }
+        // Same early-dispatch registration as generateWithMusic above: no AI
+        // provider is created on this path, so the retired module-scope
+        // auto-run must be replaced by an explicit (idempotent) call here.
+        const { registerDefaultAvatarHandlers } = await import("./avatar/index.js");
+        registerDefaultAvatarHandlers();
         const { AvatarProcessor } = await import("./utils/avatarProcessor.js");
         const avatarResult = await AvatarProcessor.generate(providerName, avatarOptions);
         generateSpan.setAttribute("neurolink.avatar.provider", providerName);

package/dist/types/index.d.ts

@@ -79,6 +79,7 @@ export * from "./video.js";
 export * from "./avatar.js";
 export * from "./music.js";
 export * from "./replicate.js";
+export * from "./mediaCatalog.js";
 export * from "./safeFetch.js";
 export * from "./modelPool.js";
 export * from "./requestRouter.js";

package/dist/types/index.js

@@ -85,6 +85,7 @@ export * from "./video.js";
 export * from "./avatar.js";
 export * from "./music.js";
 export * from "./replicate.js";
+export * from "./mediaCatalog.js";
 // Safe-fetch helper types (SSRF-hardened download)
 export * from "./safeFetch.js";
 // ModelPool — multi-provider failover with per-member cooldown (M9.x+)

package/dist/types/mediaCatalog.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Types backing the static media-handler catalog
+ * (src/lib/factories/mediaHandlerCatalog.ts) — the single source of truth
+ * for provider names/aliases across the six media-generation ecosystems
+ * (TTS, STT, Realtime, Video, Avatar, Music).
+ */
+export type MediaHandlerKind = "tts" | "stt" | "realtime" | "video" | "avatar" | "music";
+export type MediaHandlerDescriptor = {
+    readonly kind: MediaHandlerKind;
+    readonly name: string;
+    readonly aliases?: readonly string[];
+};

package/dist/types/mediaCatalog.js

@@ -0,0 +1,7 @@
+/**
+ * Types backing the static media-handler catalog
+ * (src/lib/factories/mediaHandlerCatalog.ts) — the single source of truth
+ * for provider names/aliases across the six media-generation ecosystems
+ * (TTS, STT, Realtime, Video, Avatar, Music).
+ */
+export {};

package/dist/voice/index.d.ts

@@ -8,9 +8,13 @@
  * 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
  */

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