@juspay/neurolink 8.35.0 → 8.35.2

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## [8.35.2](https://github.com/juspay/neurolink/compare/v8.35.1...v8.35.2) (2026-01-15)
+
+### Bug Fixes
+
+- **(provider):** add network retry logic with exponential backoff to detection operations ([3b29e24](https://github.com/juspay/neurolink/commit/3b29e248766fac01f1e3ea368e9439233957121e))
+
+## [8.35.1](https://github.com/juspay/neurolink/compare/v8.35.0...v8.35.1) (2026-01-15)
+
+### Bug Fixes
+
+- **(pdf):** reject empty PDFs with 0 pages instead of returning success ([92d8d4e](https://github.com/juspay/neurolink/commit/92d8d4eb3e6e675ee969e3a8ee92c5997dc416aa))
+
 ## [8.35.0](https://github.com/juspay/neurolink/compare/v8.34.1...v8.35.0) (2026-01-15)
 
 ### Features

package/dist/lib/types/fileTypes.d.ts

@@ -225,6 +225,10 @@ export type FileDetectorOptions = {
     officeOptions?: OfficeProcessorOptions;
     confidenceThreshold?: number;
     provider?: string;
+    /** Maximum number of retry attempts for network requests (default: 3) */
+    maxRetries?: number;
+    /** Initial retry delay in milliseconds with exponential backoff (default: 1000) */
+    retryDelay?: number;
 };
 /**
  * Google AI Studio Files API types

package/dist/lib/utils/fileDetector.d.ts

@@ -70,7 +70,7 @@ export declare class FileDetector {
      */
     private static processFile;
     /**
-     * Load file from URL
+     * Load file from URL with automatic retry on transient network errors
      */
     private static loadFromURL;
     /**

package/dist/lib/utils/fileDetector.js

@@ -9,6 +9,116 @@ import { logger } from "./logger.js";
 import { CSVProcessor } from "./csvProcessor.js";
 import { ImageProcessor } from "./imageProcessor.js";
 import { PDFProcessor } from "./pdfProcessor.js";
+/**
+ * Default retry configuration constants
+ */
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_RETRY_DELAY = 1000; // milliseconds
+/**
+ * Retryable network error codes (Node.js/undici network errors)
+ */
+const RETRYABLE_ERROR_CODES = [
+    "ETIMEDOUT",
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ENOTFOUND",
+    "ENETUNREACH",
+    "EAI_AGAIN",
+    "EPIPE",
+    "ECONNABORTED",
+    "UND_ERR_CONNECT_TIMEOUT",
+    "UND_ERR_HEADERS_TIMEOUT",
+    "UND_ERR_BODY_TIMEOUT",
+    "UND_ERR_SOCKET",
+];
+/**
+ * Non-retryable HTTP status codes (client errors)
+ */
+const NON_RETRYABLE_STATUS_CODES = [400, 401, 403, 404, 405];
+/**
+ * Retryable HTTP status codes (server errors + rate limiting)
+ */
+const RETRYABLE_STATUS_CODES = [429, 500, 502, 503, 504];
+/**
+ * Check if an error is a recoverable network error that should be retried
+ *
+ * @param error - Error to check
+ * @returns True if error is retryable (transient network issue)
+ */
+function isRetryableNetworkError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const errorMessage = error.message.toLowerCase();
+    // Extract error code from various error shapes
+    const errorWithCode = error;
+    const errorCode = errorWithCode.code?.toUpperCase();
+    // Check for retryable network error codes
+    if (errorCode && RETRYABLE_ERROR_CODES.includes(errorCode)) {
+        return true;
+    }
+    // Check HTTP status code if present in error message (e.g., "HTTP 503")
+    const httpStatusMatch = errorMessage.match(/http\s*(\d{3})/);
+    if (httpStatusMatch) {
+        const statusCode = parseInt(httpStatusMatch[1], 10);
+        if (NON_RETRYABLE_STATUS_CODES.includes(statusCode)) {
+            return false;
+        }
+        if (RETRYABLE_STATUS_CODES.includes(statusCode)) {
+            return true;
+        }
+    }
+    // Check error message for transient issues
+    const transientKeywords = [
+        "timeout",
+        "timed out",
+        "connection reset",
+        "econnreset",
+        "etimedout",
+        "network error",
+        "socket hang up",
+        "enotfound",
+        "getaddrinfo",
+        "unavailable",
+        "service unavailable",
+    ];
+    return transientKeywords.some((keyword) => errorMessage.includes(keyword));
+}
+/**
+ * Execute an operation with automatic retry logic on transient network errors
+ *
+ * @param operation - Async function to execute
+ * @param options - Retry configuration options
+ * @returns Promise resolving to the operation result
+ * @throws Error if all retry attempts fail or error is non-retryable
+ */
+async function withRetry(operation, options = {}) {
+    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    const retryDelay = options.retryDelay ?? DEFAULT_RETRY_DELAY;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            const isRetryable = isRetryableNetworkError(error);
+            const isLastAttempt = attempt === maxRetries;
+            if (!isRetryable || isLastAttempt) {
+                throw error;
+            }
+            // Calculate exponential backoff delay
+            const delay = retryDelay * Math.pow(2, attempt);
+            logger.debug("Retrying network operation after transient error", {
+                attempt: attempt + 1,
+                maxRetries,
+                delay,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    // TypeScript exhaustiveness check - should never reach here
+    throw new Error("Retry logic failed unexpectedly");
+}
 /**
  * Check if text has JSON markers (starts with { or [ and ends with corresponding closing bracket)
  */
@@ -356,30 +466,34 @@ export class FileDetector {
         }
     }
     /**
-     * Load file from URL
+     * Load file from URL with automatic retry on transient network errors
      */
     static async loadFromURL(url, options) {
         const maxSize = options?.maxSize || 10 * 1024 * 1024;
         const timeout = options?.timeout || this.DEFAULT_NETWORK_TIMEOUT;
-        const response = await request(url, {
-            dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
-            method: "GET",
-            headersTimeout: timeout,
-            bodyTimeout: timeout,
-        });
-        if (response.statusCode !== 200) {
-            throw new Error(`HTTP ${response.statusCode}`);
-        }
-        const chunks = [];
-        let totalSize = 0;
-        for await (const chunk of response.body) {
-            totalSize += chunk.length;
-            if (totalSize > maxSize) {
-                throw new Error(`File too large: ${formatFileSize(totalSize)} (max: ${formatFileSize(maxSize)})`);
+        const maxRetries = options?.maxRetries ?? DEFAULT_MAX_RETRIES;
+        const retryDelay = options?.retryDelay ?? DEFAULT_RETRY_DELAY;
+        return withRetry(async () => {
+            const response = await request(url, {
+                dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
+                method: "GET",
+                headersTimeout: timeout,
+                bodyTimeout: timeout,
+            });
+            if (response.statusCode !== 200) {
+                throw new Error(`HTTP ${response.statusCode}`);
             }
-            chunks.push(chunk);
-        }
-        return Buffer.concat(chunks);
+            const chunks = [];
+            let totalSize = 0;
+            for await (const chunk of response.body) {
+                totalSize += chunk.length;
+                if (totalSize > maxSize) {
+                    throw new Error(`File too large: ${formatFileSize(totalSize)} (max: ${formatFileSize(maxSize)})`);
+                }
+                chunks.push(chunk);
+            }
+            return Buffer.concat(chunks);
+        }, { maxRetries, retryDelay });
     }
     /**
      * Load file from filesystem path

package/dist/lib/utils/pdfProcessor.js

@@ -309,6 +309,10 @@ export class PDFProcessor {
                     base64Length: base64Image.length,
                 });
             }
+            // Check for empty PDF (0 pages)
+            if (images.length === 0) {
+                throw new Error("PDF has 0 pages. Cannot convert empty PDF to images.");
+            }
             const conversionTimeMs = Date.now() - startTime;
             logger.info("[PDF→Image] ✅ PDF conversion completed", {
                 pageCount: images.length,

package/dist/types/fileTypes.d.ts

@@ -225,6 +225,10 @@ export type FileDetectorOptions = {
     officeOptions?: OfficeProcessorOptions;
     confidenceThreshold?: number;
     provider?: string;
+    /** Maximum number of retry attempts for network requests (default: 3) */
+    maxRetries?: number;
+    /** Initial retry delay in milliseconds with exponential backoff (default: 1000) */
+    retryDelay?: number;
 };
 /**
  * Google AI Studio Files API types

package/dist/utils/fileDetector.d.ts

@@ -70,7 +70,7 @@ export declare class FileDetector {
      */
     private static processFile;
     /**
-     * Load file from URL
+     * Load file from URL with automatic retry on transient network errors
      */
     private static loadFromURL;
     /**

package/dist/utils/fileDetector.js

@@ -9,6 +9,116 @@ import { logger } from "./logger.js";
 import { CSVProcessor } from "./csvProcessor.js";
 import { ImageProcessor } from "./imageProcessor.js";
 import { PDFProcessor } from "./pdfProcessor.js";
+/**
+ * Default retry configuration constants
+ */
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_RETRY_DELAY = 1000; // milliseconds
+/**
+ * Retryable network error codes (Node.js/undici network errors)
+ */
+const RETRYABLE_ERROR_CODES = [
+    "ETIMEDOUT",
+    "ECONNRESET",
+    "ECONNREFUSED",
+    "ENOTFOUND",
+    "ENETUNREACH",
+    "EAI_AGAIN",
+    "EPIPE",
+    "ECONNABORTED",
+    "UND_ERR_CONNECT_TIMEOUT",
+    "UND_ERR_HEADERS_TIMEOUT",
+    "UND_ERR_BODY_TIMEOUT",
+    "UND_ERR_SOCKET",
+];
+/**
+ * Non-retryable HTTP status codes (client errors)
+ */
+const NON_RETRYABLE_STATUS_CODES = [400, 401, 403, 404, 405];
+/**
+ * Retryable HTTP status codes (server errors + rate limiting)
+ */
+const RETRYABLE_STATUS_CODES = [429, 500, 502, 503, 504];
+/**
+ * Check if an error is a recoverable network error that should be retried
+ *
+ * @param error - Error to check
+ * @returns True if error is retryable (transient network issue)
+ */
+function isRetryableNetworkError(error) {
+    if (!(error instanceof Error)) {
+        return false;
+    }
+    const errorMessage = error.message.toLowerCase();
+    // Extract error code from various error shapes
+    const errorWithCode = error;
+    const errorCode = errorWithCode.code?.toUpperCase();
+    // Check for retryable network error codes
+    if (errorCode && RETRYABLE_ERROR_CODES.includes(errorCode)) {
+        return true;
+    }
+    // Check HTTP status code if present in error message (e.g., "HTTP 503")
+    const httpStatusMatch = errorMessage.match(/http\s*(\d{3})/);
+    if (httpStatusMatch) {
+        const statusCode = parseInt(httpStatusMatch[1], 10);
+        if (NON_RETRYABLE_STATUS_CODES.includes(statusCode)) {
+            return false;
+        }
+        if (RETRYABLE_STATUS_CODES.includes(statusCode)) {
+            return true;
+        }
+    }
+    // Check error message for transient issues
+    const transientKeywords = [
+        "timeout",
+        "timed out",
+        "connection reset",
+        "econnreset",
+        "etimedout",
+        "network error",
+        "socket hang up",
+        "enotfound",
+        "getaddrinfo",
+        "unavailable",
+        "service unavailable",
+    ];
+    return transientKeywords.some((keyword) => errorMessage.includes(keyword));
+}
+/**
+ * Execute an operation with automatic retry logic on transient network errors
+ *
+ * @param operation - Async function to execute
+ * @param options - Retry configuration options
+ * @returns Promise resolving to the operation result
+ * @throws Error if all retry attempts fail or error is non-retryable
+ */
+async function withRetry(operation, options = {}) {
+    const maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
+    const retryDelay = options.retryDelay ?? DEFAULT_RETRY_DELAY;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            const isRetryable = isRetryableNetworkError(error);
+            const isLastAttempt = attempt === maxRetries;
+            if (!isRetryable || isLastAttempt) {
+                throw error;
+            }
+            // Calculate exponential backoff delay
+            const delay = retryDelay * Math.pow(2, attempt);
+            logger.debug("Retrying network operation after transient error", {
+                attempt: attempt + 1,
+                maxRetries,
+                delay,
+                error: error instanceof Error ? error.message : String(error),
+            });
+            await new Promise((resolve) => setTimeout(resolve, delay));
+        }
+    }
+    // TypeScript exhaustiveness check - should never reach here
+    throw new Error("Retry logic failed unexpectedly");
+}
 /**
  * Check if text has JSON markers (starts with { or [ and ends with corresponding closing bracket)
  */
@@ -356,30 +466,34 @@ export class FileDetector {
         }
     }
     /**
-     * Load file from URL
+     * Load file from URL with automatic retry on transient network errors
      */
     static async loadFromURL(url, options) {
         const maxSize = options?.maxSize || 10 * 1024 * 1024;
         const timeout = options?.timeout || this.DEFAULT_NETWORK_TIMEOUT;
-        const response = await request(url, {
-            dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
-            method: "GET",
-            headersTimeout: timeout,
-            bodyTimeout: timeout,
-        });
-        if (response.statusCode !== 200) {
-            throw new Error(`HTTP ${response.statusCode}`);
-        }
-        const chunks = [];
-        let totalSize = 0;
-        for await (const chunk of response.body) {
-            totalSize += chunk.length;
-            if (totalSize > maxSize) {
-                throw new Error(`File too large: ${formatFileSize(totalSize)} (max: ${formatFileSize(maxSize)})`);
+        const maxRetries = options?.maxRetries ?? DEFAULT_MAX_RETRIES;
+        const retryDelay = options?.retryDelay ?? DEFAULT_RETRY_DELAY;
+        return withRetry(async () => {
+            const response = await request(url, {
+                dispatcher: getGlobalDispatcher().compose(interceptors.redirect({ maxRedirections: 5 })),
+                method: "GET",
+                headersTimeout: timeout,
+                bodyTimeout: timeout,
+            });
+            if (response.statusCode !== 200) {
+                throw new Error(`HTTP ${response.statusCode}`);
             }
-            chunks.push(chunk);
-        }
-        return Buffer.concat(chunks);
+            const chunks = [];
+            let totalSize = 0;
+            for await (const chunk of response.body) {
+                totalSize += chunk.length;
+                if (totalSize > maxSize) {
+                    throw new Error(`File too large: ${formatFileSize(totalSize)} (max: ${formatFileSize(maxSize)})`);
+                }
+                chunks.push(chunk);
+            }
+            return Buffer.concat(chunks);
+        }, { maxRetries, retryDelay });
     }
     /**
      * Load file from filesystem path

package/dist/utils/pdfProcessor.js

@@ -309,6 +309,10 @@ export class PDFProcessor {
                     base64Length: base64Image.length,
                 });
             }
+            // Check for empty PDF (0 pages)
+            if (images.length === 0) {
+                throw new Error("PDF has 0 pages. Cannot convert empty PDF to images.");
+            }
             const conversionTimeMs = Date.now() - startTime;
             logger.info("[PDF→Image] ✅ PDF conversion completed", {
                 pageCount: images.length,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "8.35.0",
+  "version": "8.35.2",
   "description": "Universal AI Development Platform with working MCP integration, multi-provider support, and professional CLI. Built-in tools operational, 58+ external MCP servers discoverable. Connect to filesystem, GitHub, database operations, and more. Build, test, and deploy AI applications with 13 providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",