@cyanheads/nws-weather-mcp-server 0.3.1

package/dist/mcp-server/tools/format-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qCAAqC;AACrC,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAED,qCAAqC;AACrC,wBAAgB,IAAI,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtC;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWnD"}

package/dist/mcp-server/tools/format-utils.js

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Shared formatting utilities for tool format() functions.
+ * @module mcp-server/tools/format-utils
+ */
+/** Convert Celsius to Fahrenheit. */
+export function cToF(c) {
+    return Math.round(c * 1.8 + 32);
+}
+/** Convert Fahrenheit to Celsius. */
+export function fToC(f) {
+    return Math.round(((f - 32) * 5) / 9);
+}
+/** Format an ISO 8601 timestamp as a short human-readable string. */
+export function formatTimestamp(iso) {
+    const d = new Date(iso);
+    if (Number.isNaN(d.getTime()))
+        return iso;
+    return d.toLocaleString('en-US', {
+        weekday: 'short',
+        month: 'short',
+        day: 'numeric',
+        hour: 'numeric',
+        minute: '2-digit',
+        timeZoneName: 'short',
+    });
+}
+//# sourceMappingURL=format-utils.js.map

package/dist/mcp-server/tools/format-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-utils.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/format-utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;AAClC,CAAC;AAED,qCAAqC;AACrC,MAAM,UAAU,IAAI,CAAC,CAAS;IAC5B,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACxB,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,GAAG,CAAC;IAC1C,OAAO,CAAC,CAAC,cAAc,CAAC,OAAO,EAAE;QAC/B,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE,OAAO;QACd,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;QACjB,YAAY,EAAE,OAAO;KACtB,CAAC,CAAC;AACL,CAAC"}

package/dist/services/nws/nws-service.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview NWS API client service. Handles HTTP requests, /points resolution
+ * with caching, and retry logic for transient failures.
+ * @module services/nws/nws-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { Alert, ForecastResponse, NwsValue, Observation } from './types.js';
+export interface ForecastResult {
+    readonly forecast: ForecastResponse;
+    readonly location: {
+        city: string;
+        state: string;
+        office: string;
+        timeZone: string;
+    };
+}
+export interface AlertSearchResult {
+    readonly alerts: readonly Alert[];
+}
+export interface ObservationResult {
+    readonly observation: Observation;
+}
+export interface StationResult {
+    readonly bearing: string;
+    readonly county: string;
+    readonly distance: number;
+    readonly elevation: NwsValue;
+    readonly forecastZone: string;
+    readonly name: string;
+    readonly stationId: string;
+    readonly timeZone: string;
+}
+export interface FindStationsResult {
+    readonly stations: readonly StationResult[];
+}
+export declare class NwsService {
+    /** Get forecast (standard or hourly) for coordinates. */
+    getForecast(lat: number, lon: number, hourly: boolean, ctx: Context): Promise<ForecastResult>;
+    /** Search active alerts with optional filters. */
+    searchAlerts(params: {
+        area?: string | undefined;
+        point?: string | undefined;
+        zone?: string | undefined;
+        event?: string[] | undefined;
+        severity?: string[] | undefined;
+        urgency?: string[] | undefined;
+        certainty?: string[] | undefined;
+    }, ctx: Context): Promise<AlertSearchResult>;
+    /** Get latest observation, either by station ID or by resolving nearest station from coordinates. */
+    getObservation(params: {
+        latitude?: number | undefined;
+        longitude?: number | undefined;
+        stationId?: string | undefined;
+    }, ctx: Context): Promise<ObservationResult>;
+    /** Find observation stations near coordinates, sorted by proximity. */
+    findStations(lat: number, lon: number, limit: number, ctx: Context): Promise<FindStationsResult>;
+    /** List all valid alert event type names. */
+    listAlertTypes(ctx: Context): Promise<readonly string[]>;
+}
+export declare function initNwsService(): void;
+export declare function getNwsService(): NwsService;
+//# sourceMappingURL=nws-service.d.ts.map

package/dist/services/nws/nws-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nws-service.d.ts","sourceRoot":"","sources":["../../../src/services/nws/nws-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,OAAO,KAAK,EACV,KAAK,EAEL,gBAAgB,EAChB,QAAQ,EACR,WAAW,EAGZ,MAAM,YAAY,CAAC;AA4SpB,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACtF;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,KAAK,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED,qBAAa,UAAU;IACrB,yDAAyD;IACnD,WAAW,CACf,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,OAAO,EACf,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,cAAc,CAAC;IAkB1B,kDAAkD;IAC5C,YAAY,CAChB,MAAM,EAAE;QACN,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC7B,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAChC,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;KAClC,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,iBAAiB,CAAC;IAkB7B,qGAAqG;IAC/F,cAAc,CAClB,MAAM,EAAE;QACN,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;KAChC,EACD,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,iBAAiB,CAAC;IAqD7B,uEAAuE;IACjE,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,kBAAkB,CAAC;IA0B9B,6CAA6C;IACvC,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,SAAS,MAAM,EAAE,CAAC;CAK/D;AAQD,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAED,wBAAgB,aAAa,IAAI,UAAU,CAG1C"}

package/dist/services/nws/nws-service.js

@@ -0,0 +1,372 @@
+/**
+ * @fileoverview NWS API client service. Handles HTTP requests, /points resolution
+ * with caching, and retry logic for transient failures.
+ * @module services/nws/nws-service
+ */
+import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { getServerConfig } from '../../config/server-config.js';
+const BASE_URL = 'https://api.weather.gov';
+const POINTS_CACHE_TTL = 3600; // 1 hour — grid cells rarely change
+const MAX_RETRIES = 2;
+const RETRY_DELAY_MS = 2000;
+/** Extract the last path segment from an NWS API URL (e.g., zone code from zone URL). */
+function extractZoneCode(url) {
+    const lastSlash = url.lastIndexOf('/');
+    return lastSlash >= 0 ? url.slice(lastSlash + 1) : url;
+}
+/** Truncate coordinate to 4 decimal places per NWS API requirement. */
+function truncateCoord(n) {
+    return Math.trunc(n * 10000) / 10000;
+}
+/** Build cache key for /points resolution. */
+function pointsCacheKey(lat, lon) {
+    return `nws/points/${truncateCoord(lat)}_${truncateCoord(lon)}`;
+}
+const DEFAULT_NOT_FOUND = 'NWS only covers the US. Provide coordinates within US states, territories, or adjacent marine areas.';
+/** Try to extract a detail message from an NWS error response body. */
+async function parseNwsErrorDetail(response) {
+    try {
+        const body = (await response.json());
+        if (typeof body.detail === 'string')
+            return body.detail;
+        if (typeof body.title === 'string')
+            return body.title;
+    }
+    catch {
+        /* not JSON — ignore */
+    }
+    return null;
+}
+/** Fetch JSON from the NWS API with User-Agent and optional retries. */
+async function nwsFetch(url, ctx, retries = MAX_RETRIES, notFoundMessage = DEFAULT_NOT_FOUND) {
+    const { userAgent } = getServerConfig();
+    let lastError;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        if (attempt > 0) {
+            ctx.log.info('Retrying NWS request', { url, attempt });
+            await new Promise((r) => setTimeout(r, RETRY_DELAY_MS * attempt));
+        }
+        const response = await fetch(url, {
+            headers: {
+                'User-Agent': userAgent,
+                Accept: 'application/geo+json',
+            },
+            signal: ctx.signal,
+        });
+        if (response.ok) {
+            return (await response.json());
+        }
+        if (response.status >= 500 && attempt < retries) {
+            lastError = new Error(`NWS API returned ${response.status}`);
+            continue;
+        }
+        if (response.status === 404) {
+            throw new Error(notFoundMessage);
+        }
+        if (response.status === 400) {
+            const detail = await parseNwsErrorDetail(response);
+            throw new Error(detail ?? `NWS API returned 400: Bad Request for ${url}`);
+        }
+        throw serviceUnavailable(`NWS API returned ${response.status}: ${response.statusText}`, {
+            url,
+            status: response.status,
+        });
+    }
+    throw serviceUnavailable('NWS API unavailable after retries', { url }, { cause: lastError });
+}
+/** Resolve coordinates to NWS grid metadata, cached via ctx.state. */
+async function resolvePoints(lat, lon, ctx) {
+    const key = pointsCacheKey(lat, lon);
+    const cached = await ctx.state.get(key);
+    if (cached) {
+        ctx.log.debug('Points cache hit', { lat, lon });
+        return cached;
+    }
+    const tLat = truncateCoord(lat);
+    const tLon = truncateCoord(lon);
+    ctx.log.info('Resolving /points', { lat: tLat, lon: tLon });
+    const data = await nwsFetch(`${BASE_URL}/points/${tLat},${tLon}`, ctx);
+    const props = data.properties;
+    const relativeLocation = props.relativeLocation
+        ?.properties;
+    const forecastUrl = props.forecast;
+    const forecastHourlyUrl = props.forecastHourly;
+    const observationStationsUrl = props.observationStations;
+    if (!forecastUrl || !forecastHourlyUrl || !observationStationsUrl) {
+        throw serviceUnavailable('NWS /points response missing required URLs', {
+            lat: tLat,
+            lon: tLon,
+            forecastUrl: !!forecastUrl,
+            forecastHourlyUrl: !!forecastHourlyUrl,
+            observationStationsUrl: !!observationStationsUrl,
+        });
+    }
+    const metadata = {
+        office: props.gridId,
+        gridX: props.gridX,
+        gridY: props.gridY,
+        forecastUrl,
+        forecastHourlyUrl,
+        observationStationsUrl,
+        city: relativeLocation?.city ?? '',
+        state: relativeLocation?.state ?? '',
+        timeZone: props.timeZone,
+        forecastZone: props.forecastZone,
+        county: props.county,
+    };
+    await ctx.state.set(key, metadata, { ttl: POINTS_CACHE_TTL });
+    return metadata;
+}
+/** Parse forecast periods from a forecast GeoJSON response. */
+function parseForecastPeriods(data) {
+    const props = data.properties;
+    const rawPeriods = props.periods;
+    const periods = rawPeriods.map((p) => ({
+        number: p.number,
+        name: p.name,
+        startTime: p.startTime,
+        endTime: p.endTime,
+        isDaytime: p.isDaytime,
+        temperature: p.temperature,
+        temperatureUnit: p.temperatureUnit,
+        windSpeed: p.windSpeed,
+        windDirection: p.windDirection,
+        shortForecast: p.shortForecast,
+        detailedForecast: p.detailedForecast,
+        probabilityOfPrecipitation: p.probabilityOfPrecipitation ?? {
+            value: null,
+            unitCode: 'wmoUnit:percent',
+        },
+        dewpoint: p.dewpoint ?? { value: null, unitCode: 'wmoUnit:degC' },
+        relativeHumidity: p.relativeHumidity ?? {
+            value: null,
+            unitCode: 'wmoUnit:percent',
+        },
+    }));
+    return {
+        generatedAt: props.generatedAt,
+        updateTime: props.updateTime,
+        periods,
+    };
+}
+/** Parse a single alert from GeoJSON feature. */
+function parseAlert(feature) {
+    const p = feature.properties;
+    return {
+        id: p.id,
+        event: p.event,
+        headline: p.headline ?? null,
+        description: p.description,
+        instruction: p.instruction ?? null,
+        severity: p.severity,
+        urgency: p.urgency,
+        certainty: p.certainty,
+        areaDesc: p.areaDesc,
+        onset: p.onset ?? null,
+        expires: p.expires ?? null,
+        senderName: p.senderName,
+        affectedZones: (p.affectedZones ?? []).map(extractZoneCode),
+    };
+}
+/** Parse observation from latest observation response. */
+function parseObservation(data, stationId, stationName) {
+    const props = data.properties;
+    const nullValue = { value: null, unitCode: '' };
+    return {
+        stationId,
+        stationName,
+        timestamp: props.timestamp,
+        textDescription: props.textDescription ?? '',
+        temperature: props.temperature ?? nullValue,
+        dewpoint: props.dewpoint ?? nullValue,
+        windSpeed: props.windSpeed ?? nullValue,
+        windDirection: props.windDirection ?? nullValue,
+        windGust: props.windGust ?? nullValue,
+        barometricPressure: props.barometricPressure ?? nullValue,
+        visibility: props.visibility ?? nullValue,
+        relativeHumidity: props.relativeHumidity ?? nullValue,
+        heatIndex: props.heatIndex ?? nullValue,
+        windChill: props.windChill ?? nullValue,
+        cloudLayers: (props.cloudLayers ?? []).map((l) => ({
+            base: l.base ?? nullValue,
+            amount: l.amount ?? 'CLR',
+        })),
+    };
+}
+/** Parse station features from observation stations response. */
+function parseStations(data) {
+    const features = (data.features ?? data.observationStations);
+    if (!Array.isArray(features))
+        return [];
+    return features.map((f) => {
+        const p = f.properties;
+        const geometry = f.geometry;
+        const coords = geometry?.coordinates ?? [0, 0];
+        return {
+            stationId: p.stationIdentifier ?? '',
+            name: p.name ?? '',
+            elevation: p.elevation ?? { value: null, unitCode: '' },
+            timeZone: p.timeZone ?? '',
+            county: extractZoneCode(p.county ?? ''),
+            forecastZone: extractZoneCode(p.forecast ?? ''),
+            coordinates: [coords[0] ?? 0, coords[1] ?? 0],
+        };
+    });
+}
+/** Haversine distance in kilometers between two lat/lon pairs. */
+function haversine(lat1, lon1, lat2, lon2) {
+    const R = 6371;
+    const dLat = toRad(lat2 - lat1);
+    const dLon = toRad(lon2 - lon1);
+    const a = Math.sin(dLat / 2) ** 2 +
+        Math.cos(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.sin(dLon / 2) ** 2;
+    return R * 2 * Math.atan2(Math.sqrt(a), Math.sqrt(1 - a));
+}
+function toRad(deg) {
+    return (deg * Math.PI) / 180;
+}
+/** Compass bearing from point 1 to point 2. */
+function bearing(lat1, lon1, lat2, lon2) {
+    const dLon = toRad(lon2 - lon1);
+    const y = Math.sin(dLon) * Math.cos(toRad(lat2));
+    const x = Math.cos(toRad(lat1)) * Math.sin(toRad(lat2)) -
+        Math.sin(toRad(lat1)) * Math.cos(toRad(lat2)) * Math.cos(dLon);
+    return ((Math.atan2(y, x) * 180) / Math.PI + 360) % 360;
+}
+/** Bearing degrees to compass direction. */
+function bearingToCompass(deg) {
+    const dirs = [
+        'N',
+        'NNE',
+        'NE',
+        'ENE',
+        'E',
+        'ESE',
+        'SE',
+        'SSE',
+        'S',
+        'SSW',
+        'SW',
+        'WSW',
+        'W',
+        'WNW',
+        'NW',
+        'NNW',
+    ];
+    return dirs[Math.round(deg / 22.5) % 16] ?? 'N';
+}
+export class NwsService {
+    /** Get forecast (standard or hourly) for coordinates. */
+    async getForecast(lat, lon, hourly, ctx) {
+        const points = await resolvePoints(lat, lon, ctx);
+        const url = hourly ? points.forecastHourlyUrl : points.forecastUrl;
+        ctx.log.info('Fetching forecast', { url, hourly });
+        const data = await nwsFetch(url, ctx);
+        return {
+            location: {
+                city: points.city,
+                state: points.state,
+                office: points.office,
+                timeZone: points.timeZone,
+            },
+            forecast: parseForecastPeriods(data),
+        };
+    }
+    /** Search active alerts with optional filters. */
+    async searchAlerts(params, ctx) {
+        const url = new URL(`${BASE_URL}/alerts/active`);
+        if (params.area)
+            url.searchParams.set('area', params.area);
+        if (params.point)
+            url.searchParams.set('point', params.point);
+        if (params.zone)
+            url.searchParams.set('zone', params.zone);
+        if (params.event?.length)
+            url.searchParams.set('event', params.event.join(','));
+        if (params.severity?.length)
+            url.searchParams.set('severity', params.severity.join(','));
+        if (params.urgency?.length)
+            url.searchParams.set('urgency', params.urgency.join(','));
+        if (params.certainty?.length)
+            url.searchParams.set('certainty', params.certainty.join(','));
+        ctx.log.info('Searching alerts', { url: url.toString() });
+        const data = await nwsFetch(url.toString(), ctx);
+        const features = (data.features ?? []);
+        return { alerts: features.map(parseAlert) };
+    }
+    /** Get latest observation, either by station ID or by resolving nearest station from coordinates. */
+    async getObservation(params, ctx) {
+        let stationId;
+        let stationName;
+        if (params.stationId) {
+            stationId = params.stationId.toUpperCase();
+            // Fetch station metadata to get the proper name
+            const stationData = await nwsFetch(`${BASE_URL}/stations/${stationId}`, ctx, 0, `Station '${stationId}' not found. Use nws_find_stations to discover valid station IDs.`);
+            const stationProps = stationData.properties;
+            stationName = stationProps?.name ?? stationId;
+        }
+        else {
+            const lat = params.latitude;
+            const lon = params.longitude;
+            const points = await resolvePoints(lat, lon, ctx);
+            ctx.log.info('Resolving nearest station', { url: points.observationStationsUrl });
+            const stationsData = await nwsFetch(points.observationStationsUrl, ctx, 0);
+            const features = (stationsData.features ?? []);
+            const first = features[0];
+            if (!first) {
+                throw new Error('No observation stations found near this location.');
+            }
+            const firstProps = first.properties;
+            stationId = firstProps.stationIdentifier;
+            stationName = firstProps.name;
+        }
+        ctx.log.info('Fetching latest observation', { stationId });
+        const data = await nwsFetch(`${BASE_URL}/stations/${stationId}/observations/latest`, ctx, MAX_RETRIES, `Station '${stationId}' not found. Use nws_find_stations to discover valid station IDs.`);
+        const observation = parseObservation(data, stationId, stationName);
+        if (!observation.timestamp) {
+            throw new Error(`Station ${stationId} has no recent observations. Try a different station — use nws_find_stations to find alternatives nearby.`);
+        }
+        return { observation };
+    }
+    /** Find observation stations near coordinates, sorted by proximity. */
+    async findStations(lat, lon, limit, ctx) {
+        const points = await resolvePoints(lat, lon, ctx);
+        ctx.log.info('Fetching stations', { url: points.observationStationsUrl });
+        const data = await nwsFetch(points.observationStationsUrl, ctx, 0);
+        const stations = parseStations(data).map((s) => {
+            const dist = haversine(lat, lon, s.coordinates[1], s.coordinates[0]);
+            const bear = bearing(lat, lon, s.coordinates[1], s.coordinates[0]);
+            return {
+                stationId: s.stationId,
+                name: s.name,
+                distance: Math.round(dist * 10) / 10,
+                bearing: bearingToCompass(bear),
+                elevation: s.elevation,
+                timeZone: s.timeZone,
+                county: s.county,
+                forecastZone: s.forecastZone,
+            };
+        });
+        stations.sort((a, b) => a.distance - b.distance);
+        return { stations: stations.slice(0, limit) };
+    }
+    /** List all valid alert event type names. */
+    async listAlertTypes(ctx) {
+        ctx.log.info('Fetching alert types');
+        const data = await nwsFetch(`${BASE_URL}/alerts/types`, ctx, 0);
+        return data.eventTypes ?? [];
+    }
+}
+// ---------------------------------------------------------------------------
+// Init/accessor pattern
+// ---------------------------------------------------------------------------
+let _service;
+export function initNwsService() {
+    _service = new NwsService();
+}
+export function getNwsService() {
+    if (!_service)
+        throw new Error('NwsService not initialized — call initNwsService() in setup()');
+    return _service;
+}
+//# sourceMappingURL=nws-service.js.map

package/dist/services/nws/nws-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nws-service.js","sourceRoot":"","sources":["../../../src/services/nws/nws-service.ts"],"names":[],"mappings":"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"}

package/dist/services/nws/types.d.ts

@@ -0,0 +1,96 @@
+/**
+ * @fileoverview Type definitions for NWS API responses.
+ * @module services/nws/types
+ */
+/** NWS quantity value — many observation fields use this shape. */
+export interface NwsValue {
+    readonly unitCode: string;
+    readonly value: number | null;
+}
+/** Resolved grid point from /points/{lat},{lon}. */
+export interface PointsMetadata {
+    readonly city: string;
+    readonly county: string;
+    readonly forecastHourlyUrl: string;
+    readonly forecastUrl: string;
+    readonly forecastZone: string;
+    readonly gridX: number;
+    readonly gridY: number;
+    readonly observationStationsUrl: string;
+    readonly office: string;
+    readonly state: string;
+    readonly timeZone: string;
+}
+/** A single forecast period (shared by standard and hourly). */
+export interface ForecastPeriod {
+    readonly detailedForecast: string;
+    readonly dewpoint: NwsValue;
+    readonly endTime: string;
+    readonly isDaytime: boolean;
+    readonly name: string;
+    readonly number: number;
+    readonly probabilityOfPrecipitation: NwsValue;
+    readonly relativeHumidity: NwsValue;
+    readonly shortForecast: string;
+    readonly startTime: string;
+    readonly temperature: number;
+    readonly temperatureUnit: string;
+    readonly windDirection: string;
+    readonly windSpeed: string;
+}
+/** Forecast response from /gridpoints/{wfo}/{x},{y}/forecast. */
+export interface ForecastResponse {
+    readonly generatedAt: string;
+    readonly periods: readonly ForecastPeriod[];
+    readonly updateTime: string;
+}
+/** Active alert from /alerts/active. */
+export interface Alert {
+    readonly affectedZones: readonly string[];
+    readonly areaDesc: string;
+    readonly certainty: string;
+    readonly description: string;
+    readonly event: string;
+    readonly expires: string | null;
+    readonly headline: string | null;
+    readonly id: string;
+    readonly instruction: string | null;
+    readonly onset: string | null;
+    readonly senderName: string;
+    readonly severity: string;
+    readonly urgency: string;
+}
+/** Latest observation from /stations/{id}/observations/latest. */
+export interface Observation {
+    readonly barometricPressure: NwsValue;
+    readonly cloudLayers: readonly CloudLayer[];
+    readonly dewpoint: NwsValue;
+    readonly heatIndex: NwsValue;
+    readonly relativeHumidity: NwsValue;
+    readonly stationId: string;
+    readonly stationName: string;
+    readonly temperature: NwsValue;
+    readonly textDescription: string;
+    readonly timestamp: string;
+    readonly visibility: NwsValue;
+    readonly windChill: NwsValue;
+    readonly windDirection: NwsValue;
+    readonly windGust: NwsValue;
+    readonly windSpeed: NwsValue;
+}
+/** Cloud layer from observation data. */
+export interface CloudLayer {
+    readonly amount: string;
+    readonly base: NwsValue;
+}
+/** Observation station from /points/{lat},{lon}/stations. */
+export interface Station {
+    readonly coordinates: readonly [longitude: number, latitude: number];
+    readonly county: string;
+    readonly elevation: NwsValue;
+    readonly forecastZone: string;
+    readonly name: string;
+    readonly stationId: string;
+    readonly timeZone: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/nws/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/nws/types.ts"],"names":[],"mappings":"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"}

package/dist/services/nws/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Type definitions for NWS API responses.
+ * @module services/nws/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/nws/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/nws/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}