@dangahagan/weather-mcp 0.1.2 → 0.4.0

package/dist/utils/validation.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Input validation utilities for API parameters
+ * Provides runtime type checking and sanitization
+ */
+/**
+ * Validate that latitude is a valid number within range
+ * @param lat - Latitude value to validate
+ * @throws {Error} If latitude is invalid
+ */
+export declare function validateLatitude(lat: unknown): asserts lat is number;
+/**
+ * Validate that longitude is a valid number within range
+ * @param lon - Longitude value to validate
+ * @throws {Error} If longitude is invalid
+ */
+export declare function validateLongitude(lon: unknown): asserts lon is number;
+/**
+ * Validate coordinate pair
+ * @param args - Arguments object potentially containing coordinates
+ * @returns Validated coordinates
+ * @throws {Error} If coordinates are invalid
+ */
+export declare function validateCoordinates(args: unknown): {
+    latitude: number;
+    longitude: number;
+};
+/**
+ * Validate a positive integer within optional range
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @param min - Minimum allowed value (inclusive)
+ * @param max - Maximum allowed value (inclusive)
+ * @returns Validated number
+ * @throws {Error} If value is invalid
+ */
+export declare function validatePositiveInteger(value: unknown, name: string, min?: number, max?: number): number;
+/**
+ * Validate a boolean value
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @returns Validated boolean
+ * @throws {Error} If value is invalid
+ */
+export declare function validateBoolean(value: unknown, name: string): boolean;
+/**
+ * Validate a date string in ISO format
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @returns Validated date string
+ * @throws {Error} If value is invalid
+ */
+export declare function validateDateString(value: unknown, name: string): string;
+/**
+ * Validate forecast days parameter
+ * @param args - Arguments object potentially containing days parameter
+ * @returns Validated days value (defaults to 7 if not provided)
+ * @throws {Error} If days parameter is invalid
+ */
+export declare function validateForecastDays(args: unknown): number;
+/**
+ * Validate granularity parameter
+ * @param value - Value to validate
+ * @returns Validated granularity ('daily' or 'hourly')
+ * @throws {Error} If value is invalid
+ */
+export declare function validateGranularity(value: unknown): 'daily' | 'hourly';
+/**
+ * Validate optional boolean with default
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @param defaultValue - Default value if undefined
+ * @returns Validated boolean
+ * @throws {Error} If value is invalid
+ */
+export declare function validateOptionalBoolean(value: unknown, name: string, defaultValue: boolean): boolean;
+/**
+ * Validate historical weather parameters
+ * @param args - Arguments object
+ * @returns Validated parameters
+ * @throws {Error} If parameters are invalid
+ */
+export declare function validateHistoricalWeatherParams(args: unknown): {
+    latitude: number;
+    longitude: number;
+    start_date: string;
+    end_date: string;
+    limit?: number;
+};
+//# sourceMappingURL=validation.d.ts.map

package/dist/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAOpE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAOrE;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAW1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAU,EACf,GAAG,GAAE,MAAgC,GACpC,MAAM,CAWR;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAKrE;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAYvE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAY1D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CActE;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,OAAO,GACpB,OAAO,CAKT;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,OAAO,GAAG;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAoCA"}

package/dist/utils/validation.js

@@ -0,0 +1,177 @@
+/**
+ * Input validation utilities for API parameters
+ * Provides runtime type checking and sanitization
+ */
+import { FormatConstants } from '../config/displayThresholds.js';
+/**
+ * Validate that latitude is a valid number within range
+ * @param lat - Latitude value to validate
+ * @throws {Error} If latitude is invalid
+ */
+export function validateLatitude(lat) {
+    if (typeof lat !== 'number' || !Number.isFinite(lat)) {
+        throw new Error(`Invalid latitude: must be a finite number, received ${typeof lat}`);
+    }
+    if (lat < -90 || lat > 90) {
+        throw new Error(`Invalid latitude: ${lat}. Must be between -90 and 90.`);
+    }
+}
+/**
+ * Validate that longitude is a valid number within range
+ * @param lon - Longitude value to validate
+ * @throws {Error} If longitude is invalid
+ */
+export function validateLongitude(lon) {
+    if (typeof lon !== 'number' || !Number.isFinite(lon)) {
+        throw new Error(`Invalid longitude: must be a finite number, received ${typeof lon}`);
+    }
+    if (lon < -180 || lon > 180) {
+        throw new Error(`Invalid longitude: ${lon}. Must be between -180 and 180.`);
+    }
+}
+/**
+ * Validate coordinate pair
+ * @param args - Arguments object potentially containing coordinates
+ * @returns Validated coordinates
+ * @throws {Error} If coordinates are invalid
+ */
+export function validateCoordinates(args) {
+    if (typeof args !== 'object' || args === null) {
+        throw new Error('Invalid arguments: expected object with latitude and longitude');
+    }
+    const { latitude, longitude } = args;
+    validateLatitude(latitude);
+    validateLongitude(longitude);
+    return { latitude, longitude };
+}
+/**
+ * Validate a positive integer within optional range
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @param min - Minimum allowed value (inclusive)
+ * @param max - Maximum allowed value (inclusive)
+ * @returns Validated number
+ * @throws {Error} If value is invalid
+ */
+export function validatePositiveInteger(value, name, min = 1, max = Number.MAX_SAFE_INTEGER) {
+    if (typeof value !== 'number' || !Number.isFinite(value)) {
+        throw new Error(`Invalid ${name}: must be a finite number, received ${typeof value}`);
+    }
+    if (!Number.isInteger(value)) {
+        throw new Error(`Invalid ${name}: must be an integer, received ${value}`);
+    }
+    if (value < min || value > max) {
+        throw new Error(`Invalid ${name}: ${value}. Must be between ${min} and ${max}.`);
+    }
+    return value;
+}
+/**
+ * Validate a boolean value
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @returns Validated boolean
+ * @throws {Error} If value is invalid
+ */
+export function validateBoolean(value, name) {
+    if (typeof value !== 'boolean') {
+        throw new Error(`Invalid ${name}: must be a boolean, received ${typeof value}`);
+    }
+    return value;
+}
+/**
+ * Validate a date string in ISO format
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @returns Validated date string
+ * @throws {Error} If value is invalid
+ */
+export function validateDateString(value, name) {
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid ${name}: must be a string, received ${typeof value}`);
+    }
+    // Check if it's a valid date format (YYYY-MM-DD or ISO 8601)
+    const date = new Date(value);
+    if (isNaN(date.getTime())) {
+        throw new Error(`Invalid ${name}: "${value}" is not a valid date format`);
+    }
+    return value;
+}
+/**
+ * Validate forecast days parameter
+ * @param args - Arguments object potentially containing days parameter
+ * @returns Validated days value (defaults to 7 if not provided)
+ * @throws {Error} If days parameter is invalid
+ */
+export function validateForecastDays(args) {
+    if (typeof args !== 'object' || args === null) {
+        return FormatConstants.defaultForecastDays;
+    }
+    const { days } = args;
+    if (days === undefined) {
+        return FormatConstants.defaultForecastDays;
+    }
+    return validatePositiveInteger(days, 'days', 1, FormatConstants.maxForecastDays);
+}
+/**
+ * Validate granularity parameter
+ * @param value - Value to validate
+ * @returns Validated granularity ('daily' or 'hourly')
+ * @throws {Error} If value is invalid
+ */
+export function validateGranularity(value) {
+    if (value === undefined) {
+        return 'daily'; // default
+    }
+    if (typeof value !== 'string') {
+        throw new Error(`Invalid granularity: must be a string, received ${typeof value}`);
+    }
+    if (value !== 'daily' && value !== 'hourly') {
+        throw new Error(`Invalid granularity: "${value}". Must be either "daily" or "hourly".`);
+    }
+    return value;
+}
+/**
+ * Validate optional boolean with default
+ * @param value - Value to validate
+ * @param name - Parameter name for error messages
+ * @param defaultValue - Default value if undefined
+ * @returns Validated boolean
+ * @throws {Error} If value is invalid
+ */
+export function validateOptionalBoolean(value, name, defaultValue) {
+    if (value === undefined) {
+        return defaultValue;
+    }
+    return validateBoolean(value, name);
+}
+/**
+ * Validate historical weather parameters
+ * @param args - Arguments object
+ * @returns Validated parameters
+ * @throws {Error} If parameters are invalid
+ */
+export function validateHistoricalWeatherParams(args) {
+    if (typeof args !== 'object' || args === null) {
+        throw new Error('Invalid arguments: expected object with coordinates and date range');
+    }
+    const { latitude, longitude, start_date, end_date, limit } = args;
+    validateLatitude(latitude);
+    validateLongitude(longitude);
+    const validatedStartDate = validateDateString(start_date, 'start_date');
+    const validatedEndDate = validateDateString(end_date, 'end_date');
+    // Ensure start_date is before end_date
+    if (new Date(validatedStartDate) > new Date(validatedEndDate)) {
+        throw new Error('Invalid date range: start_date must be before or equal to end_date');
+    }
+    const result = {
+        latitude,
+        longitude,
+        start_date: validatedStartDate,
+        end_date: validatedEndDate,
+    };
+    if (limit !== undefined) {
+        result.limit = validatePositiveInteger(limit, 'limit', 1, FormatConstants.maxHistoricalLimit);
+    }
+    return result;
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dangahagan/weather-mcp",
-  "version": "0.1.2",
+  "version": "0.4.0",
   "description": "MCP (Model Context Protocol) server providing weather data from NOAA and Open-Meteo APIs. Supports forecasts, current conditions, and historical weather data (1940-present) with no API keys required.",
   "mcpName": "io.github.dgahagan/weather-mcp",
   "main": "dist/index.js",
@@ -21,7 +21,12 @@
     "dev": "tsx src/index.ts",
     "start": "node dist/index.js",
     "prepublishOnly": "npm run build",
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "test:ui": "vitest --ui",
+    "audit": "npm audit --audit-level=moderate",
+    "audit:fix": "npm audit fix"
   },
   "keywords": [
     "mcp",
@@ -56,7 +61,9 @@
   },
   "devDependencies": {
     "@types/node": "^24.10.0",
+    "@vitest/coverage-v8": "^4.0.7",
     "tsx": "^4.20.6",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.7"
   }
 }