@jablum/weather-mcp 1.7.0

package/dist/services/geocoding.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Multi-Service Geocoding Service
+ * Implements automatic fallback strategy across multiple geocoding providers
+ * for maximum reliability and coverage
+ */
+/**
+ * Geocoding result with standardized format across all providers
+ */
+export interface GeocodingResult {
+    name: string;
+    display_name: string;
+    latitude: number;
+    longitude: number;
+    country?: string;
+    country_code?: string;
+    admin1?: string;
+    admin2?: string;
+    timezone?: string;
+    elevation?: number;
+    population?: number;
+    feature_code?: string;
+    confidence: 'high' | 'medium' | 'low';
+    source: 'census' | 'nominatim' | 'openmeteo';
+}
+/**
+ * Multi-Service Geocoding Service
+ * Automatically tries multiple providers in order with intelligent fallback
+ */
+export declare class GeocodingService {
+    private census;
+    private nominatim;
+    private openmeteo;
+    constructor();
+    /**
+     * Detect if query is likely a US location
+     * Helps optimize provider selection
+     */
+    private isLikelyUSLocation;
+    /**
+     * Geocode a location query with automatic multi-service fallback
+     *
+     * Strategy:
+     * 1. If likely US: Try Census.gov first (fast, authoritative)
+     * 2. Try Nominatim (worldwide, good natural language support)
+     * 3. Fallback to Open-Meteo (reliable, detailed metadata)
+     *
+     * @param query - Location search query (e.g., "Seattle, WA", "Paris, France")
+     * @param limit - Maximum number of results to return
+     * @returns Array of geocoding results from first successful provider
+     */
+    geocode(query: string, limit?: number): Promise<GeocodingResult[]>;
+    /**
+     * Get service information for debugging
+     */
+    getServiceInfo(): string;
+}
+//# sourceMappingURL=geocoding.d.ts.map

package/dist/services/geocoding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocoding.d.ts","sourceRoot":"","sources":["../../src/services/geocoding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,WAAW,CAAC;CAC9C;AAkTD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,SAAS,CAAoB;;IAQrC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IA0C1B;;;;;;;;;;;OAWG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC;IA0D3E;;OAEG;IACH,cAAc,IAAI,MAAM;CAOzB"}

package/dist/services/geocoding.js

@@ -0,0 +1,393 @@
+/**
+ * Multi-Service Geocoding Service
+ * Implements automatic fallback strategy across multiple geocoding providers
+ * for maximum reliability and coverage
+ */
+import axios from 'axios';
+import { DataNotFoundError, RateLimitError, ServiceUnavailableError } from '../errors/ApiError.js';
+import { logger } from '../utils/logger.js';
+/**
+ * Rate limiter for controlling request frequency per provider
+ */
+class RateLimiter {
+    lastRequestTime = 0;
+    minInterval; // milliseconds between requests
+    constructor(requestsPerSecond) {
+        this.minInterval = 1000 / requestsPerSecond;
+    }
+    async throttle() {
+        const now = Date.now();
+        const timeSinceLastRequest = now - this.lastRequestTime;
+        if (timeSinceLastRequest < this.minInterval) {
+            const delay = this.minInterval - timeSinceLastRequest;
+            await new Promise(resolve => setTimeout(resolve, delay));
+        }
+        this.lastRequestTime = Date.now();
+    }
+}
+/**
+ * Census.gov Geocoding Provider
+ * Best for: US locations (cities, states, addresses)
+ * Coverage: United States only
+ * Rate limit: No strict limit (but we throttle to be respectful)
+ */
+class CensusGovProvider {
+    name = 'Census.gov';
+    client;
+    rateLimiter;
+    constructor() {
+        this.client = axios.create({
+            baseURL: 'https://geocoding.geo.census.gov/geocoder',
+            timeout: 10000,
+            headers: {
+                'Accept': 'application/json'
+            }
+        });
+        // Rate limit to 5 requests/second to be respectful
+        this.rateLimiter = new RateLimiter(5);
+    }
+    async geocode(query, limit) {
+        await this.rateLimiter.throttle();
+        try {
+            logger.debug(`Census.gov geocode: "${query}"`);
+            const response = await this.client.get('/locations/onelineaddress', {
+                params: {
+                    address: query,
+                    benchmark: 'Public_AR_Current',
+                    format: 'json'
+                }
+            });
+            if (!response.data?.result?.addressMatches || response.data.result.addressMatches.length === 0) {
+                logger.debug('Census.gov: No results found');
+                return [];
+            }
+            const matches = response.data.result.addressMatches;
+            const results = [];
+            for (let i = 0; i < Math.min(matches.length, limit); i++) {
+                const match = matches[i];
+                const coords = match.coordinates;
+                if (!coords || coords.x === undefined || coords.y === undefined) {
+                    continue;
+                }
+                // Census.gov uses longitude, latitude (x, y) order
+                const result = {
+                    name: match.matchedAddress || query,
+                    display_name: match.matchedAddress || query,
+                    latitude: coords.y,
+                    longitude: coords.x,
+                    country: 'United States',
+                    country_code: 'US',
+                    admin1: match.addressComponents?.state,
+                    admin2: match.addressComponents?.county,
+                    confidence: 'high', // Census.gov is authoritative for US locations
+                    source: 'census'
+                };
+                results.push(result);
+            }
+            logger.debug(`Census.gov: Found ${results.length} result(s)`);
+            return results;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.code === 'ECONNABORTED') {
+                    throw new ServiceUnavailableError('OpenMeteo', 'Census.gov geocoding service timed out');
+                }
+                if (error.response?.status === 429) {
+                    throw new RateLimitError('OpenMeteo', 'Census.gov geocoding rate limit exceeded');
+                }
+            }
+            logger.debug(`Census.gov error: ${error instanceof Error ? error.message : 'Unknown'}`);
+            return []; // Return empty array for fallback
+        }
+    }
+}
+/**
+ * Nominatim (OpenStreetMap) Provider
+ * Best for: Worldwide locations, landmarks, natural language queries
+ * Coverage: Global
+ * Rate limit: 1 request/second (strictly enforced)
+ */
+class NominatimProvider {
+    name = 'Nominatim';
+    client;
+    rateLimiter;
+    constructor() {
+        this.client = axios.create({
+            baseURL: 'https://nominatim.openstreetmap.org',
+            timeout: 10000,
+            headers: {
+                'User-Agent': '(weather-mcp, github.com/weather-mcp/weather-mcp)',
+                'Accept': 'application/json'
+            }
+        });
+        // Strict 1 request/second rate limit as per Nominatim usage policy
+        this.rateLimiter = new RateLimiter(1);
+    }
+    async geocode(query, limit) {
+        await this.rateLimiter.throttle();
+        try {
+            logger.debug(`Nominatim geocode: "${query}"`);
+            const response = await this.client.get('/search', {
+                params: {
+                    q: query,
+                    format: 'json',
+                    addressdetails: 1,
+                    limit: Math.min(limit, 50), // Nominatim max is 50
+                    'accept-language': 'en'
+                }
+            });
+            if (!response.data || response.data.length === 0) {
+                logger.debug('Nominatim: No results found');
+                return [];
+            }
+            const results = response.data.map((item) => {
+                const address = item.address || {};
+                // Determine confidence based on importance and type
+                let confidence = 'medium';
+                if (item.importance > 0.6)
+                    confidence = 'high';
+                else if (item.importance < 0.3)
+                    confidence = 'low';
+                return {
+                    name: item.name || item.display_name,
+                    display_name: item.display_name,
+                    latitude: parseFloat(item.lat),
+                    longitude: parseFloat(item.lon),
+                    country: address.country,
+                    country_code: address.country_code?.toUpperCase(),
+                    admin1: address.state || address.region,
+                    admin2: address.county,
+                    feature_code: this.mapTypeToFeatureCode(item.type),
+                    confidence,
+                    source: 'nominatim'
+                };
+            });
+            logger.debug(`Nominatim: Found ${results.length} result(s)`);
+            return results;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.code === 'ECONNABORTED') {
+                    throw new ServiceUnavailableError('OpenMeteo', 'Nominatim geocoding service timed out');
+                }
+                if (error.response?.status === 429) {
+                    throw new RateLimitError('OpenMeteo', 'Nominatim geocoding rate limit exceeded (1 req/sec limit)');
+                }
+            }
+            logger.debug(`Nominatim error: ${error instanceof Error ? error.message : 'Unknown'}`);
+            return []; // Return empty array for fallback
+        }
+    }
+    /**
+     * Map Nominatim type to GeoNames-style feature code
+     */
+    mapTypeToFeatureCode(type) {
+        const typeMap = {
+            'city': 'PPL',
+            'town': 'PPL',
+            'village': 'PPL',
+            'administrative': 'ADM1',
+            'country': 'PCLI',
+            'state': 'ADM1',
+            'county': 'ADM2',
+            'island': 'ISL',
+            'airport': 'AIRP',
+            'park': 'PRK',
+            'lake': 'LAKE'
+        };
+        return typeMap[type.toLowerCase()] || type.toUpperCase();
+    }
+}
+/**
+ * Open-Meteo Geocoding Provider (existing implementation as fallback)
+ * Best for: Reliable global coverage with detailed metadata
+ * Coverage: Global
+ * Rate limit: Part of 10,000 requests/day shared limit
+ */
+class OpenMeteoProvider {
+    name = 'Open-Meteo';
+    client;
+    constructor() {
+        this.client = axios.create({
+            baseURL: 'https://geocoding-api.open-meteo.com/v1',
+            timeout: 10000,
+            headers: {
+                'Accept': 'application/json'
+            }
+        });
+    }
+    async geocode(query, limit) {
+        try {
+            logger.debug(`Open-Meteo geocode: "${query}"`);
+            const response = await this.client.get('/search', {
+                params: {
+                    name: query,
+                    count: Math.min(limit, 100),
+                    language: 'en',
+                    format: 'json'
+                }
+            });
+            if (!response.data?.results || response.data.results.length === 0) {
+                logger.debug('Open-Meteo: No results found');
+                return [];
+            }
+            const results = response.data.results.map((item) => ({
+                name: item.name,
+                display_name: [item.name, item.admin1, item.admin2, item.country]
+                    .filter(Boolean)
+                    .join(', '),
+                latitude: item.latitude,
+                longitude: item.longitude,
+                country: item.country,
+                country_code: item.country_code,
+                admin1: item.admin1,
+                admin2: item.admin2,
+                timezone: item.timezone,
+                elevation: item.elevation,
+                population: item.population,
+                feature_code: item.feature_code,
+                confidence: 'medium', // Open-Meteo is reliable but not authoritative
+                source: 'openmeteo'
+            }));
+            logger.debug(`Open-Meteo: Found ${results.length} result(s)`);
+            return results;
+        }
+        catch (error) {
+            if (axios.isAxiosError(error)) {
+                if (error.code === 'ECONNABORTED') {
+                    throw new ServiceUnavailableError('OpenMeteo', 'Open-Meteo geocoding service timed out');
+                }
+                if (error.response?.status === 429) {
+                    throw new RateLimitError('OpenMeteo', 'Open-Meteo geocoding rate limit exceeded');
+                }
+            }
+            logger.debug(`Open-Meteo error: ${error instanceof Error ? error.message : 'Unknown'}`);
+            return []; // Return empty array for fallback
+        }
+    }
+}
+/**
+ * Multi-Service Geocoding Service
+ * Automatically tries multiple providers in order with intelligent fallback
+ */
+export class GeocodingService {
+    census;
+    nominatim;
+    openmeteo;
+    constructor() {
+        this.census = new CensusGovProvider();
+        this.nominatim = new NominatimProvider();
+        this.openmeteo = new OpenMeteoProvider();
+    }
+    /**
+     * Detect if query is likely a US location
+     * Helps optimize provider selection
+     */
+    isLikelyUSLocation(query) {
+        const lowerQuery = query.toLowerCase();
+        // State abbreviations
+        const stateAbbreviations = [
+            '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'
+        ];
+        // Check for state abbreviations (e.g., "Seattle, WA")
+        for (const state of stateAbbreviations) {
+            if (lowerQuery.includes(`, ${state}`) || lowerQuery.endsWith(` ${state}`)) {
+                return true;
+            }
+        }
+        // Check for explicit country mentions (US or USA)
+        if (lowerQuery.includes('usa') ||
+            lowerQuery.includes('u.s.a') ||
+            lowerQuery.includes('united states')) {
+            return true;
+        }
+        // Check for explicit non-US country mentions
+        const nonUSKeywords = [
+            'france', 'germany', 'japan', 'china', 'uk', 'england',
+            'canada', 'mexico', 'australia', 'india', 'brazil'
+        ];
+        for (const keyword of nonUSKeywords) {
+            if (lowerQuery.includes(keyword)) {
+                return false;
+            }
+        }
+        // Default: Assume might be US (we'll try Census.gov first, then fallback)
+        return null; // null means "uncertain"
+    }
+    /**
+     * Geocode a location query with automatic multi-service fallback
+     *
+     * Strategy:
+     * 1. If likely US: Try Census.gov first (fast, authoritative)
+     * 2. Try Nominatim (worldwide, good natural language support)
+     * 3. Fallback to Open-Meteo (reliable, detailed metadata)
+     *
+     * @param query - Location search query (e.g., "Seattle, WA", "Paris, France")
+     * @param limit - Maximum number of results to return
+     * @returns Array of geocoding results from first successful provider
+     */
+    async geocode(query, limit = 5) {
+        const isLikelyUS = this.isLikelyUSLocation(query);
+        const providers = [];
+        // Build provider order based on query characteristics
+        if (isLikelyUS === true) {
+            // Definitely US - try Census.gov first
+            providers.push(this.census, this.nominatim, this.openmeteo);
+            logger.debug('Provider strategy: US-optimized (Census → Nominatim → Open-Meteo)');
+        }
+        else if (isLikelyUS === false) {
+            // Definitely non-US - skip Census.gov
+            providers.push(this.nominatim, this.openmeteo);
+            logger.debug('Provider strategy: International (Nominatim → Open-Meteo)');
+        }
+        else {
+            // Uncertain - try all providers
+            providers.push(this.census, this.nominatim, this.openmeteo);
+            logger.debug('Provider strategy: Uncertain (Census → Nominatim → Open-Meteo)');
+        }
+        const errors = [];
+        // Try each provider in order
+        for (const provider of providers) {
+            try {
+                logger.debug(`Trying provider: ${provider.name}`);
+                const results = await provider.geocode(query, limit);
+                if (results.length > 0) {
+                    logger.info(`Geocoding successful via ${provider.name}: ${results.length} result(s)`);
+                    return results;
+                }
+                logger.debug(`${provider.name}: No results found`);
+                errors.push(`${provider.name}: No results found`);
+            }
+            catch (error) {
+                const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+                logger.debug(`${provider.name} failed: ${errorMsg}`);
+                errors.push(`${provider.name}: ${errorMsg}`);
+                // Continue to next provider
+                continue;
+            }
+        }
+        // All providers failed or returned no results
+        throw new DataNotFoundError('OpenMeteo', `No locations found matching "${query}".\n\n` +
+            `Tried ${providers.length} provider(s): ${errors.join('; ')}\n\n` +
+            `Suggestions:\n` +
+            `- Add more detail (e.g., "Paris, France" instead of "Paris")\n` +
+            `- Check spelling\n` +
+            `- Use a nearby major city\n` +
+            `- Try providing coordinates directly (latitude, longitude)`);
+    }
+    /**
+     * Get service information for debugging
+     */
+    getServiceInfo() {
+        return `Multi-Service Geocoding:\n` +
+            `- Census.gov (US locations, high accuracy)\n` +
+            `- Nominatim/OpenStreetMap (worldwide, 1 req/sec limit)\n` +
+            `- Open-Meteo (worldwide fallback)\n` +
+            `Automatic fallback strategy based on query characteristics`;
+    }
+}
+//# sourceMappingURL=geocoding.js.map

package/dist/services/geocoding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geocoding.js","sourceRoot":"","sources":["../../src/services/geocoding.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AA8B5C;;GAEG;AACH,MAAM,WAAW;IACP,eAAe,GAAW,CAAC,CAAC;IAC5B,WAAW,CAAS,CAAC,gCAAgC;IAE7D,YAAY,iBAAyB;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,iBAAiB,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,oBAAoB,GAAG,GAAG,GAAG,IAAI,CAAC,eAAe,CAAC;QAExD,IAAI,oBAAoB,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,GAAG,oBAAoB,CAAC;YACtD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAC3D,CAAC;QAED,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACpC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,iBAAiB;IACrB,IAAI,GAAG,YAAY,CAAC;IACZ,MAAM,CAAgB;IACtB,WAAW,CAAc;IAEjC;QACE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,2CAA2C;YACpD,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;QAEH,mDAAmD;QACnD,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,KAAa;QACxC,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QAElC,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAAC;YAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,2BAA2B,EAAE;gBAClE,MAAM,EAAE;oBACN,OAAO,EAAE,KAAK;oBACd,SAAS,EAAE,mBAAmB;oBAC9B,MAAM,EAAE,MAAM;iBACf;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/F,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;gBAC7C,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;YACpD,MAAM,OAAO,GAAsB,EAAE,CAAC;YAEtC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACzD,MAAM,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;gBACzB,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC;gBAEjC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;oBAChE,SAAS;gBACX,CAAC;gBAED,mDAAmD;gBACnD,MAAM,MAAM,GAAoB;oBAC9B,IAAI,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK;oBACnC,YAAY,EAAE,KAAK,CAAC,cAAc,IAAI,KAAK;oBAC3C,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAClB,SAAS,EAAE,MAAM,CAAC,CAAC;oBACnB,OAAO,EAAE,eAAe;oBACxB,YAAY,EAAE,IAAI;oBAClB,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAAE,KAAK;oBACtC,MAAM,EAAE,KAAK,CAAC,iBAAiB,EAAE,MAAM;oBACvC,UAAU,EAAE,MAAM,EAAE,+CAA+C;oBACnE,MAAM,EAAE,QAAQ;iBACjB,CAAC;gBAEF,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;YAED,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;YAC9D,OAAO,OAAO,CAAC;QAEjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAClC,MAAM,IAAI,uBAAuB,CAAC,WAAW,EAAE,wCAAwC,CAAC,CAAC;gBAC3F,CAAC;gBACD,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;oBACnC,MAAM,IAAI,cAAc,CAAC,WAAW,EAAE,0CAA0C,CAAC,CAAC;gBACpF,CAAC;YACH,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YACxF,OAAO,EAAE,CAAC,CAAC,kCAAkC;QAC/C,CAAC;IACH,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,iBAAiB;IACrB,IAAI,GAAG,WAAW,CAAC;IACX,MAAM,CAAgB;IACtB,WAAW,CAAc;IAEjC;QACE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,qCAAqC;YAC9C,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,YAAY,EAAE,mDAAmD;gBACjE,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;QAEH,mEAAmE;QACnE,IAAI,CAAC,WAAW,GAAG,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,KAAa;QACxC,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QAElC,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,uBAAuB,KAAK,GAAG,CAAC,CAAC;YAE9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE;gBAChD,MAAM,EAAE;oBACN,CAAC,EAAE,KAAK;oBACR,MAAM,EAAE,MAAM;oBACd,cAAc,EAAE,CAAC;oBACjB,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,sBAAsB;oBAClD,iBAAiB,EAAE,IAAI;iBACxB;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjD,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;gBAC5C,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,OAAO,GAAsB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE;gBACjE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;gBAEnC,oDAAoD;gBACpD,IAAI,UAAU,GAA8B,QAAQ,CAAC;gBACrD,IAAI,IAAI,CAAC,UAAU,GAAG,GAAG;oBAAE,UAAU,GAAG,MAAM,CAAC;qBAC1C,IAAI,IAAI,CAAC,UAAU,GAAG,GAAG;oBAAE,UAAU,GAAG,KAAK,CAAC;gBAEnD,OAAO;oBACL,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,YAAY;oBACpC,YAAY,EAAE,IAAI,CAAC,YAAY;oBAC/B,QAAQ,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;oBAC9B,SAAS,EAAE,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC;oBAC/B,OAAO,EAAE,OAAO,CAAC,OAAO;oBACxB,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,WAAW,EAAE;oBACjD,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM;oBACvC,MAAM,EAAE,OAAO,CAAC,MAAM;oBACtB,YAAY,EAAE,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC;oBAClD,UAAU;oBACV,MAAM,EAAE,WAAW;iBACpB,CAAC;YACJ,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,CAAC,oBAAoB,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;YAC7D,OAAO,OAAO,CAAC;QAEjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAClC,MAAM,IAAI,uBAAuB,CAAC,WAAW,EAAE,uCAAuC,CAAC,CAAC;gBAC1F,CAAC;gBACD,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;oBACnC,MAAM,IAAI,cAAc,CAAC,WAAW,EAAE,2DAA2D,CAAC,CAAC;gBACrG,CAAC;YACH,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,oBAAoB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YACvF,OAAO,EAAE,CAAC,CAAC,kCAAkC;QAC/C,CAAC;IACH,CAAC;IAED;;OAEG;IACK,oBAAoB,CAAC,IAAY;QACvC,MAAM,OAAO,GAA8B;YACzC,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,KAAK;YAChB,gBAAgB,EAAE,MAAM;YACxB,SAAS,EAAE,MAAM;YACjB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,MAAM;YAChB,QAAQ,EAAE,KAAK;YACf,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,MAAM;SACf,CAAC;QAEF,OAAO,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;IAC3D,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,iBAAiB;IACrB,IAAI,GAAG,YAAY,CAAC;IACZ,MAAM,CAAgB;IAE9B;QACE,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;YACzB,OAAO,EAAE,yCAAyC;YAClD,OAAO,EAAE,KAAK;YACd,OAAO,EAAE;gBACP,QAAQ,EAAE,kBAAkB;aAC7B;SACF,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,KAAa;QACxC,IAAI,CAAC;YACH,MAAM,CAAC,KAAK,CAAC,wBAAwB,KAAK,GAAG,CAAC,CAAC;YAE/C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE;gBAChD,MAAM,EAAE;oBACN,IAAI,EAAE,KAAK;oBACX,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC;oBAC3B,QAAQ,EAAE,IAAI;oBACd,MAAM,EAAE,MAAM;iBACf;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClE,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;gBAC7C,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,MAAM,OAAO,GAAsB,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,IAAS,EAAE,EAAE,CAAC,CAAC;gBAC3E,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC;qBAC9D,MAAM,CAAC,OAAO,CAAC;qBACf,IAAI,CAAC,IAAI,CAAC;gBACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,YAAY,EAAE,IAAI,CAAC,YAAY;gBAC/B,UAAU,EAAE,QAAQ,EAAE,+CAA+C;gBACrE,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC,CAAC;YAEJ,MAAM,CAAC,KAAK,CAAC,qBAAqB,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;YAC9D,OAAO,OAAO,CAAC;QAEjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAClC,MAAM,IAAI,uBAAuB,CAAC,WAAW,EAAE,wCAAwC,CAAC,CAAC;gBAC3F,CAAC;gBACD,IAAI,KAAK,CAAC,QAAQ,EAAE,MAAM,KAAK,GAAG,EAAE,CAAC;oBACnC,MAAM,IAAI,cAAc,CAAC,WAAW,EAAE,0CAA0C,CAAC,CAAC;gBACpF,CAAC;YACH,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;YACxF,OAAO,EAAE,CAAC,CAAC,kCAAkC;QAC/C,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAoB;IAC1B,SAAS,CAAoB;IAC7B,SAAS,CAAoB;IAErC;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACtC,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,iBAAiB,EAAE,CAAC;IAC3C,CAAC;IAED;;;OAGG;IACK,kBAAkB,CAAC,KAAa;QACtC,MAAM,UAAU,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAEvC,sBAAsB;QACtB,MAAM,kBAAkB,GAAG;YACzB,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;YAC1D,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;YAC1D,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;YAC1D,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;YAC1D,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;SAC3D,CAAC;QAEF,sDAAsD;QACtD,KAAK,MAAM,KAAK,IAAI,kBAAkB,EAAE,CAAC;YACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,KAAK,EAAE,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,KAAK,EAAE,CAAC,EAAE,CAAC;gBAC1E,OAAO,IAAI,CAAC;YACd,CAAC;QACH,CAAC;QAED,kDAAkD;QAClD,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;YAC1B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;YAC5B,UAAU,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,CAAC;YACzC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,6CAA6C;QAC7C,MAAM,aAAa,GAAG;YACpB,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;YACtD,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ;SACnD,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;YACpC,IAAI,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,0EAA0E;QAC1E,OAAO,IAAW,CAAC,CAAC,yBAAyB;IAC/C,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,QAAgB,CAAC;QAC5C,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAClD,MAAM,SAAS,GAAwB,EAAE,CAAC;QAE1C,sDAAsD;QACtD,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;YACxB,uCAAuC;YACvC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5D,MAAM,CAAC,KAAK,CAAC,mEAAmE,CAAC,CAAC;QACpF,CAAC;aAAM,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;YAChC,sCAAsC;YACtC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,gCAAgC;YAChC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC5D,MAAM,CAAC,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACjF,CAAC;QAED,MAAM,MAAM,GAAa,EAAE,CAAC;QAE5B,6BAA6B;QAC7B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,CAAC,KAAK,CAAC,oBAAoB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;gBAClD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;gBAErD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,CAAC,IAAI,CAAC,4BAA4B,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,YAAY,CAAC,CAAC;oBACtF,OAAO,OAAO,CAAC;gBACjB,CAAC;gBAED,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,oBAAoB,CAAC,CAAC;gBACnD,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,oBAAoB,CAAC,CAAC;YAEpD,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,QAAQ,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;gBAC1E,MAAM,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,YAAY,QAAQ,EAAE,CAAC,CAAC;gBACrD,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC,CAAC;gBAE7C,4BAA4B;gBAC5B,SAAS;YACX,CAAC;QACH,CAAC;QAED,8CAA8C;QAC9C,MAAM,IAAI,iBAAiB,CACzB,WAAW,EACX,gCAAgC,KAAK,QAAQ;YAC7C,SAAS,SAAS,CAAC,MAAM,iBAAiB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM;YACjE,gBAAgB;YAChB,gEAAgE;YAChE,oBAAoB;YACpB,6BAA6B;YAC7B,4DAA4D,CAC7D,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,4BAA4B;YAC5B,8CAA8C;YAC9C,0DAA0D;YAC1D,qCAAqC;YACrC,4DAA4D,CAAC;IACtE,CAAC;CACF"}

package/dist/services/locationStore.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Service for managing saved/favorite locations
+ * Stores locations in ~/.weather-mcp/locations.json
+ */
+import type { SavedLocation, SavedLocationsStore } from '../types/savedLocations.js';
+export declare class LocationStore {
+    private readonly storePath;
+    private readonly storeDir;
+    private cache;
+    constructor(customPath?: string);
+    /**
+     * Ensure the storage directory exists
+     * @private
+     */
+    private ensureDirectoryExists;
+    /**
+     * Load all saved locations from disk
+     */
+    load(): SavedLocationsStore;
+    /**
+     * Save all locations to disk
+     * @private
+     */
+    private save;
+    /**
+     * Get a saved location by alias
+     */
+    get(alias: string): SavedLocation | undefined;
+    /**
+     * Get all saved locations
+     */
+    getAll(): SavedLocationsStore;
+    /**
+     * Save or update a location
+     */
+    set(alias: string, location: Omit<SavedLocation, 'saved_at' | 'updated_at'>): SavedLocation;
+    /**
+     * Remove a saved location
+     */
+    remove(alias: string): boolean;
+    /**
+     * Check if a location exists
+     */
+    has(alias: string): boolean;
+    /**
+     * Get the number of saved locations
+     */
+    count(): number;
+    /**
+     * Clear all saved locations
+     */
+    clear(): void;
+    /**
+     * Get the storage file path
+     */
+    getStorePath(): string;
+    /**
+     * Invalidate the cache, forcing reload on next access
+     */
+    invalidateCache(): void;
+}
+//# sourceMappingURL=locationStore.d.ts.map

package/dist/services/locationStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locationStore.d.ts","sourceRoot":"","sources":["../../src/services/locationStore.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAIrF,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,KAAK,CAAoC;gBAErC,UAAU,CAAC,EAAE,MAAM;IAU/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,IAAI,IAAI,mBAAmB;IA6C3B;;;OAGG;IACH,OAAO,CAAC,IAAI;IAmBZ;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAM7C;;OAEG;IACH,MAAM,IAAI,mBAAmB;IAI7B;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,aAAa;IAoC3F;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAe9B;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAM3B;;OAEG;IACH,KAAK,IAAI,MAAM;IAKf;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,eAAe,IAAI,IAAI;CAGxB"}