@juspay/neurolink 11.2.3 → 11.2.4

package/dist/utils/sttProcessor.js

@@ -10,6 +10,7 @@ import { logger } from "./logger.js";
 import { STT_ERROR_CODES } from "../types/index.js";
 import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
 import { STTError } from "../voice/errors.js";
+import { HandlerRegistry } from "../core/handlerRegistry.js";
 import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../observability/index.js";
 /**
  * STT processor class for orchestrating speech-to-text operations
@@ -31,11 +32,10 @@ import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../
 export class STTProcessor {
     /**
      * Handler registry mapping provider names to STT handlers
-     * Uses Map for O(1) lookups and better type safety
      *
      * @private
      */
-    static handlers = new Map();
+    static registry = new HandlerRegistry("STTProcessor");
     /**
      * Default maximum audio duration for STT transcription (in seconds)
      *
@@ -66,17 +66,10 @@ export class STTProcessor {
      * ```
      */
     static registerHandler(providerName, handler) {
-        if (!providerName) {
-            throw new Error("Provider name is required");
-        }
-        if (!handler) {
-            throw new Error("Handler is required");
-        }
-        const normalizedName = providerName.toLowerCase();
-        if (this.handlers.has(normalizedName)) {
-            logger.warn(`[STTProcessor] Overwriting existing handler for provider: ${normalizedName}`);
-        }
-        this.handlers.set(normalizedName, handler);
+        const normalizedName = providerName
+            ? providerName.toLowerCase()
+            : providerName;
+        this.registry.register(providerName, handler);
         logger.debug(`[STTProcessor] Registered STT handler for provider: ${normalizedName}`);
     }
     /**
@@ -89,8 +82,20 @@ export class STTProcessor {
      * @returns Handler instance or undefined if not registered
      */
     static getHandler(providerName) {
-        const normalizedName = providerName.toLowerCase();
-        return this.handlers.get(normalizedName);
+        return this.registry.get(providerName);
+    }
+    /**
+     * List the names of all registered providers.
+     */
+    static listProviders() {
+        return this.registry.list();
+    }
+    /**
+     * Removes every registered STT handler. Primarily for test isolation —
+     * production code should not need to call this.
+     */
+    static clearHandlers() {
+        this.registry.clear();
     }
     /**
      * Check if a provider is supported (has a registered STT handler)
@@ -110,8 +115,7 @@ export class STTProcessor {
             logger.error("[STTProcessor] Provider name is required for supports check");
             return false;
         }
-        const normalizedName = providerName.toLowerCase();
-        const isSupported = this.handlers.has(normalizedName);
+        const isSupported = this.registry.supports(providerName);
         if (!isSupported) {
             logger.debug(`[STTProcessor] Provider ${providerName} is not supported`);
         }
@@ -192,7 +196,7 @@ export class STTProcessor {
                     retriable: false,
                     context: {
                         provider,
-                        availableProviders: Array.from(this.handlers.keys()),
+                        availableProviders: this.registry.list(),
                     },
                 });
             }

package/dist/utils/ttsProcessor.d.ts

@@ -54,11 +54,10 @@ export declare class TTSError extends NeuroLinkError {
 export declare class TTSProcessor {
     /**
      * Handler registry mapping provider names to TTS handlers
-     * Uses Map for O(1) lookups and better type safety
      *
      * @private
      */
-    private static readonly handlers;
+    private static readonly registry;
     /**
      * Default maximum text length for TTS synthesis (in bytes)
      *
@@ -100,6 +99,15 @@ export declare class TTSProcessor {
      * @returns Handler instance or undefined if not registered
      */
     static getHandler(providerName: string): TTSHandler | undefined;
+    /**
+     * List the names of all registered providers.
+     */
+    static listProviders(): string[];
+    /**
+     * Removes every registered TTS handler. Primarily for test isolation —
+     * production code should not need to call this.
+     */
+    static clearHandlers(): void;
     /**
      * Check if a provider is supported (has a registered TTS handler)
      *

package/dist/utils/ttsProcessor.js

@@ -9,6 +9,7 @@
 import { logger } from "./logger.js";
 import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
 import { NeuroLinkError } from "./errorHandling.js";
+import { HandlerRegistry } from "../core/handlerRegistry.js";
 import { SpanSerializer, SpanType, SpanStatus, getMetricsAggregator, } from "../observability/index.js";
 /**
  * TTS-specific error codes
@@ -58,11 +59,10 @@ export class TTSError extends NeuroLinkError {
 export class TTSProcessor {
     /**
      * Handler registry mapping provider names to TTS handlers
-     * Uses Map for O(1) lookups and better type safety
      *
      * @private
      */
-    static handlers = new Map();
+    static registry = new HandlerRegistry("TTSProcessor");
     /**
      * Default maximum text length for TTS synthesis (in bytes)
      *
@@ -93,17 +93,10 @@ export class TTSProcessor {
      * ```
      */
     static registerHandler(providerName, handler) {
-        if (!providerName) {
-            throw new Error("Provider name is required");
-        }
-        if (!handler) {
-            throw new Error("Handler is required");
-        }
-        const normalizedName = providerName.toLowerCase();
-        if (this.handlers.has(normalizedName)) {
-            logger.warn(`[TTSProcessor] Overwriting existing handler for provider: ${normalizedName}`);
-        }
-        this.handlers.set(normalizedName, handler);
+        const normalizedName = providerName
+            ? providerName.toLowerCase()
+            : providerName;
+        this.registry.register(providerName, handler);
         logger.debug(`[TTSProcessor] Registered TTS handler for provider: ${normalizedName}`);
     }
     /**
@@ -117,8 +110,20 @@ export class TTSProcessor {
      * @returns Handler instance or undefined if not registered
      */
     static getHandler(providerName) {
-        const normalizedName = providerName.toLowerCase();
-        return this.handlers.get(normalizedName);
+        return this.registry.get(providerName);
+    }
+    /**
+     * List the names of all registered providers.
+     */
+    static listProviders() {
+        return this.registry.list();
+    }
+    /**
+     * Removes every registered TTS handler. Primarily for test isolation —
+     * production code should not need to call this.
+     */
+    static clearHandlers() {
+        this.registry.clear();
     }
     /**
      * Check if a provider is supported (has a registered TTS handler)
@@ -138,8 +143,7 @@ export class TTSProcessor {
             logger.error("[TTSProcessor] Provider name is required for supports check");
             return false;
         }
-        const normalizedName = providerName.toLowerCase();
-        const isSupported = this.handlers.has(normalizedName);
+        const isSupported = this.registry.supports(providerName);
         if (!isSupported) {
             logger.debug(`[TTSProcessor] Provider ${providerName} is not supported`);
         }
@@ -211,7 +215,7 @@ export class TTSProcessor {
                     retriable: false,
                     context: {
                         provider,
-                        availableProviders: Array.from(this.handlers.keys()),
+                        availableProviders: this.registry.list(),
                     },
                 });
             }

package/dist/utils/videoProcessor.d.ts

@@ -22,7 +22,7 @@ export { VideoError, VIDEO_ERROR_CODES };
  * O(1) on a normalised lower-case provider key.
  */
 export declare class VideoProcessor {
-    private static readonly handlers;
+    private static readonly registry;
     /**
      * Register a video handler for a specific provider.
      */
@@ -36,6 +36,10 @@ export declare class VideoProcessor {
      */
     static listProviders(): string[];
     private static getHandler;
+    /**
+     * Clear all registered handlers (for testing).
+     */
+    static clearHandlers(): void;
     private static buildSpanAttributes;
     /**
      * Generate a single video clip via the registered handler.

package/dist/utils/videoProcessor.js

@@ -19,6 +19,7 @@ import { logger } from "./logger.js";
 // the same module. Both throws and instanceof checks resolve to the same
 // class.
 import { VideoError } from "../adapters/video/vertexVideoHandler.js";
+import { HandlerRegistry } from "../core/handlerRegistry.js";
 export { VideoError, VIDEO_ERROR_CODES };
 /**
  * Static processor managing the video handler registry.
@@ -28,41 +29,35 @@ export { VideoError, VIDEO_ERROR_CODES };
  * O(1) on a normalised lower-case provider key.
  */
 export class VideoProcessor {
-    static handlers = new Map();
+    static registry = new HandlerRegistry("VideoProcessor");
     /**
      * Register a video handler for a specific provider.
      */
     static registerHandler(providerName, handler) {
-        if (!providerName) {
-            throw new Error("Provider name is required");
-        }
-        if (!handler) {
-            throw new Error("Handler is required");
-        }
-        const key = providerName.toLowerCase();
-        if (this.handlers.has(key)) {
-            logger.warn(`[VideoProcessor] Overwriting existing handler for provider: ${key}`);
-        }
-        this.handlers.set(key, handler);
+        const key = providerName ? providerName.toLowerCase() : providerName;
+        this.registry.register(providerName, handler);
         logger.debug(`[VideoProcessor] Registered video handler: ${key}`);
     }
     /**
      * Check if a provider has a registered video handler.
      */
     static supports(providerName) {
-        if (!providerName) {
-            return false;
-        }
-        return this.handlers.has(providerName.toLowerCase());
+        return this.registry.supports(providerName);
     }
     /**
      * List the names of all registered providers.
      */
     static listProviders() {
-        return Array.from(this.handlers.keys());
+        return this.registry.list();
     }
     static getHandler(providerName) {
-        return this.handlers.get(providerName.toLowerCase());
+        return this.registry.get(providerName);
+    }
+    /**
+     * Clear all registered handlers (for testing).
+     */
+    static clearHandlers() {
+        this.registry.clear();
     }
     static buildSpanAttributes(provider, options) {
         return {

package/dist/voice/RealtimeVoiceAPI.d.ts

@@ -36,7 +36,7 @@ export declare class RealtimeProcessor {
     /**
      * Handler registry mapping provider names to Realtime handlers
      */
-    private static readonly handlers;
+    private static readonly registry;
     /**
      * Active sessions by provider
      */

package/dist/voice/RealtimeVoiceAPI.js

@@ -10,6 +10,7 @@ import { logger } from "../utils/logger.js";
 import { RealtimeError } from "./errors.js";
 import { DEFAULT_REALTIME_CONFIG, REALTIME_ERROR_CODES, } from "../types/index.js";
 import { ErrorCategory, ErrorSeverity } from "../constants/enums.js";
+import { HandlerRegistry } from "../core/handlerRegistry.js";
 /**
  * Realtime Processor class for orchestrating realtime voice operations
  *
@@ -39,7 +40,7 @@ export class RealtimeProcessor {
     /**
      * Handler registry mapping provider names to Realtime handlers
      */
-    static handlers = new Map();
+    static registry = new HandlerRegistry("RealtimeProcessor");
     /**
      * Active sessions by provider
      */
@@ -51,17 +52,10 @@ export class RealtimeProcessor {
      * @param handler - Realtime handler implementation
      */
     static registerHandler(providerName, handler) {
-        if (!providerName) {
-            throw new Error("Provider name is required");
-        }
-        if (!handler) {
-            throw new Error("Handler is required");
-        }
-        const normalizedName = providerName.toLowerCase();
-        if (this.handlers.has(normalizedName)) {
-            logger.warn(`[RealtimeProcessor] Overwriting existing handler for provider: ${normalizedName}`);
-        }
-        this.handlers.set(normalizedName, handler);
+        const normalizedName = providerName
+            ? providerName.toLowerCase()
+            : providerName;
+        this.registry.register(providerName, handler);
         logger.debug(`[RealtimeProcessor] Registered Realtime handler for provider: ${normalizedName}`);
     }
     /**
@@ -71,24 +65,19 @@ export class RealtimeProcessor {
      * already-registered primary handler when backfilling its aliases.
      */
     static getHandler(providerName) {
-        const normalizedName = providerName.toLowerCase();
-        return this.handlers.get(normalizedName);
+        return this.registry.get(providerName);
     }
     /**
      * Check if a provider is supported
      */
     static supports(providerName) {
-        if (!providerName) {
-            return false;
-        }
-        const normalizedName = providerName.toLowerCase();
-        return this.handlers.has(normalizedName);
+        return this.registry.supports(providerName);
     }
     /**
      * Get list of all registered providers
      */
     static getProviders() {
-        return Array.from(this.handlers.keys());
+        return this.registry.list();
     }
     /**
      * Connect to a realtime session
@@ -101,7 +90,7 @@ export class RealtimeProcessor {
     static async connect(provider, config, handlers) {
         const handler = this.getHandler(provider);
         if (!handler) {
-            throw RealtimeError.providerNotSupported(provider, Array.from(this.handlers.keys()));
+            throw RealtimeError.providerNotSupported(provider, this.registry.list());
         }
         if (!handler.isConfigured()) {
             throw RealtimeError.providerNotConfigured(provider);
@@ -145,7 +134,7 @@ export class RealtimeProcessor {
     static async disconnect(provider) {
         const handler = this.getHandler(provider);
         if (!handler) {
-            throw RealtimeError.providerNotSupported(provider, Array.from(this.handlers.keys()));
+            throw RealtimeError.providerNotSupported(provider, this.registry.list());
         }
         if (!handler.isConnected()) {
             logger.warn(`[RealtimeProcessor] No active session for provider: ${provider}`);
@@ -174,7 +163,7 @@ export class RealtimeProcessor {
     static async sendAudio(provider, audio) {
         const handler = this.getHandler(provider);
         if (!handler) {
-            throw RealtimeError.providerNotSupported(provider, Array.from(this.handlers.keys()));
+            throw RealtimeError.providerNotSupported(provider, this.registry.list());
         }
         if (!handler.isConnected()) {
             throw RealtimeError.sessionNotActive(provider);
@@ -199,7 +188,7 @@ export class RealtimeProcessor {
     static async sendText(provider, text) {
         const handler = this.getHandler(provider);
         if (!handler) {
-            throw RealtimeError.providerNotSupported(provider, Array.from(this.handlers.keys()));
+            throw RealtimeError.providerNotSupported(provider, this.registry.list());
         }
         if (!handler.isConnected()) {
             throw RealtimeError.sessionNotActive(provider);
@@ -243,7 +232,7 @@ export class RealtimeProcessor {
     static async triggerResponse(provider) {
         const handler = this.getHandler(provider);
         if (!handler) {
-            throw RealtimeError.providerNotSupported(provider, Array.from(this.handlers.keys()));
+            throw RealtimeError.providerNotSupported(provider, this.registry.list());
         }
         if (!handler.isConnected()) {
             throw RealtimeError.sessionNotActive(provider);
@@ -276,7 +265,7 @@ export class RealtimeProcessor {
     static async cancelResponse(provider) {
         const handler = this.getHandler(provider);
         if (!handler) {
-            throw RealtimeError.providerNotSupported(provider, Array.from(this.handlers.keys()));
+            throw RealtimeError.providerNotSupported(provider, this.registry.list());
         }
         if (!handler.isConnected()) {
             return; // Nothing to cancel
@@ -335,15 +324,15 @@ export class RealtimeProcessor {
     static clearHandlers() {
         // Disconnect all active sessions
         for (const [provider] of this.sessions) {
-            const handler = this.handlers.get(provider);
+            const handler = this.registry.get(provider);
             if (handler?.isConnected()) {
                 handler.disconnect().catch(() => {
                     // Ignore errors during cleanup
                 });
             }
         }
-        this.handlers.clear();
         this.sessions.clear();
+        this.registry.clear();
         logger.debug("[RealtimeProcessor] Cleared all handlers and sessions");
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "11.2.3",
+  "version": "11.2.4",
   "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": {
@@ -72,6 +72,7 @@
     "test:client": "npx tsx test/continuous-test-suite-client.ts",
     "test:context": "npx tsx test/continuous-test-suite-context.ts",
     "test:evaluation": "npx tsx test/continuous-test-suite-evaluation.ts",
+    "test:handler-registry": "npx tsx test/continuous-test-suite-handler-registry.ts",
     "test:mcp": "npx tsx test/continuous-test-suite-mcp-infra.ts",
     "test:tool-resolution": "npx tsx test/continuous-test-suite-tool-resolution.ts",
     "test:mcp:http": "npx tsx test/continuous-test-suite-mcp-http.ts",
@@ -106,9 +107,14 @@
     "test:servers": "npx tsx test/continuous-test-suite-servers.ts",
     "test:tool-reliability": "npx tsx test/continuous-test-suite-tool-reliability.ts",
     "test:tts": "npx tsx test/continuous-test-suite-tts.ts",
+    "test:tts:unit": "npx tsx test/continuous-test-suite-tts-unit.ts",
+    "test:stt:unit": "npx tsx test/continuous-test-suite-stt-unit.ts",
+    "test:realtime:unit": "npx tsx test/continuous-test-suite-realtime-unit.ts",
     "test:voice": "npx tsx test/continuous-test-suite-voice.ts",
     "test:avatar": "npx tsx test/continuous-test-suite-avatar.ts",
+    "test:avatar:unit": "npx tsx test/continuous-test-suite-avatar-unit.ts",
     "test:music": "npx tsx test/continuous-test-suite-music.ts",
+    "test:music:unit": "npx tsx test/continuous-test-suite-music-unit.ts",
     "test:image-gen": "npx tsx test/continuous-test-suite-image-gen-extras.ts",
     "test:credentials": "npx tsx test/continuous-test-suite-credentials.ts",
     "test:dynamic": "npx tsx test/continuous-test-suite-dynamic.ts",