API OpenWeatherMap

// Interface para los datos del clima
export interface WeatherData {
  main: {
    temp: number;        // Temperatura en Kelvin
    humidity: number;    // Humedad en porcentaje
    feels_like: number;  // Sensación térmica en Kelvin
  };
  weather: {
    main: string;        // Condición principal (Clear, Clouds, Rain, etc.)
    description: string; // Descripción detallada
    icon: string;        // Código del icono
  }[];
  wind: {
    speed: number;       // Velocidad del viento en m/s
  };
  name: string;          // Nombre de la ciudad
  sys: {
    country: string;     // Código del país
  };
}

// 3 funciones principales implementadas en weatherApi.ts

// 1. getWeatherForIca() - Función principal para datos climáticos
// Consulta específicamente Ica, Perú usando OpenWeatherMap API
const weather = await getWeatherForIca();
// Retorna: WeatherData | { error: string }

// 2. kelvinToCelsius(kelvin: number) - Conversor de temperatura
// Convierte automáticamente de Kelvin a Celsius con redondeo
const tempCelsius = kelvinToCelsius(305.15); // => 32°C

// 3. getWeatherEmoji(weatherCode: string) - Emojis visuales
// Mapea 15 condiciones climáticas a emojis específicos
const emoji = getWeatherEmoji('Clear'); // => ☀️
const emoji = getWeatherEmoji('Rain');  // => 🌧️
const emoji = getWeatherEmoji('Snow');  // => ❄️

// Ejemplo real de implementación completa:
import { getWeatherForIca, kelvinToCelsius, getWeatherEmoji } from '@/lib/weatherApi';

const weatherInfo = await getWeatherForIca();
if ('error' in weatherInfo) {
  console.error('Error API:', weatherInfo.error);
  // Manejo de error con datos de respaldo
} else {
  const temp = kelvinToCelsius(weatherInfo.main.temp);
  const feelsLike = kelvinToCelsius(weatherInfo.main.feels_like);
  const condition = weatherInfo.weather[0].main;
  const description = weatherInfo.weather[0].description;
  const emoji = getWeatherEmoji(condition);
  const windKmh = Math.round(weatherInfo.wind.speed * 3.6);
  
  console.log(`${emoji} ${description} - ${temp}°C`);
  console.log(`Sensación térmica: ${feelsLike}°C`);
  console.log(`Humedad: ${weatherInfo.main.humidity}%`);
  console.log(`Viento: ${windKmh} km/h`);
}

// Implementación real completa utilizada en el proyecto
import { 
  getWeatherForIca, 
  getWeatherEmoji, 
  kelvinToCelsius,
  WeatherData
} from '@/lib/weatherApi';

// Obtener datos meteorológicos para Ica, Perú
async function fetchWeatherData() {
  const weatherData = await getWeatherForIca();

  if ('error' in weatherData) {
    // Manejo de errores específicos implementado
    console.error('Error de API:', weatherData.error);
    
    // Datos de respaldo utilizados en la terminal
    return {
      emoji: '☀️',
      description: 'Soleado',
      temp: 28,
      humidity: 45,
      windSpeed: 12,
      offline: true,
      errorMessage: weatherData.error
    };
  } else {
    // Procesamiento de datos reales de OpenWeatherMap
    const tempC = kelvinToCelsius(weatherData.main.temp);
    const feelsLikeC = kelvinToCelsius(weatherData.main.feels_like);
    const emoji = getWeatherEmoji(weatherData.weather[0].main);
    const windKmh = Math.round(weatherData.wind.speed * 3.6);
    
    console.log(`${emoji} ${weatherData.weather[0].description} - ${tempC}°C`);
    console.log(`Sensación térmica: ${feelsLikeC}°C`);
    console.log(`Humedad: ${weatherData.main.humidity}%`);
    console.log(`Viento: ${windKmh} km/h`);
    console.log(`Ciudad: ${weatherData.name}, ${weatherData.sys.country}`);
    
    return {
      emoji,
      description: weatherData.weather[0].description,
      temp: tempC,
      feelsLike: feelsLikeC,
      humidity: weatherData.main.humidity,
      windSpeed: windKmh,
      city: weatherData.name,
      country: weatherData.sys.country,
      offline: false
    };
  }
}

// Uso en contexto real (como en TerminalContext.tsx)
fetchWeatherData().then(result => {
  if (result.offline) {
    console.log(`⚠️ Modo offline: ${result.errorMessage}`);
  }
  console.log(`${result.emoji} ${result.temp}°C`);
});

// Integración en la Terminal (TerminalContext.tsx)
else if (cmd === "weather") {
  setLoading(true);
  
  // Importar módulo de clima dinámicamente
  import("@/lib/weatherApi").then(async (weatherModule) => {
    try {
      const weatherData = await weatherModule.getWeatherForIca();
      
      if ("error" in weatherData) {
        // Mostrar datos offline con error
        setHistory(prev => [...prev, {
          command: fullCmd,
          output: (
            <div className="space-y-2">
              <p className="text-emerald-300">🌤️ Clima en Ica, Perú:</p>
              <div className="bg-neutral-800 p-3 rounded">
                <p className="text-yellow-300">☀️ Soleado - 28°C</p>
                <p className="text-gray-300 text-sm">
                  Humedad: 45% | Viento: 12 km/h
                </p>
                <div className="mt-3 p-2 bg-red-900/30 border border-red-700 rounded">
                  <p className="text-red-400 text-xs font-semibold">
                    ⚠️ API Status: {weatherData.error}
                  </p>
                </div>
              </div>
            </div>
          )
        }]);
      } else {
        // Mostrar datos en tiempo real
        const tempC = weatherModule.kelvinToCelsius(weatherData.main.temp);
        const emoji = weatherModule.getWeatherEmoji(weatherData.weather[0].main);
        
        setHistory(prev => [...prev, {
          command: fullCmd,
          output: (
            <div className="space-y-2">
              <p className="text-emerald-300">🌤️ Clima en tiempo real - Ica, Perú:</p>
              <div className="bg-neutral-800 p-3 rounded">
                <div className="flex items-center gap-2">
                  <span className="text-2xl">{emoji}</span>
                  <p className="text-yellow-300 font-semibold">
                    {weatherData.weather[0].description} - {tempC}°C
                  </p>
                </div>
                <p className="text-gray-300 text-sm mt-2">
                  Sensación térmica: {weatherModule.kelvinToCelsius(weatherData.main.feels_like)}°C
                </p>
                <p className="text-gray-300 text-sm">
                  Humedad: {weatherData.main.humidity}% | 
                  Viento: {Math.round(weatherData.wind.speed * 3.6)} km/h
                </p>
              </div>
            </div>
          )
        }]);
      }
    } catch (error) {
      console.error('Error:', error);
    } finally {
      setLoading(false);
    }
  });
}

// Endpoint real utilizado en getWeatherForIca()
const API_BASE = 'https://api.openweathermap.org/data/2.5';
const CITY = 'Ica,pe';  // Ciudad fija: Ica, Perú
const LANG = 'es';      // Idioma: Español

// URL completa construida dinámicamente:
const apiUrl = `${API_BASE}/weather?q=${CITY}&appid=${apiKey}&lang=${LANG}`;

// Ejemplo real:
// https://api.openweathermap.org/data/2.5/weather?q=Ica,pe&appid=YOUR_KEY&lang=es

// Códigos de error manejados:
// 401: API key inválida
// 404: Ciudad no encontrada  
// 429: Límite de llamadas excedido
// 500: Error del servidor OpenWeatherMap

// Manejo completo de errores implementado en getWeatherForIca()

try {
  const response = await fetch(apiUrl);
  
  if (!response.ok) {
    // Error 401: API key inválida
    if (response.status === 401) {
      return { 
        error: 'API key inválida. Necesitas obtener una nueva clave en https://openweathermap.org/api'
      };
    }
    
    // Otros errores HTTP
    throw new Error(`Error ${response.status}: ${response.statusText}`);
  }
  
  const data: WeatherData = await response.json();
  return data;
  
} catch (error) {
  console.error('Error obteniendo datos del clima:', error);
  return { 
    error: 'No se pudo conectar con la API. Verifica tu conexión a internet.'
  };
}

// Verificación de API key
if (!apiKey) {
  return { 
    error: 'API key no configurada. Verifica tu archivo .env'
  };
}

// Datos de respaldo en terminal cuando hay error:
// ☀️ Soleado - 28°C
// Humedad: 45% | Viento: 12 km/h
// ⚠️ API Status: [error message]