@dangahagan/weather-mcp 1.3.0 → 1.6.1

package/README.md

@@ -91,6 +91,39 @@ An MCP (Model Context Protocol) server that provides **global weather data** to
   - Safety assessment for maritime activities (sailing, boating, surfing)
   - Wave interpretation guide based on Douglas Sea Scale
   - Important: Data has limited coastal accuracy - NOT for navigation
+- **Weather Imagery**: Visual weather radar and precipitation maps (NEW in v1.5.0)
+  - Global precipitation radar from RainViewer API
+  - Static radar images showing current precipitation
+  - Animated radar loops (up to 2 hours of history)
+  - Tile URLs for efficient rendering
+  - Automatic coordinate-to-tile calculation
+  - Visual confirmation of approaching weather
+  - Free, no API key required
+- **Lightning Activity**: Real-time lightning strike detection and safety monitoring (NEW in v1.5.0)
+  - Real-time strike detection from Blitzortung.org network
+  - Strikes within customizable radius (default: 100km)
+  - 4-level safety assessment (Safe, Elevated, High, Extreme)
+  - Distance to nearest strike with comprehensive statistics
+  - Strike polarity and amplitude information
+  - Safety recommendations based on proximity
+  - Critical for outdoor activity safety planning
+  - Free, no API key required
+- **River Conditions**: Monitor river levels and flood status for safety and recreation (NEW in v1.6.0)
+  - Current water levels from NOAA and USGS gauges
+  - Flood stage thresholds (action, minor, moderate, major)
+  - Streamflow data in cubic feet per second
+  - Distance-based gauge filtering within customizable radius
+  - Safety assessment for boating and recreation
+  - Historical flood crest data when available
+  - US coverage via NOAA NWPS and USGS Water Services
+- **Wildfire Information**: Track active wildfires and fire perimeters (NEW in v1.6.0)
+  - Active wildfire locations and prescribed burns
+  - Fire size, containment status, and discovery date
+  - Distance-based proximity filtering
+  - 4-level safety assessment (Extreme Danger, High Alert, Caution, Awareness)
+  - Evacuation recommendations based on proximity
+  - Detailed fire attributes (type, location, status)
+  - Data from NIFC WFIGS (National Interagency Fire Center)
 - **Service Status Checking**: Proactively verify API availability with health checks
 - **Enhanced Error Handling**: Detailed, actionable error messages with status page links
 - **Intelligent Caching**: Built-in in-memory cache reduces API calls and improves performance
@@ -112,6 +145,10 @@ The cache automatically stores and retrieves weather data with intelligent expir
 
 - **Location Searches**: Cached for 30 days (locations don't move)
 - **Climate Normals**: Cached indefinitely (30-year averages are static) - NEW in v1.2.0
+- **Weather Imagery**: Cached for 15 minutes (radar updates frequently) - NEW in v1.5.0
+- **Lightning Strikes**: Cached for 5 minutes (real-time safety data) - NEW in v1.5.0
+- **River Conditions**: Cached for 1 hour (gauge data updates frequently) - NEW in v1.6.0
+- **Wildfire Information**: Cached for 30 minutes (fire data changes rapidly) - NEW in v1.6.0
 - **Marine Conditions**: Cached for 1 hour (marine data updates hourly) - NEW in v0.6.0
 - **Air Quality Data**: Cached for 1 hour (air quality updates hourly) - v0.5.0
 - **Fire Weather Data**: Cached for 2 hours (gridpoint data updates ~hourly) - v0.5.0
@@ -124,6 +161,45 @@ The cache automatically stores and retrieves weather data with intelligent expir
 
 ### Configuration
 
+#### Tool Selection (NEW in v1.4.0)
+
+Control which MCP tools are exposed to reduce context overhead and customize functionality. By default, only **basic** tools are enabled.
+
+**Available Presets:**
+- `basic` (default): Essential weather tools (5 tools) - forecast, current_conditions, alerts, search_location, check_service_status
+- `standard`: Basic + historical_weather (6 tools)
+- `full`: Standard + air_quality (7 tools)
+- `all`: All available tools (12 tools) - includes marine_conditions, weather_imagery, lightning_activity, river_conditions, wildfire_info
+
+**Configuration Examples:**
+
+```bash
+# Use a preset
+export ENABLED_TOOLS=full
+
+# Select specific tools
+export ENABLED_TOOLS=forecast,current,alerts,air_quality
+
+# Add tools to a preset
+export ENABLED_TOOLS=basic,+historical,+air_quality
+
+# Remove tools from a preset
+export ENABLED_TOOLS=all,-marine
+
+# Complex combinations
+export ENABLED_TOOLS=standard,+air_quality,-alerts
+```
+
+**Tool Aliases:**
+Short names are supported: `forecast`, `current`, `conditions`, `alerts`, `warnings`, `historical`, `history`, `status`, `location`, `search`, `air_quality`, `aqi`, `marine`, `ocean`, `waves`, `imagery`, `radar`, `satellite`, `lightning`, `strikes`, `thunderstorm`
+
+**Benefits:**
+- **Reduced Context**: Load only needed tools to reduce initial MCP context
+- **Better Security**: Only expose necessary functionality
+- **Customization**: Tailor the server to your specific use case
+
+#### Cache Configuration
+
 Caching is **enabled by default** with sensible settings. To customize:
 
 ```bash
@@ -581,6 +657,144 @@ Provides comprehensive marine weather data with intelligent dual-source support:
 - Wave period for planning and safety
 - Optional 5-day forecast with daily summaries
 
+### 9. get_weather_imagery (NEW in v1.5.0)
+Get weather radar and precipitation imagery for visual weather analysis.
+
+**Parameters:**
+- `latitude` (required): Latitude coordinate (-90 to 90)
+- `longitude` (required): Longitude coordinate (-180 to 180)
+- `type` (required): Imagery type - "precipitation", "radar", or "satellite" (Note: satellite not yet implemented)
+- `animated` (optional): Return animated loop vs static image (default: false)
+- `layers` (optional): Additional map layers (reserved for future use)
+
+**Description:**
+Provides access to weather radar and precipitation imagery from RainViewer API with global coverage. Returns tile URLs for efficient rendering of current precipitation or animated radar loops showing up to 2 hours of history. Perfect for visual confirmation of approaching weather systems.
+
+**Examples:**
+```
+"Show me the current radar for New York"
+"Get animated precipitation radar for London for the last 2 hours"
+"Is there any precipitation showing on radar near me?"
+```
+
+**Returns:**
+- Precipitation radar imagery (static or animated)
+- Tile URLs for efficient rendering
+- Frame timestamps for animated sequences
+- Coverage area and resolution information
+- Automatic coordinate-to-tile calculation
+- Up to 2 hours of historical radar frames when animated
+
+**Note:** Satellite imagery is planned for a future release. Precipitation radar provides global coverage via the free RainViewer API.
+
+### 10. get_lightning_activity (NEW in v1.5.0)
+Get real-time lightning strike detection and safety assessment for outdoor activity planning.
+
+**Parameters:**
+- `latitude` (required): Latitude coordinate (-90 to 90)
+- `longitude` (required): Longitude coordinate (-180 to 180)
+- `radius` (optional): Search radius in kilometers (1-500, default: 100)
+- `timeWindow` (optional): Historical time window in minutes (1-180, default: 60)
+
+**Description:**
+Provides real-time lightning strike detection from the Blitzortung.org global lightning detection network. Includes comprehensive safety assessment with 4 risk levels based on strike proximity. Critical for outdoor safety planning including boating, hiking, golfing, and other outdoor activities.
+
+**Examples:**
+```
+"Are there any lightning strikes near Miami?"
+"Check for lightning activity within 50km"
+"Is it safe to be outside based on lightning?"
+"Show me recent lightning strikes in the last hour"
+```
+
+**Returns:**
+- Real-time lightning strikes within specified radius
+- 4-level safety assessment:
+  - **Safe** (>50km): No immediate lightning threat
+  - **Elevated** (16-50km): Monitor conditions, plan indoor access
+  - **High** (8-16km): Seek shelter immediately
+  - **Extreme** (<8km): Active thunderstorm, dangerous conditions
+- Comprehensive statistics:
+  - Total strikes and strike density (per sq km)
+  - Strikes per minute rate
+  - Distance to nearest strike
+  - Average distance of all strikes
+- Strike details:
+  - Polarity (cloud-to-ground vs intra-cloud)
+  - Amplitude in kiloamperes (kA)
+  - Precise timestamp and location
+- Safety recommendations based on proximity
+- Geographic region-optimized data retrieval
+
+**Note:** Data provided by Blitzortung.org, a free community-operated lightning detection network. May have regional coverage variations.
+
+### 11. get_river_conditions (NEW in v1.6.0)
+Monitor river levels and flood status using NOAA and USGS data sources.
+
+**Parameters:**
+- `latitude` (required): Latitude coordinate (-90 to 90)
+- `longitude` (required): Longitude coordinate (-180 to 180)
+- `radius` (optional): Search radius in kilometers (1-500, default: 50)
+
+**Description:**
+Provides comprehensive river and streamflow monitoring for flood safety and recreation planning. Automatically finds the nearest river gauges within the specified radius and reports current water levels, flood stages, and flow rates. Uses NOAA National Water Prediction Service (NWPS) for gauge locations and USGS Water Services for real-time streamflow data.
+
+**Examples:**
+```
+"What are the river conditions near St. Louis?" (latitude: 38.6270, longitude: -90.1994)
+"Check for flooding on the Mississippi River"
+"Is the river level safe for kayaking?"
+"Show me nearby river gauge readings"
+```
+
+**Returns:**
+- Nearest river gauges with current water levels
+- Flood stage thresholds (action, minor, moderate, major)
+- Current flood status and forecast
+- Streamflow data (cubic feet per second)
+- Distance to each gauge from query location
+- River and location names
+- Safety assessment for recreation
+- Historical context (flood crests if available)
+
+**Note:** US coverage only. Data provided by NOAA National Water Prediction Service and USGS Water Services.
+
+### 12. get_wildfire_info (NEW in v1.6.0)
+Monitor active wildfires and fire perimeters for safety and evacuation planning.
+
+**Parameters:**
+- `latitude` (required): Latitude coordinate (-90 to 90)
+- `longitude` (required): Longitude coordinate (-180 to 180)
+- `radius` (optional): Search radius in kilometers (1-500, default: 100)
+
+**Description:**
+Provides critical wildfire monitoring and safety information using NIFC (National Interagency Fire Center) data. Reports active wildfires and prescribed burns within the specified radius, including fire size, containment status, and proximity-based safety assessments. Essential for residents in fire-prone regions and outdoor activity planning.
+
+**Examples:**
+```
+"Are there any wildfires near Los Angeles?" (latitude: 34.0522, longitude: -118.2437)
+"Check for active fires in Colorado"
+"How close is the nearest wildfire?"
+"Show me fire perimeters and containment status"
+```
+
+**Returns:**
+- Active wildfire locations within search radius
+- Fire size in acres and hectares
+- Containment percentage with visual indicator
+- Distance from query location to each fire
+- Discovery date and days active
+- Fire type (Wildfire vs Prescribed Fire)
+- Location details (state, county, city)
+- 4-level safety assessment:
+  - **EXTREME DANGER** (<5km): Evacuate if advised
+  - **HIGH ALERT** (5-25km): Prepare for evacuation
+  - **CAUTION** (25-50km): Monitor conditions
+  - **AWARENESS** (>50km): Stay informed
+- Evacuation recommendations and safety guidance
+
+**Note:** Data from NIFC WFIGS (Wildland Fire Interagency Geospatial Services). Always consult official sources for evacuation orders at https://inciweb.nwcg.gov/
+
 ## Error Handling & Service Status
 
 ### Enhanced Error Messages
@@ -655,7 +869,7 @@ Use the `check_service_status` tool to proactively verify API availability:
 
 ### Automated Test Suite
 
-This project includes a comprehensive test suite with 722 automated tests:
+This project includes a comprehensive test suite with 1,042 automated tests:
 
 ```bash
 # Run all tests
@@ -672,14 +886,14 @@ npm run test:ui
 ```
 
 **Test Coverage:**
-- **722 tests** across unit and integration test suites (29 new tests in v1.2.1)
-- **100% coverage** on critical utilities (cache, validation, units, errors, normals, snow, timezone)
-- **54% overall coverage** with focus on reliability and security
-- All tests execute in ~1 second
+- **1,042 tests** across unit and integration test suites (111 new tests in v1.6.0)
+- **100% coverage** on critical utilities (cache, validation, units, errors, normals, snow, timezone, distance, geohash, security)
+- **100% pass rate** with comprehensive security and boundary validation
+- All tests execute in ~2 seconds
 
 **Test Categories:**
-- **Unit Tests** (427 tests) - Cache, validation, units, errors, config, retry logic, normals, snow, timezone
-- **Integration Tests** (19 tests) - Error recovery scenarios, service status checks
+- **Unit Tests** (965 tests) - Cache, validation, units, errors, config, retry logic, normals, snow, timezone, distance, security, geohash
+- **Integration Tests** (77 tests) - Error recovery, service status checks, safety & hazards features
 
 ### Quick API Connectivity Test
 

package/dist/config/tools.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Tool configuration for Weather MCP Server
+ *
+ * Supports both presets and individual tool control for flexible configuration.
+ *
+ * Usage examples:
+ * - ENABLED_TOOLS=basic                    # Only basic weather tools
+ * - ENABLED_TOOLS=full                     # All tools except experimental
+ * - ENABLED_TOOLS=basic,+air_quality       # Basic tools + air quality
+ * - ENABLED_TOOLS=all,-marine              # All tools except marine
+ * - ENABLED_TOOLS=forecast,current,alerts  # Specific tools only
+ */
+/**
+ * Available tool names in the Weather MCP Server
+ */
+export type ToolName = 'get_forecast' | 'get_current_conditions' | 'get_alerts' | 'get_historical_weather' | 'check_service_status' | 'search_location' | 'get_air_quality' | 'get_marine_conditions' | 'get_weather_imagery' | 'get_lightning_activity' | 'get_river_conditions' | 'get_wildfire_info';
+/**
+ * Tool configuration singleton
+ */
+declare class ToolConfig {
+    private enabledTools;
+    constructor();
+    /**
+     * Check if a specific tool is enabled
+     */
+    isEnabled(tool: ToolName): boolean;
+    /**
+     * Get all enabled tools
+     */
+    getEnabledTools(): ToolName[];
+    /**
+     * Get available presets
+     */
+    static getPresets(): Record<string, ToolName[]>;
+    /**
+     * Get available tool aliases
+     */
+    static getAliases(): Record<string, ToolName>;
+}
+export declare const toolConfig: ToolConfig;
+export declare const PRESETS: Record<string, ToolName[]>;
+export declare const ALIASES: Record<string, ToolName>;
+export {};
+//# sourceMappingURL=tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/config/tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,cAAc,GACd,wBAAwB,GACxB,YAAY,GACZ,wBAAwB,GACxB,sBAAsB,GACtB,iBAAiB,GACjB,iBAAiB,GACjB,uBAAuB,GACvB,qBAAqB,GACrB,wBAAwB,GACxB,sBAAsB,GACtB,mBAAmB,CAAC;AAoNxB;;GAEG;AACH,cAAM,UAAU;IACd,OAAO,CAAC,YAAY,CAAgB;;IAapC;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO;IAIlC;;OAEG;IACH,eAAe,IAAI,QAAQ,EAAE;IAI7B;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC;IAI/C;;OAEG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC;CAG9C;AAGD,eAAO,MAAM,UAAU,YAAmB,CAAC;AAG3C,eAAO,MAAM,OAAO,4BAAe,CAAC;AACpC,eAAO,MAAM,OAAO,0BAAe,CAAC"}

package/dist/config/tools.js

@@ -0,0 +1,256 @@
+/**
+ * Tool configuration for Weather MCP Server
+ *
+ * Supports both presets and individual tool control for flexible configuration.
+ *
+ * Usage examples:
+ * - ENABLED_TOOLS=basic                    # Only basic weather tools
+ * - ENABLED_TOOLS=full                     # All tools except experimental
+ * - ENABLED_TOOLS=basic,+air_quality       # Basic tools + air quality
+ * - ENABLED_TOOLS=all,-marine              # All tools except marine
+ * - ENABLED_TOOLS=forecast,current,alerts  # Specific tools only
+ */
+/**
+ * Tool presets for easy configuration
+ */
+const TOOL_PRESETS = {
+    // Essential weather tools - minimal overhead
+    basic: [
+        'get_forecast',
+        'get_current_conditions',
+        'get_alerts',
+        'search_location',
+        'check_service_status'
+    ],
+    // Basic + historical data
+    standard: [
+        'get_forecast',
+        'get_current_conditions',
+        'get_alerts',
+        'get_historical_weather',
+        'search_location',
+        'check_service_status'
+    ],
+    // Standard + environmental data
+    full: [
+        'get_forecast',
+        'get_current_conditions',
+        'get_alerts',
+        'get_historical_weather',
+        'search_location',
+        'check_service_status',
+        'get_air_quality'
+    ],
+    // All available tools
+    all: [
+        'get_forecast',
+        'get_current_conditions',
+        'get_alerts',
+        'get_historical_weather',
+        'check_service_status',
+        'search_location',
+        'get_air_quality',
+        'get_marine_conditions',
+        'get_weather_imagery',
+        'get_lightning_activity',
+        'get_river_conditions',
+        'get_wildfire_info'
+    ]
+};
+/**
+ * Tool aliases for convenience (short names)
+ */
+const TOOL_ALIASES = {
+    'forecast': 'get_forecast',
+    'current': 'get_current_conditions',
+    'conditions': 'get_current_conditions',
+    'alerts': 'get_alerts',
+    'warnings': 'get_alerts',
+    'historical': 'get_historical_weather',
+    'history': 'get_historical_weather',
+    'status': 'check_service_status',
+    'location': 'search_location',
+    'search': 'search_location',
+    'air_quality': 'get_air_quality',
+    'aqi': 'get_air_quality',
+    'marine': 'get_marine_conditions',
+    'ocean': 'get_marine_conditions',
+    'waves': 'get_marine_conditions',
+    'imagery': 'get_weather_imagery',
+    'radar': 'get_weather_imagery',
+    'satellite': 'get_weather_imagery',
+    'lightning': 'get_lightning_activity',
+    'strikes': 'get_lightning_activity',
+    'thunderstorm': 'get_lightning_activity',
+    'river': 'get_river_conditions',
+    'rivers': 'get_river_conditions',
+    'flood': 'get_river_conditions',
+    'streamflow': 'get_river_conditions',
+    'wildfire': 'get_wildfire_info',
+    'wildfires': 'get_wildfire_info',
+    'fire': 'get_wildfire_info',
+    'fires': 'get_wildfire_info',
+    'smoke': 'get_wildfire_info'
+};
+/**
+ * Parse the ENABLED_TOOLS environment variable
+ *
+ * Supports:
+ * - Presets: "basic", "standard", "full", "all"
+ * - Individual tools: "forecast,current,alerts"
+ * - Adding to presets: "basic,+air_quality"
+ * - Removing from presets: "all,-marine"
+ * - Combinations: "standard,+air_quality,-alerts"
+ *
+ * @param envValue The ENABLED_TOOLS environment variable value
+ * @returns Set of enabled tool names
+ */
+function parseEnabledTools(envValue) {
+    // Default to "basic" preset if not specified
+    if (!envValue) {
+        return new Set(TOOL_PRESETS.basic);
+    }
+    const parts = envValue.toLowerCase().split(',').map(s => s.trim()).filter(Boolean);
+    let enabledTools = new Set();
+    let hasBaseSet = false;
+    for (const part of parts) {
+        // Handle additions (+tool)
+        if (part.startsWith('+')) {
+            const toolName = part.slice(1);
+            const resolvedTool = resolveToolName(toolName);
+            if (resolvedTool) {
+                enabledTools.add(resolvedTool);
+            }
+            else {
+                console.warn(`Unknown tool to add: "${toolName}"`);
+            }
+            continue;
+        }
+        // Handle removals (-tool)
+        if (part.startsWith('-')) {
+            const toolName = part.slice(1);
+            const resolvedTool = resolveToolName(toolName);
+            if (resolvedTool) {
+                enabledTools.delete(resolvedTool);
+            }
+            else {
+                console.warn(`Unknown tool to remove: "${toolName}"`);
+            }
+            continue;
+        }
+        // Handle presets
+        if (part in TOOL_PRESETS) {
+            if (!hasBaseSet) {
+                // First preset replaces the default
+                enabledTools = new Set(TOOL_PRESETS[part]);
+                hasBaseSet = true;
+            }
+            else {
+                // Additional presets merge with existing
+                for (const tool of TOOL_PRESETS[part]) {
+                    enabledTools.add(tool);
+                }
+            }
+            continue;
+        }
+        // Handle individual tools
+        const resolvedTool = resolveToolName(part);
+        if (resolvedTool) {
+            if (!hasBaseSet) {
+                // First individual tool creates a new set
+                enabledTools = new Set([resolvedTool]);
+                hasBaseSet = true;
+            }
+            else {
+                enabledTools.add(resolvedTool);
+            }
+        }
+        else {
+            console.warn(`Unknown tool or preset: "${part}"`);
+        }
+    }
+    return enabledTools;
+}
+/**
+ * Resolve a tool name or alias to the canonical tool name
+ * @param name Tool name or alias
+ * @returns Canonical tool name or undefined if not found
+ */
+function resolveToolName(name) {
+    const normalized = name.toLowerCase();
+    // Check if it's already a canonical name
+    if (isToolName(normalized)) {
+        return normalized;
+    }
+    // Check aliases
+    if (normalized in TOOL_ALIASES) {
+        return TOOL_ALIASES[normalized];
+    }
+    return undefined;
+}
+/**
+ * Type guard to check if a string is a valid ToolName
+ */
+function isToolName(name) {
+    const validTools = [
+        'get_forecast',
+        'get_current_conditions',
+        'get_alerts',
+        'get_historical_weather',
+        'check_service_status',
+        'search_location',
+        'get_air_quality',
+        'get_marine_conditions',
+        'get_weather_imagery',
+        'get_lightning_activity',
+        'get_river_conditions',
+        'get_wildfire_info'
+    ];
+    return validTools.includes(name);
+}
+/**
+ * Tool configuration singleton
+ */
+class ToolConfig {
+    enabledTools;
+    constructor() {
+        this.enabledTools = parseEnabledTools(process.env.ENABLED_TOOLS);
+        // Log enabled tools for debugging
+        if (this.enabledTools.size > 0) {
+            console.error(`[ToolConfig] Enabled tools (${this.enabledTools.size}): ${Array.from(this.enabledTools).join(', ')}`);
+        }
+        else {
+            console.error('[ToolConfig] Warning: No tools enabled!');
+        }
+    }
+    /**
+     * Check if a specific tool is enabled
+     */
+    isEnabled(tool) {
+        return this.enabledTools.has(tool);
+    }
+    /**
+     * Get all enabled tools
+     */
+    getEnabledTools() {
+        return Array.from(this.enabledTools);
+    }
+    /**
+     * Get available presets
+     */
+    static getPresets() {
+        return { ...TOOL_PRESETS };
+    }
+    /**
+     * Get available tool aliases
+     */
+    static getAliases() {
+        return { ...TOOL_ALIASES };
+    }
+}
+// Export singleton instance
+export const toolConfig = new ToolConfig();
+// Export preset definitions for documentation
+export const PRESETS = TOOL_PRESETS;
+export const ALIASES = TOOL_ALIASES;
+//# sourceMappingURL=tools.js.map

package/dist/config/tools.js.map

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

package/dist/errors/ApiError.d.ts

@@ -6,11 +6,11 @@
  */
 export declare class ApiError extends Error {
     readonly statusCode: number;
-    readonly service: 'NOAA' | 'OpenMeteo' | 'NCEI';
+    readonly service: 'NOAA' | 'OpenMeteo' | 'NCEI' | 'RainViewer';
     readonly userMessage: string;
     readonly helpLinks: string[];
     readonly isRetryable: boolean;
-    constructor(message: string, statusCode: number, service: 'NOAA' | 'OpenMeteo' | 'NCEI', userMessage: string, helpLinks?: string[], isRetryable?: boolean);
+    constructor(message: string, statusCode: number, service: 'NOAA' | 'OpenMeteo' | 'NCEI' | 'RainViewer', userMessage: string, helpLinks?: string[], isRetryable?: boolean);
     /**
      * Format error for display to user
      */
@@ -21,13 +21,13 @@ export declare class ApiError extends Error {
  */
 export declare class RateLimitError extends ApiError {
     readonly retryAfter?: number;
-    constructor(service: 'NOAA' | 'OpenMeteo' | 'NCEI', messageOrRetryAfter?: string | number, retryAfter?: number);
+    constructor(service: 'NOAA' | 'OpenMeteo' | 'NCEI' | 'RainViewer', messageOrRetryAfter?: string | number, retryAfter?: number);
 }
 /**
  * Service unavailable error - API is down or timing out
  */
 export declare class ServiceUnavailableError extends ApiError {
-    constructor(service: 'NOAA' | 'OpenMeteo' | 'NCEI', messageOrError?: string | Error, originalError?: Error);
+    constructor(service: 'NOAA' | 'OpenMeteo' | 'NCEI' | 'RainViewer', messageOrError?: string | Error, originalError?: Error);
 }
 /**
  * Invalid location error - coordinates not supported or out of range
@@ -35,13 +35,13 @@ export declare class ServiceUnavailableError extends ApiError {
 export declare class InvalidLocationError extends ApiError {
     readonly latitude?: number;
     readonly longitude?: number;
-    constructor(service: 'NOAA' | 'OpenMeteo' | 'NCEI', message: string, latitude?: number, longitude?: number);
+    constructor(service: 'NOAA' | 'OpenMeteo' | 'NCEI' | 'RainViewer', 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' | 'NCEI', message: string);
+    constructor(service: 'NOAA' | 'OpenMeteo' | 'NCEI' | 'RainViewer', message: string);
 }
 /**
  * Validation error - invalid input parameters

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

@@ -1 +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,GAAG,MAAM,CAAC;IACvD,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,GAAG,MAAM,EACtC,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,GAAG,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAiC/G;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,aAAa,CAAC,EAAE,KAAK;CAiC3G;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,GAAG,MAAM,EACtC,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,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM;CAYpE;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"}
+{"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,GAAG,MAAM,GAAG,YAAY,CAAC;IACtE,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,GAAG,MAAM,GAAG,YAAY,EACrD,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,GAAG,MAAM,GAAG,YAAY,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM;CAiC9H;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;gBACvC,OAAO,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,YAAY,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,aAAa,CAAC,EAAE,KAAK;CAkC1H;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,GAAG,MAAM,GAAG,YAAY,EACrD,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,GAAG,MAAM,GAAG,YAAY,EAAE,OAAO,EAAE,MAAM;CAYnF;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

@@ -86,7 +86,8 @@ export class ServiceUnavailableError extends ApiError {
         const userMessage = message || `The ${service} weather service is temporarily unavailable. Please try again in a few minutes.`;
         const helpLink = service === 'NOAA' ? 'https://www.weather.gov/'
             : service === 'NCEI' ? 'https://www.ncei.noaa.gov/'
-                : 'https://open-meteo.com/';
+                : service === 'RainViewer' ? 'https://www.rainviewer.com/'
+                    : 'https://open-meteo.com/';
         super(`${service} API is currently unavailable`, 503, service, userMessage, [helpLink], true // Retryable
         );
         this.name = 'ServiceUnavailableError';