@juspay/neurolink 9.54.3 → 9.54.5

package/dist/lib/client/errors.d.ts

@@ -6,7 +6,7 @@
  *
  * @module @neurolink/client/errors
  */
-import type { ApiError, JsonObject } from "../types/clientTypes.js";
+import type { ClientApiError, ErrorCodeType, JsonObject } from "../types/index.js";
 /**
  * Standard error codes for NeuroLink API errors
  */
@@ -39,7 +39,6 @@ export declare const ErrorCode: {
     readonly CONTENT_FILTERED: "CONTENT_FILTERED";
     readonly UNKNOWN: "UNKNOWN";
 };
-export type ErrorCodeType = (typeof ErrorCode)[keyof typeof ErrorCode];
 /**
  * Base error class for all NeuroLink client errors
  *
@@ -67,7 +66,7 @@ export declare class NeuroLinkError extends Error {
     /**
      * Convert error to API error format
      */
-    toApiError(): ApiError;
+    toApiError(): ClientApiError;
     /**
      * Convert error to JSON
      */
@@ -268,7 +267,7 @@ export declare class ContentFilterError extends ClientProviderError {
 /**
  * Create an error from an API error response
  */
-export declare function createErrorFromResponse(apiError: ApiError, options?: {
+export declare function createErrorFromResponse(apiError: ClientApiError, options?: {
     requestId?: string;
 }): NeuroLinkError;
 /**
@@ -294,6 +293,6 @@ export declare function isRetryableError(error: unknown): boolean;
  */
 export declare function isNeuroLinkError(error: unknown): error is NeuroLinkError;
 /**
- * Type guard for ApiError
+ * Type guard for ClientApiError
  */
-export declare function isApiError(error: unknown): error is ApiError;
+export declare function isApiError(error: unknown): error is ClientApiError;

package/dist/lib/client/errors.js

@@ -541,7 +541,7 @@ export function isNeuroLinkError(error) {
     return error instanceof NeuroLinkError;
 }
 /**
- * Type guard for ApiError
+ * Type guard for ClientApiError
  */
 export function isApiError(error) {
     if (typeof error !== "object" || error === null) {

package/dist/lib/client/httpClient.d.ts

@@ -6,8 +6,7 @@
  *
  * @module @neurolink/client
  */
-import type { ClientConfig, RequestOptions, ClientApiResponse, ApiError, ClientRetryConfig, Middleware, MiddlewareRequest, MiddlewareResponse, ClientMiddlewareContext, StreamCallbacks, ClientStreamEvent, ClientStreamResult, GenerateRequestOptions, GenerateResponse, StreamRequestOptions, AgentExecuteOptions, AgentExecuteResult, AgentInfo, WorkflowExecuteOptions, WorkflowExecuteResult, WorkflowInfo, ToolInfo, ClientProviderStatus, WebSocketOptions, WebSocketState, WebSocketMessageHandler } from "../types/clientTypes.js";
-import type { UnknownRecord } from "../types/common.js";
+import type { ClientConfig, ClientRequestOptions, ClientApiResponse, ClientApiError, ClientRetryConfig, ClientMiddleware, ClientMiddlewareRequest, ClientMiddlewareResponse, ClientMiddlewareContext, ClientStreamCallbacks, ClientStreamEvent, ClientStreamResult, ClientGenerateRequestOptions, ClientGenerateResponse, ClientStreamRequestOptions, ClientAgentExecuteOptions, ClientAgentExecuteResult, ClientAgentInfo, ClientWorkflowExecuteOptions, ClientWorkflowExecuteResult, ClientWorkflowInfo, ClientToolInfo, ClientProviderStatus, ClientWebSocketOptions, ClientWebSocketState, ClientWebSocketMessageHandler, UnknownRecord } from "../types/index.js";
 import { HttpError, ClientNetworkError, ClientTimeoutError } from "./errors.js";
 /**
  * Combine multiple AbortSignals into a single signal.
@@ -66,10 +65,10 @@ export declare class NeuroLinkClient {
     /**
      * Add middleware to the client
      *
-     * @param middleware - Middleware function
+     * @param middleware - ClientMiddleware function
      * @returns Client instance for chaining
      */
-    use(middleware: Middleware): this;
+    use(middleware: ClientMiddleware): this;
     /**
      * Clear all middleware
      */
@@ -114,7 +113,7 @@ export declare class NeuroLinkClient {
      * console.log(response.data.content);
      * ```
      */
-    generate(options: GenerateRequestOptions, requestOptions?: RequestOptions): Promise<ClientApiResponse<GenerateResponse>>;
+    generate(options: ClientGenerateRequestOptions, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientGenerateResponse>>;
     /**
      * Stream text generation
      *
@@ -129,7 +128,7 @@ export declare class NeuroLinkClient {
      * );
      * ```
      */
-    stream(options: StreamRequestOptions | GenerateRequestOptions, callbacks?: StreamCallbacks, requestOptions?: RequestOptions): Promise<ClientStreamResult>;
+    stream(options: ClientStreamRequestOptions | ClientGenerateRequestOptions, callbacks?: ClientStreamCallbacks, requestOptions?: ClientRequestOptions): Promise<ClientStreamResult>;
     /**
      * Handle individual stream events
      */
@@ -147,19 +146,19 @@ export declare class NeuroLinkClient {
      * console.log(result.data.content);
      * ```
      */
-    executeAgent(options: AgentExecuteOptions, requestOptions?: RequestOptions): Promise<ClientApiResponse<AgentExecuteResult>>;
+    executeAgent(options: ClientAgentExecuteOptions, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientAgentExecuteResult>>;
     /**
      * Stream agent execution
      */
-    streamAgent(options: AgentExecuteOptions, callbacks?: StreamCallbacks, requestOptions?: RequestOptions): Promise<ClientStreamResult>;
+    streamAgent(options: ClientAgentExecuteOptions, callbacks?: ClientStreamCallbacks, requestOptions?: ClientRequestOptions): Promise<ClientStreamResult>;
     /**
      * List available agents
      */
-    listAgents(requestOptions?: RequestOptions): Promise<ClientApiResponse<AgentInfo[]>>;
+    listAgents(requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientAgentInfo[]>>;
     /**
      * Get agent details
      */
-    getAgent(agentId: string, requestOptions?: RequestOptions): Promise<ClientApiResponse<AgentInfo>>;
+    getAgent(agentId: string, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientAgentInfo>>;
     /**
      * Execute a workflow
      *
@@ -179,29 +178,29 @@ export declare class NeuroLinkClient {
      * }
      * ```
      */
-    executeWorkflow(options: WorkflowExecuteOptions, requestOptions?: RequestOptions): Promise<ClientApiResponse<WorkflowExecuteResult>>;
+    executeWorkflow(options: ClientWorkflowExecuteOptions, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientWorkflowExecuteResult>>;
     /**
      * Resume a suspended workflow
      */
-    resumeWorkflow(workflowId: string, resumeToken: string, resumeData?: UnknownRecord, requestOptions?: RequestOptions): Promise<ClientApiResponse<WorkflowExecuteResult>>;
+    resumeWorkflow(workflowId: string, resumeToken: string, resumeData?: UnknownRecord, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientWorkflowExecuteResult>>;
     /**
      * Get workflow execution status
      */
-    getWorkflowStatus(workflowId: string, runId: string, requestOptions?: RequestOptions): Promise<ClientApiResponse<WorkflowExecuteResult>>;
+    getWorkflowStatus(workflowId: string, runId: string, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientWorkflowExecuteResult>>;
     /**
      * Cancel workflow execution
      */
-    cancelWorkflow(workflowId: string, runId: string, requestOptions?: RequestOptions): Promise<ClientApiResponse<{
+    cancelWorkflow(workflowId: string, runId: string, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<{
         success: boolean;
     }>>;
     /**
      * List available workflows
      */
-    listWorkflows(requestOptions?: RequestOptions): Promise<ClientApiResponse<WorkflowInfo[]>>;
+    listWorkflows(requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientWorkflowInfo[]>>;
     /**
      * Get workflow details
      */
-    getWorkflow(workflowId: string, requestOptions?: RequestOptions): Promise<ClientApiResponse<WorkflowInfo>>;
+    getWorkflow(workflowId: string, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientWorkflowInfo>>;
     /**
      * List available tools
      *
@@ -214,27 +213,27 @@ export declare class NeuroLinkClient {
     listTools(options?: {
         category?: string;
         serverId?: string;
-    }, requestOptions?: RequestOptions): Promise<ClientApiResponse<ToolInfo[]>>;
+    }, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientToolInfo[]>>;
     /**
      * Execute a tool
      */
-    executeTool(toolName: string, params: UnknownRecord, requestOptions?: RequestOptions): Promise<ClientApiResponse<unknown>>;
+    executeTool(toolName: string, params: UnknownRecord, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<unknown>>;
     /**
      * Get tool details
      */
-    getTool(toolName: string, requestOptions?: RequestOptions): Promise<ClientApiResponse<ToolInfo>>;
+    getTool(toolName: string, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientToolInfo>>;
     /**
      * List available providers
      */
-    listProviders(requestOptions?: RequestOptions): Promise<ClientApiResponse<ClientProviderStatus[]>>;
+    listProviders(requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientProviderStatus[]>>;
     /**
      * Get provider status
      */
-    getProviderStatus(providerName: string, requestOptions?: RequestOptions): Promise<ClientApiResponse<ClientProviderStatus>>;
+    getProviderStatus(providerName: string, requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<ClientProviderStatus>>;
     /**
      * Health check
      */
-    health(requestOptions?: RequestOptions): Promise<ClientApiResponse<{
+    health(requestOptions?: ClientRequestOptions): Promise<ClientApiResponse<{
         status: string;
         version: string;
     }>>;
@@ -253,7 +252,7 @@ export declare class NeuroLinkClient {
      * });
      * ```
      */
-    connectWebSocket(options?: Partial<WebSocketOptions>): void;
+    connectWebSocket(options?: Partial<ClientWebSocketOptions>): void;
     /**
      * Disconnect WebSocket
      */
@@ -265,11 +264,11 @@ export declare class NeuroLinkClient {
     /**
      * Register WebSocket message handler
      */
-    onWebSocketMessage(messageType: string, handler: WebSocketMessageHandler): () => void;
+    onWebSocketMessage(messageType: string, handler: ClientWebSocketMessageHandler): () => void;
     /**
      * Get WebSocket connection state
      */
-    getWebSocketState(): WebSocketState;
+    getWebSocketState(): ClientWebSocketState;
     /**
      * Update client configuration
      */
@@ -294,4 +293,4 @@ export declare class NeuroLinkClient {
  * ```
  */
 export declare function createClient(config: ClientConfig): NeuroLinkClient;
-export type { ClientConfig, RequestOptions, ClientApiResponse, ApiError, ClientRetryConfig, Middleware, MiddlewareRequest, MiddlewareResponse, ClientMiddlewareContext, StreamCallbacks, ClientStreamEvent, ClientStreamResult, GenerateRequestOptions, GenerateResponse, StreamRequestOptions, AgentExecuteOptions, AgentExecuteResult, AgentInfo, WorkflowExecuteOptions, WorkflowExecuteResult, WorkflowInfo, ToolInfo, ClientProviderStatus, WebSocketOptions, WebSocketState, WebSocketMessageHandler, };
+export type { ClientConfig, ClientRequestOptions, ClientApiResponse, ClientApiError, ClientRetryConfig, ClientMiddleware, ClientMiddlewareRequest, ClientMiddlewareResponse, ClientMiddlewareContext, ClientStreamCallbacks, ClientStreamEvent, ClientStreamResult, ClientGenerateRequestOptions, ClientGenerateResponse, ClientStreamRequestOptions, ClientAgentExecuteOptions, ClientAgentExecuteResult, ClientAgentInfo, ClientWorkflowExecuteOptions, ClientWorkflowExecuteResult, ClientWorkflowInfo, ClientToolInfo, ClientProviderStatus, ClientWebSocketOptions, ClientWebSocketState, ClientWebSocketMessageHandler, };

package/dist/lib/client/httpClient.js

@@ -6,7 +6,7 @@
  *
  * @module @neurolink/client
  */
-import { HttpError, ClientNetworkError, ClientTimeoutError, } from "./errors.js";
+import { HttpError, ClientNetworkError, ClientTimeoutError } from "./errors.js";
 import { logger } from "../utils/logger.js";
 // =============================================================================
 // Shared Utilities
@@ -122,12 +122,12 @@ export class NeuroLinkClient {
         throw new Error("No fetch implementation available. Please provide a custom fetch function in the client configuration.");
     }
     // ===========================================================================
-    // Middleware Methods
+    // ClientMiddleware Methods
     // ===========================================================================
     /**
      * Add middleware to the client
      *
-     * @param middleware - Middleware function
+     * @param middleware - ClientMiddleware function
      * @returns Client instance for chaining
      */
     use(middleware) {

package/dist/lib/client/index.d.ts

@@ -92,20 +92,11 @@
  * ```
  */
 export { NeuroLinkClient, createClient, NeuroLinkApiError, } from "./httpClient.js";
-export type { ClientConfig, RequestOptions, ClientApiResponse as ApiResponse, ApiError, ClientRetryConfig as RetryConfig, Middleware, MiddlewareRequest, MiddlewareResponse, ClientMiddlewareContext as MiddlewareContext, StreamCallbacks, ClientStreamEvent as StreamEvent, StreamEventType, ClientStreamResult as StreamResult, GenerateRequestOptions, GenerateResponse, StreamRequestOptions, AgentExecuteOptions, AgentExecuteResult, AgentInfo, WorkflowExecuteOptions, WorkflowExecuteResult, WorkflowInfo, ToolInfo, ClientProviderStatus as ProviderStatus, WebSocketOptions, WebSocketState, WebSocketMessageHandler, } from "../types/clientTypes.js";
 export { NeuroLinkProvider, useNeuroLinkClient, useChat, useAgent, useWorkflow, useVoice, useStream, useTools, } from "./reactHooks.js";
-export type { NeuroLinkProviderProps } from "./reactHooks.js";
-export type { UseChatOptions, UseChatReturn, UseAgentOptions, UseAgentReturn, UseWorkflowOptions, UseWorkflowReturn, UseVoiceOptions, UseVoiceReturn, UseStreamOptions, UseStreamReturn, UseToolsOptions, UseToolsReturn, ClientChatMessage as ChatMessage, NeuroLinkProviderOptions, ModelOptions, LanguageModel, LanguageModelCallOptions, LanguageModelResponse, LanguageModelStreamResponse, } from "../types/clientTypes.js";
 export { NeuroLinkLanguageModel, NeuroLinkProvider as NeuroLinkAIProvider, createNeuroLinkProvider, createNeuroLinkModel, createStreamingResponse, neurolink, } from "./aiSdkAdapter.js";
 export { createApiKeyAuthInterceptor, createBearerAuthInterceptor, createDynamicAuthInterceptor, createLoggingInterceptor, createRetryInterceptor, createRateLimitInterceptor, createRequestTransformInterceptor, createResponseTransformInterceptor, createCacheInterceptor, createTimeoutInterceptor, createErrorHandlerInterceptor, composeMiddleware, conditionalMiddleware, } from "./interceptors.js";
-export type { LoggingInterceptorOptions, RetryInterceptorOptions, RateLimiterOptions, CacheInterceptorOptions, TimeoutInterceptorOptions, ErrorHandlerOptions, } from "./interceptors.js";
 export { SSEClient, WebSocketStreamingClient, createStreamingClient, createAsyncStream, collectStream, } from "./streamingClient.js";
-export type { SSEConnectionOptions, SSEConnectionState, StreamingRequestOptions, StreamingEventEmitter, StreamingClientConfig, } from "./streamingClient.js";
 export { NeuroLinkWebSocket, createWebSocketClient } from "./wsClient.js";
-export type { WebSocketConfig, WebSocketMessage, WebSocketEventHandlers, WebSocketState as WSState, } from "./wsClient.js";
 export { NeuroLinkSSE, createSSEClient } from "./sseClient.js";
-export type { SSEConfig, SSERequestOptions, SSEEventHandlers, SSEState, } from "./sseClient.js";
 export { OAuth2TokenManager, JWTTokenManager, createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, OAuth2Error, OAuth2AuthenticationError as OAuth2AuthError, TokenRefreshError, decodeJWTPayload, isJWTExpired, getJWTExpiry, getApiKeyFromEnv, } from "./auth.js";
-export type { AuthConfig, ClientOAuth2Config as OAuth2Config, ClientTokenRefreshResult as TokenRefreshResult, SpeechRecognitionResult, SpeechSynthesisOptions, JsonValue, JsonObject, UnknownRecord, ToolCall, ToolResult, } from "../types/clientTypes.js";
 export { ErrorCode, NeuroLinkError, HttpError, ClientRateLimitError, ClientValidationError, ClientAuthenticationError, ClientAuthorizationError, NotFoundError, ClientNetworkError, ClientTimeoutError, ClientConnectionError, AbortError, ClientConfigurationError, StreamError, ClientProviderError, ContextLengthError, ContentFilterError, createErrorFromResponse, createErrorFromNative, mapStatusToErrorCode, isRetryableStatus, isRetryableError, isNeuroLinkError, isApiError, } from "./errors.js";
-export type { ErrorCodeType } from "./errors.js";

package/dist/lib/client/index.js

@@ -144,7 +144,7 @@ export { NeuroLinkSSE, createSSEClient } from "./sseClient.js";
 export { 
 // Token Managers
 OAuth2TokenManager, JWTTokenManager, 
-// Auth Middleware
+// Auth ClientMiddleware
 createApiKeyMiddleware, createBearerTokenMiddleware, createTokenManagerMiddleware, createAuthWithRetryMiddleware, createMultiAuthMiddleware, 
 // Error Classes
 OAuth2Error, OAuth2AuthenticationError as OAuth2AuthError, TokenRefreshError, 

package/dist/lib/client/interceptors.d.ts

@@ -6,7 +6,7 @@
  *
  * @module @neurolink/client/interceptors
  */
-import type { Middleware, MiddlewareRequest, MiddlewareResponse, ClientMiddlewareContext as MiddlewareContext, ClientRetryConfig as RetryConfig, ApiError } from "../types/clientTypes.js";
+import type { ClientMiddleware, ClientMiddlewareRequest, ClientMiddlewareResponse, CacheInterceptorOptions, ErrorHandlerOptions, LoggingInterceptorOptions, RateLimiterOptions, RetryInterceptorOptions, TimeoutInterceptorOptions } from "../types/index.js";
 /**
  * API Key authentication interceptor
  *
@@ -17,7 +17,7 @@ import type { Middleware, MiddlewareRequest, MiddlewareResponse, ClientMiddlewar
  * client.use(createApiKeyAuthInterceptor('your-api-key'));
  * ```
  */
-export declare function createApiKeyAuthInterceptor(apiKey: string): Middleware;
+export declare function createApiKeyAuthInterceptor(apiKey: string): ClientMiddleware;
 /**
  * Bearer token authentication interceptor
  *
@@ -28,7 +28,7 @@ export declare function createApiKeyAuthInterceptor(apiKey: string): Middleware;
  * client.use(createBearerAuthInterceptor('your-token'));
  * ```
  */
-export declare function createBearerAuthInterceptor(token: string): Middleware;
+export declare function createBearerAuthInterceptor(token: string): ClientMiddleware;
 /**
  * Dynamic authentication interceptor
  *
@@ -49,24 +49,7 @@ export declare function createDynamicAuthInterceptor(getAuth: () => Promise<{
 } | {
     type: "bearer";
     token: string;
-} | null>): Middleware;
-/**
- * Logging interceptor options
- */
-export type LoggingInterceptorOptions = {
-    /** Log request details */
-    logRequest?: boolean;
-    /** Log response details */
-    logResponse?: boolean;
-    /** Log request body */
-    logBody?: boolean;
-    /** Log response body */
-    logResponseBody?: boolean;
-    /** Custom logger function */
-    logger?: (message: string, data?: unknown) => void;
-    /** Redact sensitive fields */
-    redactFields?: string[];
-};
+} | null>): ClientMiddleware;
 /**
  * Logging interceptor
  *
@@ -81,16 +64,7 @@ export type LoggingInterceptorOptions = {
  * }));
  * ```
  */
-export declare function createLoggingInterceptor(options?: LoggingInterceptorOptions): Middleware;
-/**
- * Retry interceptor options
- */
-export type RetryInterceptorOptions = RetryConfig & {
-    /** Callback when a retry is attempted */
-    onRetry?: (attempt: number, error: Error | ApiError, request: MiddlewareRequest) => void;
-    /** Custom retry condition */
-    shouldRetry?: (response: MiddlewareResponse, attempt: number) => boolean;
-};
+export declare function createLoggingInterceptor(options?: LoggingInterceptorOptions): ClientMiddleware;
 /**
  * Retry interceptor with exponential backoff
  *
@@ -108,20 +82,7 @@ export type RetryInterceptorOptions = RetryConfig & {
  * }));
  * ```
  */
-export declare function createRetryInterceptor(options: RetryInterceptorOptions): Middleware;
-/**
- * Rate limiter options
- */
-export type RateLimiterOptions = {
-    /** Maximum requests per window */
-    maxRequests: number;
-    /** Window size in milliseconds */
-    windowMs: number;
-    /** Strategy when limit is reached: 'queue' or 'throw' */
-    strategy?: "queue" | "throw";
-    /** Callback when rate limited */
-    onRateLimited?: (waitTime: number) => void;
-};
+export declare function createRetryInterceptor(options: RetryInterceptorOptions): ClientMiddleware;
 /**
  * Rate limiting interceptor
  *
@@ -137,7 +98,7 @@ export type RateLimiterOptions = {
  * }));
  * ```
  */
-export declare function createRateLimitInterceptor(options: RateLimiterOptions): Middleware;
+export declare function createRateLimitInterceptor(options: RateLimiterOptions): ClientMiddleware;
 /**
  * Request transformation interceptor
  *
@@ -154,7 +115,7 @@ export declare function createRateLimitInterceptor(options: RateLimiterOptions):
  * }));
  * ```
  */
-export declare function createRequestTransformInterceptor(transform: (request: MiddlewareRequest) => MiddlewareRequest | Promise<MiddlewareRequest>): Middleware;
+export declare function createRequestTransformInterceptor(transform: (request: ClientMiddlewareRequest) => ClientMiddlewareRequest | Promise<ClientMiddlewareRequest>): ClientMiddleware;
 /**
  * Response transformation interceptor
  *
@@ -169,24 +130,7 @@ export declare function createRequestTransformInterceptor(transform: (request: M
  * }));
  * ```
  */
-export declare function createResponseTransformInterceptor(transform: (response: MiddlewareResponse) => MiddlewareResponse | Promise<MiddlewareResponse>): Middleware;
-/**
- * Cache options
- */
-export type CacheInterceptorOptions = {
-    /** Cache TTL in milliseconds */
-    ttl: number;
-    /** Maximum cache size */
-    maxSize?: number;
-    /** Cache key generator */
-    keyGenerator?: (request: MiddlewareRequest) => string;
-    /** Methods to cache (default: ['GET']) */
-    methods?: string[];
-    /** Paths to cache (regex patterns) */
-    includePaths?: RegExp[];
-    /** Paths to exclude from cache */
-    excludePaths?: RegExp[];
-};
+export declare function createResponseTransformInterceptor(transform: (response: ClientMiddlewareResponse) => ClientMiddlewareResponse | Promise<ClientMiddlewareResponse>): ClientMiddleware;
 /**
  * Caching interceptor
  *
@@ -201,16 +145,7 @@ export type CacheInterceptorOptions = {
  * }));
  * ```
  */
-export declare function createCacheInterceptor(options: CacheInterceptorOptions): Middleware;
-/**
- * Timeout interceptor options
- */
-export type TimeoutInterceptorOptions = {
-    /** Timeout in milliseconds */
-    timeout: number;
-    /** Callback when timeout occurs */
-    onTimeout?: (request: MiddlewareRequest) => void;
-};
+export declare function createCacheInterceptor(options: CacheInterceptorOptions): ClientMiddleware;
 /**
  * Timeout interceptor
  *
@@ -224,18 +159,7 @@ export type TimeoutInterceptorOptions = {
  * }));
  * ```
  */
-export declare function createTimeoutInterceptor(options: TimeoutInterceptorOptions): Middleware;
-/**
- * Error handling interceptor options
- */
-export type ErrorHandlerOptions = {
-    /** Custom error handler */
-    onError?: (error: Error, request: MiddlewareRequest) => Error | void;
-    /** Transform error response */
-    transformError?: (error: unknown) => ApiError;
-    /** Report errors to external service */
-    reportError?: (error: Error, context: MiddlewareContext) => void | Promise<void>;
-};
+export declare function createTimeoutInterceptor(options: TimeoutInterceptorOptions): ClientMiddleware;
 /**
  * Error handling interceptor
  *
@@ -253,7 +177,7 @@ export type ErrorHandlerOptions = {
  * }));
  * ```
  */
-export declare function createErrorHandlerInterceptor(options?: ErrorHandlerOptions): Middleware;
+export declare function createErrorHandlerInterceptor(options?: ErrorHandlerOptions): ClientMiddleware;
 /**
  * Compose multiple middleware into one
  *
@@ -268,7 +192,7 @@ export declare function createErrorHandlerInterceptor(options?: ErrorHandlerOpti
  * client.use(combinedMiddleware);
  * ```
  */
-export declare function composeMiddleware(...middlewares: Middleware[]): Middleware;
+export declare function composeMiddleware(...middlewares: ClientMiddleware[]): ClientMiddleware;
 /**
  * Conditionally apply middleware
  *
@@ -280,4 +204,4 @@ export declare function composeMiddleware(...middlewares: Middleware[]): Middlew
  * ));
  * ```
  */
-export declare function conditionalMiddleware(condition: (request: MiddlewareRequest) => boolean, middleware: Middleware): Middleware;
+export declare function conditionalMiddleware(condition: (request: ClientMiddlewareRequest) => boolean, middleware: ClientMiddleware): ClientMiddleware;

package/dist/lib/client/interceptors.js

@@ -93,6 +93,9 @@ export function createDynamicAuthInterceptor(getAuth) {
         return next();
     };
 }
+// =============================================================================
+// Logging Interceptors
+// =============================================================================
 /**
  * Logging interceptor
  *
@@ -170,6 +173,9 @@ export function createLoggingInterceptor(options = {}) {
         }
     };
 }
+// =============================================================================
+// Retry Interceptors
+// =============================================================================
 /**
  * Retry interceptor with exponential backoff
  *
@@ -238,6 +244,9 @@ export function createRetryInterceptor(options) {
         throw lastError ?? new Error("Max retries exceeded");
     };
 }
+// =============================================================================
+// Rate Limiting Interceptors
+// =============================================================================
 /**
  * Token bucket rate limiter
  */
@@ -368,6 +377,9 @@ export function createResponseTransformInterceptor(transform) {
         return transform(response);
     };
 }
+// =============================================================================
+// Caching Interceptors
+// =============================================================================
 /**
  * Simple in-memory cache
  */
@@ -459,6 +471,9 @@ export function createCacheInterceptor(options) {
         return response;
     };
 }
+// =============================================================================
+// Timeout Interceptors
+// =============================================================================
 /**
  * Timeout interceptor
  *
@@ -506,6 +521,9 @@ export function createTimeoutInterceptor(options) {
         }
     };
 }
+// =============================================================================
+// Error Handling Interceptors
+// =============================================================================
 /**
  * Error handling interceptor
  *

package/dist/lib/client/reactHooks.d.ts

@@ -15,7 +15,7 @@
  * @module @neurolink/react
  */
 import type { ReactNode } from "react";
-import type { NeuroLinkProviderProps, UseChatOptions, UseChatReturn, UseAgentOptions, UseAgentReturn, UseWorkflowOptions, UseWorkflowReturn, UseVoiceOptions, UseVoiceReturn, UseStreamOptions, UseStreamReturn, UseToolsOptions, UseToolsReturn, ClientChatMessage as ChatMessage, SpeechRecognitionInternal } from "../types/clientTypes.js";
+import type { NeuroLinkProviderProps, UseChatOptions, UseChatReturn, UseAgentOptions, UseAgentReturn, UseWorkflowOptions, UseWorkflowReturn, UseVoiceOptions, UseVoiceReturn, UseStreamOptions, UseStreamReturn, UseToolsOptions, UseToolsReturn, SpeechRecognitionInternal } from "../types/index.js";
 import { NeuroLinkClient } from "./httpClient.js";
 /**
  * Provider component for NeuroLink client
@@ -226,7 +226,6 @@ export declare function useStream(options?: UseStreamOptions): UseStreamReturn;
  * ```
  */
 export declare function useTools(options?: UseToolsOptions): UseToolsReturn;
-export type { NeuroLinkProviderProps, UseChatOptions, UseChatReturn, UseAgentOptions, UseAgentReturn, UseWorkflowOptions, UseWorkflowReturn, UseVoiceOptions, UseVoiceReturn, UseStreamOptions, UseStreamReturn, UseToolsOptions, UseToolsReturn, ChatMessage, };
 declare global {
     interface Window {
         SpeechRecognition: {

package/dist/lib/client/sseClient.d.ts

@@ -7,48 +7,7 @@
  *
  * @module @neurolink/client/sseClient
  */
-import type { ClientConfig, StreamCallbacks, ClientStreamEvent as StreamEvent, ClientStreamResult as StreamResult, ApiError } from "../types/clientTypes.js";
-/**
- * SSE connection state
- */
-export type SSEState = "connecting" | "connected" | "disconnected" | "error";
-/**
- * SSE client configuration
- */
-export type SSEConfig = ClientConfig & {
-    /** Auto-reconnect on disconnect (default: true) */
-    autoReconnect?: boolean;
-    /** Maximum reconnection attempts (default: 5) */
-    maxReconnectAttempts?: number;
-    /** Initial reconnection delay in ms (default: 1000) */
-    reconnectDelay?: number;
-    /** Maximum reconnection delay in ms (default: 30000) */
-    maxReconnectDelay?: number;
-    /** Use native EventSource when available (default: false for more control) */
-    useNativeEventSource?: boolean;
-};
-/**
- * SSE request options
- */
-export type SSERequestOptions = {
-    /** Request body */
-    body?: unknown;
-    /** Additional headers */
-    headers?: Record<string, string>;
-    /** Abort signal */
-    signal?: AbortSignal;
-};
-/**
- * SSE event handlers
- */
-export type SSEEventHandlers = {
-    onOpen?: () => void;
-    onClose?: () => void;
-    onError?: (error: Error) => void;
-    onEvent?: (event: StreamEvent) => void;
-    onReconnect?: (attempt: number) => void;
-    onStateChange?: (state: SSEState) => void;
-};
+import type { ClientStreamCallbacks, ClientStreamEvent as StreamEvent, ClientStreamResult as StreamResult, ClientApiError, SSEConfig, SSEEventHandlers, SSERequestOptions, SSEState } from "../types/index.js";
 /**
  * SSE streaming client for NeuroLink
  *
@@ -89,7 +48,7 @@ export declare class NeuroLinkSSE {
     /**
      * Stream from an endpoint using SSE
      */
-    stream(path: string, options?: SSERequestOptions, callbacks?: StreamCallbacks): Promise<void>;
+    stream(path: string, options?: SSERequestOptions, callbacks?: ClientStreamCallbacks): Promise<void>;
     /**
      * Abort the current stream
      */
@@ -107,7 +66,7 @@ export declare class NeuroLinkSSE {
         temperature?: number;
         maxTokens?: number;
         systemPrompt?: string;
-    } & StreamCallbacks): Promise<string>;
+    } & ClientStreamCallbacks): Promise<string>;
     /**
      * Stream a chat request
      */
@@ -117,11 +76,11 @@ export declare class NeuroLinkSSE {
     }>, options?: {
         agentId?: string;
         sessionId?: string;
-    } & StreamCallbacks): Promise<string>;
+    } & ClientStreamCallbacks): Promise<string>;
     /**
      * Stream an agent execution
      */
-    executeAgent(agentId: string, input: string, options?: StreamCallbacks): Promise<string>;
+    executeAgent(agentId: string, input: string, options?: ClientStreamCallbacks): Promise<string>;
     /**
      * Stream using the browser's native EventSource API (GET requests only).
      * Provides automatic reconnection handled by the browser and a simpler
@@ -153,4 +112,4 @@ export declare class NeuroLinkSSE {
  * ```
  */
 export declare function createSSEClient(config: SSEConfig): NeuroLinkSSE;
-export type { StreamCallbacks, StreamEvent, StreamResult, ApiError };
+export type { ClientStreamCallbacks, StreamEvent, StreamResult, ClientApiError, };