A simple, modern, Node.js client for the OpenWeatherMap API. Fetch current weather, 24-hour forecast, and sunrise/sunset times with a clean, promise-based API.
- Fetch current weather for any coordinates
- Fetch 24-hour forecast (3-hour intervals)
- Fetch sunrise and sunset times (adjusted to local timezone)
- Fully typed (TypeScript definitions included)
- Supports dependency injection for fetch and API key (easy to test/mocks)
npm install @eliware/openweathermapimport { getCurrent, get24hForecast, getSun } from '@eliware/openweathermap';
const lat = 40.7128;
const lon = -74.0060;
const apiKey = 'your_api_key_here';
(async () => {
const current = await getCurrent(lat, lon, { apiKey, units: 'F' });
console.log('Current:', current);
const forecast = await get24hForecast(lat, lon, { apiKey, units: 'F' });
console.log('24h Forecast:', forecast);
const sun = await getSun(lat, lon, { apiKey, units: 'F' });
console.log('Sunrise/Sunset:', sun);
})();Fetches current weather for the given latitude and longitude.
lat(number): Latitudelon(number): Longitudeoptions(object):apiKey(string, required): Your OpenWeatherMap API keyunits(string, optional): 'F' for Fahrenheit, 'C' for Celsius (default 'C')fetchImpl(function, optional): Custom fetch implementation (for testing/mocks)
- Returns: Promise resolving to the current weather object (see OpenWeatherMap docs)
Fetches the next 24 hours of forecast data (3-hour intervals, up to 8 items).
- Same parameters as
getCurrent - Returns: Promise resolving to an array of forecast objects
Fetches sunrise and sunset times for the given coordinates, returning both UTC and local times.
-
Same parameters as
getCurrent -
Returns: Promise resolving to:
{ sunriseUtc: number, // Sunrise time (UTC, Unix timestamp) sunsetUtc: number, // Sunset time (UTC, Unix timestamp) sunriseLocal: number, // Sunrise time (local, Unix timestamp) sunsetLocal: number, // Sunset time (local, Unix timestamp) offset: number // Timezone offset in seconds (from UTC) }
Type definitions are included and will be picked up automatically. Example:
import { getCurrent, get24hForecast, getSun } from '@eliware/openweathermap';
const weather = await getCurrent(40.7128, -74.0060, { apiKey: 'your_api_key_here' });
// weather: object (see OpenWeatherMap API docs)For help, questions, or to chat with the author and community, visit:
