@dangahagan/weather-mcp 0.1.2 → 0.4.0

package/dist/config/displayThresholds.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Display thresholds and constants for weather data formatting
+ *
+ * These values determine when certain weather metrics are shown or highlighted
+ */
+export declare const DisplayThresholds: {
+    /**
+     * Temperature thresholds (in Fahrenheit)
+     */
+    readonly temperature: {
+        /** Show heat index when temperature is above this value */
+        readonly showHeatIndex: 80;
+        /** Show wind chill when temperature is below this value */
+        readonly showWindChill: 50;
+    };
+    /**
+     * Wind thresholds
+     */
+    readonly wind: {
+        /** Show gusts if they are this ratio higher than sustained wind speed (1.2 = 20% higher) */
+        readonly gustSignificanceRatio: 1.2;
+    };
+    /**
+     * Visibility thresholds (in miles)
+     */
+    readonly visibility: {
+        /** Dense fog */
+        readonly denseFog: 0.25;
+        /** Fog */
+        readonly fog: 1;
+        /** Haze or mist */
+        readonly hazeMist: 3;
+        /** Clear visibility */
+        readonly clear: 10;
+    };
+    /**
+     * Precipitation thresholds
+     */
+    readonly precipitation: {
+        /** Light precipitation (inches per hour) */
+        readonly light: 0.1;
+        /** Moderate precipitation (inches per hour) */
+        readonly moderate: 0.3;
+        /** Heavy precipitation (inches per hour) */
+        readonly heavy: 0.5;
+    };
+};
+/**
+ * API-related constants
+ */
+export declare const ApiConstants: {
+    /**
+     * Historical data threshold (in days)
+     * Data older than this uses archival API instead of recent observations
+     */
+    readonly historicalDataThresholdDays: 7;
+    /**
+     * Maximum date range for hourly historical data (in days)
+     */
+    readonly maxHourlyHistoricalDays: 31;
+};
+/**
+ * Formatting constants
+ */
+export declare const FormatConstants: {
+    /**
+     * Default forecast periods to show
+     */
+    readonly defaultForecastDays: 7;
+    /**
+     * Maximum forecast days (Open-Meteo supports up to 16 days)
+     */
+    readonly maxForecastDays: 16;
+    /**
+     * Default observation limit for historical data
+     */
+    readonly defaultHistoricalLimit: 168;
+    /**
+     * Maximum observations to return
+     */
+    readonly maxHistoricalLimit: 500;
+};
+//# sourceMappingURL=displayThresholds.d.ts.map

package/dist/config/displayThresholds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayThresholds.d.ts","sourceRoot":"","sources":["../../src/config/displayThresholds.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,iBAAiB;IAC5B;;OAEG;;QAED,2DAA2D;;QAE3D,2DAA2D;;;IAI7D;;OAEG;;QAED,4FAA4F;;;IAI9F;;OAEG;;QAED,gBAAgB;;QAEhB,UAAU;;QAEV,mBAAmB;;QAEnB,uBAAuB;;;IAIzB;;OAEG;;QAED,4CAA4C;;QAE5C,+CAA+C;;QAE/C,4CAA4C;;;CAGtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,YAAY;IACvB;;;OAGG;;IAGH;;OAEG;;CAEK,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,eAAe;IAC1B;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;CAEK,CAAC"}

package/dist/config/displayThresholds.js

@@ -0,0 +1,83 @@
+/**
+ * Display thresholds and constants for weather data formatting
+ *
+ * These values determine when certain weather metrics are shown or highlighted
+ */
+export const DisplayThresholds = {
+    /**
+     * Temperature thresholds (in Fahrenheit)
+     */
+    temperature: {
+        /** Show heat index when temperature is above this value */
+        showHeatIndex: 80,
+        /** Show wind chill when temperature is below this value */
+        showWindChill: 50,
+    },
+    /**
+     * Wind thresholds
+     */
+    wind: {
+        /** Show gusts if they are this ratio higher than sustained wind speed (1.2 = 20% higher) */
+        gustSignificanceRatio: 1.2,
+    },
+    /**
+     * Visibility thresholds (in miles)
+     */
+    visibility: {
+        /** Dense fog */
+        denseFog: 0.25,
+        /** Fog */
+        fog: 1.0,
+        /** Haze or mist */
+        hazeMist: 3.0,
+        /** Clear visibility */
+        clear: 10.0,
+    },
+    /**
+     * Precipitation thresholds
+     */
+    precipitation: {
+        /** Light precipitation (inches per hour) */
+        light: 0.1,
+        /** Moderate precipitation (inches per hour) */
+        moderate: 0.3,
+        /** Heavy precipitation (inches per hour) */
+        heavy: 0.5,
+    },
+};
+/**
+ * API-related constants
+ */
+export const ApiConstants = {
+    /**
+     * Historical data threshold (in days)
+     * Data older than this uses archival API instead of recent observations
+     */
+    historicalDataThresholdDays: 7,
+    /**
+     * Maximum date range for hourly historical data (in days)
+     */
+    maxHourlyHistoricalDays: 31,
+};
+/**
+ * Formatting constants
+ */
+export const FormatConstants = {
+    /**
+     * Default forecast periods to show
+     */
+    defaultForecastDays: 7,
+    /**
+     * Maximum forecast days (Open-Meteo supports up to 16 days)
+     */
+    maxForecastDays: 16,
+    /**
+     * Default observation limit for historical data
+     */
+    defaultHistoricalLimit: 168, // One week of hourly data
+    /**
+     * Maximum observations to return
+     */
+    maxHistoricalLimit: 500,
+};
+//# sourceMappingURL=displayThresholds.js.map

package/dist/config/displayThresholds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"displayThresholds.js","sourceRoot":"","sources":["../../src/config/displayThresholds.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;;OAEG;IACH,WAAW,EAAE;QACX,2DAA2D;QAC3D,aAAa,EAAE,EAAE;QACjB,2DAA2D;QAC3D,aAAa,EAAE,EAAE;KAClB;IAED;;OAEG;IACH,IAAI,EAAE;QACJ,4FAA4F;QAC5F,qBAAqB,EAAE,GAAG;KAC3B;IAED;;OAEG;IACH,UAAU,EAAE;QACV,gBAAgB;QAChB,QAAQ,EAAE,IAAI;QACd,UAAU;QACV,GAAG,EAAE,GAAG;QACR,mBAAmB;QACnB,QAAQ,EAAE,GAAG;QACb,uBAAuB;QACvB,KAAK,EAAE,IAAI;KACZ;IAED;;OAEG;IACH,aAAa,EAAE;QACb,4CAA4C;QAC5C,KAAK,EAAE,GAAG;QACV,+CAA+C;QAC/C,QAAQ,EAAE,GAAG;QACb,4CAA4C;QAC5C,KAAK,EAAE,GAAG;KACX;CACO,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B;;;OAGG;IACH,2BAA2B,EAAE,CAAC;IAE9B;;OAEG;IACH,uBAAuB,EAAE,EAAE;CACnB,CAAC;AAEX;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B;;OAEG;IACH,mBAAmB,EAAE,CAAC;IAEtB;;OAEG;IACH,eAAe,EAAE,EAAE;IAEnB;;OAEG;IACH,sBAAsB,EAAE,GAAG,EAAE,0BAA0B;IAEvD;;OAEG;IACH,kBAAkB,EAAE,GAAG;CACf,CAAC"}

package/dist/errors/ApiError.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Custom error classes for better error handling and logging
+ */
+/**
+ * Base error class for API-related errors
+ */
+export declare class ApiError extends Error {
+    readonly statusCode: number;
+    readonly service: 'NOAA' | 'OpenMeteo';
+    readonly userMessage: string;
+    readonly helpLinks: string[];
+    readonly isRetryable: boolean;
+    constructor(message: string, statusCode: number, service: 'NOAA' | 'OpenMeteo', userMessage: string, helpLinks?: string[], isRetryable?: boolean);
+    /**
+     * Format error for display to user
+     */
+    toUserMessage(): string;
+}
+/**
+ * Rate limit error - too many requests
+ */
+export declare class RateLimitError extends ApiError {
+    readonly retryAfter?: number;
+    constructor(service: 'NOAA' | 'OpenMeteo', retryAfter?: number);
+}
+/**
+ * Service unavailable error - API is down or timing out
+ */
+export declare class ServiceUnavailableError extends ApiError {
+    constructor(service: 'NOAA' | 'OpenMeteo', originalError?: Error);
+}
+/**
+ * Invalid location error - coordinates not supported or out of range
+ */
+export declare class InvalidLocationError extends ApiError {
+    readonly latitude?: number;
+    readonly longitude?: number;
+    constructor(service: 'NOAA' | 'OpenMeteo', message: string, latitude?: number, longitude?: number);
+}
+/**
+ * Data not found error - requested data doesn't exist
+ */
+export declare class DataNotFoundError extends ApiError {
+    constructor(service: 'NOAA' | 'OpenMeteo', message: string);
+}
+/**
+ * Validation error - invalid input parameters
+ */
+export declare class ValidationError extends Error {
+    readonly field?: string;
+    readonly value?: any;
+    constructor(message: string, field?: string, value?: any);
+}
+/**
+ * Check if an error is retryable
+ */
+export declare function isRetryableError(error: Error): boolean;
+/**
+ * Format error for user display
+ */
+export declare function formatErrorForUser(error: Error): string;
+//# sourceMappingURL=ApiError.d.ts.map

package/dist/errors/ApiError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiError.d.ts","sourceRoot":"","sources":["../../src/errors/ApiError.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9C,SAAgB,WAAW,EAAE,MAAM,CAAC;IACpC,SAAgB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpC,SAAgB,WAAW,EAAE,OAAO,CAAC;gBAGnC,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,GAAG,WAAW,EAC7B,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAM,EAAO,EACxB,WAAW,GAAE,OAAe;IAgB9B;;OAEG;IACH,aAAa,IAAI,MAAM;CAYxB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,UAAU,CAAC,EAAE,MAAM;CAoB/D;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,aAAa,CAAC,EAAE,KAAK;CAoBjE;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,SAAS,CAAC,EAAE,MAAM,CAAC;gBAGjC,OAAO,EAAE,MAAM,GAAG,WAAW,EAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM;CAerB;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;gBACjC,OAAO,EAAE,MAAM,GAAG,WAAW,EAAE,OAAO,EAAE,MAAM;CAY3D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAgB,KAAK,CAAC,EAAE,GAAG,CAAC;gBAEhB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG;CAUzD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAetD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,CAgBvD"}

package/dist/errors/ApiError.js

@@ -0,0 +1,147 @@
+/**
+ * Custom error classes for better error handling and logging
+ */
+/**
+ * Base error class for API-related errors
+ */
+export class ApiError extends Error {
+    statusCode;
+    service;
+    userMessage;
+    helpLinks;
+    isRetryable;
+    constructor(message, statusCode, service, userMessage, helpLinks = [], isRetryable = false) {
+        super(message);
+        this.name = 'ApiError';
+        this.statusCode = statusCode;
+        this.service = service;
+        this.userMessage = userMessage;
+        this.helpLinks = helpLinks;
+        this.isRetryable = isRetryable;
+        // Maintains proper stack trace for where our error was thrown (only available on V8)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Format error for display to user
+     */
+    toUserMessage() {
+        let message = `${this.service} API Error: ${this.userMessage}`;
+        if (this.helpLinks.length > 0) {
+            message += '\n\nFor more information:\n';
+            this.helpLinks.forEach(link => {
+                message += `- ${link}\n`;
+            });
+        }
+        return message;
+    }
+}
+/**
+ * Rate limit error - too many requests
+ */
+export class RateLimitError extends ApiError {
+    retryAfter;
+    constructor(service, retryAfter) {
+        const userMessage = retryAfter
+            ? `Rate limit exceeded. Please retry after ${retryAfter} seconds.`
+            : 'Rate limit exceeded. Please retry in a few seconds.';
+        super(`Rate limit exceeded for ${service}`, 429, service, userMessage, [
+            'https://weather.gov/documentation/services-web-api',
+            'https://open-meteo.com/en/features#api-documentation',
+        ], true // Retryable after waiting
+        );
+        this.name = 'RateLimitError';
+        this.retryAfter = retryAfter;
+    }
+}
+/**
+ * Service unavailable error - API is down or timing out
+ */
+export class ServiceUnavailableError extends ApiError {
+    constructor(service, originalError) {
+        super(`${service} API is currently unavailable`, 503, service, `The ${service} weather service is temporarily unavailable. Please try again in a few minutes.`, [
+            service === 'NOAA'
+                ? 'https://www.weather.gov/'
+                : 'https://open-meteo.com/',
+        ], true // Retryable
+        );
+        this.name = 'ServiceUnavailableError';
+        if (originalError && originalError.stack) {
+            this.stack = `${this.stack}\nCaused by: ${originalError.stack}`;
+        }
+    }
+}
+/**
+ * Invalid location error - coordinates not supported or out of range
+ */
+export class InvalidLocationError extends ApiError {
+    latitude;
+    longitude;
+    constructor(service, message, latitude, longitude) {
+        super(message, 400, service, message, [], false // Not retryable
+        );
+        this.name = 'InvalidLocationError';
+        this.latitude = latitude;
+        this.longitude = longitude;
+    }
+}
+/**
+ * Data not found error - requested data doesn't exist
+ */
+export class DataNotFoundError extends ApiError {
+    constructor(service, message) {
+        super(message, 404, service, message, [], false // Not retryable
+        );
+        this.name = 'DataNotFoundError';
+    }
+}
+/**
+ * Validation error - invalid input parameters
+ */
+export class ValidationError extends Error {
+    field;
+    value;
+    constructor(message, field, value) {
+        super(message);
+        this.name = 'ValidationError';
+        this.field = field;
+        this.value = value;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+/**
+ * Check if an error is retryable
+ */
+export function isRetryableError(error) {
+    if (error instanceof ApiError) {
+        return error.isRetryable;
+    }
+    // Network errors are generally retryable
+    if (error.message.includes('ECONNREFUSED') ||
+        error.message.includes('ETIMEDOUT') ||
+        error.message.includes('ENOTFOUND')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Format error for user display
+ */
+export function formatErrorForUser(error) {
+    if (error instanceof ApiError) {
+        return error.toUserMessage();
+    }
+    if (error instanceof ValidationError) {
+        return `Validation Error: ${error.message}`;
+    }
+    // Sanitize generic errors to avoid leaking sensitive information
+    const sanitizedMessage = error.message
+        .replace(/ECONNREFUSED/, 'Connection refused')
+        .replace(/ETIMEDOUT/, 'Connection timed out')
+        .replace(/ENOTFOUND/, 'Service not found');
+    return `Error: ${sanitizedMessage}`;
+}
+//# sourceMappingURL=ApiError.js.map

package/dist/errors/ApiError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApiError.js","sourceRoot":"","sources":["../../src/errors/ApiError.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjB,UAAU,CAAS;IACnB,OAAO,CAAuB;IAC9B,WAAW,CAAS;IACpB,SAAS,CAAW;IACpB,WAAW,CAAU;IAErC,YACE,OAAe,EACf,UAAkB,EAClB,OAA6B,EAC7B,WAAmB,EACnB,YAAsB,EAAE,EACxB,cAAuB,KAAK;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,qFAAqF;QACrF,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,OAAO,GAAG,GAAG,IAAI,CAAC,OAAO,eAAe,IAAI,CAAC,WAAW,EAAE,CAAC;QAE/D,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,OAAO,IAAI,6BAA6B,CAAC;YACzC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;gBAC5B,OAAO,IAAI,KAAK,IAAI,IAAI,CAAC;YAC3B,CAAC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,cAAe,SAAQ,QAAQ;IAC1B,UAAU,CAAU;IAEpC,YAAY,OAA6B,EAAE,UAAmB;QAC5D,MAAM,WAAW,GAAG,UAAU;YAC5B,CAAC,CAAC,2CAA2C,UAAU,WAAW;YAClE,CAAC,CAAC,qDAAqD,CAAC;QAE1D,KAAK,CACH,2BAA2B,OAAO,EAAE,EACpC,GAAG,EACH,OAAO,EACP,WAAW,EACX;YACE,oDAAoD;YACpD,sDAAsD;SACvD,EACD,IAAI,CAAC,0BAA0B;SAChC,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,QAAQ;IACnD,YAAY,OAA6B,EAAE,aAAqB;QAC9D,KAAK,CACH,GAAG,OAAO,+BAA+B,EACzC,GAAG,EACH,OAAO,EACP,OAAO,OAAO,iFAAiF,EAC/F;YACE,OAAO,KAAK,MAAM;gBAChB,CAAC,CAAC,0BAA0B;gBAC5B,CAAC,CAAC,yBAAyB;SAC9B,EACD,IAAI,CAAC,YAAY;SAClB,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QAEtC,IAAI,aAAa,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACzC,IAAI,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,gBAAgB,aAAa,CAAC,KAAK,EAAE,CAAC;QAClE,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,QAAQ;IAChC,QAAQ,CAAU;IAClB,SAAS,CAAU;IAEnC,YACE,OAA6B,EAC7B,OAAe,EACf,QAAiB,EACjB,SAAkB;QAElB,KAAK,CACH,OAAO,EACP,GAAG,EACH,OAAO,EACP,OAAO,EACP,EAAE,EACF,KAAK,CAAC,gBAAgB;SACvB,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,QAAQ;IAC7C,YAAY,OAA6B,EAAE,OAAe;QACxD,KAAK,CACH,OAAO,EACP,GAAG,EACH,OAAO,EACP,OAAO,EACP,EAAE,EACF,KAAK,CAAC,gBAAgB;SACvB,CAAC;QAEF,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxB,KAAK,CAAU;IACf,KAAK,CAAO;IAE5B,YAAY,OAAe,EAAE,KAAc,EAAE,KAAW;QACtD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QAEnB,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;QAClD,CAAC;IACH,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAY;IAC3C,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,WAAW,CAAC;IAC3B,CAAC;IAED,yCAAyC;IACzC,IACE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC;QACtC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QACnC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,EACnC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAY;IAC7C,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,aAAa,EAAE,CAAC;IAC/B,CAAC;IAED,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;QACrC,OAAO,qBAAqB,KAAK,CAAC,OAAO,EAAE,CAAC;IAC9C,CAAC;IAED,iEAAiE;IACjE,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO;SACnC,OAAO,CAAC,cAAc,EAAE,oBAAoB,CAAC;SAC7C,OAAO,CAAC,WAAW,EAAE,sBAAsB,CAAC;SAC5C,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;IAE7C,OAAO,UAAU,gBAAgB,EAAE,CAAC;AACtC,CAAC"}

package/dist/handlers/alertsHandler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Handler for get_alerts tool
+ */
+import { NOAAService } from '../services/noaa.js';
+export declare function handleGetAlerts(args: unknown, noaaService: NOAAService): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=alertsHandler.d.ts.map

package/dist/handlers/alertsHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alertsHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/alertsHandler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AASlD,wBAAsB,eAAe,CACnC,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CA+F7D"}

package/dist/handlers/alertsHandler.js

@@ -0,0 +1,79 @@
+/**
+ * Handler for get_alerts tool
+ */
+import { validateCoordinates, validateOptionalBoolean } from '../utils/validation.js';
+export async function handleGetAlerts(args, noaaService) {
+    // Validate input parameters with runtime checks
+    const { latitude, longitude } = validateCoordinates(args);
+    const active_only = validateOptionalBoolean(args?.active_only, 'active_only', true);
+    // Get alerts data
+    const alertsData = await noaaService.getAlerts(latitude, longitude, active_only);
+    const alerts = alertsData.features;
+    // Format the alerts for display
+    let output = `# Weather Alerts\n\n`;
+    output += `**Location:** ${latitude.toFixed(4)}, ${longitude.toFixed(4)}\n`;
+    output += `**Status:** ${active_only ? 'Active alerts only' : 'All alerts'}\n`;
+    if (alertsData.updated) {
+        output += `**Updated:** ${new Date(alertsData.updated).toLocaleString()}\n`;
+    }
+    output += `\n`;
+    if (alerts.length === 0) {
+        output += `✅ **No active weather alerts for this location.**\n\n`;
+        output += `The area is currently clear of weather warnings, watches, and advisories.\n`;
+    }
+    else {
+        output += `⚠️ **${alerts.length} active alert${alerts.length > 1 ? 's' : ''} found**\n\n`;
+        const severityOrder = {
+            'Extreme': 0,
+            'Severe': 1,
+            'Moderate': 2,
+            'Minor': 3,
+            'Unknown': 4
+        };
+        const sortedAlerts = alerts.sort((a, b) => {
+            const severityA = severityOrder[a.properties.severity] ?? 4;
+            const severityB = severityOrder[b.properties.severity] ?? 4;
+            return severityA - severityB;
+        });
+        for (const alert of sortedAlerts) {
+            const props = alert.properties;
+            // Severity emoji
+            const severityEmoji = props.severity === 'Extreme' ? '🔴' :
+                props.severity === 'Severe' ? '🟠' :
+                    props.severity === 'Moderate' ? '🟡' :
+                        props.severity === 'Minor' ? '🔵' : '⚪';
+            output += `${severityEmoji} **${props.event}**\n`;
+            output += `---\n`;
+            if (props.headline) {
+                output += `**${props.headline}**\n\n`;
+            }
+            output += `**Severity:** ${props.severity} | **Urgency:** ${props.urgency} | **Certainty:** ${props.certainty}\n`;
+            output += `**Area:** ${props.areaDesc}\n`;
+            output += `**Effective:** ${new Date(props.effective).toLocaleString()}\n`;
+            output += `**Expires:** ${new Date(props.expires).toLocaleString()}\n`;
+            if (props.onset && props.onset !== props.effective) {
+                output += `**Onset:** ${new Date(props.onset).toLocaleString()}\n`;
+            }
+            if (props.ends) {
+                output += `**Ends:** ${new Date(props.ends).toLocaleString()}\n`;
+            }
+            output += `\n**Description:**\n${props.description}\n`;
+            if (props.instruction) {
+                output += `\n**Instructions:**\n${props.instruction}\n`;
+            }
+            output += `\n**Recommended Response:** ${props.response}\n`;
+            output += `**Sender:** ${props.senderName}\n\n`;
+        }
+    }
+    output += `---\n`;
+    output += `*Data source: NOAA National Weather Service*\n`;
+    return {
+        content: [
+            {
+                type: 'text',
+                text: output
+            }
+        ]
+    };
+}
+//# sourceMappingURL=alertsHandler.js.map

package/dist/handlers/alertsHandler.js.map

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

package/dist/handlers/currentConditionsHandler.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Handler for get_current_conditions tool
+ */
+import { NOAAService } from '../services/noaa.js';
+export declare function handleGetCurrentConditions(args: unknown, noaaService: NOAAService): Promise<{
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+}>;
+//# sourceMappingURL=currentConditionsHandler.d.ts.map

package/dist/handlers/currentConditionsHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currentConditionsHandler.d.ts","sourceRoot":"","sources":["../../src/handlers/currentConditionsHandler.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAKlD,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC,CAkL7D"}