@jablum/weather-mcp 1.7.0

package/dist/analytics/config.js

@@ -0,0 +1,172 @@
+/**
+ * Analytics configuration and singleton collector instance
+ * Loads settings from environment variables with secure defaults
+ */
+import crypto from 'crypto';
+import { readFileSync } from 'fs';
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { logger } from '../utils/logger.js';
+import { AnalyticsCollector } from './collector.js';
+// Read version from package.json to ensure single source of truth
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const packageJson = JSON.parse(readFileSync(join(__dirname, '../../package.json'), 'utf-8'));
+/**
+ * Default analytics endpoint (production analytics server)
+ */
+const DEFAULT_ENDPOINT = 'https://analytics.weather-mcp.com/v1/events';
+/**
+ * Validate analytics endpoint for security
+ * Prevents SSRF attacks and enforces HTTPS
+ */
+function validateAnalyticsEndpoint(endpoint) {
+    let url;
+    try {
+        url = new URL(endpoint);
+    }
+    catch (error) {
+        throw new Error('Invalid ANALYTICS_ENDPOINT: must be a valid URL');
+    }
+    // SECURITY: Only allow HTTPS
+    if (url.protocol !== 'https:') {
+        throw new Error('Invalid ANALYTICS_ENDPOINT: must use HTTPS protocol');
+    }
+    // SECURITY: Prevent SSRF to internal networks
+    const hostname = url.hostname.toLowerCase();
+    if (hostname === 'localhost' ||
+        hostname === '127.0.0.1' ||
+        hostname === '::1' ||
+        hostname.startsWith('10.') ||
+        hostname.startsWith('172.16.') ||
+        hostname.startsWith('172.17.') ||
+        hostname.startsWith('172.18.') ||
+        hostname.startsWith('172.19.') ||
+        hostname.startsWith('172.20.') ||
+        hostname.startsWith('172.21.') ||
+        hostname.startsWith('172.22.') ||
+        hostname.startsWith('172.23.') ||
+        hostname.startsWith('172.24.') ||
+        hostname.startsWith('172.25.') ||
+        hostname.startsWith('172.26.') ||
+        hostname.startsWith('172.27.') ||
+        hostname.startsWith('172.28.') ||
+        hostname.startsWith('172.29.') ||
+        hostname.startsWith('172.30.') ||
+        hostname.startsWith('172.31.') ||
+        hostname.startsWith('192.168.') ||
+        hostname.startsWith('169.254.') || // Link-local
+        hostname.endsWith('.local')) {
+        throw new Error('Invalid ANALYTICS_ENDPOINT: cannot point to internal network');
+    }
+    // SECURITY: Require domain name (not IP address)
+    if (/^\d+\.\d+\.\d+\.\d+$/.test(hostname)) {
+        throw new Error('Invalid ANALYTICS_ENDPOINT: IP addresses not allowed, use domain name');
+    }
+    // SECURITY: Validate port range
+    const port = url.port ? parseInt(url.port) : 443;
+    if (port < 1 || port > 65535 || (port !== 443 && port < 1024)) {
+        throw new Error('Invalid ANALYTICS_ENDPOINT: invalid port number');
+    }
+}
+/**
+ * Get or generate analytics salt for session ID hashing
+ * Generates a unique salt per installation and persists it
+ */
+function getOrGenerateAnalyticsSalt() {
+    // Check environment variable first
+    if (process.env.ANALYTICS_SALT) {
+        return process.env.ANALYTICS_SALT;
+    }
+    // Store in user's config directory (NOT in project directory)
+    const configDir = path.join(os.homedir(), '.weather-mcp');
+    const saltFile = path.join(configDir, 'analytics-salt');
+    try {
+        if (fs.existsSync(saltFile)) {
+            return fs.readFileSync(saltFile, 'utf8').trim();
+        }
+    }
+    catch (err) {
+        logger.warn('Could not read analytics salt file', {
+            error: err instanceof Error ? err.message : 'Unknown error',
+        });
+    }
+    // Generate new random salt
+    const newSalt = crypto.randomBytes(32).toString('hex');
+    try {
+        fs.mkdirSync(configDir, { recursive: true, mode: 0o700 });
+        fs.writeFileSync(saltFile, newSalt, { mode: 0o600 });
+        logger.info('Generated new analytics salt');
+    }
+    catch (err) {
+        logger.warn('Could not persist analytics salt', {
+            error: err instanceof Error ? err.message : 'Unknown error',
+        });
+        // Continue with in-memory salt (regenerates each restart)
+    }
+    return newSalt;
+}
+/**
+ * Load and validate analytics configuration from environment variables
+ */
+function loadAnalyticsConfig() {
+    // Analytics disabled by default (users must opt-in)
+    const enabled = process.env.ANALYTICS_ENABLED === 'true';
+    // Analytics level: minimal (default), standard, detailed
+    let level = 'minimal';
+    const levelEnv = process.env.ANALYTICS_LEVEL?.toLowerCase();
+    if (levelEnv === 'standard' || levelEnv === 'detailed') {
+        level = levelEnv;
+    }
+    else if (levelEnv && levelEnv !== 'minimal') {
+        logger.warn('Invalid ANALYTICS_LEVEL, using minimal', {
+            provided: levelEnv,
+            securityEvent: true,
+        });
+    }
+    // Analytics endpoint (custom server or default)
+    const endpoint = process.env.ANALYTICS_ENDPOINT || DEFAULT_ENDPOINT;
+    // Validate endpoint for security
+    try {
+        validateAnalyticsEndpoint(endpoint);
+    }
+    catch (error) {
+        const errorMsg = error instanceof Error ? error.message : 'Unknown error';
+        logger.error(`Invalid ANALYTICS_ENDPOINT configuration: ${errorMsg}`, error instanceof Error ? error : new Error(String(error)));
+        // Disable analytics if endpoint is invalid (fail-safe)
+        return {
+            enabled: false,
+            level: 'minimal',
+            endpoint: DEFAULT_ENDPOINT,
+            version: packageJson.version,
+        };
+    }
+    // Salt for session ID hashing (auto-generated if not provided)
+    const salt = getOrGenerateAnalyticsSalt();
+    const config = {
+        enabled,
+        level,
+        endpoint,
+        version: packageJson.version,
+        salt,
+    };
+    if (enabled) {
+        logger.info('Analytics configuration loaded', {
+            level,
+            endpoint: endpoint === DEFAULT_ENDPOINT ? 'default' : 'custom',
+        });
+    }
+    else {
+        logger.info('Analytics disabled by user preference');
+    }
+    return config;
+}
+/**
+ * Singleton analytics collector instance
+ * Exported for use throughout the application
+ */
+export const analytics = new AnalyticsCollector(loadAnalyticsConfig());
+//# sourceMappingURL=config.js.map

package/dist/analytics/config.js.map

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

package/dist/analytics/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Analytics module - Privacy-first usage tracking
+ * Implements anonymous, opt-out analytics as defined in docs/ANALYTICS_MCP_PLAN.md
+ */
+export { analytics } from './config.js';
+export { withAnalytics, createMetadataExtractor } from './middleware.js';
+export type { AnalyticsLevel, ToolExecutionMetadata } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/analytics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACzE,YAAY,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC"}

package/dist/analytics/index.js

@@ -0,0 +1,7 @@
+/**
+ * Analytics module - Privacy-first usage tracking
+ * Implements anonymous, opt-out analytics as defined in docs/ANALYTICS_MCP_PLAN.md
+ */
+export { analytics } from './config.js';
+export { withAnalytics, createMetadataExtractor } from './middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/analytics/middleware.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Analytics middleware for tool handlers
+ * Automatically tracks tool executions with performance metrics
+ */
+import { ToolExecutionMetadata } from './types.js';
+/**
+ * Wrapper function that adds analytics tracking to tool handlers
+ * Captures execution time, errors, and custom metadata
+ *
+ * @param toolName - Name of the MCP tool being executed
+ * @param handler - The tool handler function to wrap
+ * @param metadataExtractor - Optional function to extract metadata from handler result
+ * @returns Wrapped handler with analytics tracking
+ *
+ * @example
+ * ```typescript
+ * export async function getForecastHandler(args: ForecastArgs) {
+ *   return withAnalytics('get_forecast', async () => {
+ *     // ... handler implementation
+ *     return result;
+ *   }, (result) => ({
+ *     service: result.source,
+ *     cache_hit: result.cached,
+ *   }));
+ * }
+ * ```
+ */
+export declare function withAnalytics<T>(toolName: string, handler: () => Promise<T>, metadataExtractor?: (result: T) => Partial<ToolExecutionMetadata>): Promise<T>;
+/**
+ * Helper to create metadata extractor for common patterns
+ */
+export declare function createMetadataExtractor<T>(extractor: (result: T) => Partial<ToolExecutionMetadata>): (result: T) => Partial<ToolExecutionMetadata>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/analytics/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/analytics/middleware.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,aAAa,CAAC,CAAC,EACnC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,iBAAiB,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,qBAAqB,CAAC,GAChE,OAAO,CAAC,CAAC,CAAC,CAgEZ;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,qBAAqB,CAAC,GACvD,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAE/C"}

package/dist/analytics/middleware.js

@@ -0,0 +1,99 @@
+/**
+ * Analytics middleware for tool handlers
+ * Automatically tracks tool executions with performance metrics
+ */
+import { logger } from '../utils/logger.js';
+import { analytics } from './config.js';
+/**
+ * Wrapper function that adds analytics tracking to tool handlers
+ * Captures execution time, errors, and custom metadata
+ *
+ * @param toolName - Name of the MCP tool being executed
+ * @param handler - The tool handler function to wrap
+ * @param metadataExtractor - Optional function to extract metadata from handler result
+ * @returns Wrapped handler with analytics tracking
+ *
+ * @example
+ * ```typescript
+ * export async function getForecastHandler(args: ForecastArgs) {
+ *   return withAnalytics('get_forecast', async () => {
+ *     // ... handler implementation
+ *     return result;
+ *   }, (result) => ({
+ *     service: result.source,
+ *     cache_hit: result.cached,
+ *   }));
+ * }
+ * ```
+ */
+export async function withAnalytics(toolName, handler, metadataExtractor) {
+    const startTime = Date.now();
+    let metadata = {};
+    try {
+        // Execute the handler
+        const result = await handler();
+        // Calculate response time
+        const responseTimeMs = Date.now() - startTime;
+        metadata.response_time_ms = responseTimeMs;
+        // Extract additional metadata from result if extractor provided
+        if (metadataExtractor) {
+            try {
+                const extracted = metadataExtractor(result);
+                metadata = { ...metadata, ...extracted };
+            }
+            catch (error) {
+                logger.warn('Analytics metadata extraction error', {
+                    tool: toolName,
+                    error: error instanceof Error ? error.message : 'Unknown error',
+                });
+            }
+        }
+        // Track successful execution
+        await analytics.trackToolCall(toolName, 'success', metadata);
+        return result;
+    }
+    catch (error) {
+        // Calculate response time even for errors
+        const responseTimeMs = Date.now() - startTime;
+        metadata.response_time_ms = responseTimeMs;
+        // Categorize error type
+        let errorType = 'unknown';
+        if (error instanceof Error) {
+            const errorName = error.constructor.name;
+            // Map error classes to analytics categories
+            if (errorName.includes('Validation') || errorName.includes('Invalid')) {
+                errorType = 'validation';
+            }
+            else if (errorName.includes('NotFound') || errorName.includes('404')) {
+                errorType = 'not_found';
+            }
+            else if (errorName.includes('RateLimit')) {
+                errorType = 'rate_limit';
+            }
+            else if (errorName.includes('Timeout')) {
+                errorType = 'timeout';
+            }
+            else if (errorName.includes('Network') || errorName.includes('Connection')) {
+                errorType = 'network';
+            }
+            else if (errorName.includes('Service') || errorName.includes('API')) {
+                errorType = 'service_error';
+            }
+            else {
+                errorType = errorName.toLowerCase().replace('error', '').trim() || 'unknown';
+            }
+        }
+        metadata.error_type = errorType;
+        // Track error execution
+        await analytics.trackToolCall(toolName, 'error', metadata);
+        // Re-throw the error to maintain normal error handling flow
+        throw error;
+    }
+}
+/**
+ * Helper to create metadata extractor for common patterns
+ */
+export function createMetadataExtractor(extractor) {
+    return extractor;
+}
+//# sourceMappingURL=middleware.js.map

package/dist/analytics/middleware.js.map

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

package/dist/analytics/transport.d.ts

@@ -0,0 +1,11 @@
+/**
+ * HTTPS transport layer for analytics events
+ * Sends batched events to analytics collection server
+ */
+import { AnalyticsEvent } from './types.js';
+/**
+ * Send batch of analytics events to collection server
+ * Fails silently - analytics should never break the application
+ */
+export declare function sendBatch(events: AnalyticsEvent[], endpoint: string, version: string): Promise<void>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/analytics/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/analytics/transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C;;;GAGG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,cAAc,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC,CAwFf"}

package/dist/analytics/transport.js

@@ -0,0 +1,92 @@
+/**
+ * HTTPS transport layer for analytics events
+ * Sends batched events to analytics collection server
+ */
+import https from 'https';
+import { logger } from '../utils/logger.js';
+/**
+ * Send batch of analytics events to collection server
+ * Fails silently - analytics should never break the application
+ */
+export async function sendBatch(events, endpoint, version) {
+    if (events.length === 0) {
+        return;
+    }
+    return new Promise((resolve, reject) => {
+        const data = JSON.stringify({ events });
+        try {
+            const url = new URL(endpoint);
+            // SECURITY: Only allow HTTPS for analytics transmission (H-1)
+            if (url.protocol !== 'https:') {
+                const error = new Error(`Analytics endpoint must use HTTPS for secure transmission (got ${url.protocol})`);
+                logger.error('Analytics endpoint must use HTTPS', error);
+                reject(error);
+                return;
+            }
+            const options = {
+                hostname: url.hostname,
+                port: url.port || 443,
+                path: url.pathname + url.search,
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Content-Length': Buffer.byteLength(data),
+                    'User-Agent': `weather-mcp/${version}`,
+                },
+                timeout: 5000, // 5 second timeout
+                // SECURITY: Explicitly require valid certificates (H-2)
+                rejectUnauthorized: true,
+            };
+            const req = https.request(options, (res) => {
+                let responseData = '';
+                // Consume response data
+                res.on('data', (chunk) => {
+                    responseData += chunk;
+                });
+                res.on('end', () => {
+                    if (res.statusCode && res.statusCode >= 200 && res.statusCode < 300) {
+                        logger.debug('Analytics batch sent successfully', {
+                            count: events.length,
+                            statusCode: res.statusCode,
+                        });
+                        resolve();
+                    }
+                    else {
+                        const error = new Error(`HTTP ${res.statusCode}`);
+                        logger.warn('Analytics batch failed', {
+                            statusCode: res.statusCode,
+                            count: events.length,
+                            error: error.message,
+                        });
+                        reject(error);
+                    }
+                });
+            });
+            req.on('error', (err) => {
+                logger.warn('Analytics request error', {
+                    error: err.message,
+                    count: events.length,
+                });
+                reject(err);
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                const error = new Error('Request timeout');
+                logger.warn('Analytics request timeout', {
+                    count: events.length,
+                });
+                reject(error);
+            });
+            req.write(data);
+            req.end();
+        }
+        catch (error) {
+            logger.warn('Analytics transport error', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+                count: events.length,
+            });
+            reject(error);
+        }
+    });
+}
+//# sourceMappingURL=transport.js.map

package/dist/analytics/transport.js.map

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

package/dist/analytics/types.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Analytics type definitions for Weather MCP Server
+ * Implements privacy-first analytics as defined in docs/ANALYTICS_MCP_PLAN.md
+ */
+export type AnalyticsLevel = 'minimal' | 'standard' | 'detailed';
+export type EventStatus = 'success' | 'error';
+/**
+ * Base analytics event (minimal level)
+ */
+export interface BaseAnalyticsEvent {
+    version: string;
+    tool: string;
+    status: EventStatus;
+    timestamp_hour: string;
+    analytics_level: AnalyticsLevel;
+    error_type?: string;
+}
+/**
+ * Standard level analytics event
+ * Includes performance and service metrics
+ */
+export interface StandardAnalyticsEvent extends BaseAnalyticsEvent {
+    analytics_level: 'standard' | 'detailed';
+    response_time_ms?: number;
+    service?: 'noaa' | 'openmeteo' | 'nifc' | 'usgs' | 'blitzortung' | 'rainviewer';
+    cache_hit?: boolean;
+    retry_count?: number;
+    country?: string;
+}
+/**
+ * Detailed level analytics event
+ * Includes anonymized workflow patterns
+ */
+export interface DetailedAnalyticsEvent extends StandardAnalyticsEvent {
+    analytics_level: 'detailed';
+    parameters?: Record<string, unknown>;
+    session_id?: string;
+    sequence_number?: number;
+}
+/**
+ * Union type for all analytics events
+ */
+export type AnalyticsEvent = BaseAnalyticsEvent | StandardAnalyticsEvent | DetailedAnalyticsEvent;
+/**
+ * Analytics configuration
+ */
+export interface AnalyticsConfig {
+    enabled: boolean;
+    level: AnalyticsLevel;
+    endpoint: string;
+    version: string;
+    salt?: string;
+}
+/**
+ * Event batch for transport
+ */
+export interface EventBatch {
+    events: AnalyticsEvent[];
+}
+/**
+ * Metadata collected during tool execution
+ */
+export interface ToolExecutionMetadata {
+    response_time_ms?: number;
+    service?: string;
+    cache_hit?: boolean;
+    retry_count?: number;
+    country?: string;
+    parameters?: Record<string, unknown>;
+    error_type?: string;
+    session_id?: string;
+    sequence_number?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/analytics/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AACjE,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,cAAc,CAAC;IAChC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,kBAAkB;IAChE,eAAe,EAAE,UAAU,GAAG,UAAU,CAAC;IACzC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,GAAG,YAAY,CAAC;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,eAAe,EAAE,UAAU,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,kBAAkB,GAClB,sBAAsB,GACtB,sBAAsB,CAAC;AAE3B;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,cAAc,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/analytics/types.js

@@ -0,0 +1,6 @@
+/**
+ * Analytics type definitions for Weather MCP Server
+ * Implements privacy-first analytics as defined in docs/ANALYTICS_MCP_PLAN.md
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/analytics/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/analytics/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/config/api.d.ts

@@ -0,0 +1,30 @@
+/**
+ * API configuration for external weather services
+ *
+ * Most APIs used by this server are free and require no authentication.
+ * Optional API tokens can be configured for enhanced features.
+ */
+/**
+ * NCEI (National Centers for Environmental Information) API token
+ *
+ * OPTIONAL: Get a free token at https://www.ncdc.noaa.gov/cdo-web/token
+ *
+ * Benefits of providing a token:
+ * - Access to official NOAA climate normals for US locations
+ * - More accurate than computed normals from reanalysis data
+ *
+ * If not provided:
+ * - Climate normals will be computed from Open-Meteo historical data
+ * - Works globally (not just US)
+ * - No setup required
+ *
+ * Rate limits with token:
+ * - 5 requests per second
+ * - 10,000 requests per day
+ */
+export declare const NCEI_API_TOKEN: string | undefined;
+/**
+ * Check if NCEI API is available (token configured)
+ */
+export declare function isNCEIAvailable(): boolean;
+//# sourceMappingURL=api.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/config/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,oBAA6B,CAAC;AAEzD;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC"}

package/dist/config/api.js

@@ -0,0 +1,32 @@
+/**
+ * API configuration for external weather services
+ *
+ * Most APIs used by this server are free and require no authentication.
+ * Optional API tokens can be configured for enhanced features.
+ */
+/**
+ * NCEI (National Centers for Environmental Information) API token
+ *
+ * OPTIONAL: Get a free token at https://www.ncdc.noaa.gov/cdo-web/token
+ *
+ * Benefits of providing a token:
+ * - Access to official NOAA climate normals for US locations
+ * - More accurate than computed normals from reanalysis data
+ *
+ * If not provided:
+ * - Climate normals will be computed from Open-Meteo historical data
+ * - Works globally (not just US)
+ * - No setup required
+ *
+ * Rate limits with token:
+ * - 5 requests per second
+ * - 10,000 requests per day
+ */
+export const NCEI_API_TOKEN = process.env.NCEI_API_TOKEN;
+/**
+ * Check if NCEI API is available (token configured)
+ */
+export function isNCEIAvailable() {
+    return !!NCEI_API_TOKEN && NCEI_API_TOKEN.trim().length > 0;
+}
+//# sourceMappingURL=api.js.map

package/dist/config/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/config/api.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;AAEzD;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9D,CAAC"}