@juspay/neurolink 9.54.2 → 9.54.4

package/dist/cli/commands/authProviders.d.ts

@@ -1,34 +1,5 @@
 import type { ArgumentsCamelCase } from "yargs";
-import type { AuthProviderType } from "../../lib/types/index.js";
-/**
- * Auth command argument types
- */
-export type AuthProvidersArgs = {
-    format?: "text" | "json" | "table";
-};
-export type AuthValidateArgs = {
-    token: string;
-    provider: AuthProviderType;
-    domain?: string;
-    clientId?: string;
-    secretKey?: string;
-    secret?: string;
-    url?: string;
-    anonKey?: string;
-    apiKey?: string;
-    format?: "text" | "json";
-};
-export type AuthHealthArgs = {
-    provider: AuthProviderType;
-    domain?: string;
-    clientId?: string;
-    secretKey?: string;
-    secret?: string;
-    url?: string;
-    anonKey?: string;
-    apiKey?: string;
-    format?: "text" | "json";
-};
+import type { AuthHealthArgs, AuthProvidersArgs, AuthValidateArgs } from "../../lib/types/index.js";
 /**
  * Handle 'auth providers' command
  */

package/dist/cli/commands/config.d.ts

@@ -82,8 +82,8 @@ declare const ConfigSchema: z.ZodObject<{
         enableCaching: z.ZodDefault<z.ZodBoolean>;
         cacheStrategy: z.ZodDefault<z.ZodEnum<{
             file: "file";
-            memory: "memory";
             redis: "redis";
+            memory: "memory";
         }>>;
         defaultEvaluationDomain: z.ZodOptional<z.ZodString>;
         enableAnalyticsByDefault: z.ZodDefault<z.ZodBoolean>;
@@ -124,7 +124,7 @@ declare const ConfigSchema: z.ZodObject<{
         }, z.core.$strip>>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
-export type NeuroLinkConfig = z.infer<typeof ConfigSchema>;
+type NeuroLinkConfig = z.infer<typeof ConfigSchema>;
 export declare class ConfigManager {
     private configDir;
     private configFile;

package/dist/cli/commands/evaluate.js

@@ -10,7 +10,7 @@ import ora from "ora";
 import fs from "node:fs";
 import { EvaluationPipeline, getPreset, getPresetNames, PipelinePresets, } from "../../lib/evaluation/pipeline/index.js";
 import { ScorerRegistry } from "../../lib/evaluation/scorers/index.js";
-import { ReportGenerator, } from "../../lib/evaluation/reporting/reportGenerator.js";
+import { ReportGenerator } from "../../lib/evaluation/reporting/reportGenerator.js";
 import { logger } from "../../lib/utils/logger.js";
 /**
  * Format score result for display

package/dist/cli/factories/commandFactory.js

@@ -20,6 +20,7 @@ import { initializeCliParser } from "../parser.js";
 import { formatFileSize, saveAudioToFile } from "../utils/audioFileUtils.js";
 import { resolveFilePaths } from "../utils/pathResolver.js";
 import { animatedWrite } from "../utils/typewriter.js";
+import { createStreamAbortHandler } from "../utils/abortHandler.js";
 import { formatVideoFileSize, getVideoMetadataSummary, saveVideoToFile, } from "../utils/videoFileUtils.js";
 import { OllamaCommandFactory } from "./ollamaCommandFactory.js";
 import { SageMakerCommandFactory } from "./sagemakerCommandFactory.js";
@@ -2176,6 +2177,11 @@ export class CLICommandFactory {
         let lastImageBase64;
         let contentReceived = false;
         const abortController = new AbortController();
+        // BZ-667: Wire SIGINT to abort stream gracefully
+        const abortHandler = createStreamAbortHandler();
+        abortHandler.signal.addEventListener("abort", () => {
+            abortController.abort();
+        }, { once: true });
         // Create timeout promise for stream consumption (default: 30 seconds, respects user-provided timeout)
         const streamTimeout = options.timeout && typeof options.timeout === "number"
             ? options.timeout * 1000
@@ -2197,22 +2203,37 @@ export class CLICommandFactory {
                 clearTimeout(timeoutId);
             });
         });
+        const streamIterator = stream.stream[Symbol.asyncIterator]();
         try {
             // Process the stream with timeout handling
-            const streamIterator = stream.stream[Symbol.asyncIterator]();
             let timeoutActive = true;
+            // BZ-667: Create an abort promise that rejects when the user presses Ctrl+C,
+            // so we can race it against streamIterator.next() and unblock pending reads.
+            const abortPromise = new Promise((_, reject) => {
+                if (abortHandler.signal.aborted) {
+                    reject(new DOMException("Stream aborted", "AbortError"));
+                    return;
+                }
+                abortHandler.signal.addEventListener("abort", () => {
+                    reject(new DOMException("Stream aborted", "AbortError"));
+                }, { once: true });
+            });
             while (true) {
                 let nextResult;
                 if (timeoutActive && !contentReceived) {
-                    // Race between next chunk and timeout for first chunk only
+                    // Race between next chunk, timeout, and abort signal
                     nextResult = await Promise.race([
                         streamIterator.next(),
                         timeoutPromise,
+                        abortPromise,
                     ]);
                 }
                 else {
-                    // No timeout for subsequent chunks
-                    nextResult = await streamIterator.next();
+                    // Race between next chunk and abort signal
+                    nextResult = await Promise.race([
+                        streamIterator.next(),
+                        abortPromise,
+                    ]);
                 }
                 if (nextResult.done) {
                     break;
@@ -2266,8 +2287,26 @@ export class CLICommandFactory {
         }
         catch (error) {
             abortController.abort(); // Clean up timeout
+            // BZ-667: Close the stream iterator so the provider connection is released.
+            // Wrap in try/catch to prevent cleanup failures from masking the original error.
+            try {
+                await streamIterator.return?.();
+            }
+            catch {
+                // Iterator cleanup failed — swallow so the original error propagates
+            }
+            abortHandler.cleanup();
+            // BZ-667: Handle graceful abort — return partial content instead of throwing
+            if (abortHandler.signal.aborted ||
+                (error instanceof Error && error.name === "AbortError")) {
+                if (!options.quiet) {
+                    process.stdout.write("\n");
+                }
+                return { content: fullContent, imageBase64: lastImageBase64 };
+            }
             throw error;
         }
+        abortHandler.cleanup();
         if (!contentReceived) {
             throw new Error("\n❌ No content received from stream\n" +
                 "Check your credentials and provider configuration");

package/dist/cli/loop/conversationSelector.d.ts

@@ -2,8 +2,7 @@
  * Conversation Selector for Loop Mode
  * Handles discovery and selection of stored conversations from Redis
  */
-import type { ConversationSummary } from "../../lib/types/index.js";
-import type { RedisStorageConfig } from "../../lib/types/index.js";
+import type { ConversationSummary, RedisStorageConfig } from "../../lib/types/index.js";
 export declare class ConversationSelector {
     private redisClient;
     private redisConfig;

package/dist/cli/loop/conversationSelector.js

@@ -21,7 +21,7 @@ export class ConversationSelector {
     async initializeRedis() {
         if (!this.redisClient) {
             // Cast is necessary: createRedisClient returns the ioredis client type which
-            // does not structurally match our RedisClient interface due to overloaded
+            // does not structurally match our CliRedisClient interface due to overloaded
             // method signatures. The runtime value is fully compatible.
             this.redisClient = (await createRedisClient(this.redisConfig));
         }

package/dist/cli/loop/optionsSchema.d.ts

@@ -1,5 +1,4 @@
-import type { OptionSchema } from "../../lib/types/index.js";
-import type { TextGenerationOptions } from "../../lib/types/index.js";
+import type { OptionSchema, TextGenerationOptions } from "../../lib/types/index.js";
 /**
  * Master schema for all text generation options.
  * This object provides metadata for validation and help text in the CLI loop.

package/dist/cli/utils/abortHandler.d.ts

@@ -0,0 +1,22 @@
+/**
+ * CLI Abort Handler (BZ-667)
+ *
+ * Bridges SIGINT (Ctrl+C) to an AbortController for graceful stream cancellation.
+ * First Ctrl+C aborts the stream and shows "Stream cancelled."
+ * Second Ctrl+C within 1 second force-exits the process.
+ *
+ * Uses `prependListener` so the stream handler fires BEFORE the top-level
+ * SIGINT handler in cli/index.ts (which calls process.exit). The listener
+ * remains registered until `cleanup()` removes it. On the first Ctrl+C the
+ * stream is cancelled gracefully; only a rapid second press exits.
+ *
+ * @module cli/utils/abortHandler
+ */
+/**
+ * Create an abort handler that wires SIGINT to an AbortController.
+ * Call cleanup() when the stream finishes (success or error) to remove listeners.
+ */
+export declare function createStreamAbortHandler(): {
+    signal: AbortSignal;
+    cleanup: () => void;
+};

package/dist/cli/utils/abortHandler.js

@@ -0,0 +1,53 @@
+/**
+ * CLI Abort Handler (BZ-667)
+ *
+ * Bridges SIGINT (Ctrl+C) to an AbortController for graceful stream cancellation.
+ * First Ctrl+C aborts the stream and shows "Stream cancelled."
+ * Second Ctrl+C within 1 second force-exits the process.
+ *
+ * Uses `prependListener` so the stream handler fires BEFORE the top-level
+ * SIGINT handler in cli/index.ts (which calls process.exit). The listener
+ * remains registered until `cleanup()` removes it. On the first Ctrl+C the
+ * stream is cancelled gracefully; only a rapid second press exits.
+ *
+ * @module cli/utils/abortHandler
+ */
+import chalk from "chalk";
+/**
+ * Create an abort handler that wires SIGINT to an AbortController.
+ * Call cleanup() when the stream finishes (success or error) to remove listeners.
+ */
+export function createStreamAbortHandler() {
+    const controller = new AbortController();
+    let aborted = false;
+    let forceExitTimer = null;
+    const sigintHandler = () => {
+        if (aborted) {
+            // Second Ctrl+C — force exit
+            if (forceExitTimer) {
+                clearTimeout(forceExitTimer);
+            }
+            // Let the top-level SIGINT handler in cli/index.ts handle the exit
+            return;
+        }
+        aborted = true;
+        controller.abort();
+        process.stderr.write(chalk.yellow("\nStream cancelled.\n"));
+        // Allow force exit on second Ctrl+C within 1 second
+        forceExitTimer = setTimeout(() => {
+            forceExitTimer = null;
+        }, 1000);
+    };
+    // Use prependListener so our handler fires before the top-level
+    // SIGINT handler in cli/index.ts. cleanup() removes it after the stream ends.
+    process.prependListener("SIGINT", sigintHandler);
+    const cleanup = () => {
+        process.removeListener("SIGINT", sigintHandler);
+        if (forceExitTimer) {
+            clearTimeout(forceExitTimer);
+            forceExitTimer = null;
+        }
+    };
+    return { signal: controller.signal, cleanup };
+}
+//# sourceMappingURL=abortHandler.js.map

package/dist/cli/utils/completeSetup.d.ts

@@ -4,7 +4,7 @@
  * Orchestrates the entire setup process: interactive wizard, environment management,
  * provider testing, and summary display.
  */
-import { type SetupResult } from "./interactiveSetup.js";
+import type { SetupResult } from "../../lib/types/index.js";
 /**
  * Run the complete interactive setup process
  */

package/dist/cli/utils/interactiveSetup.d.ts

@@ -5,7 +5,8 @@
  * credential collection, testing, and environment file management.
  */
 import { AIProviderName } from "../../lib/constants/enums.js";
-export type ProviderConfig = {
+import type { SetupResult } from "../../lib/types/index.js";
+type ProviderConfig = {
     id: AIProviderName;
     name: string;
     description: string;
@@ -18,17 +19,6 @@ export type ProviderConfig = {
     }>;
 };
 export declare const PROVIDER_CONFIGS: ProviderConfig[];
-export type SetupResult = {
-    selectedProviders: AIProviderName[];
-    credentials: Record<string, string>;
-    envFileBackup?: string;
-    testResults: Array<{
-        provider: AIProviderName;
-        status: "working" | "failed";
-        error?: string;
-        responseTime?: number;
-    }>;
-};
 /**
  * Run the interactive setup wizard
  */
@@ -46,3 +36,4 @@ export declare function testProviderConnectivity(providers: AIProviderName[], qu
  * Display setup summary
  */
 export declare function displaySetupSummary(result: SetupResult, quiet?: boolean): void;
+export {};

package/dist/cli/utils/videoFileUtils.d.ts

@@ -11,7 +11,7 @@ import type { VideoGenerationResult } from "../../lib/types/index.js";
 /**
  * Result of saving video to file
  */
-export type VideoSaveResult = {
+type VideoSaveResult = {
     /** Whether the save was successful */
     success: boolean;
     /** Full path to the saved file */
@@ -109,3 +109,4 @@ export declare function isVideoGenerationResult(obj: unknown): obj is VideoGener
  * @returns Formatted metadata summary string
  */
 export declare function getVideoMetadataSummary(video: VideoGenerationResult): string;
+export {};

package/dist/client/aiSdkAdapter.d.ts

@@ -7,7 +7,7 @@
  *
  * @module @neurolink/ai-sdk
  */
-import type { LanguageModel, LanguageModelCallOptions, LanguageModelResponse, LanguageModelStreamResponse, NeuroLinkProviderOptions, ModelOptions } from "../types/clientTypes.js";
+import type { ClientLanguageModel, ClientLanguageModelCallOptions, ClientLanguageModelResponse, ClientLanguageModelStreamResponse, NeuroLinkProviderOptions, ClientModelOptions } from "../types/index.js";
 import { NeuroLinkClient } from "./httpClient.js";
 /**
  * NeuroLink Language Model implementation compatible with Vercel AI SDK
@@ -30,23 +30,23 @@ import { NeuroLinkClient } from "./httpClient.js";
  * });
  * ```
  */
-export declare class NeuroLinkLanguageModel implements LanguageModel {
+export declare class NeuroLinkLanguageModel implements ClientLanguageModel {
     readonly modelId: string;
     readonly provider: string;
     private client;
     private options;
-    constructor(client: NeuroLinkClient, modelId: string, provider: string, options?: ModelOptions);
+    constructor(client: NeuroLinkClient, modelId: string, provider: string, options?: ClientModelOptions);
     /**
      * Generate a non-streaming response
      */
-    doGenerate(options: LanguageModelCallOptions): Promise<LanguageModelResponse>;
+    doGenerate(options: ClientLanguageModelCallOptions): Promise<ClientLanguageModelResponse>;
     /**
      * Generate a streaming response
      *
      * Uses an async queue so that each text delta from the provider is yielded
      * to the consumer immediately, rather than buffering the entire response.
      */
-    doStream(options: LanguageModelCallOptions): Promise<LanguageModelStreamResponse>;
+    doStream(options: ClientLanguageModelCallOptions): Promise<ClientLanguageModelStreamResponse>;
     /**
      * Map NeuroLink finish reasons to AI SDK finish reasons
      */
@@ -87,11 +87,11 @@ export declare class NeuroLinkProvider {
      * @param modelId - Model ID (e.g., 'gpt-4o', 'claude-3-opus')
      * @param options - Additional model options
      */
-    model(modelId?: string, options?: ModelOptions): NeuroLinkLanguageModel;
+    model(modelId?: string, options?: ClientModelOptions): NeuroLinkLanguageModel;
     /**
      * Alias for model() - makes the provider callable
      */
-    call(modelId?: string, options?: ModelOptions): NeuroLinkLanguageModel;
+    call(modelId?: string, options?: ClientModelOptions): NeuroLinkLanguageModel;
     /**
      * Infer provider from model ID
      */
@@ -119,7 +119,7 @@ export declare class NeuroLinkProvider {
  * });
  * ```
  */
-export declare function createNeuroLinkProvider(options: NeuroLinkProviderOptions): NeuroLinkProvider & ((modelId?: string, modelOptions?: ModelOptions) => NeuroLinkLanguageModel);
+export declare function createNeuroLinkProvider(options: NeuroLinkProviderOptions): NeuroLinkProvider & ((modelId?: string, modelOptions?: ClientModelOptions) => NeuroLinkLanguageModel);
 /**
  * Create a standalone NeuroLink model for Vercel AI SDK
  *
@@ -193,4 +193,3 @@ export declare function createStreamingResponse(options: NeuroLinkProviderOption
     maxTokens?: number;
     systemPrompt?: string;
 }): Promise<Response>;
-export type { LanguageModel, LanguageModelCallOptions, LanguageModelResponse, LanguageModelStreamResponse, NeuroLinkProviderOptions, ModelOptions, } from "../types/clientTypes.js";

package/dist/client/aiSdkAdapter.js

@@ -10,7 +10,7 @@
 import { logger } from "../utils/logger.js";
 import { createClient } from "./httpClient.js";
 // =============================================================================
-// LanguageModel Implementation
+// ClientLanguageModel Implementation
 // =============================================================================
 /**
  * NeuroLink Language Model implementation compatible with Vercel AI SDK
@@ -488,3 +488,8 @@ export async function createStreamingResponse(options) {
         },
     });
 }
+// =============================================================================
+// Type Re-exports
+// =============================================================================
+// Re-export types from ./types.js for convenience
+// Note: NeuroLinkProviderOptions and ClientModelOptions are defined and exported above

package/dist/client/auth.d.ts

@@ -6,7 +6,7 @@
  *
  * @module @neurolink/client/auth
  */
-import type { Middleware, AuthConfig, ClientOAuth2Config, ClientTokenRefreshResult } from "../types/clientTypes.js";
+import type { ClientMiddleware, ClientAuthConfig, ClientOAuth2Config, ClientTokenRefreshResult } from "../types/index.js";
 /**
  * OAuth2 Token Manager for client credentials flow
  *
@@ -127,7 +127,7 @@ export declare class JWTTokenManager {
  * client.use(createApiKeyMiddleware('your-api-key'));
  * ```
  */
-export declare function createApiKeyMiddleware(apiKey: string, headerName?: string): Middleware;
+export declare function createApiKeyMiddleware(apiKey: string, headerName?: string): ClientMiddleware;
 /**
  * Create a Bearer token authentication middleware
  *
@@ -137,7 +137,7 @@ export declare function createApiKeyMiddleware(apiKey: string, headerName?: stri
  * client.use(createBearerTokenMiddleware('your-jwt-token'));
  * ```
  */
-export declare function createBearerTokenMiddleware(token: string): Middleware;
+export declare function createBearerTokenMiddleware(token: string): ClientMiddleware;
 /**
  * Create a dynamic authentication middleware with token manager
  *
@@ -153,7 +153,7 @@ export declare function createBearerTokenMiddleware(token: string): Middleware;
  * client.use(createTokenManagerMiddleware(tokenManager));
  * ```
  */
-export declare function createTokenManagerMiddleware(tokenManager: OAuth2TokenManager | JWTTokenManager): Middleware;
+export declare function createTokenManagerMiddleware(tokenManager: OAuth2TokenManager | JWTTokenManager): ClientMiddleware;
 /**
  * Create an authentication middleware with retry on 401
  *
@@ -167,7 +167,7 @@ export declare function createTokenManagerMiddleware(tokenManager: OAuth2TokenMa
  * client.use(createAuthWithRetryMiddleware(tokenManager));
  * ```
  */
-export declare function createAuthWithRetryMiddleware(tokenManager: OAuth2TokenManager, maxRetries?: number): Middleware;
+export declare function createAuthWithRetryMiddleware(tokenManager: OAuth2TokenManager, maxRetries?: number): ClientMiddleware;
 /**
  * Create a multi-auth middleware that supports multiple authentication methods
  *
@@ -180,7 +180,7 @@ export declare function createAuthWithRetryMiddleware(tokenManager: OAuth2TokenM
  * }));
  * ```
  */
-export declare function createMultiAuthMiddleware(config: AuthConfig): Middleware;
+export declare function createMultiAuthMiddleware(config: ClientAuthConfig): ClientMiddleware;
 /**
  * Error thrown during OAuth2 operations
  */

package/dist/client/auth.js

@@ -222,7 +222,7 @@ export class JWTTokenManager {
     }
 }
 // =============================================================================
-// Authentication Middleware
+// Authentication ClientMiddleware
 // =============================================================================
 /**
  * Create an API key authentication middleware

package/dist/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/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) {