clodds 1.1.0

package/dist/feeds/weather-openmeteo/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Open-Meteo Weather Feed
+ *
+ * Free weather API — no API key needed.
+ * Provides current conditions, hourly/daily forecasts, historical data, and alerts.
+ *
+ * API docs: https://open-meteo.com/en/docs
+ */
+import { EventEmitter } from 'events';
+export interface WeatherLocation {
+    name: string;
+    latitude: number;
+    longitude: number;
+    country?: string;
+    timezone?: string;
+}
+export interface CurrentWeather {
+    location: WeatherLocation;
+    temperature: number;
+    feelsLike: number;
+    humidity: number;
+    windSpeed: number;
+    windDirection: number;
+    precipitation: number;
+    weatherCode: number;
+    weatherDescription: string;
+    isDay: boolean;
+    timestamp: Date;
+}
+export interface HourlyForecast {
+    time: Date;
+    temperature: number;
+    humidity: number;
+    precipitation: number;
+    precipitationProbability: number;
+    windSpeed: number;
+    weatherCode: number;
+    weatherDescription: string;
+}
+export interface DailyForecast {
+    date: Date;
+    temperatureMax: number;
+    temperatureMin: number;
+    precipitationSum: number;
+    precipitationProbabilityMax: number;
+    windSpeedMax: number;
+    weatherCode: number;
+    weatherDescription: string;
+    sunrise: Date;
+    sunset: Date;
+}
+export interface HistoricalData {
+    date: Date;
+    temperatureMax: number;
+    temperatureMin: number;
+    temperatureMean: number;
+    precipitationSum: number;
+    windSpeedMax: number;
+}
+export interface OpenMeteoFeed extends EventEmitter {
+    start(): Promise<void>;
+    stop(): void;
+    /** Geocode a location name to coordinates */
+    geocode(name: string): Promise<WeatherLocation[]>;
+    /** Get current weather for a location */
+    getCurrent(lat: number, lon: number): Promise<CurrentWeather>;
+    /** Get hourly forecast (up to 16 days) */
+    getHourlyForecast(lat: number, lon: number, days?: number): Promise<HourlyForecast[]>;
+    /** Get daily forecast (up to 16 days) */
+    getDailyForecast(lat: number, lon: number, days?: number): Promise<DailyForecast[]>;
+    /** Get historical daily data */
+    getHistorical(lat: number, lon: number, startDate: string, endDate: string): Promise<HistoricalData[]>;
+    /** Quick summary: current + 7-day forecast for a named location */
+    getSummary(locationName: string): Promise<{
+        location: WeatherLocation;
+        current: CurrentWeather;
+        daily: DailyForecast[];
+    } | null>;
+}
+export declare function createOpenMeteoFeed(): Promise<OpenMeteoFeed>;

package/dist/feeds/weather-openmeteo/index.js

@@ -0,0 +1,197 @@
+"use strict";
+/**
+ * Open-Meteo Weather Feed
+ *
+ * Free weather API — no API key needed.
+ * Provides current conditions, hourly/daily forecasts, historical data, and alerts.
+ *
+ * API docs: https://open-meteo.com/en/docs
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOpenMeteoFeed = createOpenMeteoFeed;
+const events_1 = require("events");
+const logger_1 = require("../../utils/logger");
+// =============================================================================
+// WMO WEATHER CODES
+// =============================================================================
+const WMO_CODES = {
+    0: 'Clear sky',
+    1: 'Mainly clear',
+    2: 'Partly cloudy',
+    3: 'Overcast',
+    45: 'Foggy',
+    48: 'Rime fog',
+    51: 'Light drizzle',
+    53: 'Moderate drizzle',
+    55: 'Dense drizzle',
+    56: 'Light freezing drizzle',
+    57: 'Dense freezing drizzle',
+    61: 'Slight rain',
+    63: 'Moderate rain',
+    65: 'Heavy rain',
+    66: 'Light freezing rain',
+    67: 'Heavy freezing rain',
+    71: 'Slight snow',
+    73: 'Moderate snow',
+    75: 'Heavy snow',
+    77: 'Snow grains',
+    80: 'Slight rain showers',
+    81: 'Moderate rain showers',
+    82: 'Violent rain showers',
+    85: 'Slight snow showers',
+    86: 'Heavy snow showers',
+    95: 'Thunderstorm',
+    96: 'Thunderstorm with slight hail',
+    99: 'Thunderstorm with heavy hail',
+};
+function describeWeather(code) {
+    return WMO_CODES[code] || `Unknown (${code})`;
+}
+// =============================================================================
+// API HELPERS
+// =============================================================================
+const BASE_URL = 'https://api.open-meteo.com/v1';
+const GEOCODING_URL = 'https://geocoding-api.open-meteo.com/v1';
+const ARCHIVE_URL = 'https://archive-api.open-meteo.com/v1';
+async function fetchJson(url) {
+    const res = await fetch(url);
+    if (!res.ok) {
+        throw new Error(`Open-Meteo API error ${res.status}: ${await res.text()}`);
+    }
+    return res.json();
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+async function createOpenMeteoFeed() {
+    const emitter = new events_1.EventEmitter();
+    let running = false;
+    emitter.start = async () => {
+        running = true;
+        logger_1.logger.info('Open-Meteo weather feed started');
+    };
+    emitter.stop = () => {
+        running = false;
+        logger_1.logger.info('Open-Meteo weather feed stopped');
+    };
+    emitter.geocode = async (name) => {
+        const data = await fetchJson(`${GEOCODING_URL}/search?name=${encodeURIComponent(name)}&count=5&language=en`);
+        return (data.results || []).map(r => ({
+            name: r.name,
+            latitude: r.latitude,
+            longitude: r.longitude,
+            country: r.country,
+            timezone: r.timezone,
+        }));
+    };
+    emitter.getCurrent = async (lat, lon) => {
+        const params = [
+            `latitude=${lat}`,
+            `longitude=${lon}`,
+            'current=temperature_2m,relative_humidity_2m,apparent_temperature,precipitation,weather_code,wind_speed_10m,wind_direction_10m,is_day',
+            'temperature_unit=fahrenheit',
+            'wind_speed_unit=mph',
+            'precipitation_unit=inch',
+        ].join('&');
+        const data = await fetchJson(`${BASE_URL}/forecast?${params}`);
+        const c = data.current;
+        return {
+            location: { name: '', latitude: data.latitude, longitude: data.longitude, timezone: data.timezone },
+            temperature: c.temperature_2m,
+            feelsLike: c.apparent_temperature,
+            humidity: c.relative_humidity_2m,
+            windSpeed: c.wind_speed_10m,
+            windDirection: c.wind_direction_10m,
+            precipitation: c.precipitation,
+            weatherCode: c.weather_code,
+            weatherDescription: describeWeather(c.weather_code),
+            isDay: c.is_day === 1,
+            timestamp: new Date(c.time),
+        };
+    };
+    emitter.getHourlyForecast = async (lat, lon, days = 3) => {
+        const params = [
+            `latitude=${lat}`,
+            `longitude=${lon}`,
+            'hourly=temperature_2m,relative_humidity_2m,precipitation,precipitation_probability,wind_speed_10m,weather_code',
+            'temperature_unit=fahrenheit',
+            'wind_speed_unit=mph',
+            'precipitation_unit=inch',
+            `forecast_days=${Math.min(days, 16)}`,
+        ].join('&');
+        const data = await fetchJson(`${BASE_URL}/forecast?${params}`);
+        const h = data.hourly;
+        return h.time.map((t, i) => ({
+            time: new Date(t),
+            temperature: h.temperature_2m[i],
+            humidity: h.relative_humidity_2m[i],
+            precipitation: h.precipitation[i],
+            precipitationProbability: h.precipitation_probability[i],
+            windSpeed: h.wind_speed_10m[i],
+            weatherCode: h.weather_code[i],
+            weatherDescription: describeWeather(h.weather_code[i]),
+        }));
+    };
+    emitter.getDailyForecast = async (lat, lon, days = 7) => {
+        const params = [
+            `latitude=${lat}`,
+            `longitude=${lon}`,
+            'daily=temperature_2m_max,temperature_2m_min,precipitation_sum,precipitation_probability_max,wind_speed_10m_max,weather_code,sunrise,sunset',
+            'temperature_unit=fahrenheit',
+            'wind_speed_unit=mph',
+            'precipitation_unit=inch',
+            `forecast_days=${Math.min(days, 16)}`,
+        ].join('&');
+        const data = await fetchJson(`${BASE_URL}/forecast?${params}`);
+        const d = data.daily;
+        return d.time.map((t, i) => ({
+            date: new Date(t),
+            temperatureMax: d.temperature_2m_max[i],
+            temperatureMin: d.temperature_2m_min[i],
+            precipitationSum: d.precipitation_sum[i],
+            precipitationProbabilityMax: d.precipitation_probability_max[i],
+            windSpeedMax: d.wind_speed_10m_max[i],
+            weatherCode: d.weather_code[i],
+            weatherDescription: describeWeather(d.weather_code[i]),
+            sunrise: new Date(d.sunrise[i]),
+            sunset: new Date(d.sunset[i]),
+        }));
+    };
+    emitter.getHistorical = async (lat, lon, startDate, endDate) => {
+        const params = [
+            `latitude=${lat}`,
+            `longitude=${lon}`,
+            'daily=temperature_2m_max,temperature_2m_min,temperature_2m_mean,precipitation_sum,wind_speed_10m_max',
+            'temperature_unit=fahrenheit',
+            'wind_speed_unit=mph',
+            'precipitation_unit=inch',
+            `start_date=${startDate}`,
+            `end_date=${endDate}`,
+        ].join('&');
+        const data = await fetchJson(`${ARCHIVE_URL}/archive?${params}`);
+        const d = data.daily;
+        return d.time.map((t, i) => ({
+            date: new Date(t),
+            temperatureMax: d.temperature_2m_max[i],
+            temperatureMin: d.temperature_2m_min[i],
+            temperatureMean: d.temperature_2m_mean[i],
+            precipitationSum: d.precipitation_sum[i],
+            windSpeedMax: d.wind_speed_10m_max[i],
+        }));
+    };
+    emitter.getSummary = async (locationName) => {
+        const locations = await emitter.geocode(locationName);
+        if (locations.length === 0)
+            return null;
+        const loc = locations[0];
+        const [current, daily] = await Promise.all([
+            emitter.getCurrent(loc.latitude, loc.longitude),
+            emitter.getDailyForecast(loc.latitude, loc.longitude, 7),
+        ]);
+        current.location.name = loc.name;
+        current.location.country = loc.country;
+        return { location: loc, current, daily };
+    };
+    return emitter;
+}
+//# sourceMappingURL=index.js.map

package/dist/feeds/weather-openmeteo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/feeds/weather-openmeteo/index.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;AAsJH,kDA4MC;AAhWD,mCAAsC;AACtC,+CAA4C;AAwF5C,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF,MAAM,SAAS,GAA2B;IACxC,CAAC,EAAE,WAAW;IACd,CAAC,EAAE,cAAc;IACjB,CAAC,EAAE,eAAe;IAClB,CAAC,EAAE,UAAU;IACb,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,UAAU;IACd,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,kBAAkB;IACtB,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,wBAAwB;IAC5B,EAAE,EAAE,wBAAwB;IAC5B,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,YAAY;IAChB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,eAAe;IACnB,EAAE,EAAE,YAAY;IAChB,EAAE,EAAE,aAAa;IACjB,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,uBAAuB;IAC3B,EAAE,EAAE,sBAAsB;IAC1B,EAAE,EAAE,qBAAqB;IACzB,EAAE,EAAE,oBAAoB;IACxB,EAAE,EAAE,cAAc;IAClB,EAAE,EAAE,+BAA+B;IACnC,EAAE,EAAE,8BAA8B;CACnC,CAAC;AAEF,SAAS,eAAe,CAAC,IAAY;IACnC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,YAAY,IAAI,GAAG,CAAC;AAChD,CAAC;AAED,gFAAgF;AAChF,cAAc;AACd,gFAAgF;AAEhF,MAAM,QAAQ,GAAG,+BAA+B,CAAC;AACjD,MAAM,aAAa,GAAG,yCAAyC,CAAC;AAChE,MAAM,WAAW,GAAG,uCAAuC,CAAC;AAE5D,KAAK,UAAU,SAAS,CAAI,GAAW;IACrC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,EAAgB,CAAC;AAClC,CAAC;AAED,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEzE,KAAK,UAAU,mBAAmB;IACvC,MAAM,OAAO,GAAG,IAAI,qBAAY,EAAmB,CAAC;IACpD,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,OAAO,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE;QACzB,OAAO,GAAG,IAAI,CAAC;QACf,eAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,GAAG,GAAG,EAAE;QAClB,OAAO,GAAG,KAAK,CAAC;QAChB,eAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,OAAO,CAAC,OAAO,GAAG,KAAK,EAAE,IAAY,EAA8B,EAAE;QACnE,MAAM,IAAI,GAAG,MAAM,SAAS,CAQzB,GAAG,aAAa,gBAAgB,kBAAkB,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAEnF,OAAO,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC,CAAC;IACN,CAAC,CAAC;IAEF,OAAO,CAAC,UAAU,GAAG,KAAK,EAAE,GAAW,EAAE,GAAW,EAA2B,EAAE;QAC/E,MAAM,MAAM,GAAG;YACb,YAAY,GAAG,EAAE;YACjB,aAAa,GAAG,EAAE;YAClB,sIAAsI;YACtI,6BAA6B;YAC7B,qBAAqB;YACrB,yBAAyB;SAC1B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEZ,MAAM,IAAI,GAAG,MAAM,SAAS,CAezB,GAAG,QAAQ,aAAa,MAAM,EAAE,CAAC,CAAC;QAErC,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,OAAO;YACL,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE;YACnG,WAAW,EAAE,CAAC,CAAC,cAAc;YAC7B,SAAS,EAAE,CAAC,CAAC,oBAAoB;YACjC,QAAQ,EAAE,CAAC,CAAC,oBAAoB;YAChC,SAAS,EAAE,CAAC,CAAC,cAAc;YAC3B,aAAa,EAAE,CAAC,CAAC,kBAAkB;YACnC,aAAa,EAAE,CAAC,CAAC,aAAa;YAC9B,WAAW,EAAE,CAAC,CAAC,YAAY;YAC3B,kBAAkB,EAAE,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC;YACnD,KAAK,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC;YACrB,SAAS,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;SAC5B,CAAC;IACJ,CAAC,CAAC;IAEF,OAAO,CAAC,iBAAiB,GAAG,KAAK,EAAE,GAAW,EAAE,GAAW,EAAE,IAAI,GAAG,CAAC,EAA6B,EAAE;QAClG,MAAM,MAAM,GAAG;YACb,YAAY,GAAG,EAAE;YACjB,aAAa,GAAG,EAAE;YAClB,gHAAgH;YAChH,6BAA6B;YAC7B,qBAAqB;YACrB,yBAAyB;YACzB,iBAAiB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;SACtC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEZ,MAAM,IAAI,GAAG,MAAM,SAAS,CAUzB,GAAG,QAAQ,aAAa,MAAM,EAAE,CAAC,CAAC;QAErC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC;QACtB,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;YACjB,WAAW,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;YAChC,QAAQ,EAAE,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC;YACnC,aAAa,EAAE,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;YACjC,wBAAwB,EAAE,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC;YACxD,SAAS,EAAE,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC;YAC9B,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAC9B,kBAAkB,EAAE,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;SACvD,CAAC,CAAC,CAAC;IACN,CAAC,CAAC;IAEF,OAAO,CAAC,gBAAgB,GAAG,KAAK,EAAE,GAAW,EAAE,GAAW,EAAE,IAAI,GAAG,CAAC,EAA4B,EAAE;QAChG,MAAM,MAAM,GAAG;YACb,YAAY,GAAG,EAAE;YACjB,aAAa,GAAG,EAAE;YAClB,4IAA4I;YAC5I,6BAA6B;YAC7B,qBAAqB;YACrB,yBAAyB;YACzB,iBAAiB,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE;SACtC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEZ,MAAM,IAAI,GAAG,MAAM,SAAS,CAYzB,GAAG,QAAQ,aAAa,MAAM,EAAE,CAAC,CAAC;QAErC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;YACjB,cAAc,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACvC,cAAc,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACvC,gBAAgB,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACxC,2BAA2B,EAAE,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC;YAC/D,YAAY,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACrC,WAAW,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC;YAC9B,kBAAkB,EAAE,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACtD,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;SAC9B,CAAC,CAAC,CAAC;IACN,CAAC,CAAC;IAEF,OAAO,CAAC,aAAa,GAAG,KAAK,EAAE,GAAW,EAAE,GAAW,EAAE,SAAiB,EAAE,OAAe,EAA6B,EAAE;QACxH,MAAM,MAAM,GAAG;YACb,YAAY,GAAG,EAAE;YACjB,aAAa,GAAG,EAAE;YAClB,sGAAsG;YACtG,6BAA6B;YAC7B,qBAAqB;YACrB,yBAAyB;YACzB,cAAc,SAAS,EAAE;YACzB,YAAY,OAAO,EAAE;SACtB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEZ,MAAM,IAAI,GAAG,MAAM,SAAS,CASzB,GAAG,WAAW,YAAY,MAAM,EAAE,CAAC,CAAC;QAEvC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;QACrB,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC;YACjB,cAAc,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACvC,cAAc,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;YACvC,eAAe,EAAE,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;YACzC,gBAAgB,EAAE,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACxC,YAAY,EAAE,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;SACtC,CAAC,CAAC,CAAC;IACN,CAAC,CAAC;IAEF,OAAO,CAAC,UAAU,GAAG,KAAK,EAAE,YAAoB,EAAE,EAAE;QAClD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACtD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAExC,MAAM,GAAG,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACzC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,CAAC;YAC/C,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;SACzD,CAAC,CAAC;QAEH,OAAO,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAEvC,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/gateway/alerts-routes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Alerts HTTP API Routes — REST endpoints for price/volume alert CRUD.
+ *
+ * Mounted as an Express Router via httpGateway.setAlertsRouter().
+ * All endpoints are prefixed with /api/alerts by the caller.
+ *
+ * NOTE: AlertService is NOT instantiated in gateway by default.
+ * We use a lazy getter pattern — the service is created on first access.
+ */
+import { Router } from 'express';
+import type { AlertService } from '../alerts/index.js';
+export interface AlertsRouterDeps {
+    getService: () => AlertService | null;
+}
+export declare function createAlertsRouter(deps: AlertsRouterDeps): Router;

package/dist/gateway/alerts-routes.js

@@ -0,0 +1,188 @@
+"use strict";
+/**
+ * Alerts HTTP API Routes — REST endpoints for price/volume alert CRUD.
+ *
+ * Mounted as an Express Router via httpGateway.setAlertsRouter().
+ * All endpoints are prefixed with /api/alerts by the caller.
+ *
+ * NOTE: AlertService is NOT instantiated in gateway by default.
+ * We use a lazy getter pattern — the service is created on first access.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAlertsRouter = createAlertsRouter;
+const express_1 = require("express");
+const logger_js_1 = require("../utils/logger.js");
+function createAlertsRouter(deps) {
+    const router = (0, express_1.Router)();
+    function svc() {
+        const s = deps.getService();
+        if (!s)
+            throw new Error('Alert service not available');
+        return s;
+    }
+    // ── GET /api/alerts ───────────────────────────────────────────────────────
+    // List alerts for a user
+    router.get('/', (req, res) => {
+        try {
+            const userId = req.query.userId || 'default';
+            const alerts = svc().getAlerts(userId);
+            res.json({ ok: true, data: { alerts, count: alerts.length } });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: List failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── GET /api/alerts/:id ───────────────────────────────────────────────────
+    router.get('/:id', (req, res) => {
+        try {
+            const alert = svc().getAlert(req.params.id);
+            if (!alert) {
+                res.status(404).json({ ok: false, error: `Alert ${req.params.id} not found` });
+                return;
+            }
+            res.json({ ok: true, data: alert });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: Get failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── POST /api/alerts/price ────────────────────────────────────────────────
+    // Create a price alert (above/below threshold)
+    router.post('/price', (req, res) => {
+        try {
+            const { userId, platform, marketId, marketQuestion, type, threshold, deliveryChannel, deliveryChatId, oneTime } = req.body;
+            if (!platform || !marketId || !type || threshold === undefined) {
+                res.status(400).json({ ok: false, error: 'Required: platform, marketId, type, threshold' });
+                return;
+            }
+            if (type !== 'price_above' && type !== 'price_below') {
+                res.status(400).json({ ok: false, error: 'type must be "price_above" or "price_below"' });
+                return;
+            }
+            const alert = svc().createPriceAlert({
+                userId: userId || 'default', platform, marketId, marketQuestion,
+                type, threshold, deliveryChannel: deliveryChannel || 'http',
+                deliveryChatId: deliveryChatId || '', oneTime,
+            });
+            res.json({ ok: true, data: alert });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: Create price alert failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── POST /api/alerts/price-change ─────────────────────────────────────────
+    // Create a price change alert (% change in time window)
+    router.post('/price-change', (req, res) => {
+        try {
+            const { userId, platform, marketId, marketQuestion, changePct, timeWindowSecs, deliveryChannel, deliveryChatId } = req.body;
+            if (!platform || !marketId || !changePct || !timeWindowSecs) {
+                res.status(400).json({ ok: false, error: 'Required: platform, marketId, changePct, timeWindowSecs' });
+                return;
+            }
+            const alert = svc().createPriceChangeAlert({
+                userId: userId || 'default', platform, marketId, marketQuestion,
+                changePct, timeWindowSecs, deliveryChannel: deliveryChannel || 'http',
+                deliveryChatId: deliveryChatId || '',
+            });
+            res.json({ ok: true, data: alert });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: Create price change alert failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── POST /api/alerts/volume ───────────────────────────────────────────────
+    // Create a volume spike alert
+    router.post('/volume', (req, res) => {
+        try {
+            const { userId, platform, marketId, marketQuestion, threshold, deliveryChannel, deliveryChatId } = req.body;
+            if (!platform || !marketId || !threshold) {
+                res.status(400).json({ ok: false, error: 'Required: platform, marketId, threshold' });
+                return;
+            }
+            const alert = svc().createVolumeAlert({
+                userId: userId || 'default', platform, marketId, marketQuestion,
+                threshold, deliveryChannel: deliveryChannel || 'http',
+                deliveryChatId: deliveryChatId || '',
+            });
+            res.json({ ok: true, data: alert });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: Create volume alert failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── PUT /api/alerts/:id/enable ────────────────────────────────────────────
+    router.put('/:id/enable', (req, res) => {
+        try {
+            const ok = svc().enableAlert(req.params.id);
+            if (!ok) {
+                res.status(404).json({ ok: false, error: `Alert ${req.params.id} not found` });
+                return;
+            }
+            res.json({ ok: true, data: { id: req.params.id, enabled: true } });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: Enable failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── PUT /api/alerts/:id/disable ───────────────────────────────────────────
+    router.put('/:id/disable', (req, res) => {
+        try {
+            const ok = svc().disableAlert(req.params.id);
+            if (!ok) {
+                res.status(404).json({ ok: false, error: `Alert ${req.params.id} not found` });
+                return;
+            }
+            res.json({ ok: true, data: { id: req.params.id, enabled: false } });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: Disable failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── DELETE /api/alerts/:id ────────────────────────────────────────────────
+    router.delete('/:id', (req, res) => {
+        try {
+            const ok = svc().deleteAlert(req.params.id);
+            if (!ok) {
+                res.status(404).json({ ok: false, error: `Alert ${req.params.id} not found` });
+                return;
+            }
+            res.json({ ok: true, data: { id: req.params.id, deleted: true } });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: Delete failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── POST /api/alerts/start-monitoring ─────────────────────────────────────
+    router.post('/start-monitoring', (_req, res) => {
+        try {
+            svc().startMonitoring();
+            res.json({ ok: true, data: { monitoring: true } });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: Start monitoring failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── POST /api/alerts/stop-monitoring ──────────────────────────────────────
+    router.post('/stop-monitoring', (_req, res) => {
+        try {
+            svc().stopMonitoring();
+            res.json({ ok: true, data: { monitoring: false } });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alerts API: Stop monitoring failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    logger_js_1.logger.info('Alerts API routes initialized');
+    return router;
+}
+//# sourceMappingURL=alerts-routes.js.map

package/dist/gateway/alerts-routes.js.map

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

package/dist/gateway/alt-data-routes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Alt Data HTTP API Routes — REST endpoints for alternative data / sentiment.
+ *
+ * Mounted as an Express Router via httpGateway.setAltDataRouter().
+ * All endpoints are prefixed with /api/alt-data by the caller.
+ *
+ * NOTE: AltDataService is created inside gateway's start() function,
+ * so we use a lazy getter pattern.
+ */
+import { Router } from 'express';
+import type { AltDataService } from '../services/alt-data/index.js';
+export interface AltDataRouterDeps {
+    getService: () => AltDataService | null;
+}
+export declare function createAltDataRouter(deps: AltDataRouterDeps): Router;

package/dist/gateway/alt-data-routes.js

@@ -0,0 +1,67 @@
+"use strict";
+/**
+ * Alt Data HTTP API Routes — REST endpoints for alternative data / sentiment.
+ *
+ * Mounted as an Express Router via httpGateway.setAltDataRouter().
+ * All endpoints are prefixed with /api/alt-data by the caller.
+ *
+ * NOTE: AltDataService is created inside gateway's start() function,
+ * so we use a lazy getter pattern.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAltDataRouter = createAltDataRouter;
+const express_1 = require("express");
+const logger_js_1 = require("../utils/logger.js");
+function createAltDataRouter(deps) {
+    const router = (0, express_1.Router)();
+    function svc() {
+        const s = deps.getService();
+        if (!s)
+            throw new Error('Alt data service not available');
+        return s;
+    }
+    // ── GET /api/alt-data/signals ─────────────────────────────────────────────
+    // Recent alt-data signals
+    router.get('/signals', (req, res) => {
+        try {
+            const limit = req.query.limit ? parseInt(req.query.limit, 10) : undefined;
+            const signals = svc().getRecentSignals(limit);
+            res.json({ ok: true, data: { signals, count: signals.length } });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alt Data API: Signals failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── GET /api/alt-data/sentiment/:marketId ─────────────────────────────────
+    // Market-specific sentiment
+    router.get('/sentiment/:marketId', (req, res) => {
+        try {
+            const sentiment = svc().getMarketSentiment(req.params.marketId);
+            if (!sentiment) {
+                res.json({ ok: true, data: null });
+                return;
+            }
+            res.json({ ok: true, data: sentiment });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alt Data API: Sentiment failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    // ── GET /api/alt-data/stats ───────────────────────────────────────────────
+    // Service statistics
+    router.get('/stats', (_req, res) => {
+        try {
+            const stats = svc().getStats();
+            res.json({ ok: true, data: stats });
+        }
+        catch (err) {
+            logger_js_1.logger.warn({ err }, 'Alt Data API: Stats failed');
+            res.status(500).json({ ok: false, error: err instanceof Error ? err.message : 'Unknown error' });
+        }
+    });
+    logger_js_1.logger.info('Alt Data API routes initialized');
+    return router;
+}
+//# sourceMappingURL=alt-data-routes.js.map

package/dist/gateway/alt-data-routes.js.map

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

package/dist/gateway/api-routes.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Trading API Routes — REST endpoints for positions, portfolio, orders,
+ * signals, strategies, and orchestrator status.
+ *
+ * Mounted as a single Express Router via httpGateway.setTradingApiRouter().
+ * All endpoints are prefixed with /api by the caller.
+ */
+import { Router } from 'express';
+import type { Database } from '../db/index.js';
+import type { ExecutionService } from '../execution/index.js';
+import type { TradingOrchestrator } from '../trading/orchestrator.js';
+import type { SafetyManager } from '../trading/safety.js';
+import type { SignalRouter } from '../signal-router/index.js';
+import { type BotManager } from '../trading/bots/index.js';
+import type { TradeLogger } from '../trading/logger.js';
+import type { StrategyBuilder } from '../trading/builder.js';
+import type { TickRecorder } from '../services/tick-recorder/types.js';
+import type { BacktestEngine } from '../trading/backtest.js';
+import type { SignalBus } from './signal-bus.js';
+import type { FeatureEngineering } from '../services/feature-engineering/types.js';
+import type { PositionManager } from '../execution/position-manager.js';
+import type { MLPipeline } from '../ml-pipeline/index.js';
+export interface TradingApiDeps {
+    db: Database;
+    execution: ExecutionService | null;
+    orchestrator: TradingOrchestrator | null;
+    safety: SafetyManager | null;
+    signalRouter: SignalRouter | null;
+    botManager: BotManager | null;
+    tradeLogger: TradeLogger | null;
+    tickRecorder: TickRecorder | null;
+    backtestEngine: BacktestEngine | null;
+    strategyBuilder: StrategyBuilder | null;
+    signalBus: SignalBus | null;
+    featureEngine: FeatureEngineering | null;
+    positionManager: PositionManager | null;
+    mlPipeline: MLPipeline | null;
+}
+export declare function createTradingApiRouter(deps: TradingApiDeps): Router;