@juspay/neurolink 9.0.0 → 9.0.1

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [9.0.1](https://github.com/juspay/neurolink/compare/v9.0.0...v9.0.1) (2026-02-03)
+
+### Bug Fixes
+
+- **(pdf-processor):** enforce page limits by default with actionable alternatives ([35576aa](https://github.com/juspay/neurolink/commit/35576aa210b5a9a0bce8e6c5df041351905f0c96))
+
 ## [9.0.0](https://github.com/juspay/neurolink/compare/v8.43.0...v9.0.0) (2026-02-03)
 
 ### ⚠ BREAKING CHANGES

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

@@ -105,6 +105,11 @@ export type PDFProcessorOptions = {
     model?: string;
     maxSizeMB?: number;
     bedrockApiMode?: "converse" | "invokeModel";
+    /**
+     * Whether to enforce page limits by throwing an error (default: true)
+     * Set to false to bypass limit enforcement (logs warning instead)
+     */
+    enforceLimits?: boolean;
 };
 /**
  * Audio provider configuration for transcription services

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

@@ -32,6 +32,7 @@ export declare const ERROR_CODES: {
     readonly IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
     readonly IMAGE_TOO_SMALL: "IMAGE_TOO_SMALL";
     readonly INVALID_IMAGE_FORMAT: "INVALID_IMAGE_FORMAT";
+    readonly PDF_PAGE_LIMIT_EXCEEDED: "PDF_PAGE_LIMIT_EXCEEDED";
     readonly RATE_LIMITER_QUEUE_FULL: "RATE_LIMITER_QUEUE_FULL";
     readonly RATE_LIMITER_QUEUE_TIMEOUT: "RATE_LIMITER_QUEUE_TIMEOUT";
     readonly RATE_LIMITER_RESET: "RATE_LIMITER_RESET";
@@ -149,6 +150,10 @@ export declare class ErrorFactory {
      * Create an invalid image type error
      */
     static invalidImageType(): NeuroLinkError;
+    /**
+     * Create a PDF page limit exceeded error
+     */
+    static pdfPageLimitExceeded(estimatedPages: number, maxPages: number, provider: string): NeuroLinkError;
     /**
      * Create an image too large error
      */

package/dist/lib/utils/errorHandling.js

@@ -40,6 +40,8 @@ export const ERROR_CODES = {
     IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
     IMAGE_TOO_SMALL: "IMAGE_TOO_SMALL",
     INVALID_IMAGE_FORMAT: "INVALID_IMAGE_FORMAT",
+    // PDF validation errors
+    PDF_PAGE_LIMIT_EXCEEDED: "PDF_PAGE_LIMIT_EXCEEDED",
     // Rate limiter errors
     RATE_LIMITER_QUEUE_FULL: "RATE_LIMITER_QUEUE_FULL",
     RATE_LIMITER_QUEUE_TIMEOUT: "RATE_LIMITER_QUEUE_TIMEOUT",
@@ -417,6 +419,36 @@ export class ErrorFactory {
             },
         });
     }
+    // ============================================================================
+    // PDF VALIDATION ERRORS
+    // ============================================================================
+    /**
+     * Create a PDF page limit exceeded error
+     */
+    static pdfPageLimitExceeded(estimatedPages, maxPages, provider) {
+        const alternatives = [
+            `Split the PDF into smaller files (max ${maxPages} pages each)`,
+            "Extract only the pages you need using a PDF editor",
+            "For large files, consider Google AI Studio which supports up to 2000MB file size (though page limits still apply)",
+            "Convert specific pages to images manually before processing",
+            "Bypass this limit with { enforceLimits: false } (not recommended - may cause API errors or unexpected costs)",
+        ];
+        return new NeuroLinkError({
+            code: ERROR_CODES.PDF_PAGE_LIMIT_EXCEEDED,
+            message: `PDF page limit exceeded: ${estimatedPages} pages detected, but ${provider} supports maximum ${maxPages} pages.\n\n` +
+                `Alternatives:\n` +
+                alternatives.map((alt, i) => `${i + 1}. ${alt}`).join("\n"),
+            category: ErrorCategory.VALIDATION,
+            severity: ErrorSeverity.MEDIUM,
+            retriable: false,
+            context: {
+                estimatedPages,
+                maxPages,
+                provider,
+                alternatives,
+            },
+        });
+    }
     /**
      * Create an image too large error
      */

package/dist/lib/utils/pdfProcessor.js

@@ -9,6 +9,7 @@
  */
 import { PDF_LIMITS } from "../core/constants.js";
 import { logger } from "./logger.js";
+import { ErrorFactory } from "./errorHandling.js";
 /**
  * Provider configurations for PDF handling
  *
@@ -150,8 +151,15 @@ export class PDFProcessor {
         }
         const metadata = this.extractBasicMetadata(content);
         if (metadata.estimatedPages && metadata.estimatedPages > config.maxPages) {
-            logger.warn(`[PDF] PDF appears to have ${metadata.estimatedPages}+ pages. ` +
-                `${provider} supports up to ${config.maxPages} pages.`);
+            const enforceLimits = options?.enforceLimits !== false;
+            if (enforceLimits) {
+                throw ErrorFactory.pdfPageLimitExceeded(metadata.estimatedPages, config.maxPages, provider);
+            }
+            else {
+                logger.warn(`[PDF] ⚠️ LIMIT BYPASS: Processing ${metadata.estimatedPages}-page PDF despite ${config.maxPages}-page limit for ${provider}. ` +
+                    `This may cause API rejection, token errors, or unexpected costs. ` +
+                    `Consider splitting the PDF or using a different provider.`);
+            }
         }
         if (provider === "bedrock" && options?.bedrockApiMode === "converse") {
             logger.info("[PDF] Using Bedrock Converse API. " +

package/dist/types/fileTypes.d.ts

@@ -105,6 +105,11 @@ export type PDFProcessorOptions = {
     model?: string;
     maxSizeMB?: number;
     bedrockApiMode?: "converse" | "invokeModel";
+    /**
+     * Whether to enforce page limits by throwing an error (default: true)
+     * Set to false to bypass limit enforcement (logs warning instead)
+     */
+    enforceLimits?: boolean;
 };
 /**
  * Audio provider configuration for transcription services

package/dist/utils/errorHandling.d.ts

@@ -32,6 +32,7 @@ export declare const ERROR_CODES: {
     readonly IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE";
     readonly IMAGE_TOO_SMALL: "IMAGE_TOO_SMALL";
     readonly INVALID_IMAGE_FORMAT: "INVALID_IMAGE_FORMAT";
+    readonly PDF_PAGE_LIMIT_EXCEEDED: "PDF_PAGE_LIMIT_EXCEEDED";
     readonly RATE_LIMITER_QUEUE_FULL: "RATE_LIMITER_QUEUE_FULL";
     readonly RATE_LIMITER_QUEUE_TIMEOUT: "RATE_LIMITER_QUEUE_TIMEOUT";
     readonly RATE_LIMITER_RESET: "RATE_LIMITER_RESET";
@@ -149,6 +150,10 @@ export declare class ErrorFactory {
      * Create an invalid image type error
      */
     static invalidImageType(): NeuroLinkError;
+    /**
+     * Create a PDF page limit exceeded error
+     */
+    static pdfPageLimitExceeded(estimatedPages: number, maxPages: number, provider: string): NeuroLinkError;
     /**
      * Create an image too large error
      */

package/dist/utils/errorHandling.js

@@ -40,6 +40,8 @@ export const ERROR_CODES = {
     IMAGE_TOO_LARGE: "IMAGE_TOO_LARGE",
     IMAGE_TOO_SMALL: "IMAGE_TOO_SMALL",
     INVALID_IMAGE_FORMAT: "INVALID_IMAGE_FORMAT",
+    // PDF validation errors
+    PDF_PAGE_LIMIT_EXCEEDED: "PDF_PAGE_LIMIT_EXCEEDED",
     // Rate limiter errors
     RATE_LIMITER_QUEUE_FULL: "RATE_LIMITER_QUEUE_FULL",
     RATE_LIMITER_QUEUE_TIMEOUT: "RATE_LIMITER_QUEUE_TIMEOUT",
@@ -417,6 +419,36 @@ export class ErrorFactory {
             },
         });
     }
+    // ============================================================================
+    // PDF VALIDATION ERRORS
+    // ============================================================================
+    /**
+     * Create a PDF page limit exceeded error
+     */
+    static pdfPageLimitExceeded(estimatedPages, maxPages, provider) {
+        const alternatives = [
+            `Split the PDF into smaller files (max ${maxPages} pages each)`,
+            "Extract only the pages you need using a PDF editor",
+            "For large files, consider Google AI Studio which supports up to 2000MB file size (though page limits still apply)",
+            "Convert specific pages to images manually before processing",
+            "Bypass this limit with { enforceLimits: false } (not recommended - may cause API errors or unexpected costs)",
+        ];
+        return new NeuroLinkError({
+            code: ERROR_CODES.PDF_PAGE_LIMIT_EXCEEDED,
+            message: `PDF page limit exceeded: ${estimatedPages} pages detected, but ${provider} supports maximum ${maxPages} pages.\n\n` +
+                `Alternatives:\n` +
+                alternatives.map((alt, i) => `${i + 1}. ${alt}`).join("\n"),
+            category: ErrorCategory.VALIDATION,
+            severity: ErrorSeverity.MEDIUM,
+            retriable: false,
+            context: {
+                estimatedPages,
+                maxPages,
+                provider,
+                alternatives,
+            },
+        });
+    }
     /**
      * Create an image too large error
      */

package/dist/utils/pdfProcessor.js

@@ -9,6 +9,7 @@
  */
 import { PDF_LIMITS } from "../core/constants.js";
 import { logger } from "./logger.js";
+import { ErrorFactory } from "./errorHandling.js";
 /**
  * Provider configurations for PDF handling
  *
@@ -150,8 +151,15 @@ export class PDFProcessor {
         }
         const metadata = this.extractBasicMetadata(content);
         if (metadata.estimatedPages && metadata.estimatedPages > config.maxPages) {
-            logger.warn(`[PDF] PDF appears to have ${metadata.estimatedPages}+ pages. ` +
-                `${provider} supports up to ${config.maxPages} pages.`);
+            const enforceLimits = options?.enforceLimits !== false;
+            if (enforceLimits) {
+                throw ErrorFactory.pdfPageLimitExceeded(metadata.estimatedPages, config.maxPages, provider);
+            }
+            else {
+                logger.warn(`[PDF] ⚠️ LIMIT BYPASS: Processing ${metadata.estimatedPages}-page PDF despite ${config.maxPages}-page limit for ${provider}. ` +
+                    `This may cause API rejection, token errors, or unexpected costs. ` +
+                    `Consider splitting the PDF or using a different provider.`);
+            }
         }
         if (provider === "bedrock" && options?.bedrockApiMode === "converse") {
             logger.info("[PDF] Using Bedrock Converse API. " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.0.0",
+  "version": "9.0.1",
   "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",