JasonSanford · JasonSanford · Jun 17, 2021 · Jun 15, 2021 · Jun 15, 2021 · Jun 15, 2021
diff --git a/dist/cache.d.ts b/dist/cache.d.ts
@@ -0,0 +1,7 @@
+declare class Cache<T> {
+    private items;
+    constructor();
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+}
+export default Cache;
diff --git a/dist/cache.js b/dist/cache.js
@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+class Cache {
+    constructor() {
+        this.items = {};
+    }
+    get(key) {
+        return this.items[key];
+    }
+    set(key, value) {
+        this.items[key] = value;
+    }
+}
+exports.default = Cache;
diff --git a/dist/client.d.ts b/dist/client.d.ts
@@ -1,4 +1,4 @@
-import { ClientOptions, ForecastResponse, AlertsResponse, ForecastType, AlertOptions } from './types';
+import { ClientOptions, ForecastResponse, AlertsResponse, ForecastType, StationsResponse, Station, AlertOptions } from './types';
 /**
  * The main client
  *
@@ -8,14 +8,16 @@ import { ClientOptions, ForecastResponse, AlertsResponse, ForecastType, AlertOpt
  */
 declare class Client {
     private options;
+    private pointCache;
+    private stationsCache;
     constructor(options?: ClientOptions);
     private getPath;
     private getUrl;
     private getPoint;
     getOptions(): ClientOptions;
     setOptions(newOptions: ClientOptions): void;
     /**
-     * Get weather alerts for a given area
+     * Get weather alerts for a given area.
      *
      * ```typescript
      * const active = true;
@@ -26,7 +28,7 @@ declare class Client {
      */
     getAlerts(active: boolean, options: AlertOptions): Promise<AlertsResponse>;
     /**
-     * Get a weather forecast for a given latitude and longitude
+     * Get a weather forecast for a given latitude and longitude.
      *
      * ```typescript
      * const latitude = 35.6175667;
@@ -36,5 +38,27 @@ declare class Client {
      *
      */
     getForecast(latitude: number, longitude: number, forecastType: ForecastType): Promise<ForecastResponse>;
+    /**
+     * Get the closest weather stations for a given latitude and longitude.
+     *
+     * ```typescript
+     * const latitude = 35.6175667;
+     * const longitude = -80.7709911;
+     * const stations = await client.getStations(latitude, longitude);
+     * ```
+     *
+     */
+    getStations(latitude: number, longitude: number): Promise<StationsResponse>;
+    /**
+     * Get the closest weather station for a given latitude and longitude.
+     *
+     * ```typescript
+     * const latitude = 35.6175667;
+     * const longitude = -80.7709911;
+     * const stationOrNull = await client.getNearestStation(latitude, longitude);
+     * ```
+     *
+     */
+    getNearestStation(latitude: number, longitude: number): Promise<Station | null>;
 }
 export { Client };
diff --git a/dist/client.js b/dist/client.js
@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Client = void 0;
 const cross_fetch_1 = __importDefault(require("cross-fetch"));
+const cache_1 = __importDefault(require("./cache"));
 const defaultOptions = {
     userAgent: 'weathered package'
 };
@@ -33,6 +34,8 @@ const processOptions = (options) => {
 class Client {
     constructor(options) {
         this.options = { ...defaultOptions, ...options };
+        this.pointCache = new cache_1.default();
+        this.stationsCache = new cache_1.default();
     }
     getPath(path) {
         return this.getUrl(API_ROOT + path);
@@ -41,9 +44,16 @@ class Client {
         const resp = await cross_fetch_1.default(url);
         return await resp.json();
     }
-    getPoint(latitude, longitude) {
+    async getPoint(latitude, longitude) {
+        const cacheKey = `${latitude},${longitude}`;
+        const potentialPointResponse = this.pointCache.get(cacheKey);
+        if (potentialPointResponse) {
+            return potentialPointResponse;
+        }
         const path = `points/${latitude},${longitude}`;
-        return this.getPath(path);
+        const pointResponse = await this.getPath(path);
+        this.pointCache.set(cacheKey, pointResponse);
+        return pointResponse;
     }
     getOptions() {
         return { ...this.options };
@@ -52,7 +62,7 @@ class Client {
         this.options = { ...this.options, ...newOptions };
     }
     /**
-     * Get weather alerts for a given area
+     * Get weather alerts for a given area.
      *
      * ```typescript
      * const active = true;
@@ -67,7 +77,7 @@ class Client {
         return this.getPath(path);
     }
     /**
-     * Get a weather forecast for a given latitude and longitude
+     * Get a weather forecast for a given latitude and longitude.
      *
      * ```typescript
      * const latitude = 35.6175667;
@@ -77,10 +87,48 @@ class Client {
      *
      */
     async getForecast(latitude, longitude, forecastType) {
-        const pointResp = await this.getPoint(latitude, longitude);
+        const pointResponse = await this.getPoint(latitude, longitude);
         const forecastKey = forecastType === 'hourly' ? 'forecastHourly' : 'forecast';
-        const url = pointResp.properties[forecastKey];
+        const url = pointResponse.properties[forecastKey];
         return this.getUrl(url);
     }
+    /**
+     * Get the closest weather stations for a given latitude and longitude.
+     *
+     * ```typescript
+     * const latitude = 35.6175667;
+     * const longitude = -80.7709911;
+     * const stations = await client.getStations(latitude, longitude);
+     * ```
+     *
+     */
+    async getStations(latitude, longitude) {
+        const pointResponse = await this.getPoint(latitude, longitude);
+        const stationsUrl = pointResponse.properties.observationStations;
+        const potentionalStationsResponse = this.stationsCache.get(stationsUrl);
+        if (potentionalStationsResponse) {
+            return potentionalStationsResponse;
+        }
+        const stationsResponse = await this.getUrl(stationsUrl);
+        this.stationsCache.set(stationsUrl, stationsResponse);
+        return stationsResponse;
+    }
+    /**
+     * Get the closest weather station for a given latitude and longitude.
+     *
+     * ```typescript
+     * const latitude = 35.6175667;
+     * const longitude = -80.7709911;
+     * const stationOrNull = await client.getNearestStation(latitude, longitude);
+     * ```
+     *
+     */
+    async getNearestStation(latitude, longitude) {
+        const stationsResponse = await this.getStations(latitude, longitude);
+        if (stationsResponse.features.length > 0) {
+            return stationsResponse.features[0];
+        }
+        return null;
+    }
 }
 exports.Client = Client;
diff --git a/dist/index.d.ts b/dist/index.d.ts
@@ -1,2 +1,2 @@
 export { Client } from './client';
-export { ForecastType, Area, Region, RegionType, Urgency, AlertOptions, ClientOptions, PointResponse, ForecastResponse, AlertsResponse, AlertsFeature } from './types';
+export { ForecastType, Area, Region, RegionType, Urgency, AlertOptions, ClientOptions, PointResponse, ForecastResponse, ForecastProperties, AlertsResponse, Station, StationsResponse, AlertsFeature } from './types';
diff --git a/dist/point_cache.d.ts b/dist/point_cache.d.ts
@@ -0,0 +1,8 @@
+import { PointResponse } from './types';
+declare class PointCache {
+    private points;
+    constructor();
+    get(latitude: number, longitude: number): PointResponse | undefined;
+    set(latitude: number, longitude: number, pointResponse: PointResponse): void;
+}
+export default PointCache;
diff --git a/dist/point_cache.js b/dist/point_cache.js
@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const cacheKey = (lat, lng) => `${lat},${lng}`;
+class PointCache {
+    constructor() {
+        this.points = {};
+    }
+    get(latitude, longitude) {
+        return this.points[cacheKey(latitude, longitude)];
+    }
+    set(latitude, longitude, pointResponse) {
+        this.points[cacheKey(latitude, longitude)] = pointResponse;
+    }
+}
+exports.default = PointCache;
diff --git a/dist/types.d.ts b/dist/types.d.ts
@@ -31,8 +31,15 @@ declare type PointResponse = {
     properties: {
         forecast: string;
         forecastHourly: string;
+        observationStations: string;
     };
 };
+declare type Station = {
+    id: string;
+};
+declare type StationsResponse = {
+    features: Station[];
+};
 declare type ForecastPeriod = {
     number: number;
     name: string;
@@ -81,4 +88,4 @@ declare type AlertsFeature = {
 declare type AlertsResponse = {
     features: AlertsFeature[];
 };
-export { ForecastType, Area, Region, RegionType, Urgency, AlertOptions, ClientOptions, PointResponse, ForecastResponse, AlertsResponse, AlertsFeature };
+export { ForecastType, Area, Region, RegionType, Urgency, AlertOptions, ClientOptions, PointResponse, ForecastResponse, ForecastProperties, Station, StationsResponse, AlertsResponse, AlertsFeature };
diff --git a/docs/assets/js/search.js b/docs/assets/js/search.js