jeroentvb/node-knmi-fetch

import data from './modules/data';
import helper from './modules/helper';

import { API_URL_DAYS, API_URL_HOURS, HOURLY, DAILY } from './constants';

import { DailyVars, TimeSpan, HourlyVars, StationData, StationCode } from './types';

/**
 * Fetches and parses the daily climatology data from a station from the KNMI
 * @param stationCode: string | number
 * @param variables: string | string[]
 * @param timeSpan: { start: string, end: string }
 * @param inSeason: boolean
 * @returns Promise<{ [key: string]: string }[]>
 */
async function days(
   stationCode: StationCode,
   variables?: DailyVars,
   timeSpan?: TimeSpan,
   inSeason?: boolean
): Promise<StationData | StationData[]> {
   helper.checkParams({
      stationCode,
      variables,
      timeSpan,
      inSeason
   }, DAILY);

   const knmiData = await data
      .get(API_URL_DAYS, {
         stationCode,
         variables,
         timeSpan,
         inSeason
      });

   return knmiData;
}

/**
 * Fetches and parses the hourly climatology data from a station from the KNMI
 * @param stationCode: string | number
 * @param variables: string | string[]
 * @param timeSpan: { start: string, end: string }
 * @param inSeason: boolean
 * @returns Promise<{ [key: string]: string }[]>
 */
async function hours(
   stationCode: StationCode,
   variables?: HourlyVars,
   timeSpan?: TimeSpan,
   inSeason?: boolean
): Promise<StationData | StationData[]> {
   helper.checkParams({
      stationCode,
      variables,
      timeSpan,
      inSeason
   }, HOURLY);

   const knmiData = await data
      .get(API_URL_HOURS, {
         stationCode,
         variables,
         timeSpan,
         inSeason
      });

   return knmiData;
}

export {
   days,
   hours
};