clodds 1.1.0

package/dist/feeds/fred/index.d.ts

@@ -0,0 +1,134 @@
+/**
+ * FRED (Federal Reserve Economic Data) Feed
+ *
+ * Access to 800,000+ US and international economic time series.
+ * Free API key from https://fred.stlouisfed.org/docs/api/api_key.html
+ *
+ * API docs: https://fred.stlouisfed.org/docs/api/fred/
+ */
+import { EventEmitter } from 'events';
+export interface FREDSeries {
+    id: string;
+    title: string;
+    frequency: string;
+    units: string;
+    seasonalAdjustment: string;
+    lastUpdated: Date;
+    observationStart: string;
+    observationEnd: string;
+    popularity: number;
+    notes?: string;
+}
+export interface FREDObservation {
+    date: Date;
+    value: number | null;
+    /** Raw string value (some entries are ".") */
+    rawValue: string;
+}
+export interface FREDCategory {
+    id: number;
+    name: string;
+    parentId: number;
+}
+export interface FREDRelease {
+    id: number;
+    name: string;
+    pressRelease: boolean;
+    link?: string;
+    notes?: string;
+}
+export interface EconomicSnapshot {
+    gdp: {
+        value: number | null;
+        date: string;
+    } | null;
+    cpi: {
+        value: number | null;
+        date: string;
+    } | null;
+    unemployment: {
+        value: number | null;
+        date: string;
+    } | null;
+    fedFundsRate: {
+        value: number | null;
+        date: string;
+    } | null;
+    tenYearYield: {
+        value: number | null;
+        date: string;
+    } | null;
+    sp500: {
+        value: number | null;
+        date: string;
+    } | null;
+    timestamp: Date;
+}
+/** Common FRED series IDs for quick access */
+export declare const FRED_SERIES: {
+    readonly GDP: "GDP";
+    readonly REAL_GDP: "GDPC1";
+    readonly GDP_GROWTH: "A191RL1Q225SBEA";
+    readonly CPI: "CPIAUCSL";
+    readonly CPI_YOY: "CPIAUCSL";
+    readonly CORE_CPI: "CPILFESL";
+    readonly PCE: "PCEPI";
+    readonly CORE_PCE: "PCEPILFE";
+    readonly UNEMPLOYMENT: "UNRATE";
+    readonly NONFARM_PAYROLLS: "PAYEMS";
+    readonly INITIAL_CLAIMS: "ICSA";
+    readonly CONTINUING_CLAIMS: "CCSA";
+    readonly LABOR_FORCE_PARTICIPATION: "CIVPART";
+    readonly FED_FUNDS_RATE: "FEDFUNDS";
+    readonly FED_FUNDS_EFFECTIVE: "DFF";
+    readonly TEN_YEAR_YIELD: "DGS10";
+    readonly TWO_YEAR_YIELD: "DGS2";
+    readonly THIRTY_YEAR_YIELD: "DGS30";
+    readonly YIELD_SPREAD_10Y2Y: "T10Y2Y";
+    readonly PRIME_RATE: "DPRIME";
+    readonly SP500: "SP500";
+    readonly WILSHIRE_5000: "WILL5000IND";
+    readonly VIX: "VIXCLS";
+    readonly HOUSING_STARTS: "HOUST";
+    readonly CASE_SHILLER: "CSUSHPISA";
+    readonly MORTGAGE_30Y: "MORTGAGE30US";
+    readonly CONSUMER_SENTIMENT: "UMCSENT";
+    readonly RETAIL_SALES: "RSXFS";
+    readonly CONSUMER_CONFIDENCE: "CSCICP03USM665S";
+    readonly TRADE_BALANCE: "BOPGSTB";
+    readonly M2: "M2SL";
+    readonly WTI_OIL: "DCOILWTICO";
+    readonly GOLD: "GOLDAMGBD228NLBM";
+};
+export interface FREDFeed extends EventEmitter {
+    start(): Promise<void>;
+    stop(): void;
+    /** Get series metadata */
+    getSeries(seriesId: string): Promise<FREDSeries | null>;
+    /** Get observations (data points) for a series */
+    getObservations(seriesId: string, options?: {
+        startDate?: string;
+        endDate?: string;
+        limit?: number;
+        sort?: 'asc' | 'desc';
+        frequency?: 'd' | 'w' | 'bw' | 'm' | 'q' | 'sa' | 'a';
+    }): Promise<FREDObservation[]>;
+    /** Get the latest value for a series */
+    getLatest(seriesId: string): Promise<FREDObservation | null>;
+    /** Search for series by keywords */
+    search(query: string, limit?: number): Promise<FREDSeries[]>;
+    /** Get series in a category */
+    getCategory(categoryId: number): Promise<FREDCategory[]>;
+    /** Get a quick snapshot of key economic indicators */
+    getSnapshot(): Promise<EconomicSnapshot>;
+    /** Get year-over-year change for a series */
+    getYoYChange(seriesId: string): Promise<{
+        current: number | null;
+        previous: number | null;
+        change: number | null;
+        changePercent: number | null;
+    }>;
+    /** Compare multiple series for the same date range */
+    compare(seriesIds: string[], startDate: string, endDate: string): Promise<Record<string, FREDObservation[]>>;
+}
+export declare function createFREDFeed(): Promise<FREDFeed>;

package/dist/feeds/fred/index.js

@@ -0,0 +1,263 @@
+"use strict";
+/**
+ * FRED (Federal Reserve Economic Data) Feed
+ *
+ * Access to 800,000+ US and international economic time series.
+ * Free API key from https://fred.stlouisfed.org/docs/api/api_key.html
+ *
+ * API docs: https://fred.stlouisfed.org/docs/api/fred/
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FRED_SERIES = void 0;
+exports.createFREDFeed = createFREDFeed;
+const events_1 = require("events");
+const logger_1 = require("../../utils/logger");
+/** Common FRED series IDs for quick access */
+exports.FRED_SERIES = {
+    // Growth
+    GDP: 'GDP',
+    REAL_GDP: 'GDPC1',
+    GDP_GROWTH: 'A191RL1Q225SBEA',
+    // Inflation
+    CPI: 'CPIAUCSL',
+    CPI_YOY: 'CPIAUCSL',
+    CORE_CPI: 'CPILFESL',
+    PCE: 'PCEPI',
+    CORE_PCE: 'PCEPILFE',
+    // Employment
+    UNEMPLOYMENT: 'UNRATE',
+    NONFARM_PAYROLLS: 'PAYEMS',
+    INITIAL_CLAIMS: 'ICSA',
+    CONTINUING_CLAIMS: 'CCSA',
+    LABOR_FORCE_PARTICIPATION: 'CIVPART',
+    // Interest Rates
+    FED_FUNDS_RATE: 'FEDFUNDS',
+    FED_FUNDS_EFFECTIVE: 'DFF',
+    TEN_YEAR_YIELD: 'DGS10',
+    TWO_YEAR_YIELD: 'DGS2',
+    THIRTY_YEAR_YIELD: 'DGS30',
+    YIELD_SPREAD_10Y2Y: 'T10Y2Y',
+    PRIME_RATE: 'DPRIME',
+    // Markets
+    SP500: 'SP500',
+    WILSHIRE_5000: 'WILL5000IND',
+    VIX: 'VIXCLS',
+    // Housing
+    HOUSING_STARTS: 'HOUST',
+    CASE_SHILLER: 'CSUSHPISA',
+    MORTGAGE_30Y: 'MORTGAGE30US',
+    // Consumer
+    CONSUMER_SENTIMENT: 'UMCSENT',
+    RETAIL_SALES: 'RSXFS',
+    CONSUMER_CONFIDENCE: 'CSCICP03USM665S',
+    // Trade
+    TRADE_BALANCE: 'BOPGSTB',
+    // Money Supply
+    M2: 'M2SL',
+    // Commodity
+    WTI_OIL: 'DCOILWTICO',
+    GOLD: 'GOLDAMGBD228NLBM',
+};
+// =============================================================================
+// API HELPERS
+// =============================================================================
+const BASE_URL = 'https://api.stlouisfed.org/fred';
+function getApiKey() {
+    const key = process.env.FRED_API_KEY;
+    if (!key) {
+        throw new Error('FRED_API_KEY environment variable is required. Get a free key at https://fred.stlouisfed.org/docs/api/api_key.html');
+    }
+    return key;
+}
+async function fredFetch(endpoint, params = {}) {
+    const apiKey = getApiKey();
+    const queryParams = new URLSearchParams({
+        api_key: apiKey,
+        file_type: 'json',
+        ...params,
+    });
+    const url = `${BASE_URL}/${endpoint}?${queryParams.toString()}`;
+    const res = await fetch(url, {
+        headers: { 'Accept': 'application/json' },
+    });
+    if (!res.ok) {
+        throw new Error(`FRED API error ${res.status}: ${await res.text()}`);
+    }
+    return res.json();
+}
+function parseObservation(raw) {
+    const value = raw.value === '.' ? null : parseFloat(raw.value);
+    return {
+        date: new Date(raw.date),
+        value: Number.isNaN(value) ? null : value,
+        rawValue: raw.value,
+    };
+}
+function parseSeries(raw) {
+    return {
+        id: raw.id,
+        title: raw.title,
+        frequency: raw.frequency,
+        units: raw.units,
+        seasonalAdjustment: raw.seasonal_adjustment,
+        lastUpdated: new Date(raw.last_updated),
+        observationStart: raw.observation_start,
+        observationEnd: raw.observation_end,
+        popularity: raw.popularity || 0,
+        notes: raw.notes || undefined,
+    };
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+async function createFREDFeed() {
+    const emitter = new events_1.EventEmitter();
+    let running = false;
+    // Simple cache for series metadata (rarely changes)
+    const seriesCache = new Map();
+    emitter.start = async () => {
+        running = true;
+        logger_1.logger.info('FRED economic data feed started');
+    };
+    emitter.stop = () => {
+        running = false;
+        seriesCache.clear();
+        logger_1.logger.info('FRED economic data feed stopped');
+    };
+    emitter.getSeries = async (seriesId) => {
+        const cached = seriesCache.get(seriesId);
+        if (cached)
+            return cached;
+        try {
+            const data = await fredFetch('series', {
+                series_id: seriesId,
+            });
+            if (!data.seriess || data.seriess.length === 0)
+                return null;
+            const series = parseSeries(data.seriess[0]);
+            seriesCache.set(seriesId, series);
+            return series;
+        }
+        catch (error) {
+            logger_1.logger.warn({ error, seriesId }, 'Failed to get FRED series');
+            return null;
+        }
+    };
+    emitter.getObservations = async (seriesId, options = {}) => {
+        const params = {
+            series_id: seriesId,
+            sort_order: options.sort || 'desc',
+        };
+        if (options.startDate)
+            params.observation_start = options.startDate;
+        if (options.endDate)
+            params.observation_end = options.endDate;
+        if (options.limit)
+            params.limit = String(options.limit);
+        if (options.frequency)
+            params.frequency = options.frequency;
+        const data = await fredFetch('series/observations', params);
+        return data.observations.map(parseObservation);
+    };
+    emitter.getLatest = async (seriesId) => {
+        const observations = await emitter.getObservations(seriesId, {
+            sort: 'desc',
+            limit: 1,
+        });
+        return observations.length > 0 ? observations[0] : null;
+    };
+    emitter.search = async (query, limit = 20) => {
+        const data = await fredFetch('series/search', {
+            search_text: query,
+            limit: String(limit),
+            order_by: 'popularity',
+            sort_order: 'desc',
+        });
+        return (data.seriess || []).map(parseSeries);
+    };
+    emitter.getCategory = async (categoryId) => {
+        const data = await fredFetch('category/children', {
+            category_id: String(categoryId),
+        });
+        return (data.categories || []).map(c => ({
+            id: c.id,
+            name: c.name,
+            parentId: c.parent_id,
+        }));
+    };
+    emitter.getSnapshot = async () => {
+        const seriesIds = [
+            exports.FRED_SERIES.GDP,
+            exports.FRED_SERIES.CPI,
+            exports.FRED_SERIES.UNEMPLOYMENT,
+            exports.FRED_SERIES.FED_FUNDS_RATE,
+            exports.FRED_SERIES.TEN_YEAR_YIELD,
+            exports.FRED_SERIES.SP500,
+        ];
+        const results = await Promise.allSettled(seriesIds.map(id => emitter.getLatest(id)));
+        const getValue = (idx) => {
+            const result = results[idx];
+            if (result.status === 'fulfilled' && result.value) {
+                return {
+                    value: result.value.value,
+                    date: result.value.date.toISOString().slice(0, 10),
+                };
+            }
+            return null;
+        };
+        return {
+            gdp: getValue(0),
+            cpi: getValue(1),
+            unemployment: getValue(2),
+            fedFundsRate: getValue(3),
+            tenYearYield: getValue(4),
+            sp500: getValue(5),
+            timestamp: new Date(),
+        };
+    };
+    emitter.getYoYChange = async (seriesId) => {
+        const observations = await emitter.getObservations(seriesId, {
+            sort: 'desc',
+            limit: 13, // Get ~13 months of monthly data to find YoY
+        });
+        if (observations.length < 2) {
+            return { current: null, previous: null, change: null, changePercent: null };
+        }
+        const current = observations[0].value;
+        // Find observation approximately 12 months ago
+        const currentDate = observations[0].date.getTime();
+        const targetDate = currentDate - 365 * 24 * 60 * 60 * 1000;
+        let closest = observations[observations.length - 1];
+        let closestDiff = Math.abs(closest.date.getTime() - targetDate);
+        for (const obs of observations) {
+            const diff = Math.abs(obs.date.getTime() - targetDate);
+            if (diff < closestDiff) {
+                closest = obs;
+                closestDiff = diff;
+            }
+        }
+        const previous = closest.value;
+        if (current === null || previous === null || previous === 0) {
+            return { current, previous, change: null, changePercent: null };
+        }
+        const change = current - previous;
+        const changePercent = (change / Math.abs(previous)) * 100;
+        return {
+            current,
+            previous,
+            change: Math.round(change * 1000) / 1000,
+            changePercent: Math.round(changePercent * 100) / 100,
+        };
+    };
+    emitter.compare = async (seriesIds, startDate, endDate) => {
+        const results = await Promise.allSettled(seriesIds.map(id => emitter.getObservations(id, { startDate, endDate, sort: 'asc' })));
+        const output = {};
+        for (let i = 0; i < seriesIds.length; i++) {
+            const result = results[i];
+            output[seriesIds[i]] = result.status === 'fulfilled' ? result.value : [];
+        }
+        return output;
+    };
+    return emitter;
+}
+//# sourceMappingURL=index.js.map

package/dist/feeds/fred/index.js.map

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

package/dist/feeds/freshness.d.ts

@@ -0,0 +1,79 @@
+/**
+ * WebSocket Feed Freshness Tracking
+ *
+ * Monitors WebSocket message timestamps and alerts on stale data.
+ * Supports automatic fallback to polling when feeds go stale.
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { Platform } from '../types';
+export interface FreshnessConfig {
+    /** Maximum age in ms before data is considered stale (default: 5000) */
+    staleThresholdMs?: number;
+    /** Check interval in ms (default: 1000) */
+    checkIntervalMs?: number;
+    /** Number of stale checks before alerting (default: 3) */
+    staleCountThreshold?: number;
+    /** Enable automatic polling fallback (default: true) */
+    enablePollingFallback?: boolean;
+    /** Polling interval when in fallback mode (default: 2000) */
+    pollingIntervalMs?: number;
+}
+export interface FreshnessStatus {
+    platform: Platform;
+    marketId: string;
+    lastMessageTime: number;
+    age: number;
+    isStale: boolean;
+    staleCount: number;
+    inFallbackMode: boolean;
+}
+export interface FreshnessEvents {
+    stale: (status: FreshnessStatus) => void;
+    recovered: (status: FreshnessStatus) => void;
+    fallbackStarted: (status: FreshnessStatus) => void;
+    fallbackEnded: (status: FreshnessStatus) => void;
+}
+export declare class FreshnessTracker extends EventEmitter {
+    private feeds;
+    private checkInterval;
+    private config;
+    constructor(config?: FreshnessConfig);
+    /**
+     * Start tracking freshness for a feed
+     */
+    track(platform: Platform, marketId: string, pollingCallback?: () => Promise<void>): void;
+    /**
+     * Record a message received for a feed
+     */
+    recordMessage(platform: Platform, marketId: string): void;
+    /**
+     * Stop tracking a feed
+     */
+    untrack(platform: Platform, marketId: string): void;
+    /**
+     * Get current status for a feed
+     */
+    getStatus(platform: Platform, marketId: string): FreshnessStatus | null;
+    /**
+     * Get all tracked feeds' status
+     */
+    getAllStatus(): FreshnessStatus[];
+    /**
+     * Get count of stale feeds
+     */
+    getStaleCount(): number;
+    /**
+     * Stop all tracking
+     */
+    stop(): void;
+    private getKey;
+    private startChecking;
+    private checkFreshness;
+    private enterFallbackMode;
+    private exitFallbackMode;
+}
+/**
+ * Create a freshness tracker instance
+ */
+export declare function createFreshnessTracker(config?: FreshnessConfig): FreshnessTracker;
+export declare function getGlobalFreshnessTracker(): FreshnessTracker;