clodds 1.1.0

package/dist/weather/noaa.js

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * NOAA Weather API Client
+ *
+ * Free weather data from the National Weather Service (no API key required).
+ * Provides forecasts, current conditions, and historical data.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NOAAClient = exports.CITY_COORDINATES = void 0;
+exports.getNOAAClient = getNOAAClient;
+const logger_1 = require("../utils/logger");
+// City coordinates for major US cities
+exports.CITY_COORDINATES = {
+    'new york': { lat: 40.7128, lon: -74.0060, name: 'New York, NY' },
+    'nyc': { lat: 40.7128, lon: -74.0060, name: 'New York, NY' },
+    'los angeles': { lat: 34.0522, lon: -118.2437, name: 'Los Angeles, CA' },
+    'la': { lat: 34.0522, lon: -118.2437, name: 'Los Angeles, CA' },
+    'chicago': { lat: 41.8781, lon: -87.6298, name: 'Chicago, IL' },
+    'houston': { lat: 29.7604, lon: -95.3698, name: 'Houston, TX' },
+    'phoenix': { lat: 33.4484, lon: -112.0740, name: 'Phoenix, AZ' },
+    'philadelphia': { lat: 39.9526, lon: -75.1652, name: 'Philadelphia, PA' },
+    'san antonio': { lat: 29.4241, lon: -98.4936, name: 'San Antonio, TX' },
+    'san diego': { lat: 32.7157, lon: -117.1611, name: 'San Diego, CA' },
+    'dallas': { lat: 32.7767, lon: -96.7970, name: 'Dallas, TX' },
+    'san jose': { lat: 37.3382, lon: -121.8863, name: 'San Jose, CA' },
+    'austin': { lat: 30.2672, lon: -97.7431, name: 'Austin, TX' },
+    'jacksonville': { lat: 30.3322, lon: -81.6557, name: 'Jacksonville, FL' },
+    'fort worth': { lat: 32.7555, lon: -97.3308, name: 'Fort Worth, TX' },
+    'columbus': { lat: 39.9612, lon: -82.9988, name: 'Columbus, OH' },
+    'charlotte': { lat: 35.2271, lon: -80.8431, name: 'Charlotte, NC' },
+    'san francisco': { lat: 37.7749, lon: -122.4194, name: 'San Francisco, CA' },
+    'sf': { lat: 37.7749, lon: -122.4194, name: 'San Francisco, CA' },
+    'indianapolis': { lat: 39.7684, lon: -86.1581, name: 'Indianapolis, IN' },
+    'seattle': { lat: 47.6062, lon: -122.3321, name: 'Seattle, WA' },
+    'denver': { lat: 39.7392, lon: -104.9903, name: 'Denver, CO' },
+    'washington': { lat: 38.9072, lon: -77.0369, name: 'Washington, DC' },
+    'dc': { lat: 38.9072, lon: -77.0369, name: 'Washington, DC' },
+    'boston': { lat: 42.3601, lon: -71.0589, name: 'Boston, MA' },
+    'nashville': { lat: 36.1627, lon: -86.7816, name: 'Nashville, TN' },
+    'detroit': { lat: 42.3314, lon: -83.0458, name: 'Detroit, MI' },
+    'oklahoma city': { lat: 35.4676, lon: -97.5164, name: 'Oklahoma City, OK' },
+    'portland': { lat: 45.5152, lon: -122.6784, name: 'Portland, OR' },
+    'las vegas': { lat: 36.1699, lon: -115.1398, name: 'Las Vegas, NV' },
+    'memphis': { lat: 35.1495, lon: -90.0490, name: 'Memphis, TN' },
+    'louisville': { lat: 38.2527, lon: -85.7585, name: 'Louisville, KY' },
+    'baltimore': { lat: 39.2904, lon: -76.6122, name: 'Baltimore, MD' },
+    'milwaukee': { lat: 43.0389, lon: -87.9065, name: 'Milwaukee, WI' },
+    'albuquerque': { lat: 35.0844, lon: -106.6504, name: 'Albuquerque, NM' },
+    'tucson': { lat: 32.2226, lon: -110.9747, name: 'Tucson, AZ' },
+    'fresno': { lat: 36.7378, lon: -119.7871, name: 'Fresno, CA' },
+    'sacramento': { lat: 38.5816, lon: -121.4944, name: 'Sacramento, CA' },
+    'atlanta': { lat: 33.7490, lon: -84.3880, name: 'Atlanta, GA' },
+    'miami': { lat: 25.7617, lon: -80.1918, name: 'Miami, FL' },
+    'minneapolis': { lat: 44.9778, lon: -93.2650, name: 'Minneapolis, MN' },
+    'cleveland': { lat: 41.4993, lon: -81.6944, name: 'Cleveland, OH' },
+    'new orleans': { lat: 29.9511, lon: -90.0715, name: 'New Orleans, LA' },
+    'tampa': { lat: 27.9506, lon: -82.4572, name: 'Tampa, FL' },
+    'pittsburgh': { lat: 40.4406, lon: -79.9959, name: 'Pittsburgh, PA' },
+    'cincinnati': { lat: 39.1031, lon: -84.5120, name: 'Cincinnati, OH' },
+    'st louis': { lat: 38.6270, lon: -90.1994, name: 'St. Louis, MO' },
+    'orlando': { lat: 28.5383, lon: -81.3792, name: 'Orlando, FL' },
+};
+const NOAA_BASE_URL = 'https://api.weather.gov';
+const USER_AGENT = 'Clodds-Weather/1.0 (contact@clodds.ai)';
+// ============================================================================
+// NOAA API Client
+// ============================================================================
+class NOAAClient {
+    pointCache = new Map();
+    forecastCache = new Map();
+    cacheTTL = 15 * 60 * 1000; // 15 minutes
+    /**
+     * Get grid point data for coordinates
+     */
+    async getPoint(lat, lon) {
+        const cacheKey = `${lat.toFixed(4)},${lon.toFixed(4)}`;
+        const cached = this.pointCache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < this.cacheTTL) {
+            return cached.data;
+        }
+        try {
+            const url = `${NOAA_BASE_URL}/points/${lat.toFixed(4)},${lon.toFixed(4)}`;
+            const response = await fetch(url, {
+                headers: { 'User-Agent': USER_AGENT },
+            });
+            if (!response.ok) {
+                throw new Error(`NOAA API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const point = {
+                gridId: data.properties.gridId,
+                gridX: data.properties.gridX,
+                gridY: data.properties.gridY,
+                forecastUrl: data.properties.forecast,
+                forecastHourlyUrl: data.properties.forecastHourly,
+                observationStationsUrl: data.properties.observationStations,
+                city: data.properties.relativeLocation?.properties?.city,
+                state: data.properties.relativeLocation?.properties?.state,
+                timezone: data.properties.timeZone,
+            };
+            this.pointCache.set(cacheKey, { data: point, timestamp: Date.now() });
+            return point;
+        }
+        catch (error) {
+            logger_1.logger.error('[NOAA] Failed to get point data:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get 7-day forecast for coordinates
+     */
+    async getForecast(lat, lon) {
+        const cacheKey = `forecast:${lat.toFixed(4)},${lon.toFixed(4)}`;
+        const cached = this.forecastCache.get(cacheKey);
+        if (cached && Date.now() - cached.timestamp < this.cacheTTL) {
+            return cached.data;
+        }
+        const point = await this.getPoint(lat, lon);
+        try {
+            const response = await fetch(point.forecastUrl, {
+                headers: { 'User-Agent': USER_AGENT },
+            });
+            if (!response.ok) {
+                throw new Error(`NOAA API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const location = point.city && point.state
+                ? `${point.city}, ${point.state}`
+                : `${lat.toFixed(2)}, ${lon.toFixed(2)}`;
+            const forecast = {
+                location,
+                generatedAt: data.properties.generatedAt,
+                periods: data.properties.periods,
+            };
+            this.forecastCache.set(cacheKey, { data: forecast, timestamp: Date.now() });
+            return forecast;
+        }
+        catch (error) {
+            logger_1.logger.error('[NOAA] Failed to get forecast:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get hourly forecast for coordinates
+     */
+    async getHourlyForecast(lat, lon) {
+        const point = await this.getPoint(lat, lon);
+        try {
+            const response = await fetch(point.forecastHourlyUrl, {
+                headers: { 'User-Agent': USER_AGENT },
+            });
+            if (!response.ok) {
+                throw new Error(`NOAA API error: ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            const location = point.city && point.state
+                ? `${point.city}, ${point.state}`
+                : `${lat.toFixed(2)}, ${lon.toFixed(2)}`;
+            return {
+                location,
+                generatedAt: data.properties.generatedAt,
+                periods: data.properties.periods,
+            };
+        }
+        catch (error) {
+            logger_1.logger.error('[NOAA] Failed to get hourly forecast:', error);
+            throw error;
+        }
+    }
+    /**
+     * Get current observations from nearest station
+     */
+    async getCurrentObservation(lat, lon) {
+        const point = await this.getPoint(lat, lon);
+        try {
+            // Get observation stations
+            const stationsResponse = await fetch(point.observationStationsUrl, {
+                headers: { 'User-Agent': USER_AGENT },
+            });
+            if (!stationsResponse.ok)
+                return null;
+            const stationsData = await stationsResponse.json();
+            const stations = stationsData.features || [];
+            if (stations.length === 0)
+                return null;
+            // Get latest observation from first (nearest) station
+            const stationId = stations[0].properties.stationIdentifier;
+            const obsUrl = `${NOAA_BASE_URL}/stations/${stationId}/observations/latest`;
+            const obsResponse = await fetch(obsUrl, {
+                headers: { 'User-Agent': USER_AGENT },
+            });
+            if (!obsResponse.ok)
+                return null;
+            const obsData = await obsResponse.json();
+            const props = obsData.properties;
+            return {
+                station: stationId,
+                timestamp: props.timestamp,
+                temperature: props.temperature?.value
+                    ? this.celsiusToFahrenheit(props.temperature.value)
+                    : 0,
+                temperatureUnit: 'F',
+                humidity: props.relativeHumidity?.value || 0,
+                windSpeed: props.windSpeed?.value
+                    ? Math.round(props.windSpeed.value * 2.237) // m/s to mph
+                    : 0,
+                windDirection: this.degreesToDirection(props.windDirection?.value || 0),
+                description: props.textDescription || 'Unknown',
+                precipitationLastHour: props.precipitationLastHour?.value,
+            };
+        }
+        catch (error) {
+            logger_1.logger.error('[NOAA] Failed to get current observation:', error);
+            return null;
+        }
+    }
+    /**
+     * Get forecast by city name
+     */
+    async getForecastByCity(cityName) {
+        const normalizedCity = cityName.toLowerCase().trim();
+        const coords = exports.CITY_COORDINATES[normalizedCity];
+        if (!coords) {
+            throw new Error(`Unknown city: ${cityName}. Try a major US city like "New York" or "Los Angeles".`);
+        }
+        return this.getForecast(coords.lat, coords.lon);
+    }
+    /**
+     * Get precipitation probability for a specific date
+     */
+    async getPrecipitationProbability(lat, lon, targetDate) {
+        const forecast = await this.getForecast(lat, lon);
+        for (const period of forecast.periods) {
+            const periodStart = new Date(period.startTime);
+            const periodEnd = new Date(period.endTime);
+            if (targetDate >= periodStart && targetDate < periodEnd) {
+                return {
+                    probability: period.probabilityOfPrecipitation.value || 0,
+                    period,
+                };
+            }
+        }
+        return null;
+    }
+    /**
+     * Get temperature forecast for a specific date
+     */
+    async getTemperatureForecast(lat, lon, targetDate) {
+        const forecast = await this.getForecast(lat, lon);
+        const targetDay = targetDate.toDateString();
+        const periodsForDay = forecast.periods.filter(p => {
+            const periodDate = new Date(p.startTime).toDateString();
+            return periodDate === targetDay;
+        });
+        if (periodsForDay.length === 0)
+            return null;
+        const temps = periodsForDay.map(p => p.temperature);
+        return {
+            high: Math.max(...temps),
+            low: Math.min(...temps),
+            periods: periodsForDay,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // Helpers
+    // --------------------------------------------------------------------------
+    celsiusToFahrenheit(celsius) {
+        return Math.round((celsius * 9) / 5 + 32);
+    }
+    degreesToDirection(degrees) {
+        const directions = ['N', 'NE', 'E', 'SE', 'S', 'SW', 'W', 'NW'];
+        const index = Math.round(degrees / 45) % 8;
+        return directions[index];
+    }
+}
+exports.NOAAClient = NOAAClient;
+// ============================================================================
+// Factory
+// ============================================================================
+let noaaClientInstance = null;
+function getNOAAClient() {
+    if (!noaaClientInstance) {
+        noaaClientInstance = new NOAAClient();
+    }
+    return noaaClientInstance;
+}
+//# sourceMappingURL=noaa.js.map

package/dist/weather/noaa.js.map

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

package/dist/web/index.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Web Module - Clawdbot-style web interface
+ *
+ * Features:
+ * - HTTP server with WebSocket support
+ * - WebChat interface
+ * - Control panel UI
+ * - REST API endpoints
+ * - Real-time updates
+ * - Session management
+ */
+import { EventEmitter } from 'events';
+export interface ServerConfig {
+    port?: number;
+    host?: string;
+    ssl?: {
+        cert: string;
+        key: string;
+    };
+    cors?: boolean | string[];
+    auth?: AuthConfig;
+}
+export interface AuthConfig {
+    type: 'basic' | 'bearer' | 'none';
+    users?: Record<string, string>;
+    tokens?: string[];
+}
+export interface WebSession {
+    id: string;
+    userId?: string;
+    createdAt: Date;
+    lastActivity: Date;
+    data: Record<string, unknown>;
+}
+export interface ApiRoute {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    handler: (req: ApiRequest, res: ApiResponse) => Promise<void> | void;
+    auth?: boolean;
+}
+export interface ApiRequest {
+    method: string;
+    path: string;
+    params: Record<string, string>;
+    query: Record<string, string>;
+    body: unknown;
+    headers: Record<string, string>;
+    session?: WebSession;
+}
+export interface ApiResponse {
+    status(code: number): ApiResponse;
+    json(data: unknown): void;
+    text(data: string): void;
+    html(data: string): void;
+    send(data: Buffer | string): void;
+    redirect(url: string): void;
+    setHeader(name: string, value: string): ApiResponse;
+}
+export interface WebMessage {
+    type: string;
+    payload: unknown;
+    timestamp: number;
+}
+export declare class SessionManager {
+    private sessions;
+    private timeout;
+    constructor(timeoutMs?: number);
+    create(userId?: string): WebSession;
+    get(id: string): WebSession | undefined;
+    delete(id: string): void;
+    private cleanup;
+    private generateId;
+}
+export declare class WebServer extends EventEmitter {
+    private server;
+    private wss;
+    private config;
+    private routes;
+    private sessions;
+    private clients;
+    constructor(config?: ServerConfig);
+    /** Add an API route */
+    route(route: ApiRoute): this;
+    /** Add GET route */
+    get(path: string, handler: ApiRoute['handler'], auth?: boolean): this;
+    /** Add POST route */
+    post(path: string, handler: ApiRoute['handler'], auth?: boolean): this;
+    /** Add PUT route */
+    put(path: string, handler: ApiRoute['handler'], auth?: boolean): this;
+    /** Add DELETE route */
+    delete(path: string, handler: ApiRoute['handler'], auth?: boolean): this;
+    /** Start the server */
+    start(): Promise<void>;
+    /** Stop the server */
+    stop(): Promise<void>;
+    /** Broadcast message to all WebSocket clients */
+    broadcast(message: WebMessage): void;
+    /** Send message to specific client */
+    sendTo(clientId: string, message: WebMessage): void;
+    /** Get session manager */
+    getSessionManager(): SessionManager;
+    private handleRequest;
+    private handleWebSocket;
+    private findRoute;
+    private parseBody;
+    private checkAuth;
+    private serveStatic;
+}
+/** Create and configure a web server */
+export declare function createWebServer(config?: ServerConfig): WebServer;
+/** Quick start a web chat server */
+export declare function startChat(port?: number): Promise<WebServer>;