@juspay/neurolink 9.88.4 → 9.88.6

package/dist/core/constants.d.ts

@@ -121,6 +121,7 @@ export declare const CLI_LIMITS: {
 export declare const PDF_LIMITS: {
     MAX_SIZE_MB: number;
     DEFAULT_MAX_PAGES: number;
+    MAX_SCALE: number;
 };
 export declare const SYSTEM_LIMITS: {
     MAX_PROMPT_LENGTH: number;

package/dist/core/constants.js

@@ -217,6 +217,9 @@ export const PDF_LIMITS = {
     MAX_SIZE_MB: 20,
     // Default maximum pages for image conversion
     DEFAULT_MAX_PAGES: 20,
+    // Upper bound for the render scale factor. Above this, a single page can
+    // allocate hundreds of MB; scale <= 0 produces a degenerate viewport.
+    MAX_SCALE: 10,
 };
 // Performance and System Limits
 export const SYSTEM_LIMITS = {

package/dist/lib/core/constants.d.ts

@@ -121,6 +121,7 @@ export declare const CLI_LIMITS: {
 export declare const PDF_LIMITS: {
     MAX_SIZE_MB: number;
     DEFAULT_MAX_PAGES: number;
+    MAX_SCALE: number;
 };
 export declare const SYSTEM_LIMITS: {
     MAX_PROMPT_LENGTH: number;

package/dist/lib/core/constants.js

@@ -217,6 +217,9 @@ export const PDF_LIMITS = {
     MAX_SIZE_MB: 20,
     // Default maximum pages for image conversion
     DEFAULT_MAX_PAGES: 20,
+    // Upper bound for the render scale factor. Above this, a single page can
+    // allocate hundreds of MB; scale <= 0 produces a degenerate viewport.
+    MAX_SCALE: 10,
 };
 // Performance and System Limits
 export const SYSTEM_LIMITS = {

package/dist/lib/processors/document/PptxProcessor.d.ts

@@ -42,6 +42,20 @@ export declare class PptxProcessor {
      * @throws Error if the buffer is not a valid ZIP/PPTX file
      */
     static extractText(content: Buffer): Promise<string | null>;
+    /**
+     * Extract the speaker notes for one slide.
+     *
+     * Speaker notes live in a separate `ppt/notesSlides/notesSlideN.xml` part
+     * whose number is NOT tied to the slide number — the link is declared in the
+     * slide's own relationships file (`ppt/slides/_rels/slideN.xml.rels`) via a
+     * relationship of type `.../notesSlide`. We resolve that target, then pull the
+     * `<a:t>` runs from the notes part. Returns null when the slide has no notes.
+     *
+     * @param zip - The opened PPTX archive
+     * @param slideNumber - 1-indexed slide number
+     * @returns The notes text (runs joined by a space), or null when absent
+     */
+    private static extractNotesForSlide;
     /**
      * Extract text strings from a slide XML document.
      * Finds all `<a:t>` elements and returns their text content.

package/dist/lib/processors/document/PptxProcessor.js

@@ -37,6 +37,14 @@ const TEXT_ELEMENT_REGEX = /<a:t[^>]*>([\s\S]*?)<\/a:t>/g;
  * Matches entries like "ppt/slides/slide1.xml", "ppt/slides/slide12.xml".
  */
 const SLIDE_ENTRY_REGEX = /^ppt\/slides\/slide(\d+)\.xml$/;
+/**
+ * A slide's per-slide relationships file, e.g.
+ * "ppt/slides/_rels/slide1.xml.rels", which links the slide to its speaker
+ * notes part (among other relationships).
+ */
+const SLIDE_RELS_NAME = (n) => `ppt/slides/_rels/slide${n}.xml.rels`;
+/** Matches a single `<Relationship .../>` tag inside a .rels document. */
+const RELATIONSHIP_TAG_REGEX = /<Relationship\b[^>]*\/?>/g;
 /**
  * Static utility class for extracting text from PPTX files.
  *
@@ -74,15 +82,65 @@ export class PptxProcessor {
         parts.push(`Presentation: ${slides.length} slide(s)\n`);
         for (const slide of slides) {
             const texts = PptxProcessor.extractTextFromXml(slide.xml);
-            if (texts.length > 0) {
+            const notes = PptxProcessor.extractNotesForSlide(zip, slide.slideNumber);
+            // Emit a slide section when it has either body text or speaker notes.
+            if (texts.length > 0 || notes) {
                 parts.push(`### Slide ${slide.slideNumber}`);
-                parts.push(texts.join("\n"));
+                if (texts.length > 0) {
+                    parts.push(texts.join("\n"));
+                }
+                if (notes) {
+                    parts.push(`**Speaker notes:** ${notes}`);
+                }
                 parts.push(""); // blank line between slides
             }
         }
         const result = parts.join("\n").trim();
         return result || null;
     }
+    /**
+     * Extract the speaker notes for one slide.
+     *
+     * Speaker notes live in a separate `ppt/notesSlides/notesSlideN.xml` part
+     * whose number is NOT tied to the slide number — the link is declared in the
+     * slide's own relationships file (`ppt/slides/_rels/slideN.xml.rels`) via a
+     * relationship of type `.../notesSlide`. We resolve that target, then pull the
+     * `<a:t>` runs from the notes part. Returns null when the slide has no notes.
+     *
+     * @param zip - The opened PPTX archive
+     * @param slideNumber - 1-indexed slide number
+     * @returns The notes text (runs joined by a space), or null when absent
+     */
+    static extractNotesForSlide(zip, slideNumber) {
+        const relsEntry = zip.getEntry(SLIDE_RELS_NAME(slideNumber));
+        if (!relsEntry) {
+            return null;
+        }
+        const relsXml = relsEntry.getData().toString("utf-8");
+        let notesTarget = null;
+        RELATIONSHIP_TAG_REGEX.lastIndex = 0;
+        for (let match = RELATIONSHIP_TAG_REGEX.exec(relsXml); match !== null; match = RELATIONSHIP_TAG_REGEX.exec(relsXml)) {
+            const tag = match[0];
+            if (/Type="[^"]*\/notesSlide"/.test(tag)) {
+                notesTarget = tag.match(/Target="([^"]+)"/)?.[1] ?? null;
+                break;
+            }
+        }
+        if (!notesTarget) {
+            return null;
+        }
+        // Targets are relative to the slide's folder (ppt/slides/), e.g.
+        // "../notesSlides/notesSlide1.xml" → "ppt/notesSlides/notesSlide1.xml".
+        const normalized = notesTarget
+            .replace(/^\.\.\//, "ppt/")
+            .replace(/^\/+/, "");
+        const notesEntry = zip.getEntry(normalized);
+        if (!notesEntry) {
+            return null;
+        }
+        const notes = PptxProcessor.extractTextFromXml(notesEntry.getData().toString("utf-8")).join(" ");
+        return notes.trim() || null;
+    }
     /**
      * Extract text strings from a slide XML document.
      * Finds all `<a:t>` elements and returns their text content.

package/dist/lib/utils/pdfProcessor.js

@@ -267,6 +267,12 @@ export class PDFProcessor {
         if (format !== "png") {
             throw new Error(`Invalid format: "${format}". Only "png" format is currently supported.`);
         }
+        // 0b. Validate the render scale. A non-finite or non-positive scale yields a
+        // degenerate viewport (blank/zero-dimension render), and an excessive scale
+        // can allocate hundreds of MB per page — reject both with a clear message.
+        if (!Number.isFinite(scale) || scale <= 0 || scale > PDF_LIMITS.MAX_SCALE) {
+            throw new Error(`Invalid scale: ${scale}. Scale must be a finite number greater than 0 and at most ${PDF_LIMITS.MAX_SCALE}.`);
+        }
         // 1. Validate buffer is not empty or too small
         if (!pdfBuffer || pdfBuffer.length < 5) {
             throw new Error("Invalid PDF: Buffer is too small or empty. " +

package/dist/processors/document/PptxProcessor.d.ts

@@ -42,6 +42,20 @@ export declare class PptxProcessor {
      * @throws Error if the buffer is not a valid ZIP/PPTX file
      */
     static extractText(content: Buffer): Promise<string | null>;
+    /**
+     * Extract the speaker notes for one slide.
+     *
+     * Speaker notes live in a separate `ppt/notesSlides/notesSlideN.xml` part
+     * whose number is NOT tied to the slide number — the link is declared in the
+     * slide's own relationships file (`ppt/slides/_rels/slideN.xml.rels`) via a
+     * relationship of type `.../notesSlide`. We resolve that target, then pull the
+     * `<a:t>` runs from the notes part. Returns null when the slide has no notes.
+     *
+     * @param zip - The opened PPTX archive
+     * @param slideNumber - 1-indexed slide number
+     * @returns The notes text (runs joined by a space), or null when absent
+     */
+    private static extractNotesForSlide;
     /**
      * Extract text strings from a slide XML document.
      * Finds all `<a:t>` elements and returns their text content.

package/dist/processors/document/PptxProcessor.js

@@ -37,6 +37,14 @@ const TEXT_ELEMENT_REGEX = /<a:t[^>]*>([\s\S]*?)<\/a:t>/g;
  * Matches entries like "ppt/slides/slide1.xml", "ppt/slides/slide12.xml".
  */
 const SLIDE_ENTRY_REGEX = /^ppt\/slides\/slide(\d+)\.xml$/;
+/**
+ * A slide's per-slide relationships file, e.g.
+ * "ppt/slides/_rels/slide1.xml.rels", which links the slide to its speaker
+ * notes part (among other relationships).
+ */
+const SLIDE_RELS_NAME = (n) => `ppt/slides/_rels/slide${n}.xml.rels`;
+/** Matches a single `<Relationship .../>` tag inside a .rels document. */
+const RELATIONSHIP_TAG_REGEX = /<Relationship\b[^>]*\/?>/g;
 /**
  * Static utility class for extracting text from PPTX files.
  *
@@ -74,15 +82,65 @@ export class PptxProcessor {
         parts.push(`Presentation: ${slides.length} slide(s)\n`);
         for (const slide of slides) {
             const texts = PptxProcessor.extractTextFromXml(slide.xml);
-            if (texts.length > 0) {
+            const notes = PptxProcessor.extractNotesForSlide(zip, slide.slideNumber);
+            // Emit a slide section when it has either body text or speaker notes.
+            if (texts.length > 0 || notes) {
                 parts.push(`### Slide ${slide.slideNumber}`);
-                parts.push(texts.join("\n"));
+                if (texts.length > 0) {
+                    parts.push(texts.join("\n"));
+                }
+                if (notes) {
+                    parts.push(`**Speaker notes:** ${notes}`);
+                }
                 parts.push(""); // blank line between slides
             }
         }
         const result = parts.join("\n").trim();
         return result || null;
     }
+    /**
+     * Extract the speaker notes for one slide.
+     *
+     * Speaker notes live in a separate `ppt/notesSlides/notesSlideN.xml` part
+     * whose number is NOT tied to the slide number — the link is declared in the
+     * slide's own relationships file (`ppt/slides/_rels/slideN.xml.rels`) via a
+     * relationship of type `.../notesSlide`. We resolve that target, then pull the
+     * `<a:t>` runs from the notes part. Returns null when the slide has no notes.
+     *
+     * @param zip - The opened PPTX archive
+     * @param slideNumber - 1-indexed slide number
+     * @returns The notes text (runs joined by a space), or null when absent
+     */
+    static extractNotesForSlide(zip, slideNumber) {
+        const relsEntry = zip.getEntry(SLIDE_RELS_NAME(slideNumber));
+        if (!relsEntry) {
+            return null;
+        }
+        const relsXml = relsEntry.getData().toString("utf-8");
+        let notesTarget = null;
+        RELATIONSHIP_TAG_REGEX.lastIndex = 0;
+        for (let match = RELATIONSHIP_TAG_REGEX.exec(relsXml); match !== null; match = RELATIONSHIP_TAG_REGEX.exec(relsXml)) {
+            const tag = match[0];
+            if (/Type="[^"]*\/notesSlide"/.test(tag)) {
+                notesTarget = tag.match(/Target="([^"]+)"/)?.[1] ?? null;
+                break;
+            }
+        }
+        if (!notesTarget) {
+            return null;
+        }
+        // Targets are relative to the slide's folder (ppt/slides/), e.g.
+        // "../notesSlides/notesSlide1.xml" → "ppt/notesSlides/notesSlide1.xml".
+        const normalized = notesTarget
+            .replace(/^\.\.\//, "ppt/")
+            .replace(/^\/+/, "");
+        const notesEntry = zip.getEntry(normalized);
+        if (!notesEntry) {
+            return null;
+        }
+        const notes = PptxProcessor.extractTextFromXml(notesEntry.getData().toString("utf-8")).join(" ");
+        return notes.trim() || null;
+    }
     /**
      * Extract text strings from a slide XML document.
      * Finds all `<a:t>` elements and returns their text content.

package/dist/utils/pdfProcessor.js

@@ -267,6 +267,12 @@ export class PDFProcessor {
         if (format !== "png") {
             throw new Error(`Invalid format: "${format}". Only "png" format is currently supported.`);
         }
+        // 0b. Validate the render scale. A non-finite or non-positive scale yields a
+        // degenerate viewport (blank/zero-dimension render), and an excessive scale
+        // can allocate hundreds of MB per page — reject both with a clear message.
+        if (!Number.isFinite(scale) || scale <= 0 || scale > PDF_LIMITS.MAX_SCALE) {
+            throw new Error(`Invalid scale: ${scale}. Scale must be a finite number greater than 0 and at most ${PDF_LIMITS.MAX_SCALE}.`);
+        }
         // 1. Validate buffer is not empty or too small
         if (!pdfBuffer || pdfBuffer.length < 5) {
             throw new Error("Invalid PDF: Buffer is too small or empty. " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "9.88.4",
+  "version": "9.88.6",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (58+ servers), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {