@procedures/weather

A weather forecast for a point from Open-Meteo, without a key. The days and the hours are local to the point.

Install

pnpm add @procedures/weather @procedures/client

A host registers the procedures with createRegistry(weatherModule), or with import "@procedures/weather/register" for the global registry. The package root and ./module register nothing.

Procedures

| Procedure | Effects | What it does | | --- | --- | --- | | weather.forecast | reads network | Gives the forecast of each day, and optionally of each hour: temperatures, precipitation probability, wind and the WMO weather code. |

Example

const forecast = await client.exec(["weather", "forecast"], { lat: 52.52, lon: 13.4, days: 3, units: "metric" });

Weather codes

The field weatherCode of a day or an hour is a WMO weather code. The function weatherCodeGroup(code) gives its group, for example clear, fog, rain-showers or thunderstorm. It gives undefined for a code that Open-Meteo does not use.

import { weatherCodeGroup } from "@procedures/weather";

weatherCodeGroup(61); // "rain"
weatherCodeGroup(96); // "thunderstorm-hail"

The host policy

The request goes through createHostFetch() of @procedures/http. The policy refuses a baseUrl on a loopback, private or link-local address, with the error FORBIDDEN and the reason host-not-allowed.

A host with its own Open-Meteo server on such an address gives a fetch whose allow list has that address:

import { createHostFetch } from "@procedures/http";
import { createWeatherModule } from "@procedures/weather/module";

const registry = createRegistry(createWeatherModule({ fetch: createHostFetch({ allow: ["10.0.0.5:8080"] }) }));

Units

units: "metric" (the default) gives °C and km/h. units: "imperial" gives °F and mph. The units field of the result names them.