clodds 1.1.0

package/dist/monitoring/index.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * Monitoring & Alerting - health checks + error notifications.
+ *
+ * This module provides:
+ * - Prometheus-compatible metrics (metrics.ts)
+ * - Health check endpoints (health.ts)
+ * - Alert thresholds and webhooks (alerts.ts)
+ * - Legacy monitoring service (below)
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMonitoringService = createMonitoringService;
+const email_1 = require("../tools/email");
+const infra_1 = require("../infra");
+const logger_1 = require("../utils/logger");
+// Re-export new monitoring modules
+__exportStar(require("./metrics"), exports);
+__exportStar(require("./health"), exports);
+__exportStar(require("./alerts"), exports);
+function now() {
+    return Date.now();
+}
+function formatError(error) {
+    if (error instanceof Error) {
+        return error.stack || error.message || String(error);
+    }
+    if (typeof error === 'string')
+        return error;
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return String(error);
+    }
+}
+function truncate(text, max = 3500) {
+    if (text.length <= max)
+        return text;
+    return `${text.slice(0, max - 3)}...`;
+}
+function createMonitoringService(options) {
+    const emailTool = (0, email_1.createEmailTool)();
+    const providerHealth = options.providerHealth ?? null;
+    const config = options.config ?? {};
+    let running = false;
+    let systemTimer = null;
+    const lastSent = new Map();
+    const providerState = new Map();
+    const processHandlers = [];
+    function shouldSend(key, cooldownMs) {
+        const last = lastSent.get(key);
+        const nowTime = now();
+        if (last && nowTime - last < cooldownMs)
+            return false;
+        lastSent.set(key, nowTime);
+        return true;
+    }
+    function getTargets() {
+        return Array.isArray(config.alertTargets) ? config.alertTargets : [];
+    }
+    function buildAlertMessage(title, body) {
+        return `ALERT: ${title}\n${body}`;
+    }
+    async function sendAlert(key, title, body, opts) {
+        if (config.enabled === false)
+            return;
+        const cooldownMs = opts?.cooldownMs ?? config.cooldownMs ?? 5 * 60 * 1000;
+        if (!shouldSend(key, cooldownMs))
+            return;
+        const targets = getTargets();
+        const text = truncate(buildAlertMessage(title, body));
+        if (targets.length === 0 && !config.email?.to?.length && !config.email?.enabled) {
+            logger_1.logger.warn({ title }, 'Monitoring alert suppressed (no targets configured)');
+            return;
+        }
+        for (const target of targets) {
+            try {
+                const resolvedAccountId = target.accountId
+                    ? target.accountId
+                    : options.resolveAccountId
+                        ? await options.resolveAccountId(target)
+                        : undefined;
+                await options.sendMessage({
+                    platform: target.platform,
+                    chatId: target.chatId,
+                    accountId: resolvedAccountId,
+                    text,
+                    thread: target.threadId ? { threadId: target.threadId } : undefined,
+                });
+            }
+            catch (error) {
+                logger_1.logger.warn({ error, target }, 'Failed to send monitoring alert');
+            }
+        }
+        const emailConfig = config.email;
+        if (emailConfig?.enabled && emailConfig.to && emailConfig.to.length > 0) {
+            if (!emailTool.isAvailable()) {
+                logger_1.logger.warn('Email tool not available; skipping email alert');
+            }
+            else {
+                const from = emailConfig.from || 'clodds@localhost';
+                const subjectPrefix = opts?.subjectPrefix ?? emailConfig.subjectPrefix ?? 'Clodds';
+                const subject = `[${subjectPrefix}] ${title}`;
+                try {
+                    await emailTool.send({
+                        from: { email: from },
+                        to: emailConfig.to,
+                        subject,
+                        text: `${title}\n\n${body}`,
+                    });
+                }
+                catch (error) {
+                    logger_1.logger.warn({ error }, 'Failed to send email alert');
+                }
+            }
+        }
+    }
+    function handleProviderHealth(snapshot) {
+        const healthConfig = config.providerHealth;
+        if (healthConfig?.enabled === false)
+            return;
+        const alertAfter = healthConfig?.alertAfterFailures ?? 3;
+        const alertOnRecovery = healthConfig?.alertOnRecovery !== false;
+        const cooldownMs = healthConfig?.cooldownMs ?? 10 * 60 * 1000;
+        for (const status of snapshot.statuses) {
+            const prev = providerState.get(status.provider);
+            providerState.set(status.provider, {
+                available: status.available,
+                notifiedDown: prev?.notifiedDown ?? false,
+            });
+            if (!status.available) {
+                const shouldAlert = status.consecutiveFailures >= alertAfter && (!prev || prev.available || !prev.notifiedDown);
+                if (shouldAlert) {
+                    providerState.set(status.provider, {
+                        available: false,
+                        notifiedDown: true,
+                    });
+                    void sendAlert(`provider:${status.provider}:down`, `${status.provider} provider unavailable`, `Consecutive failures: ${status.consecutiveFailures}\nLast checked: ${new Date(status.lastCheckedAt).toISOString()}\nLast error: ${status.lastError || 'Unknown'}`, { cooldownMs });
+                }
+            }
+            else if (prev && !prev.available && alertOnRecovery) {
+                providerState.set(status.provider, {
+                    available: true,
+                    notifiedDown: false,
+                });
+                void sendAlert(`provider:${status.provider}:up`, `${status.provider} provider recovered`, `Recovered at ${new Date(status.lastCheckedAt).toISOString()}`, { cooldownMs });
+            }
+        }
+    }
+    async function checkSystemHealth() {
+        const systemConfig = config.systemHealth;
+        if (!systemConfig?.enabled)
+            return;
+        try {
+            const health = await (0, infra_1.getSystemHealth)();
+            const memoryWarn = systemConfig.memoryWarnPct ?? 85;
+            const diskWarn = systemConfig.diskWarnPct ?? 90;
+            const cooldownMs = systemConfig.cooldownMs ?? 30 * 60 * 1000;
+            if (health.memory.percent >= memoryWarn) {
+                await sendAlert('system:memory', 'High memory usage', `Memory used: ${health.memory.percent.toFixed(1)}% (${(health.memory.used / 1024 / 1024 / 1024).toFixed(1)}GB/${(health.memory.total / 1024 / 1024 / 1024).toFixed(1)}GB)`, { cooldownMs });
+            }
+            if (health.disk && health.disk.percent >= diskWarn) {
+                await sendAlert('system:disk', 'Low disk space', `Disk used: ${health.disk.percent.toFixed(1)}% (${(health.disk.used / 1024 / 1024 / 1024).toFixed(1)}GB/${(health.disk.total / 1024 / 1024 / 1024).toFixed(1)}GB)`, { cooldownMs });
+            }
+        }
+        catch (error) {
+            logger_1.logger.warn({ error }, 'System health check failed');
+        }
+    }
+    function attachProcessHandlers() {
+        if (config.errors?.enabled === false)
+            return;
+        const cooldownMs = config.errors?.cooldownMs ?? 5 * 60 * 1000;
+        const includeStack = config.errors?.includeStack !== false;
+        const onUnhandledRejection = (reason) => {
+            const details = includeStack ? formatError(reason) : String(reason);
+            void sendAlert('error:unhandledRejection', 'Unhandled promise rejection', truncate(details), { cooldownMs });
+        };
+        const onUncaughtException = (error) => {
+            const details = includeStack ? formatError(error) : error.message;
+            void sendAlert('error:uncaughtException', 'Uncaught exception', truncate(details), { cooldownMs });
+        };
+        const onWarning = (warning) => {
+            const details = includeStack ? formatError(warning) : warning.message;
+            void sendAlert('error:warning', 'Process warning', truncate(details), { cooldownMs });
+        };
+        process.on('unhandledRejection', onUnhandledRejection);
+        process.on('uncaughtException', onUncaughtException);
+        process.on('warning', onWarning);
+        processHandlers.push({ event: 'unhandledRejection', handler: onUnhandledRejection }, { event: 'uncaughtException', handler: onUncaughtException }, { event: 'warning', handler: onWarning });
+    }
+    function detachProcessHandlers() {
+        for (const entry of processHandlers) {
+            process.off(entry.event, entry.handler);
+        }
+        processHandlers.length = 0;
+    }
+    function startSystemTimer() {
+        if (!config.systemHealth?.enabled)
+            return;
+        const intervalMs = config.systemHealth.intervalMs ?? 60 * 1000;
+        if (systemTimer)
+            clearInterval(systemTimer);
+        void checkSystemHealth();
+        systemTimer = setInterval(() => {
+            void checkSystemHealth();
+        }, intervalMs);
+    }
+    return {
+        start() {
+            if (running)
+                return;
+            if (config.enabled === false) {
+                logger_1.logger.info('Monitoring disabled by config');
+                return;
+            }
+            running = true;
+            if (providerHealth && config.providerHealth?.enabled !== false) {
+                providerHealth.on('health', handleProviderHealth);
+            }
+            attachProcessHandlers();
+            startSystemTimer();
+            logger_1.logger.info('Monitoring service started');
+        },
+        stop() {
+            if (!running)
+                return;
+            running = false;
+            if (providerHealth) {
+                providerHealth.off('health', handleProviderHealth);
+            }
+            detachProcessHandlers();
+            if (systemTimer) {
+                clearInterval(systemTimer);
+                systemTimer = null;
+            }
+            logger_1.logger.info('Monitoring service stopped');
+        },
+        isRunning() {
+            return running;
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/monitoring/index.js.map

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

package/dist/monitoring/metrics.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Prometheus-compatible Metrics System
+ *
+ * Features:
+ * - Counters: Monotonically increasing values (requests, errors)
+ * - Gauges: Point-in-time values (active connections, memory)
+ * - Histograms: Distribution of values with buckets (latency)
+ * - Labels: Dimensional data for filtering
+ * - Prometheus text format export
+ */
+export type MetricType = 'counter' | 'gauge' | 'histogram';
+export interface MetricLabels {
+    [key: string]: string;
+}
+export interface MetricOptions {
+    name: string;
+    help: string;
+    labels?: string[];
+    buckets?: number[];
+}
+export interface MetricValue {
+    value: number;
+    labels: MetricLabels;
+    timestamp?: number;
+}
+export interface HistogramValue {
+    sum: number;
+    count: number;
+    buckets: Map<number, number>;
+    labels: MetricLabels;
+}
+/**
+ * Counter - Monotonically increasing metric
+ */
+export declare class Counter {
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: string[];
+    private values;
+    constructor(options: MetricOptions);
+    private getKey;
+    inc(labels?: MetricLabels, value?: number): void;
+    get(labels?: MetricLabels): number;
+    getAll(): MetricValue[];
+    reset(): void;
+}
+/**
+ * Gauge - Point-in-time metric that can go up or down
+ */
+export declare class Gauge {
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: string[];
+    private values;
+    constructor(options: MetricOptions);
+    private getKey;
+    set(labels: MetricLabels, value: number): void;
+    set(value: number): void;
+    inc(labels?: MetricLabels, value?: number): void;
+    dec(labels?: MetricLabels, value?: number): void;
+    get(labels?: MetricLabels): number;
+    getAll(): MetricValue[];
+    reset(): void;
+}
+/**
+ * Histogram - Distribution of values with configurable buckets
+ */
+export declare class Histogram {
+    readonly name: string;
+    readonly help: string;
+    readonly labelNames: string[];
+    readonly buckets: number[];
+    private values;
+    constructor(options: MetricOptions);
+    private getKey;
+    observe(labels: MetricLabels, value: number): void;
+    observe(value: number): void;
+    /**
+     * Time a function and record the duration
+     */
+    time<T>(labels: MetricLabels, fn: () => Promise<T>): Promise<T>;
+    time<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Start a timer that can be stopped later
+     */
+    startTimer(labels?: MetricLabels): () => number;
+    get(labels?: MetricLabels): HistogramValue | undefined;
+    getAll(): HistogramValue[];
+    reset(): void;
+}
+export declare class MetricsRegistry {
+    private counters;
+    private gauges;
+    private histograms;
+    private prefix;
+    constructor(prefix?: string);
+    createCounter(options: MetricOptions): Counter;
+    createGauge(options: MetricOptions): Gauge;
+    createHistogram(options: MetricOptions): Histogram;
+    getCounter(name: string): Counter | undefined;
+    getGauge(name: string): Gauge | undefined;
+    getHistogram(name: string): Histogram | undefined;
+    /**
+     * Export metrics in Prometheus text format
+     */
+    toPrometheusText(): string;
+    /**
+     * Export metrics as JSON
+     */
+    toJSON(): Record<string, unknown>;
+    reset(): void;
+}
+declare function formatLabels(labels: MetricLabels): string;
+declare function escapeLabel(value: string): string;
+export declare const registry: MetricsRegistry;
+export declare const httpRequestsTotal: Counter;
+export declare const httpRequestDuration: Histogram;
+export declare const httpActiveConnections: Gauge;
+export declare const httpErrorsTotal: Counter;
+export declare const wsConnectionsTotal: Counter;
+export declare const wsActiveConnections: Gauge;
+export declare const wsMessagesTotal: Counter;
+export declare const feedMessagesTotal: Counter;
+export declare const feedMessagesPerSecond: Gauge;
+export declare const feedSubscriptions: Gauge;
+export declare const feedLatency: Histogram;
+export declare const feedReconnects: Counter;
+export declare const tradingVolumeTotal: Counter;
+export declare const tradingOrdersTotal: Counter;
+export declare const tradingPnl: Gauge;
+export declare const tradingFillRate: Histogram;
+export declare const tradingLatency: Histogram;
+export declare const processMemoryBytes: Gauge;
+export declare const processCpuUsage: Gauge;
+export declare const processUptime: Gauge;
+export declare const jobsTotal: Counter;
+export declare const jobsActive: Gauge;
+export declare const jobDuration: Histogram;
+/**
+ * Start collecting system metrics at regular intervals
+ */
+export declare function startMetricsCollection(intervalMs?: number): void;
+/**
+ * Stop collecting system metrics
+ */
+export declare function stopMetricsCollection(): void;
+export { formatLabels, escapeLabel, };