mcp-hydrocoder-image 1.0.0

package/dist/api/geminiClient.js

@@ -0,0 +1,341 @@
+/**
+ * Gemini API client for image generation
+ * Integrates with Google's Gemini AI API using the official SDK
+ * Supports automatic URL Context processing and feature parameters
+ */
+import { GoogleGenAI } from '@google/genai';
+import { GEMINI_MODELS } from '../types/mcp.js';
+import { Err, Ok } from '../types/result.js';
+import { GeminiAPIError, NetworkError } from '../utils/errors.js';
+/**
+ * Safely analyze response structure for debugging (removes sensitive data)
+ */
+function analyzeResponseStructure(obj) {
+    if (!obj || typeof obj !== 'object') {
+        return { type: typeof obj, value: obj };
+    }
+    const seen = new WeakSet();
+    const sanitize = (value, depth = 0) => {
+        if (depth > 3)
+            return '[max depth]';
+        if (value === null || value === undefined)
+            return value;
+        if (typeof value !== 'object')
+            return typeof value === 'string' && value.length > 100
+                ? `[string length: ${value.length}]`
+                : value;
+        if (seen.has(value))
+            return '[circular]';
+        seen.add(value);
+        if (Array.isArray(value)) {
+            return value.slice(0, 3).map((v) => sanitize(v, depth + 1));
+        }
+        const record = value;
+        const result = {};
+        for (const [key, val] of Object.entries(record)) {
+            // Skip sensitive keys
+            if (/apikey|token|secret|password|credential/i.test(key)) {
+                result[key] = '[REDACTED]';
+            }
+            else if (key === 'data' && typeof val === 'string' && val.length > 100) {
+                // Likely base64 image data
+                result[key] = `[base64 data, length: ${val.length}]`;
+            }
+            else {
+                result[key] = sanitize(val, depth + 1);
+            }
+        }
+        return result;
+    };
+    return sanitize(obj);
+}
+/**
+ * Type guard for Gemini response validation
+ */
+function isGeminiResponse(obj) {
+    if (!obj || typeof obj !== 'object')
+        return false;
+    const response = obj;
+    // Check if it has response property (wrapped response)
+    if ('response' in response && response['response'] && typeof response['response'] === 'object') {
+        const innerResponse = response['response'];
+        return 'candidates' in innerResponse && Array.isArray(innerResponse['candidates']);
+    }
+    // Check direct candidates property (direct response)
+    return 'candidates' in response && Array.isArray(response['candidates']);
+}
+/**
+ * Implementation of Gemini API client
+ */
+class GeminiClientImpl {
+    constructor(genai, defaultQuality = 'fast') {
+        this.genai = genai;
+        this.defaultQuality = defaultQuality;
+    }
+    async generateImage(params) {
+        try {
+            // Prepare the request content with proper structure for multimodal input
+            const requestContent = [];
+            // Structure the contents properly for image generation/editing
+            // Priority: inputImages > inputImage > text-only
+            if (params.inputImages && params.inputImages.length > 0) {
+                // For multi-image: multiple inlineData parts + text
+                const parts = params.inputImages.map((img) => ({
+                    inlineData: {
+                        data: img.data,
+                        mimeType: img.mimeType,
+                    },
+                }));
+                parts.push({ text: params.prompt });
+                requestContent.push({ parts });
+            }
+            else if (params.inputImage) {
+                // For image editing: provide image first, then text instructions
+                requestContent.push({
+                    parts: [
+                        {
+                            inlineData: {
+                                data: params.inputImage,
+                                mimeType: params.inputImageMimeType || 'image/jpeg',
+                            },
+                        },
+                        {
+                            text: params.prompt,
+                        },
+                    ],
+                });
+            }
+            else {
+                // For text-to-image: provide only text prompt
+                requestContent.push({
+                    parts: [
+                        {
+                            text: params.prompt,
+                        },
+                    ],
+                });
+            }
+            // Determine effective quality
+            const effectiveQuality = params.quality ?? this.defaultQuality;
+            // Select model based on quality preset
+            const modelName = effectiveQuality === 'quality' ? GEMINI_MODELS.PRO : GEMINI_MODELS.FLASH;
+            // Construct config object for generateContent
+            const imageConfig = {};
+            if (params.aspectRatio) {
+                imageConfig['aspectRatio'] = params.aspectRatio;
+            }
+            if (params.imageSize) {
+                imageConfig['imageSize'] = params.imageSize;
+            }
+            // Build config with optional thinkingConfig
+            const thinkingConfig = effectiveQuality === 'balanced' ? { thinkingConfig: { thinkingLevel: 'high' } } : {};
+            const config = {
+                ...(Object.keys(imageConfig).length > 0 && { imageConfig }),
+                responseModalities: ['IMAGE'],
+                ...thinkingConfig,
+            };
+            // Construct tools array for Google Search grounding
+            const tools = params.useGoogleSearch ? [{ googleSearch: {} }] : undefined;
+            // Generate content using Gemini API
+            const rawResponse = await this.genai.models.generateContent({
+                model: modelName,
+                contents: requestContent,
+                config,
+                ...(tools && { tools }),
+            });
+            // Validate response structure with type guard
+            if (!isGeminiResponse(rawResponse)) {
+                const responseStructure = analyzeResponseStructure(rawResponse);
+                // Check if it's an error response from Gemini
+                const asRecord = rawResponse;
+                if (asRecord['error']) {
+                    const error = asRecord['error'];
+                    return Err(new GeminiAPIError(`Gemini API Error: ${error['message'] || 'Unknown error'}`, {
+                        code: error['code'],
+                        status: error['status'],
+                        details: error['details'] || responseStructure,
+                        stage: 'api_error',
+                    }));
+                }
+                return Err(new GeminiAPIError('Invalid response structure from Gemini API', {
+                    message: 'The API returned an unexpected response format',
+                    responseStructure: responseStructure,
+                    stage: 'response_validation',
+                    suggestion: 'Check if the API endpoint or model configuration is correct',
+                }));
+            }
+            // Extract the actual response data (handle wrapped responses)
+            const responseData = rawResponse['response']
+                ? rawResponse['response']
+                : rawResponse;
+            // Check for prompt feedback (safety blocking)
+            const responseAsRecord = responseData;
+            if (responseAsRecord['promptFeedback']) {
+                const promptFeedback = responseAsRecord['promptFeedback'];
+                if (promptFeedback['blockReason'] === 'SAFETY') {
+                    return Err(new GeminiAPIError('Image generation blocked for safety reasons', {
+                        stage: 'prompt_analysis',
+                        blockReason: promptFeedback['blockReason'],
+                        suggestion: 'Rephrase your prompt to avoid potentially sensitive content',
+                    }));
+                }
+                if (promptFeedback['blockReason'] === 'OTHER' ||
+                    promptFeedback['blockReason'] === 'PROHIBITED_CONTENT') {
+                    return Err(new GeminiAPIError('Image generation blocked due to prohibited content', {
+                        stage: 'prompt_analysis',
+                        blockReason: promptFeedback['blockReason'],
+                        suggestion: 'Remove any prohibited content from your prompt and try again',
+                    }));
+                }
+            }
+            // Check for candidates
+            if (!responseData.candidates || responseData.candidates.length === 0) {
+                return Err(new GeminiAPIError('No image generated: Content may have been filtered', {
+                    stage: 'generation',
+                    candidatesCount: 0,
+                    suggestion: 'Try rephrasing your prompt to avoid potentially sensitive content',
+                }));
+            }
+            const candidate = responseData.candidates[0];
+            if (!candidate || !candidate.content || !candidate.content.parts) {
+                return Err(new GeminiAPIError('No valid content in response', {
+                    stage: 'candidate_extraction',
+                    suggestion: 'The API response was incomplete. Please try again',
+                }));
+            }
+            const parts = candidate.content.parts;
+            // Handle finish reason specific errors before checking parts
+            if (candidate.finishReason) {
+                const finishReason = candidate.finishReason;
+                if (finishReason === 'IMAGE_SAFETY') {
+                    return Err(new GeminiAPIError('Image generation stopped for safety reasons', {
+                        finishReason,
+                        stage: 'generation_stopped',
+                        suggestion: 'Modify your prompt to avoid potentially sensitive content',
+                        safetyRatings: candidate['safetyRatings']
+                            ? candidate['safetyRatings']
+                                ?.map((rating) => {
+                                const category = rating['category']
+                                    .replace('HARM_CATEGORY_', '')
+                                    .split('_')
+                                    .map((word) => word.charAt(0) + word.slice(1).toLowerCase())
+                                    .join(' ');
+                                return `${category} (${rating['blocked'] ? 'BLOCKED' : 'ALLOWED'})`;
+                            })
+                                .join(', ')
+                            : undefined,
+                    }));
+                }
+                if (finishReason === 'MAX_TOKENS') {
+                    return Err(new GeminiAPIError('Maximum token limit reached during generation', {
+                        finishReason,
+                        stage: 'generation_stopped',
+                        suggestion: 'Try using a shorter or simpler prompt',
+                    }));
+                }
+            }
+            if (parts.length === 0) {
+                return Err(new GeminiAPIError('No content parts in response', {
+                    stage: 'content_extraction',
+                    suggestion: 'The generation was incomplete. Please try again',
+                }));
+            }
+            // Check if we got an image or text (error message)
+            const imagePart = parts.find((part) => part.inlineData?.data);
+            const textPart = parts.find((part) => part.text);
+            if (!imagePart?.inlineData) {
+                // If there's text, it's likely an error message from Gemini
+                const errorMessage = textPart?.text || 'Image generation failed';
+                return Err(new GeminiAPIError('Image generation failed due to content filtering', {
+                    reason: errorMessage,
+                    stage: 'image_extraction',
+                    suggestion: 'The prompt was blocked by safety filters. Try rephrasing your prompt to avoid potentially sensitive content.',
+                }));
+            }
+            // Convert base64 image data to Buffer
+            const imageBuffer = Buffer.from(imagePart.inlineData.data, 'base64');
+            const mimeType = imagePart.inlineData.mimeType || 'image/png';
+            // Create metadata
+            const metadata = {
+                model: modelName,
+                prompt: params.prompt,
+                mimeType,
+                timestamp: new Date(),
+                inputImageProvided: !!params.inputImage || !!(params.inputImages && params.inputImages.length > 0),
+                ...(responseData.modelVersion && { modelVersion: responseData.modelVersion }),
+                ...(responseData.responseId && { responseId: responseData.responseId }),
+            };
+            return Ok({
+                imageData: imageBuffer,
+                metadata,
+            });
+        }
+        catch (error) {
+            return this.handleError(error, params.prompt);
+        }
+    }
+    handleError(error, prompt) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        // Check if it's a network error
+        if (this.isNetworkError(error)) {
+            return Err(new NetworkError(`Network error during image generation: ${errorMessage}`, 'Check your internet connection and try again', error instanceof Error ? error : undefined));
+        }
+        // Check if it's an API-specific error
+        if (this.isAPIError(error)) {
+            return Err(new GeminiAPIError(`Failed to generate image: ${errorMessage}`, this.getAPIErrorSuggestion(errorMessage), this.extractStatusCode(error)));
+        }
+        // Generic API error
+        return Err(new GeminiAPIError(`Failed to generate image with prompt "${prompt}": ${errorMessage}`, 'Check your API key, quota, and prompt validity. Try again with a different prompt'));
+    }
+    isNetworkError(error) {
+        if (error instanceof Error) {
+            const networkErrorCodes = ['ECONNRESET', 'ECONNREFUSED', 'ETIMEDOUT', 'ENOTFOUND'];
+            return networkErrorCodes.some((code) => error.message.includes(code) || error.code === code);
+        }
+        return false;
+    }
+    isAPIError(error) {
+        if (error instanceof Error) {
+            const apiErrorKeywords = ['quota', 'rate limit', 'unauthorized', 'forbidden', 'api key'];
+            return apiErrorKeywords.some((keyword) => error.message.toLowerCase().includes(keyword));
+        }
+        return false;
+    }
+    getAPIErrorSuggestion(errorMessage) {
+        const lowerMessage = errorMessage.toLowerCase();
+        if (lowerMessage.includes('quota') || lowerMessage.includes('rate limit')) {
+            return 'You have exceeded your API quota or rate limit. Wait before making more requests or upgrade your plan';
+        }
+        if (lowerMessage.includes('unauthorized') || lowerMessage.includes('api key')) {
+            return 'Check that your GEMINI_API_KEY is valid and has the necessary permissions';
+        }
+        if (lowerMessage.includes('forbidden')) {
+            return 'Your API key does not have permission for this operation';
+        }
+        return 'Check your API configuration and try again';
+    }
+    extractStatusCode(error) {
+        if (error && typeof error === 'object' && 'status' in error) {
+            return typeof error.status === 'number' ? error.status : undefined;
+        }
+        return undefined;
+    }
+}
+/**
+ * Creates a new Gemini API client
+ * @param config Configuration containing API key and other settings
+ * @returns Result containing the client or an error
+ */
+export function createGeminiClient(config) {
+    try {
+        const genai = new GoogleGenAI({
+            apiKey: config.geminiApiKey,
+        });
+        return Ok(new GeminiClientImpl(genai, config.imageQuality));
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return Err(new GeminiAPIError(`Failed to initialize Gemini client: ${errorMessage}`, 'Verify your GEMINI_API_KEY is valid and the @google/genai package is properly installed'));
+    }
+}
+//# sourceMappingURL=geminiClient.js.map

package/dist/api/geminiClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geminiClient.js","sourceRoot":"","sources":["../../src/api/geminiClient.ts"],"names":[],"mappings":"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"}

package/dist/api/geminiTextClient.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Gemini Text Client for text generation
+ * Pure API client for interacting with Google AI Studio
+ * Handles text generation without any prompt optimization logic
+ */
+import type { Result } from '../types/result.js';
+import type { Config } from '../utils/config.js';
+import { GeminiAPIError, NetworkError } from '../utils/errors.js';
+/**
+ * Options for text generation
+ */
+export interface GenerationConfig {
+    temperature?: number;
+    maxTokens?: number;
+    timeout?: number;
+    systemInstruction?: string;
+    inputImage?: string;
+    topP?: number;
+    topK?: number;
+}
+/**
+ * Interface for Gemini Text Client - pure API client
+ */
+export interface GeminiTextClient {
+    /**
+     * Generate text using Gemini API
+     * @param prompt The prompt to send to the API
+     * @param config Optional configuration for generation
+     * @returns Result containing generated text or error
+     */
+    generateText(prompt: string, config?: GenerationConfig): Promise<Result<string, GeminiAPIError | NetworkError>>;
+    /**
+     * Validate connection to Gemini API
+     * @returns Result indicating if connection is successful
+     */
+    validateConnection(): Promise<Result<boolean, GeminiAPIError | NetworkError>>;
+}
+/**
+ * Creates a new Gemini Text Client for prompt generation
+ * @param config Configuration containing API key and settings
+ * @returns Result containing the client or an error
+ */
+export declare function createGeminiTextClient(config: Config): Result<GeminiTextClient, GeminiAPIError>;
+//# sourceMappingURL=geminiTextClient.d.ts.map

package/dist/api/geminiTextClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geminiTextClient.d.ts","sourceRoot":"","sources":["../../src/api/geminiTextClient.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEjE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;OAKG;IACH,YAAY,CACV,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,gBAAgB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;IAEzD;;;OAGG;IACH,kBAAkB,IAAI,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,GAAG,YAAY,CAAC,CAAC,CAAA;CAC9E;AA+RD;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,gBAAgB,EAAE,cAAc,CAAC,CAY/F"}

package/dist/api/geminiTextClient.js

@@ -0,0 +1,202 @@
+/**
+ * Gemini Text Client for text generation
+ * Pure API client for interacting with Google AI Studio
+ * Handles text generation without any prompt optimization logic
+ */
+import { GoogleGenAI } from '@google/genai';
+import { Err, Ok } from '../types/result.js';
+import { GeminiAPIError, NetworkError } from '../utils/errors.js';
+/**
+ * Default configuration for text generation
+ */
+const DEFAULT_GENERATION_CONFIG = {
+    temperature: 0.7,
+    maxTokens: 8192,
+    timeout: 15000,
+};
+/**
+ * Implementation of Gemini Text Client - pure API client
+ */
+class GeminiTextClientImpl {
+    constructor(config) {
+        this.modelName = 'gemini-2.5-flash';
+        this.genai = new GoogleGenAI({
+            apiKey: config.geminiApiKey,
+        });
+    }
+    async generateText(prompt, config = {}) {
+        // Merge with default configuration
+        const mergedConfig = {
+            ...DEFAULT_GENERATION_CONFIG,
+            ...config,
+        };
+        // Validate input
+        const validationResult = this.validatePromptInput(prompt);
+        if (!validationResult.success) {
+            return validationResult;
+        }
+        try {
+            // Call Gemini API
+            const generatedText = await this.callGeminiAPI(prompt, mergedConfig);
+            return Ok(generatedText);
+        }
+        catch (error) {
+            return this.handleError(error, 'text generation');
+        }
+    }
+    /**
+     * Call Gemini API to generate text
+     */
+    async callGeminiAPI(prompt, config) {
+        try {
+            // Generate content with timeout
+            const timeoutPromise = new Promise((_, reject) => {
+                setTimeout(() => reject(new Error('API call timeout')), config.timeout || 15000);
+            });
+            // Build contents based on whether input image is provided (multimodal support)
+            let contents;
+            if (config.inputImage) {
+                // Multimodal request: combine image and text
+                contents = [
+                    {
+                        parts: [
+                            {
+                                inlineData: {
+                                    data: config.inputImage,
+                                    mimeType: 'image/jpeg', // Assuming JPEG for simplicity; can be enhanced later
+                                },
+                            },
+                            {
+                                text: prompt,
+                            },
+                        ],
+                    },
+                ];
+            }
+            else {
+                // Text-only request
+                contents = prompt;
+            }
+            // Call Gemini API
+            const apiCall = this.genai.models.generateContent({
+                model: this.modelName,
+                contents,
+                config: {
+                    ...(config.systemInstruction !== undefined && {
+                        systemInstruction: config.systemInstruction,
+                    }),
+                    temperature: config.temperature || 0.7,
+                    maxOutputTokens: config.maxTokens || 8192,
+                    topP: config.topP ?? 0.95,
+                    topK: config.topK ?? 40,
+                    thinkingConfig: {
+                        thinkingBudget: 0,
+                    },
+                },
+            });
+            const response = await Promise.race([apiCall, timeoutPromise]);
+            // Extract text from response - handling both possible response structures
+            let responseText;
+            if (typeof response.text === 'string') {
+                responseText = response.text;
+            }
+            else if (response.response?.text && typeof response.response.text === 'function') {
+                responseText = response.response.text();
+            }
+            else if (response.response?.candidates?.[0]?.content?.parts?.[0]?.text) {
+                responseText = response.response.candidates[0].content.parts[0].text;
+            }
+            else {
+                throw new Error('Unable to extract text from API response');
+            }
+            if (!responseText || responseText.trim().length === 0) {
+                throw new Error('Empty response from Gemini API');
+            }
+            return responseText.trim();
+        }
+        catch (error) {
+            // Re-throw with context for proper error handling
+            throw new Error(`Gemini API call failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async validateConnection() {
+        try {
+            // Validate by checking if the models object exists
+            if (!this.genai.models) {
+                return Err(new GeminiAPIError('Failed to access Gemini models', 'Check your GEMINI_API_KEY configuration'));
+            }
+            // API key validation happens during actual API calls
+            return Ok(true);
+        }
+        catch (error) {
+            return this.handleError(error, 'connection validation');
+        }
+    }
+    handleError(error, context) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        // Check for network errors
+        if (this.isNetworkError(error)) {
+            return Err(new NetworkError(`Network error during ${context}: ${errorMessage}`, 'Check your internet connection and try again'));
+        }
+        // Check for API errors
+        if (this.isAPIError(error)) {
+            return Err(new GeminiAPIError(`Failed during ${context}: ${errorMessage}`, this.getAPIErrorSuggestion(errorMessage)));
+        }
+        // Generic error
+        return Err(new GeminiAPIError(`Failed during ${context}: ${errorMessage}`, 'Check your API configuration and try again'));
+    }
+    isNetworkError(error) {
+        if (error instanceof Error) {
+            const networkErrorCodes = ['ECONNRESET', 'ECONNREFUSED', 'ETIMEDOUT', 'ENOTFOUND'];
+            return networkErrorCodes.some((code) => error.message.includes(code) || error.code === code);
+        }
+        return false;
+    }
+    isAPIError(error) {
+        if (error instanceof Error) {
+            const apiErrorKeywords = ['quota', 'rate limit', 'unauthorized', 'forbidden', 'api key'];
+            return apiErrorKeywords.some((keyword) => error.message.toLowerCase().includes(keyword));
+        }
+        return false;
+    }
+    getAPIErrorSuggestion(errorMessage) {
+        const lowerMessage = errorMessage.toLowerCase();
+        if (lowerMessage.includes('quota') || lowerMessage.includes('rate limit')) {
+            return 'You have exceeded your API quota or rate limit. Wait before making more requests or upgrade your plan';
+        }
+        if (lowerMessage.includes('unauthorized') || lowerMessage.includes('api key')) {
+            return 'Check that your GEMINI_API_KEY is valid and has the necessary permissions';
+        }
+        if (lowerMessage.includes('forbidden')) {
+            return 'Your API key does not have permission for this operation';
+        }
+        return 'Check your API configuration and try again';
+    }
+    /**
+     * Validate prompt input before processing
+     */
+    validatePromptInput(prompt) {
+        if (!prompt || prompt.trim().length === 0) {
+            return Err(new GeminiAPIError('Empty prompt provided', 'Please provide a non-empty prompt for generation'));
+        }
+        if (prompt.length > 100000) {
+            return Err(new GeminiAPIError('Prompt too long', 'Please provide a shorter prompt (under 100,000 characters)'));
+        }
+        return Ok(true);
+    }
+}
+/**
+ * Creates a new Gemini Text Client for prompt generation
+ * @param config Configuration containing API key and settings
+ * @returns Result containing the client or an error
+ */
+export function createGeminiTextClient(config) {
+    try {
+        return Ok(new GeminiTextClientImpl(config));
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        return Err(new GeminiAPIError(`Failed to initialize Gemini Text client: ${errorMessage}`, 'Verify your GEMINI_API_KEY is valid and the @google/genai package is properly installed'));
+    }
+}
+//# sourceMappingURL=geminiTextClient.js.map

package/dist/api/geminiTextClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geminiTextClient.js","sourceRoot":"","sources":["../../src/api/geminiTextClient.ts"],"names":[],"mappings":"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"}

package/dist/business/fileManager.d.ts

@@ -0,0 +1,20 @@
+/**
+ * File Manager for handling image file operations
+ * Provides functionality for saving images and managing directories
+ */
+import type { Result } from '../types/result.js';
+import { FileOperationError } from '../utils/errors.js';
+/**
+ * Interface for file management operations
+ */
+export interface FileManager {
+    saveImage(imageData: Buffer, outputPath: string, format?: string): Promise<Result<string, FileOperationError>>;
+    ensureDirectoryExists(dirPath: string): Result<void, FileOperationError>;
+    generateFileName(): string;
+}
+/**
+ * Creates a file manager for image file operations
+ * @returns FileManager implementation
+ */
+export declare function createFileManager(): FileManager;
+//# sourceMappingURL=fileManager.d.ts.map

package/dist/business/fileManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileManager.d.ts","sourceRoot":"","sources":["../../src/business/fileManager.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAcvD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,SAAS,CACP,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAC9C,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAA;IACxE,gBAAgB,IAAI,MAAM,CAAA;CAC3B;AA+BD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAsC/C"}