@juspay/neurolink 7.45.0 → 7.47.0

package/dist/utils/imageProcessor.js

@@ -151,6 +151,8 @@ export class ImageProcessor {
                     bmp: "image/bmp",
                     tiff: "image/tiff",
                     tif: "image/tiff",
+                    svg: "image/svg+xml",
+                    avif: "image/avif",
                 };
                 return imageTypes[extension || ""] || "image/jpeg";
             }
@@ -183,6 +185,21 @@ export class ImageProcessor {
                         return "image/webp";
                     }
                 }
+                // SVG: check for "<svg" or "<?xml" at start (text-based)
+                if (input.length >= 4) {
+                    const start = input.subarray(0, 4).toString();
+                    if (start === "<svg" || start === "<?xm") {
+                        return "image/svg+xml";
+                    }
+                }
+                // AVIF: check for "ftypavif" signature at bytes 4-11
+                if (input.length >= 12) {
+                    const ftyp = input.subarray(4, 8).toString();
+                    const brand = input.subarray(8, 12).toString();
+                    if (ftyp === "ftyp" && brand === "avif") {
+                        return "image/avif";
+                    }
+                }
             }
             return "image/jpeg"; // Default fallback
         }
@@ -217,6 +234,8 @@ export class ImageProcessor {
             "image/webp",
             "image/bmp",
             "image/tiff",
+            "image/svg+xml",
+            "image/avif",
         ];
         return supportedFormats.includes(mediaType.toLowerCase());
     }
@@ -332,14 +351,7 @@ export const imageUtils = {
     /**
      * Check if a string is base64 encoded
      */
-    isBase64: (str) => {
-        try {
-            return btoa(atob(str)) === str;
-        }
-        catch {
-            return false;
-        }
-    },
+    isBase64: (str) => imageUtils.isValidBase64(str),
     /**
      * Extract file extension from filename or URL
      */
@@ -359,4 +371,143 @@ export const imageUtils = {
         const i = Math.floor(Math.log(bytes) / Math.log(k));
         return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + " " + sizes[i];
     },
+    /**
+     * Convert Buffer to base64 string
+     */
+    bufferToBase64: (buffer) => {
+        return buffer.toString("base64");
+    },
+    /**
+     * Convert base64 string to Buffer
+     */
+    base64ToBuffer: (base64) => {
+        // Remove data URI prefix if present
+        const cleanBase64 = base64.includes(",") ? base64.split(",")[1] : base64;
+        return Buffer.from(cleanBase64, "base64");
+    },
+    /**
+     * Convert file path to base64 data URI
+     */
+    fileToBase64DataUri: async (filePath, maxBytes = 10 * 1024 * 1024) => {
+        try {
+            const fs = await import("fs/promises");
+            // File existence and type validation
+            const stat = await fs.stat(filePath);
+            if (!stat.isFile()) {
+                throw new Error("Not a file");
+            }
+            // Size check before reading - prevent memory exhaustion
+            if (stat.size > maxBytes) {
+                throw new Error(`File too large: ${stat.size} bytes (max: ${maxBytes} bytes)`);
+            }
+            const buffer = await fs.readFile(filePath);
+            // Enhanced MIME detection: try buffer content first, fallback to filename
+            const mimeType = ImageProcessor.detectImageType(buffer) ||
+                ImageProcessor.detectImageType(filePath);
+            const base64 = buffer.toString("base64");
+            return `data:${mimeType};base64,${base64}`;
+        }
+        catch (error) {
+            throw new Error(`Failed to convert file to base64: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    },
+    /**
+     * Convert URL to base64 data URI by downloading the image
+     */
+    urlToBase64DataUri: async (url, { timeoutMs = 15000, maxBytes = 10 * 1024 * 1024 } = {}) => {
+        try {
+            // Basic protocol whitelist
+            if (!/^https?:\/\//i.test(url)) {
+                throw new Error("Unsupported protocol");
+            }
+            const controller = new AbortController();
+            const t = setTimeout(() => controller.abort(), timeoutMs);
+            try {
+                const response = await fetch(url, { signal: controller.signal });
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                const contentType = response.headers.get("content-type") || "";
+                if (!/^image\//i.test(contentType)) {
+                    throw new Error(`Unsupported content-type: ${contentType || "unknown"}`);
+                }
+                const len = Number(response.headers.get("content-length") || 0);
+                if (len && len > maxBytes) {
+                    throw new Error(`Content too large: ${len} bytes`);
+                }
+                const buffer = await response.arrayBuffer();
+                if (buffer.byteLength > maxBytes) {
+                    throw new Error(`Downloaded content too large: ${buffer.byteLength} bytes`);
+                }
+                const base64 = Buffer.from(buffer).toString("base64");
+                return `data:${contentType || "image/jpeg"};base64,${base64}`;
+            }
+            finally {
+                clearTimeout(t);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to download and convert URL to base64: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    },
+    /**
+     * Extract base64 data from data URI
+     */
+    extractBase64FromDataUri: (dataUri) => {
+        if (!dataUri.includes(",")) {
+            return dataUri; // Already just base64
+        }
+        return dataUri.split(",")[1];
+    },
+    /**
+     * Extract MIME type from data URI
+     */
+    extractMimeTypeFromDataUri: (dataUri) => {
+        const match = dataUri.match(/^data:([^;]+);base64,/);
+        return match ? match[1] : "image/jpeg";
+    },
+    /**
+     * Create data URI from base64 and MIME type
+     */
+    createDataUri: (base64, mimeType = "image/jpeg") => {
+        // Remove data URI prefix if already present
+        const cleanBase64 = base64.includes(",") ? base64.split(",")[1] : base64;
+        return `data:${mimeType};base64,${cleanBase64}`;
+    },
+    /**
+     * Validate base64 string format
+     */
+    isValidBase64: (str) => {
+        try {
+            // Remove data URI prefix if present
+            const cleanBase64 = str.includes(",") ? str.split(",")[1] : str;
+            // Check if it's valid base64
+            const decoded = Buffer.from(cleanBase64, "base64");
+            const reencoded = decoded.toString("base64");
+            // Remove padding for comparison (base64 can have different padding)
+            const normalizeBase64 = (b64) => b64.replace(/=+$/, "");
+            return normalizeBase64(cleanBase64) === normalizeBase64(reencoded);
+        }
+        catch {
+            return false;
+        }
+    },
+    /**
+     * Get base64 string size in bytes
+     */
+    getBase64Size: (base64) => {
+        // Remove data URI prefix if present
+        const cleanBase64 = base64.includes(",") ? base64.split(",")[1] : base64;
+        return Buffer.byteLength(cleanBase64, "base64");
+    },
+    /**
+     * Compress base64 image by reducing quality (basic implementation)
+     * Note: This is a placeholder - for production use, consider using sharp or similar
+     */
+    compressBase64: (base64, _quality = 0.8) => {
+        // This is a basic implementation that just returns the original
+        // In a real implementation, you'd use an image processing library
+        logger.warn("Base64 compression not implemented - returning original");
+        return base64;
+    },
 };

package/dist/utils/messageBuilder.d.ts

@@ -7,13 +7,12 @@ import type { MultimodalChatMessage } from "../types/conversation.js";
 import type { TextGenerationOptions } from "../types/index.js";
 import type { StreamOptions } from "../types/streamTypes.js";
 import type { GenerateOptions } from "../types/generateTypes.js";
+import type { CoreMessage } from "ai";
 /**
- * Core message type compatible with AI SDK
+ * Type-safe conversion from MultimodalChatMessage[] to CoreMessage[]
+ * Filters out invalid content and ensures strict CoreMessage contract compliance
  */
-type CoreMessage = {
-    role: "user" | "assistant" | "system";
-    content: string;
-};
+export declare function convertToCoreMessages(messages: MultimodalChatMessage[]): CoreMessage[];
 /**
  * Build a properly formatted message array for AI providers
  * Combines system prompt, conversation history, and current user prompt
@@ -25,4 +24,3 @@ export declare function buildMessagesArray(options: TextGenerationOptions | Stre
  * Detects when images are present and routes through provider adapter
  */
 export declare function buildMultimodalMessagesArray(options: GenerateOptions, provider: string, model: string): Promise<MultimodalChatMessage[]>;
-export {};

package/dist/utils/messageBuilder.js

@@ -8,6 +8,147 @@ import { ProviderImageAdapter, MultimodalLogger, } from "../adapters/providerIma
 import { logger } from "./logger.js";
 import { request } from "undici";
 import { readFileSync, existsSync } from "fs";
+/**
+ * Type guard for validating message roles
+ */
+function isValidRole(role) {
+    return (typeof role === "string" &&
+        (role === "user" || role === "assistant" || role === "system"));
+}
+/**
+ * Type guard for validating content items
+ */
+function isValidContentItem(item) {
+    if (!item || typeof item !== "object") {
+        return false;
+    }
+    const contentItem = item;
+    if (contentItem.type === "text") {
+        return typeof contentItem.text === "string";
+    }
+    if (contentItem.type === "image") {
+        return (typeof contentItem.image === "string" &&
+            (contentItem.mimeType === undefined ||
+                typeof contentItem.mimeType === "string"));
+    }
+    return false;
+}
+/**
+ * Safely convert content item to AI SDK content format
+ */
+function convertContentItem(item) {
+    if (!isValidContentItem(item)) {
+        return null;
+    }
+    const contentItem = item;
+    if (contentItem.type === "text" && typeof contentItem.text === "string") {
+        return { type: "text", text: contentItem.text };
+    }
+    if (contentItem.type === "image" && typeof contentItem.image === "string") {
+        return {
+            type: "image",
+            image: contentItem.image,
+            ...(contentItem.mimeType && { mimeType: contentItem.mimeType }),
+        };
+    }
+    return null;
+}
+/**
+ * Type-safe conversion from MultimodalChatMessage[] to CoreMessage[]
+ * Filters out invalid content and ensures strict CoreMessage contract compliance
+ */
+export function convertToCoreMessages(messages) {
+    return messages
+        .map((msg) => {
+        // Validate role
+        if (!isValidRole(msg.role)) {
+            logger.warn("Invalid message role found, skipping", { role: msg.role });
+            return null;
+        }
+        // Handle string content
+        if (typeof msg.content === "string") {
+            // Create properly typed discriminated union messages
+            if (msg.role === "system") {
+                return {
+                    role: "system",
+                    content: msg.content,
+                };
+            }
+            else if (msg.role === "user") {
+                return {
+                    role: "user",
+                    content: msg.content,
+                };
+            }
+            else if (msg.role === "assistant") {
+                return {
+                    role: "assistant",
+                    content: msg.content,
+                };
+            }
+        }
+        // Handle array content (multimodal) - only user messages support full multimodal content
+        if (Array.isArray(msg.content)) {
+            const validContent = msg.content
+                .map(convertContentItem)
+                .filter((item) => item !== null);
+            // If no valid content items, skip the message
+            if (validContent.length === 0) {
+                logger.warn("No valid content items found in multimodal message, skipping");
+                return null;
+            }
+            if (msg.role === "user") {
+                // User messages support both text and image content
+                return {
+                    role: "user",
+                    content: validContent,
+                };
+            }
+            else if (msg.role === "assistant") {
+                // Assistant messages only support text content, filter out images
+                const textOnlyContent = validContent.filter((item) => item.type === "text");
+                if (textOnlyContent.length === 0) {
+                    // If no text content, convert to empty string
+                    return {
+                        role: "assistant",
+                        content: "",
+                    };
+                }
+                else if (textOnlyContent.length === 1) {
+                    // Single text item, use string content
+                    return {
+                        role: "assistant",
+                        content: textOnlyContent[0].text,
+                    };
+                }
+                else {
+                    // Multiple text items, concatenate them
+                    const combinedText = textOnlyContent
+                        .map((item) => item.text)
+                        .join(" ");
+                    return {
+                        role: "assistant",
+                        content: combinedText,
+                    };
+                }
+            }
+            else {
+                // System messages cannot have multimodal content, convert to text
+                const textContent = validContent.find((item) => item.type === "text")?.text || "";
+                return {
+                    role: "system",
+                    content: textContent,
+                };
+            }
+        }
+        // Invalid content type
+        logger.warn("Invalid message content type found, skipping", {
+            contentType: typeof msg.content,
+        });
+        return null;
+    })
+        .filter((msg) => msg !== null);
+}
 /**
  * Convert ChatMessage to CoreMessage for AI SDK compatibility
  */
@@ -84,7 +225,10 @@ export async function buildMultimodalMessagesArray(options, provider, model) {
     // If no images, use standard message building and convert to MultimodalChatMessage[]
     if (!hasImages) {
         const standardMessages = buildMessagesArray(options);
-        return standardMessages.map((msg) => ({ ...msg, content: msg.content }));
+        return standardMessages.map((msg) => ({
+            role: msg.role,
+            content: typeof msg.content === "string" ? msg.content : msg.content,
+        }));
     }
     // Validate provider supports vision
     if (!ProviderImageAdapter.supportsVision(provider, model)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "7.45.0",
+  "version": "7.47.0",
   "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 9 major providers: OpenAI, Anthropic, Google AI, AWS Bedrock, Azure, Hugging Face, Ollama, and Mistral AI.",
   "author": {
     "name": "Juspay Technologies",