weather-cli-16bit/src/utils/validators.js

Command-line weather tool with formatted display and Tokyo Night theme

import { WeatherError, ERROR_CODES } from './errors.js';

const UNSAFE_CHARS_REGEX = /[<>'"{}|\\\^`]/g;
const MAX_LOCATION_LENGTH = 100;

// US state abbreviations
const US_STATE_CODES = new Set([
  'AL', 'AK', 'AZ', 'AR', 'CA', 'CO', 'CT', 'DE', 'FL', 'GA',
  'HI', 'ID', 'IL', 'IN', 'IA', 'KS', 'KY', 'LA', 'ME', 'MD',
  'MA', 'MI', 'MN', 'MS', 'MO', 'MT', 'NE', 'NV', 'NH', 'NJ',
  'NM', 'NY', 'NC', 'ND', 'OH', 'OK', 'OR', 'PA', 'RI', 'SC',
  'SD', 'TN', 'TX', 'UT', 'VT', 'VA', 'WA', 'WV', 'WI', 'WY',
  'DC'
]);

// Major cities that can be searched without country/state
const MAJOR_CITIES = new Set([
  'london', 'paris', 'tokyo', 'beijing', 'moscow', 'berlin', 'madrid', 'rome',
  'amsterdam', 'brussels', 'vienna', 'stockholm', 'oslo', 'copenhagen', 'dublin',
  'lisbon', 'athens', 'prague', 'budapest', 'warsaw', 'bucharest', 'helsinki',
  'sydney', 'melbourne', 'auckland', 'singapore', 'bangkok', 'jakarta', 'manila',
  'delhi', 'mumbai', 'bangalore', 'chennai', 'kolkata', 'hyderabad', 'pune',
  'cairo', 'lagos', 'johannesburg', 'nairobi', 'casablanca', 'tunis', 'accra',
  'dubai', 'istanbul', 'jerusalem', 'tehran', 'baghdad', 'riyadh', 'doha',
  'toronto', 'vancouver', 'montreal', 'ottawa', 'calgary', 'edmonton', 'quebec',
  'new york', 'los angeles', 'chicago', 'houston', 'phoenix', 'philadelphia',
  'san antonio', 'san diego', 'dallas', 'san jose', 'austin', 'jacksonville',
  'fort worth', 'columbus', 'charlotte', 'san francisco', 'indianapolis',
  'seattle', 'denver', 'washington', 'boston', 'el paso', 'nashville',
  'detroit', 'oklahoma city', 'portland', 'las vegas', 'memphis', 'louisville',
  'baltimore', 'milwaukee', 'albuquerque', 'tucson', 'fresno', 'sacramento',
  'kansas city', 'long beach', 'mesa', 'atlanta', 'colorado springs', 'virginia beach',
  'raleigh', 'omaha', 'miami', 'oakland', 'minneapolis', 'tulsa', 'wichita',
  'new orleans', 'arlington'
]);

export function sanitizeLocation(location) {
  if (typeof location !== 'string') {
    throw new WeatherError('Location must be a string', ERROR_CODES.INVALID_INPUT);
  }
  
  return location
    .replace(UNSAFE_CHARS_REGEX, '')
    .trim()
    .slice(0, MAX_LOCATION_LENGTH);
}

export function validateLocation(location) {
  const sanitized = sanitizeLocation(location);

  if (!sanitized) {
    throw new WeatherError('Location cannot be empty', ERROR_CODES.INVALID_INPUT);
  }

  // Check if location contains a comma (City, State/Country format)
  if (sanitized.includes(',')) {
    const parts = sanitized.split(',').map(p => p.trim());

    // Check if second part is a US state code
    if (parts.length === 2 && US_STATE_CODES.has(parts[1].toUpperCase())) {
      // Convert "City, ST" to "City, US" for OpenWeatherMap API
      return `${parts[0]}, US`;
    }

    return sanitized;
  }

  // Allow major cities to be searched without country/state
  const lowerLocation = sanitized.toLowerCase();
  if (MAJOR_CITIES.has(lowerLocation)) {
    return sanitized; // Allow single-word major cities
  }

  throw new WeatherError(
    `Location "${sanitized}" not recognized. For smaller cities, please use: "City, State" or "City, Country"`,
    ERROR_CODES.INVALID_INPUT
  );
}

export function validateCoordinates(lat, lon) {
  const latitude = parseFloat(lat);
  const longitude = parseFloat(lon);
  
  if (isNaN(latitude) || isNaN(longitude)) {
    throw new WeatherError(
      'Invalid coordinates. Both latitude and longitude must be numbers',
      ERROR_CODES.INVALID_INPUT
    );
  }
  
  if (latitude < -90 || latitude > 90) {
    throw new WeatherError(
      'Invalid latitude. Must be between -90 and 90',
      ERROR_CODES.INVALID_INPUT
    );
  }
  
  if (longitude < -180 || longitude > 180) {
    throw new WeatherError(
      'Invalid longitude. Must be between -180 and 180',
      ERROR_CODES.INVALID_INPUT
    );
  }
  
  return { latitude, longitude };
}