/**
* solar.ts - Open-Meteo solar handler
*
* This file contains handler functions for fetching solar data from Open-Meteo Solar API.
*
* Dependencies:
* - ../../types/environmental.js (for SolarResponse)
* - ../../utils/api-client.js (for fetchJson)
* - ../../utils/error-handling.js (for createErrorResponse)
*
* @author Cline
*/
import { fetchJson } from "../../utils/api-client.js";
import { createErrorResponse } from "../../utils/error-handling.js";
// ====================================
// Solar API Handlers
// ====================================
/**
* Handles the solar data request.
*
* @param {number} latitude - Latitude coordinate.
* @param {number} longitude - Longitude coordinate.
* @param {number} [tilt=0] - Solar panel tilt angle in degrees (0-90).
* @param {number} [azimuth=180] - Solar panel azimuth angle in degrees.
* @param {number} [forecast_days=1] - Number of forecast days (1-5).
* @returns {Promise<ToolResponse>} A ToolResponse containing the solar data or an error.
*/
export async function handleSolar(latitude, longitude, tilt = 0, azimuth = 180, forecast_days = 1) {
const url = new URL("https://api.open-meteo.com/v1/forecast");
url.searchParams.append("latitude", latitude.toString());
url.searchParams.append("longitude", longitude.toString());
url.searchParams.append("current", "global_tilted_irradiance,direct_normal_irradiance,diffuse_horizontal_irradiance");
url.searchParams.append("hourly", "global_tilted_irradiance,direct_normal_irradiance,diffuse_horizontal_irradiance,global_horizontal_irradiance");
url.searchParams.append("forecast_days", forecast_days.toString());
url.searchParams.append("tilt", tilt.toString());
url.searchParams.append("azimuth", azimuth.toString());
url.searchParams.append("timezone", "auto");
try {
const data = await fetchJson(url.toString());
return {
content: [{
type: "text",
text: JSON.stringify({
location: { latitude, longitude },
panel_config: { tilt, azimuth },
current: data.current,
hourly: data.hourly
}, null, 2)
}],
isError: false
};
}
catch (error) {
return createErrorResponse(`Solar request failed: ${error instanceof Error ? error.message : String(error)}`);
}
}
//# sourceMappingURL=solar.js.map
