@juspay/neurolink 7.35.0 → 7.36.0

package/dist/lib/utils/imageProcessor.js

@@ -0,0 +1,362 @@
+/**
+ * Image processing utilities for multimodal support
+ * Handles format conversion for different AI providers
+ */
+import { logger } from "./logger.js";
+/**
+ * Image processor class for handling provider-specific image formatting
+ */
+export class ImageProcessor {
+    /**
+     * Process image for OpenAI (requires data URI format)
+     */
+    static processImageForOpenAI(image) {
+        try {
+            if (typeof image === "string") {
+                // Handle URLs
+                if (image.startsWith("http")) {
+                    return image;
+                }
+                // Handle data URIs
+                if (image.startsWith("data:")) {
+                    return image;
+                }
+                // Handle base64 - convert to data URI
+                return `data:image/jpeg;base64,${image}`;
+            }
+            // Handle Buffer - convert to data URI
+            const base64 = image.toString("base64");
+            return `data:image/jpeg;base64,${base64}`;
+        }
+        catch (error) {
+            logger.error("Failed to process image for OpenAI:", error);
+            throw new Error(`Image processing failed for OpenAI: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Process image for Google AI (requires base64 without data URI prefix)
+     */
+    static processImageForGoogle(image) {
+        try {
+            let base64Data;
+            let mimeType = "image/jpeg"; // Default
+            if (typeof image === "string") {
+                if (image.startsWith("data:")) {
+                    // Extract mime type and base64 from data URI
+                    const match = image.match(/^data:([^;]+);base64,(.+)$/);
+                    if (match) {
+                        mimeType = match[1];
+                        base64Data = match[2];
+                    }
+                    else {
+                        base64Data = image.split(",")[1] || image;
+                    }
+                }
+                else {
+                    base64Data = image;
+                }
+            }
+            else {
+                base64Data = image.toString("base64");
+            }
+            return {
+                mimeType,
+                data: base64Data, // Google wants base64 WITHOUT data URI prefix
+            };
+        }
+        catch (error) {
+            logger.error("Failed to process image for Google AI:", error);
+            throw new Error(`Image processing failed for Google AI: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Process image for Anthropic (requires base64 without data URI prefix)
+     */
+    static processImageForAnthropic(image) {
+        try {
+            let base64Data;
+            let mediaType = "image/jpeg"; // Default
+            if (typeof image === "string") {
+                if (image.startsWith("data:")) {
+                    // Extract mime type and base64 from data URI
+                    const match = image.match(/^data:([^;]+);base64,(.+)$/);
+                    if (match) {
+                        mediaType = match[1];
+                        base64Data = match[2];
+                    }
+                    else {
+                        base64Data = image.split(",")[1] || image;
+                    }
+                }
+                else {
+                    base64Data = image;
+                }
+            }
+            else {
+                base64Data = image.toString("base64");
+            }
+            return {
+                mediaType,
+                data: base64Data, // Anthropic wants base64 WITHOUT data URI prefix
+            };
+        }
+        catch (error) {
+            logger.error("Failed to process image for Anthropic:", error);
+            throw new Error(`Image processing failed for Anthropic: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Process image for Vertex AI (model-specific routing)
+     */
+    static processImageForVertex(image, model) {
+        try {
+            // Route based on model type
+            if (model.includes("gemini")) {
+                // Use Google AI format for Gemini models
+                return ImageProcessor.processImageForGoogle(image);
+            }
+            else if (model.includes("claude")) {
+                // Use Anthropic format for Claude models
+                return ImageProcessor.processImageForAnthropic(image);
+            }
+            else {
+                // Default to Google format
+                return ImageProcessor.processImageForGoogle(image);
+            }
+        }
+        catch (error) {
+            logger.error("Failed to process image for Vertex AI:", error);
+            throw new Error(`Image processing failed for Vertex AI: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+    /**
+     * Detect image type from filename or data
+     */
+    static detectImageType(input) {
+        try {
+            if (typeof input === "string") {
+                // Check if it's a data URI
+                if (input.startsWith("data:")) {
+                    const match = input.match(/^data:([^;]+);/);
+                    return match ? match[1] : "image/jpeg";
+                }
+                // Check if it's a filename
+                const extension = input.toLowerCase().split(".").pop();
+                const imageTypes = {
+                    jpg: "image/jpeg",
+                    jpeg: "image/jpeg",
+                    png: "image/png",
+                    gif: "image/gif",
+                    webp: "image/webp",
+                    bmp: "image/bmp",
+                    tiff: "image/tiff",
+                    tif: "image/tiff",
+                };
+                return imageTypes[extension || ""] || "image/jpeg";
+            }
+            // For Buffer, try to detect from magic bytes
+            if (input.length >= 4) {
+                const header = input.subarray(0, 4);
+                // PNG: 89 50 4E 47
+                if (header[0] === 0x89 &&
+                    header[1] === 0x50 &&
+                    header[2] === 0x4e &&
+                    header[3] === 0x47) {
+                    return "image/png";
+                }
+                // JPEG: FF D8 FF
+                if (header[0] === 0xff && header[1] === 0xd8 && header[2] === 0xff) {
+                    return "image/jpeg";
+                }
+                // GIF: 47 49 46 38
+                if (header[0] === 0x47 &&
+                    header[1] === 0x49 &&
+                    header[2] === 0x46 &&
+                    header[3] === 0x38) {
+                    return "image/gif";
+                }
+                // WebP: check for RIFF and WEBP
+                if (input.length >= 12) {
+                    const riff = input.subarray(0, 4);
+                    const webp = input.subarray(8, 12);
+                    if (riff.toString() === "RIFF" && webp.toString() === "WEBP") {
+                        return "image/webp";
+                    }
+                }
+            }
+            return "image/jpeg"; // Default fallback
+        }
+        catch (error) {
+            logger.warn("Failed to detect image type, using default:", error);
+            return "image/jpeg";
+        }
+    }
+    /**
+     * Validate image size (default 10MB limit)
+     */
+    static validateImageSize(data, maxSize = 10 * 1024 * 1024) {
+        try {
+            const size = typeof data === "string"
+                ? Buffer.byteLength(data, "base64")
+                : data.length;
+            return size <= maxSize;
+        }
+        catch (error) {
+            logger.warn("Failed to validate image size:", error);
+            return false;
+        }
+    }
+    /**
+     * Validate image format
+     */
+    static validateImageFormat(mediaType) {
+        const supportedFormats = [
+            "image/jpeg",
+            "image/png",
+            "image/gif",
+            "image/webp",
+            "image/bmp",
+            "image/tiff",
+        ];
+        return supportedFormats.includes(mediaType.toLowerCase());
+    }
+    /**
+     * Get image dimensions from Buffer (basic implementation)
+     */
+    static getImageDimensions(buffer) {
+        try {
+            // Basic PNG dimension extraction
+            if (buffer.length >= 24 &&
+                buffer.subarray(0, 8).toString("hex") === "89504e470d0a1a0a") {
+                const width = buffer.readUInt32BE(16);
+                const height = buffer.readUInt32BE(20);
+                return { width, height };
+            }
+            // Basic JPEG dimension extraction (simplified)
+            if (buffer.length >= 4 && buffer[0] === 0xff && buffer[1] === 0xd8) {
+                // This is a very basic implementation
+                // For production, consider using a proper image library
+                return null;
+            }
+            return null;
+        }
+        catch (error) {
+            logger.warn("Failed to extract image dimensions:", error);
+            return null;
+        }
+    }
+    /**
+     * Convert image to ProcessedImage format
+     */
+    static processImage(image, provider, model) {
+        try {
+            const mediaType = ImageProcessor.detectImageType(image);
+            const size = typeof image === "string"
+                ? Buffer.byteLength(image, "base64")
+                : image.length;
+            let data;
+            let format;
+            switch (provider.toLowerCase()) {
+                case "openai":
+                    data = ImageProcessor.processImageForOpenAI(image);
+                    format = "data_uri";
+                    break;
+                case "google-ai":
+                case "google": {
+                    const googleResult = ImageProcessor.processImageForGoogle(image);
+                    data = googleResult.data;
+                    format = "base64";
+                    break;
+                }
+                case "anthropic": {
+                    const anthropicResult = ImageProcessor.processImageForAnthropic(image);
+                    data = anthropicResult.data;
+                    format = "base64";
+                    break;
+                }
+                case "vertex": {
+                    const vertexResult = ImageProcessor.processImageForVertex(image, model || "");
+                    data = vertexResult.data;
+                    format = "base64";
+                    break;
+                }
+                default:
+                    // Default to base64
+                    if (typeof image === "string") {
+                        data = image.startsWith("data:")
+                            ? image.split(",")[1] || image
+                            : image;
+                    }
+                    else {
+                        data = image.toString("base64");
+                    }
+                    format = "base64";
+            }
+            return {
+                data,
+                mediaType,
+                size,
+                format,
+            };
+        }
+        catch (error) {
+            logger.error(`Failed to process image for ${provider}:`, error);
+            throw new Error(`Image processing failed: ${error instanceof Error ? error.message : "Unknown error"}`);
+        }
+    }
+}
+/**
+ * Utility functions for image handling
+ */
+export const imageUtils = {
+    /**
+     * Check if a string is a valid data URI
+     */
+    isDataUri: (str) => {
+        return (typeof str === "string" &&
+            str.startsWith("data:") &&
+            str.includes("base64,"));
+    },
+    /**
+     * Check if a string is a valid URL
+     */
+    isUrl: (str) => {
+        try {
+            new URL(str);
+            return str.startsWith("http://") || str.startsWith("https://");
+        }
+        catch {
+            return false;
+        }
+    },
+    /**
+     * Check if a string is base64 encoded
+     */
+    isBase64: (str) => {
+        try {
+            return btoa(atob(str)) === str;
+        }
+        catch {
+            return false;
+        }
+    },
+    /**
+     * Extract file extension from filename or URL
+     */
+    getFileExtension: (filename) => {
+        const match = filename.match(/\.([^.]+)$/);
+        return match ? match[1].toLowerCase() : null;
+    },
+    /**
+     * Convert file size to human readable format
+     */
+    formatFileSize: (bytes) => {
+        if (bytes === 0) {
+            return "0 Bytes";
+        }
+        const k = 1024;
+        const sizes = ["Bytes", "KB", "MB", "GB"];
+        const i = Math.floor(Math.log(bytes) / Math.log(k));
+        return parseFloat((bytes / Math.pow(k, i)).toFixed(2)) + " " + sizes[i];
+    },
+};

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

@@ -1,13 +1,20 @@
 /**
  * Message Builder Utility
  * Centralized logic for building message arrays from TextGenerationOptions
+ * Enhanced with multimodal support for images
  */
-import type { ChatMessage } from "../types/conversation.js";
+import type { ChatMessage, 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";
 /**
  * Build a properly formatted message array for AI providers
  * Combines system prompt, conversation history, and current user prompt
  * Supports both TextGenerationOptions and StreamOptions
  */
 export declare function buildMessagesArray(options: TextGenerationOptions | StreamOptions): ChatMessage[];
+/**
+ * Build multimodal message array with image support
+ * Detects when images are present and routes through provider adapter
+ */
+export declare function buildMultimodalMessagesArray(options: GenerateOptions, provider: string, model: string): Promise<MultimodalChatMessage[]>;

package/dist/lib/utils/messageBuilder.js

@@ -1,8 +1,13 @@
 /**
  * Message Builder Utility
  * Centralized logic for building message arrays from TextGenerationOptions
+ * Enhanced with multimodal support for images
  */
 import { CONVERSATION_INSTRUCTIONS } from "../config/conversationMemory.js";
+import { ProviderImageAdapter, MultimodalLogger, } from "../adapters/providerImageAdapter.js";
+import { logger } from "./logger.js";
+import { request } from "undici";
+import { readFileSync, existsSync } from "fs";
 /**
  * Build a properly formatted message array for AI providers
  * Combines system prompt, conversation history, and current user prompt
@@ -46,3 +51,277 @@ export function buildMessagesArray(options) {
     }
     return messages;
 }
+/**
+ * Build multimodal message array with image support
+ * Detects when images are present and routes through provider adapter
+ */
+export async function buildMultimodalMessagesArray(options, provider, model) {
+    // Check if this is a multimodal request
+    const hasImages = (options.input.images && options.input.images.length > 0) ||
+        (options.input.content &&
+            options.input.content.some((c) => c.type === "image"));
+    // 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 }));
+    }
+    // Validate provider supports vision
+    if (!ProviderImageAdapter.supportsVision(provider, model)) {
+        throw new Error(`Provider ${provider} with model ${model} does not support vision processing. ` +
+            `Supported providers: ${ProviderImageAdapter.getVisionProviders().join(", ")}`);
+    }
+    const messages = [];
+    // Build enhanced system prompt
+    let systemPrompt = options.systemPrompt?.trim() || "";
+    // Add conversation-aware instructions when history exists
+    const hasConversationHistory = options.conversationHistory && options.conversationHistory.length > 0;
+    if (hasConversationHistory) {
+        systemPrompt = `${systemPrompt.trim()}${CONVERSATION_INSTRUCTIONS}`;
+    }
+    // Add system message if we have one
+    if (systemPrompt.trim()) {
+        messages.push({
+            role: "system",
+            content: systemPrompt.trim(),
+        });
+    }
+    // Add conversation history if available
+    if (hasConversationHistory && options.conversationHistory) {
+        // Convert conversation history to MultimodalChatMessage format
+        options.conversationHistory.forEach((msg) => {
+            messages.push({
+                role: msg.role,
+                content: msg.content,
+            });
+        });
+    }
+    // Handle multimodal content
+    try {
+        let userContent;
+        if (options.input.content && options.input.content.length > 0) {
+            // Advanced content format - convert to provider-specific format
+            userContent = await convertContentToProviderFormat(options.input.content, provider, model);
+        }
+        else if (options.input.images && options.input.images.length > 0) {
+            // Simple images format - convert to provider-specific format
+            userContent = await convertSimpleImagesToProviderFormat(options.input.text, options.input.images, provider, model);
+        }
+        else {
+            // Text-only fallback
+            userContent = options.input.text;
+        }
+        // 🔧 CRITICAL FIX: Handle multimodal content properly for Vercel AI SDK
+        if (typeof userContent === "string") {
+            // Simple text content - use standard MultimodalChatMessage format
+            messages.push({
+                role: "user",
+                content: userContent,
+            });
+        }
+        else {
+            // 🔧 MULTIMODAL CONTENT: Wrap the content array in a proper message object
+            // The Vercel AI SDK expects messages with multimodal content arrays
+            messages.push({
+                role: "user",
+                content: userContent,
+            });
+        }
+        return messages;
+    }
+    catch (error) {
+        MultimodalLogger.logError("MULTIMODAL_BUILD", error, {
+            provider,
+            model,
+            hasImages,
+            imageCount: options.input.images?.length || 0,
+        });
+        throw error;
+    }
+}
+/**
+ * Convert advanced content format to provider-specific format
+ */
+async function convertContentToProviderFormat(content, provider, _model) {
+    const textContent = content.find((c) => c.type === "text");
+    const imageContent = content.filter((c) => c.type === "image");
+    if (!textContent) {
+        throw new Error("Multimodal content must include at least one text element");
+    }
+    if (imageContent.length === 0) {
+        return textContent.text;
+    }
+    // Extract images as Buffer | string array
+    const images = imageContent.map((img) => img.data);
+    return await convertSimpleImagesToProviderFormat(textContent.text, images, provider, _model);
+}
+/**
+ * Check if a string is an internet URL
+ */
+function isInternetUrl(input) {
+    return input.startsWith("http://") || input.startsWith("https://");
+}
+/**
+ * Download image from URL and convert to base64 data URI
+ */
+async function downloadImageFromUrl(url) {
+    try {
+        const response = await request(url, {
+            method: "GET",
+            headersTimeout: 10000, // 10 second timeout for headers
+            bodyTimeout: 30000, // 30 second timeout for body
+            maxRedirections: 5,
+        });
+        if (response.statusCode !== 200) {
+            throw new Error(`HTTP ${response.statusCode}: Failed to download image from ${url}`);
+        }
+        // Get content type from headers
+        const contentType = response.headers["content-type"] || "image/jpeg";
+        // Validate it's an image
+        if (!contentType.startsWith("image/")) {
+            throw new Error(`URL does not point to an image. Content-Type: ${contentType}`);
+        }
+        // Read the response body
+        const chunks = [];
+        for await (const chunk of response.body) {
+            chunks.push(chunk);
+        }
+        const buffer = Buffer.concat(chunks);
+        // Check file size (limit to 10MB)
+        const maxSize = 10 * 1024 * 1024; // 10MB
+        if (buffer.length > maxSize) {
+            throw new Error(`Image too large: ${buffer.length} bytes (max: ${maxSize} bytes)`);
+        }
+        // Convert to base64 data URI
+        const base64 = buffer.toString("base64");
+        const dataUri = `data:${contentType};base64,${base64}`;
+        return dataUri;
+    }
+    catch (error) {
+        MultimodalLogger.logError("URL_DOWNLOAD_FAILED", error, { url });
+        throw new Error(`Failed to download image from ${url}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Convert simple images format to Vercel AI SDK format with smart auto-detection
+ * - URLs: Downloaded and converted to base64 for Vercel AI SDK compatibility
+ * - Local files: Converted to base64 for Vercel AI SDK compatibility
+ * - Buffers/Data URIs: Processed normally
+ */
+async function convertSimpleImagesToProviderFormat(text, images, provider, _model) {
+    // For Vercel AI SDK, we need to return the content in the standard format
+    // The Vercel AI SDK will handle provider-specific formatting internally
+    // Smart auto-detection: separate URLs from actual image data
+    const urlImages = [];
+    const actualImages = [];
+    images.forEach((image, _index) => {
+        if (typeof image === "string" && isInternetUrl(image)) {
+            // Internet URL - will be downloaded and converted to base64
+            urlImages.push(image);
+        }
+        else {
+            // Actual image data (file path, Buffer, data URI) - process for Vercel AI SDK
+            actualImages.push(image);
+        }
+    });
+    // Download URL images and add to actual images
+    for (const url of urlImages) {
+        try {
+            const downloadedDataUri = await downloadImageFromUrl(url);
+            actualImages.push(downloadedDataUri);
+        }
+        catch (error) {
+            MultimodalLogger.logError("URL_DOWNLOAD_FAILED_SKIPPING", error, { url });
+            // Continue processing other images even if one URL fails
+            logger.warn(`Failed to download image from ${url}, skipping: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    const content = [{ type: "text", text }];
+    // Process all images (including downloaded URLs) for Vercel AI SDK
+    actualImages.forEach((image, index) => {
+        try {
+            // Vercel AI SDK expects { type: 'image', image: Buffer | string, mimeType?: string }
+            // For Vertex AI, we need to include mimeType
+            let imageData;
+            let mimeType = "image/jpeg"; // Default mime type
+            if (typeof image === "string") {
+                if (image.startsWith("data:")) {
+                    // Data URI (including downloaded URLs) - extract mime type and use directly
+                    const match = image.match(/^data:([^;]+);base64,(.+)$/);
+                    if (match) {
+                        mimeType = match[1];
+                        imageData = image; // Keep as data URI for Vercel AI SDK
+                    }
+                    else {
+                        imageData = image;
+                    }
+                }
+                else if (isInternetUrl(image)) {
+                    // This should not happen as URLs are processed separately above
+                    // But handle it gracefully just in case
+                    throw new Error(`Unprocessed URL found in actualImages: ${image}`);
+                }
+                else {
+                    // File path string - convert to base64 data URI
+                    try {
+                        if (existsSync(image)) {
+                            const buffer = readFileSync(image);
+                            const base64 = buffer.toString("base64");
+                            // Detect mime type from file extension
+                            const ext = image.toLowerCase().split(".").pop();
+                            switch (ext) {
+                                case "png":
+                                    mimeType = "image/png";
+                                    break;
+                                case "gif":
+                                    mimeType = "image/gif";
+                                    break;
+                                case "webp":
+                                    mimeType = "image/webp";
+                                    break;
+                                case "bmp":
+                                    mimeType = "image/bmp";
+                                    break;
+                                case "tiff":
+                                case "tif":
+                                    mimeType = "image/tiff";
+                                    break;
+                                default:
+                                    mimeType = "image/jpeg";
+                                    break;
+                            }
+                            imageData = `data:${mimeType};base64,${base64}`;
+                        }
+                        else {
+                            throw new Error(`Image file not found: ${image}`);
+                        }
+                    }
+                    catch (error) {
+                        MultimodalLogger.logError("FILE_PATH_CONVERSION", error, {
+                            index,
+                            filePath: image,
+                        });
+                        throw new Error(`Failed to convert file path to base64: ${image}. ${error}`);
+                    }
+                }
+            }
+            else {
+                // Buffer - convert to base64 data URI
+                const base64 = image.toString("base64");
+                imageData = `data:${mimeType};base64,${base64}`;
+            }
+            content.push({
+                type: "image",
+                image: imageData,
+                mimeType: mimeType, // Add mimeType for Vertex AI compatibility
+            });
+        }
+        catch (error) {
+            MultimodalLogger.logError("ADD_IMAGE_TO_CONTENT", error, {
+                index,
+                provider,
+            });
+            throw error;
+        }
+    });
+    return content;
+}