myaidev-method 0.2.22 → 0.2.23

package/src/lib/visual-config-utils.js

@@ -8,9 +8,9 @@
  * @module visual-config-utils
  */
 
-import fs from 'fs-extra';
-import path from 'path';
-import dotenv from 'dotenv';
+import fs from "fs-extra";
+import path from "path";
+import dotenv from "dotenv";
 
 dotenv.config();
 
@@ -20,16 +20,17 @@ dotenv.config();
  * @returns {Object} Configuration object
  */
 export function loadVisualConfig() {
-  return {
-    googleApiKey: process.env.GOOGLE_API_KEY || null,
-    openaiApiKey: process.env.OPENAI_API_KEY || null,
-    defaultService: process.env.VISUAL_DEFAULT_SERVICE || 'gemini',
-    defaultQuality: process.env.VISUAL_DEFAULT_QUALITY || 'standard',
-    assetsPath: process.env.VISUAL_ASSETS_PATH || './content-assets',
-    dailyBudget: parseFloat(process.env.VISUAL_DAILY_BUDGET || 5.0),
-    monthlyBudget: parseFloat(process.env.VISUAL_MONTHLY_BUDGET || 50.0),
-    warnThreshold: parseFloat(process.env.VISUAL_WARN_THRESHOLD || 0.8)
-  };
+	return {
+		googleApiKey: process.env.GOOGLE_API_KEY || null,
+		openaiApiKey: process.env.OPENAI_API_KEY || null,
+		falApiKey: process.env.FAL_KEY || null,
+		defaultService: process.env.VISUAL_DEFAULT_SERVICE || "gemini",
+		defaultQuality: process.env.VISUAL_DEFAULT_QUALITY || "standard",
+		assetsPath: process.env.VISUAL_ASSETS_PATH || "./content-assets",
+		dailyBudget: parseFloat(process.env.VISUAL_DAILY_BUDGET || 5.0),
+		monthlyBudget: parseFloat(process.env.VISUAL_MONTHLY_BUDGET || 50.0),
+		warnThreshold: parseFloat(process.env.VISUAL_WARN_THRESHOLD || 0.8),
+	};
 }
 
 /**
@@ -38,57 +39,71 @@ export function loadVisualConfig() {
  * @returns {Object} Validation results
  */
 export function validateVisualConfig() {
-  const config = loadVisualConfig();
-
-  const validation = {
-    isValid: false,
-    hasGoogle: false,
-    hasOpenAI: false,
-    hasAnyAPIKeys: false,
-    availableServices: [],
-    errors: [],
-    warnings: []
-  };
-
-  // Validate API keys
-  if (config.googleApiKey && config.googleApiKey.length > 20) {
-    validation.hasGoogle = true;
-    validation.availableServices.push('gemini', 'imagen', 'veo');
-  } else if (config.googleApiKey) {
-    validation.errors.push('GOOGLE_API_KEY appears to be invalid (too short)');
-  }
-
-  if (config.openaiApiKey && config.openaiApiKey.length > 20) {
-    validation.hasOpenAI = true;
-    validation.availableServices.push('dalle');
-  } else if (config.openaiApiKey) {
-    validation.errors.push('OPENAI_API_KEY appears to be invalid (too short)');
-  }
-
-  validation.hasAnyAPIKeys = validation.hasGoogle || validation.hasOpenAI;
-
-  // Validate default service
-  if (config.defaultService && !validation.availableServices.includes(config.defaultService)) {
-    validation.warnings.push(`Default service '${config.defaultService}' is not available with current API keys`);
-  }
-
-  // Validate budget values
-  if (config.dailyBudget <= 0) {
-    validation.warnings.push('Daily budget should be greater than 0');
-  }
-
-  if (config.monthlyBudget <= 0) {
-    validation.warnings.push('Monthly budget should be greater than 0');
-  }
-
-  if (config.monthlyBudget < config.dailyBudget) {
-    validation.warnings.push('Monthly budget is less than daily budget');
-  }
-
-  // Configuration is valid if at least one API key is configured
-  validation.isValid = validation.hasAnyAPIKeys && validation.errors.length === 0;
-
-  return validation;
+	const config = loadVisualConfig();
+
+	const validation = {
+		isValid: false,
+		hasGoogle: false,
+		hasOpenAI: false,
+		hasFal: false,
+		hasAnyAPIKeys: false,
+		availableServices: [],
+		errors: [],
+		warnings: [],
+	};
+
+	// Validate API keys
+	if (config.googleApiKey && config.googleApiKey.length > 20) {
+		validation.hasGoogle = true;
+		validation.availableServices.push("gemini", "imagen", "veo");
+	} else if (config.googleApiKey) {
+		validation.errors.push("GOOGLE_API_KEY appears to be invalid (too short)");
+	}
+
+	if (config.openaiApiKey && config.openaiApiKey.length > 20) {
+		validation.hasOpenAI = true;
+		validation.availableServices.push("dalle");
+	} else if (config.openaiApiKey) {
+		validation.errors.push("OPENAI_API_KEY appears to be invalid (too short)");
+	}
+
+	if (config.falApiKey && config.falApiKey.length > 20) {
+		validation.hasFal = true;
+		validation.availableServices.push("fal");
+	} else if (config.falApiKey) {
+		validation.errors.push("FAL_KEY appears to be invalid (too short)");
+	}
+
+	validation.hasAnyAPIKeys = validation.hasGoogle || validation.hasOpenAI;
+
+	// Validate default service
+	if (
+		config.defaultService &&
+		!validation.availableServices.includes(config.defaultService)
+	) {
+		validation.warnings.push(
+			`Default service '${config.defaultService}' is not available with current API keys`,
+		);
+	}
+
+	// Validate budget values
+	if (config.dailyBudget <= 0) {
+		validation.warnings.push("Daily budget should be greater than 0");
+	}
+
+	if (config.monthlyBudget <= 0) {
+		validation.warnings.push("Monthly budget should be greater than 0");
+	}
+
+	if (config.monthlyBudget < config.dailyBudget) {
+		validation.warnings.push("Monthly budget is less than daily budget");
+	}
+
+	// Configuration is valid if at least one API key is configured
+	validation.isValid =
+		validation.hasAnyAPIKeys && validation.errors.length === 0;
+
+	return validation;
 }
 
 /**
@@ -97,8 +112,8 @@ export function validateVisualConfig() {
  * @returns {boolean} True if at least one API key is configured
  */
 export function hasAnyAPIKeys() {
-  const validation = validateVisualConfig();
-  return validation.hasAnyAPIKeys;
+	const validation = validateVisualConfig();
+	return validation.hasAnyAPIKeys;
 }
 
 /**
@@ -107,8 +122,8 @@ export function hasAnyAPIKeys() {
  * @returns {Array<string>} List of available service names
  */
 export function getAvailableServices() {
-  const validation = validateVisualConfig();
-  return validation.availableServices;
+	const validation = validateVisualConfig();
+	return validation.availableServices;
 }
 
 /**
@@ -118,54 +133,65 @@ export function getAvailableServices() {
  * @returns {Object} Service information
  */
 export function getServiceDisplayInfo(service) {
-  const services = {
-    gemini: {
-      id: 'gemini',
-      name: 'Gemini 2.5 Flash Image',
-      nickname: '"Nano Banana"',
-      provider: 'Google',
-      apiKey: 'GOOGLE_API_KEY',
-      speed: 'Fast ⚡⚡⚡',
-      cost: '$0.02/image',
-      quality: 'Good',
-      bestFor: 'Quick hero images, high volume'
-    },
-    imagen: {
-      id: 'imagen',
-      name: 'Imagen 3',
-      nickname: 'Premium Quality',
-      provider: 'Google',
-      apiKey: 'GOOGLE_API_KEY',
-      speed: 'Medium ⚡⚡',
-      cost: '$0.03/image',
-      quality: 'Excellent',
-      bestFor: 'Premium hero images, photorealistic content'
-    },
-    dalle: {
-      id: 'dalle',
-      name: 'DALL-E 3',
-      nickname: 'Creative AI',
-      provider: 'OpenAI',
-      apiKey: 'OPENAI_API_KEY',
-      speed: 'Medium ⚡⚡',
-      cost: '$0.04-0.12/image',
-      quality: 'Excellent',
-      bestFor: 'Creative illustrations, concept art'
-    },
-    veo: {
-      id: 'veo',
-      name: 'Veo 2',
-      nickname: 'Video Generation',
-      provider: 'Google',
-      apiKey: 'GOOGLE_API_KEY',
-      speed: 'Slow ⚡',
-      cost: '$0.10/video (est.)',
-      quality: 'Good',
-      bestFor: 'Product demos, animated diagrams'
-    }
-  };
-
-  return services[service] || null;
+	const services = {
+		gemini: {
+			id: "gemini",
+			name: "Gemini 2.5 Flash Image",
+			nickname: '"Nano Banana"',
+			provider: "Google",
+			apiKey: "GOOGLE_API_KEY",
+			speed: "Fast ⚡⚡⚡",
+			cost: "$0.02/image",
+			quality: "Good",
+			bestFor: "Quick hero images, high volume",
+		},
+		imagen: {
+			id: "imagen",
+			name: "Imagen 3",
+			nickname: "Premium Quality",
+			provider: "Google",
+			apiKey: "GOOGLE_API_KEY",
+			speed: "Medium ⚡⚡",
+			cost: "$0.03/image",
+			quality: "Excellent",
+			bestFor: "Premium hero images, photorealistic content",
+		},
+		dalle: {
+			id: "dalle",
+			name: "DALL-E 3",
+			nickname: "Creative AI",
+			provider: "OpenAI",
+			apiKey: "OPENAI_API_KEY",
+			speed: "Medium ⚡⚡",
+			cost: "$0.04-0.12/image",
+			quality: "Excellent",
+			bestFor: "Creative illustrations, concept art",
+		},
+		veo: {
+			id: "veo",
+			name: "Veo 2",
+			nickname: "Video Generation",
+			provider: "Google",
+			apiKey: "GOOGLE_API_KEY",
+			speed: "Slow ⚡",
+			cost: "$0.10/video (est.)",
+			quality: "Good",
+			bestFor: "Product demos, animated diagrams",
+		},
+		fal: {
+			id: "fal",
+			name: "Fal.ai (FLUX, Nano Banana Pro)",
+			nickname: "Premium Models",
+			provider: "Fal.ai",
+			apiKey: "FAL_KEY",
+			speed: "Fast ⚡⚡⚡",
+			cost: "$0.06-0.15/image",
+			quality: "Excellent",
+			bestFor: "High-quality branded content, FLUX models",
+		},
+	};
+
+	return services[service] || null;
 }
 
 /**
@@ -175,11 +201,11 @@ export function getServiceDisplayInfo(service) {
  * @returns {string} Status message
  */
 export function getConfigStatusMessage(verbose = false) {
-  const validation = validateVisualConfig();
-  const config = loadVisualConfig();
+	const validation = validateVisualConfig();
+	const config = loadVisualConfig();
 
-  if (!validation.hasAnyAPIKeys) {
-    return `⚠️ Visual content generation not configured
+	if (!validation.hasAnyAPIKeys) {
+		return `⚠️ Visual content generation not configured
 
 No API keys found. To enable image/video generation:
 
@@ -188,39 +214,41 @@ No API keys found. To enable image/video generation:
 2. Add to your .env file:
    GOOGLE_API_KEY=your_key_here  # For Gemini, Imagen, Veo
    OPENAI_API_KEY=your_key_here  # For DALL-E
+   FAL_KEY=your_key_here         # For Fal.ai (FLUX, Nano Banana Pro)
 
 Get API keys:
 • Google: https://ai.google.dev/
-• OpenAI: https://platform.openai.com/api-keys`;
-  }
-
-  let message = `✅ Visual content generation configured\n\n`;
-
-  // Show available services
-  message += `📋 Available Services:\n`;
-  for (const service of validation.availableServices) {
-    const info = getServiceDisplayInfo(service);
-    message += `   • ${info.name} - ${info.cost}\n`;
-  }
-
-  if (verbose) {
-    message += `\n⚙️ Settings:\n`;
-    message += `   Default Service: ${config.defaultService}\n`;
-    message += `   Default Quality: ${config.defaultQuality}\n`;
-    message += `   Assets Path: ${config.assetsPath}\n`;
-    message += `   Daily Budget: $${config.dailyBudget.toFixed(2)}\n`;
-    message += `   Monthly Budget: $${config.monthlyBudget.toFixed(2)}\n`;
-  }
-
-  // Show warnings
-  if (validation.warnings.length > 0) {
-    message += `\n⚠️ Warnings:\n`;
-    for (const warning of validation.warnings) {
-      message += `   • ${warning}\n`;
-    }
-  }
-
-  return message;
+• OpenAI: https://platform.openai.com/api-keys
+• Fal.ai: https://fal.ai/dashboard/keys`;
+	}
+
+	let message = `✅ Visual content generation configured\n\n`;
+
+	// Show available services
+	message += `📋 Available Services:\n`;
+	for (const service of validation.availableServices) {
+		const info = getServiceDisplayInfo(service);
+		message += `   • ${info.name} - ${info.cost}\n`;
+	}
+
+	if (verbose) {
+		message += `\n⚙️ Settings:\n`;
+		message += `   Default Service: ${config.defaultService}\n`;
+		message += `   Default Quality: ${config.defaultQuality}\n`;
+		message += `   Assets Path: ${config.assetsPath}\n`;
+		message += `   Daily Budget: $${config.dailyBudget.toFixed(2)}\n`;
+		message += `   Monthly Budget: $${config.monthlyBudget.toFixed(2)}\n`;
+	}
+
+	// Show warnings
+	if (validation.warnings.length > 0) {
+		message += `\n⚠️ Warnings:\n`;
+		for (const warning of validation.warnings) {
+			message += `   • ${warning}\n`;
+		}
+	}
+
+	return message;
 }
 
 /**
@@ -230,33 +258,33 @@ Get API keys:
  * @returns {Promise<void>}
  */
 export async function updateEnvFile(updates) {
-  const envPath = path.join(process.cwd(), '.env');
-  let envContent = '';
-
-  // Read existing .env file
-  if (await fs.pathExists(envPath)) {
-    envContent = await fs.readFile(envPath, 'utf-8');
-  }
-
-  // Update or add each key
-  for (const [key, value] of Object.entries(updates)) {
-    const regex = new RegExp(`^${key}=.*$`, 'm');
-    const line = `${key}=${value}`;
-
-    if (regex.test(envContent)) {
-      // Update existing key
-      envContent = envContent.replace(regex, line);
-    } else {
-      // Add new key
-      envContent += `\n${line}`;
-    }
-  }
-
-  // Write back to file
-  await fs.writeFile(envPath, envContent.trim() + '\n');
-
-  // Reload environment variables
-  dotenv.config({ override: true });
+	const envPath = path.join(process.cwd(), ".env");
+	let envContent = "";
+
+	// Read existing .env file
+	if (await fs.pathExists(envPath)) {
+		envContent = await fs.readFile(envPath, "utf-8");
+	}
+
+	// Update or add each key
+	for (const [key, value] of Object.entries(updates)) {
+		const regex = new RegExp(`^${key}=.*$`, "m");
+		const line = `${key}=${value}`;
+
+		if (regex.test(envContent)) {
+			// Update existing key
+			envContent = envContent.replace(regex, line);
+		} else {
+			// Add new key
+			envContent += `\n${line}`;
+		}
+	}
+
+	// Write back to file
+	await fs.writeFile(envPath, envContent.trim() + "\n");
+
+	// Reload environment variables
+	dotenv.config({ override: true });
 }
 
 /**
@@ -266,15 +294,15 @@ export async function updateEnvFile(updates) {
  * @returns {string} Masked API key
  */
 export function maskAPIKey(apiKey) {
-  if (!apiKey || apiKey.length < 16) {
-    return '****';
-  }
+	if (!apiKey || apiKey.length < 16) {
+		return "****";
+	}
 
-  const start = apiKey.substring(0, 8);
-  const end = apiKey.substring(apiKey.length - 4);
-  const masked = `${start}${'*'.repeat(Math.max(4, apiKey.length - 12))}${end}`;
+	const start = apiKey.substring(0, 8);
+	const end = apiKey.substring(apiKey.length - 4);
+	const masked = `${start}${"*".repeat(Math.max(4, apiKey.length - 12))}${end}`;
 
-  return masked;
+	return masked;
 }
 
 /**
@@ -284,57 +312,53 @@ export function maskAPIKey(apiKey) {
  * @returns {Promise<Object>} Test result
  */
 export async function testAPIKey(service) {
-  const config = loadVisualConfig();
-
-  try {
-    if (service === 'google') {
-      if (!config.googleApiKey) {
-        return { success: false, error: 'GOOGLE_API_KEY not configured' };
-      }
-
-      // Simple test: list models
-      const response = await fetch(
-        `https://generativelanguage.googleapis.com/v1beta/models?key=${config.googleApiKey}`,
-        { method: 'GET' }
-      );
-
-      if (response.ok) {
-        return { success: true, service: 'google' };
-      } else {
-        const error = await response.text();
-        return { success: false, error: `Google API test failed: ${error}` };
-      }
-    }
-
-    if (service === 'openai') {
-      if (!config.openaiApiKey) {
-        return { success: false, error: 'OPENAI_API_KEY not configured' };
-      }
-
-      // Simple test: list models
-      const response = await fetch(
-        'https://api.openai.com/v1/models',
-        {
-          method: 'GET',
-          headers: {
-            'Authorization': `Bearer ${config.openaiApiKey}`
-          }
-        }
-      );
-
-      if (response.ok) {
-        return { success: true, service: 'openai' };
-      } else {
-        const error = await response.text();
-        return { success: false, error: `OpenAI API test failed: ${error}` };
-      }
-    }
-
-    return { success: false, error: `Unknown service: ${service}` };
-
-  } catch (error) {
-    return { success: false, error: error.message };
-  }
+	const config = loadVisualConfig();
+
+	try {
+		if (service === "google") {
+			if (!config.googleApiKey) {
+				return { success: false, error: "GOOGLE_API_KEY not configured" };
+			}
+
+			// Simple test: list models
+			const response = await fetch(
+				`https://generativelanguage.googleapis.com/v1beta/models?key=${config.googleApiKey}`,
+				{ method: "GET" },
+			);
+
+			if (response.ok) {
+				return { success: true, service: "google" };
+			} else {
+				const error = await response.text();
+				return { success: false, error: `Google API test failed: ${error}` };
+			}
+		}
+
+		if (service === "openai") {
+			if (!config.openaiApiKey) {
+				return { success: false, error: "OPENAI_API_KEY not configured" };
+			}
+
+			// Simple test: list models
+			const response = await fetch("https://api.openai.com/v1/models", {
+				method: "GET",
+				headers: {
+					Authorization: `Bearer ${config.openaiApiKey}`,
+				},
+			});
+
+			if (response.ok) {
+				return { success: true, service: "openai" };
+			} else {
+				const error = await response.text();
+				return { success: false, error: `OpenAI API test failed: ${error}` };
+			}
+		}
+
+		return { success: false, error: `Unknown service: ${service}` };
+	} catch (error) {
+		return { success: false, error: error.message };
+	}
 }
 
 /**
@@ -343,39 +367,41 @@ export async function testAPIKey(service) {
  * @returns {Object} Configuration summary
  */
 export function getConfigSummary() {
-  const validation = validateVisualConfig();
-  const config = loadVisualConfig();
-
-  return {
-    configured: validation.hasAnyAPIKeys,
-    services: {
-      google: {
-        configured: validation.hasGoogle,
-        available: ['gemini', 'imagen', 'veo'].filter(s =>
-          validation.availableServices.includes(s)
-        )
-      },
-      openai: {
-        configured: validation.hasOpenAI,
-        available: validation.availableServices.includes('dalle') ? ['dalle'] : []
-      }
-    },
-    settings: {
-      defaultService: config.defaultService,
-      defaultQuality: config.defaultQuality,
-      assetsPath: config.assetsPath,
-      budgets: {
-        daily: config.dailyBudget,
-        monthly: config.monthlyBudget,
-        warnThreshold: config.warnThreshold
-      }
-    },
-    validation: {
-      isValid: validation.isValid,
-      errors: validation.errors,
-      warnings: validation.warnings
-    }
-  };
+	const validation = validateVisualConfig();
+	const config = loadVisualConfig();
+
+	return {
+		configured: validation.hasAnyAPIKeys,
+		services: {
+			google: {
+				configured: validation.hasGoogle,
+				available: ["gemini", "imagen", "veo"].filter((s) =>
+					validation.availableServices.includes(s),
+				),
+			},
+			openai: {
+				configured: validation.hasOpenAI,
+				available: validation.availableServices.includes("dalle")
+					? ["dalle"]
+					: [],
+			},
+		},
+		settings: {
+			defaultService: config.defaultService,
+			defaultQuality: config.defaultQuality,
+			assetsPath: config.assetsPath,
+			budgets: {
+				daily: config.dailyBudget,
+				monthly: config.monthlyBudget,
+				warnThreshold: config.warnThreshold,
+			},
+		},
+		validation: {
+			isValid: validation.isValid,
+			errors: validation.errors,
+			warnings: validation.warnings,
+		},
+	};
 }
 
 /**
@@ -385,8 +411,8 @@ export function getConfigSummary() {
  * @returns {boolean} True if service is available
  */
 export function isServiceAvailable(service) {
-  const available = getAvailableServices();
-  return available.includes(service);
+	const available = getAvailableServices();
+	return available.includes(service);
 }
 
 /**
@@ -396,29 +422,29 @@ export function isServiceAvailable(service) {
  * @returns {string} Recommended service name
  */
 export function getRecommendedService(type) {
-  const available = getAvailableServices();
-  const config = loadVisualConfig();
-
-  // Recommendations by type
-  const recommendations = {
-    hero: ['imagen', 'dalle', 'gemini'],       // Premium quality for hero
-    illustration: ['dalle', 'imagen', 'gemini'], // Creative for illustrations
-    diagram: ['gemini', 'dalle', 'imagen'],    // Fast for diagrams
-    screenshot: ['gemini', 'imagen', 'dalle'], // Fast for screenshots
-    video: ['veo']                             // Only Veo for video
-  };
-
-  const preferred = recommendations[type] || recommendations.hero;
-
-  // Return first available from preferred list
-  for (const service of preferred) {
-    if (available.includes(service)) {
-      return service;
-    }
-  }
-
-  // Fallback to default or first available
-  return available.includes(config.defaultService)
-    ? config.defaultService
-    : available[0];
+	const available = getAvailableServices();
+	const config = loadVisualConfig();
+
+	// Recommendations by type
+	const recommendations = {
+		hero: ["imagen", "dalle", "gemini"], // Premium quality for hero
+		illustration: ["dalle", "imagen", "gemini"], // Creative for illustrations
+		diagram: ["gemini", "dalle", "imagen"], // Fast for diagrams
+		screenshot: ["gemini", "imagen", "dalle"], // Fast for screenshots
+		video: ["veo"], // Only Veo for video
+	};
+
+	const preferred = recommendations[type] || recommendations.hero;
+
+	// Return first available from preferred list
+	for (const service of preferred) {
+		if (available.includes(service)) {
+			return service;
+		}
+	}
+
+	// Fallback to default or first available
+	return available.includes(config.defaultService)
+		? config.defaultService
+		: available[0];
 }