@revealui/mcp 0.0.1-pre.0 → 0.1.0

package/dist/packages/core/src/monitoring/alerts.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Alert System
+ *
+ * Manages alert channels (logger, Sentry, console) and alert delivery.
+ * Provides configurable thresholds and aggregation for production.
+ */
+import type { Alert } from './types.js';
+/**
+ * Sentry interface for dependency injection and testing
+ */
+interface SentryClient {
+    captureMessage: (message: string, context?: unknown) => void;
+    setUser: (user: unknown) => void;
+}
+/**
+ * Alert channel type
+ */
+type AlertChannel = 'logger' | 'sentry' | 'console';
+/**
+ * Alert configuration
+ */
+interface AlertConfig {
+    /** Enabled channels */
+    channels: AlertChannel[];
+    /** Aggregate alerts in production (log every N minutes instead of immediately) */
+    aggregateInProduction: boolean;
+    /** Aggregation interval in milliseconds */
+    aggregationInterval: number;
+    /** Enable Sentry in production only */
+    sentryProductionOnly: boolean;
+}
+/**
+ * Alert manager class
+ */
+declare class AlertManager {
+    private config;
+    private alertQueue;
+    private aggregationTimer;
+    private lastAggregationTime;
+    private sentryClient;
+    constructor(config?: Partial<AlertConfig>, sentryClient?: SentryClient | null);
+    /**
+     * Send an alert through configured channels
+     */
+    sendAlert(alert: Alert): void;
+    /**
+     * Send multiple alerts
+     */
+    sendAlerts(alerts: Alert[]): void;
+    /**
+     * Deliver an alert to configured channels
+     */
+    private deliverAlert;
+    /**
+     * Send alert to logger
+     */
+    private sendToLogger;
+    /**
+     * Send alert to console (uses logger for structured output)
+     */
+    private sendToConsole;
+    /**
+     * Send alert to Sentry
+     */
+    private sendToSentry;
+    /**
+     * Start aggregation timer
+     */
+    private startAggregation;
+    /**
+     * Flush aggregated alerts
+     */
+    private flushAlerts;
+    /**
+     * Stop aggregation timer
+     */
+    stopAggregation(): void;
+    /**
+     * Check if running in production
+     */
+    private isProduction;
+    /**
+     * Get alert queue stats
+     */
+    getStats(): {
+        queueSize: number;
+        lastAggregationTime: number;
+        aggregationEnabled: boolean;
+    };
+    /**
+     * Configure alert channels
+     */
+    setChannels(channels: AlertChannel[]): void;
+    /**
+     * Cleanup resources
+     */
+    dispose(): void;
+}
+/**
+ * Singleton instance
+ */
+export declare const alertManager: AlertManager;
+/**
+ * Export AlertManager class for testing
+ */
+export { AlertManager };
+/**
+ * Export types for testing
+ */
+export type { AlertChannel, SentryClient };
+/**
+ * Convenience functions
+ */
+export declare function sendAlert(alert: Alert): void;
+export declare function sendAlerts(alerts: Alert[]): void;
+export declare function getAlertStats(): ReturnType<typeof alertManager.getStats>;
+export declare function setAlertChannels(channels: AlertChannel[]): void;
+//# sourceMappingURL=alerts.d.ts.map

package/dist/packages/core/src/monitoring/alerts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alerts.d.ts","sourceRoot":"","sources":["../../../../../../core/src/monitoring/alerts.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAEvC;;GAEG;AACH,UAAU,YAAY;IACpB,cAAc,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IAC5D,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAA;CACjC;AAsCD;;GAEG;AACH,KAAK,YAAY,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAA;AAEnD;;GAEG;AACH,UAAU,WAAW;IACnB,uBAAuB;IACvB,QAAQ,EAAE,YAAY,EAAE,CAAA;IAExB,kFAAkF;IAClF,qBAAqB,EAAE,OAAO,CAAA;IAE9B,2CAA2C;IAC3C,mBAAmB,EAAE,MAAM,CAAA;IAE3B,uCAAuC;IACvC,oBAAoB,EAAE,OAAO,CAAA;CAC9B;AAYD;;GAEG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,gBAAgB,CAA8B;IACtD,OAAO,CAAC,mBAAmB,CAAI;IAC/B,OAAO,CAAC,YAAY,CAA4B;gBAEpC,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EAAE,YAAY,CAAC,EAAE,YAAY,GAAG,IAAI;IAUjF;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU7B;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI;IAMjC;;OAEG;IACH,OAAO,CAAC,YAAY;IAoBpB;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmEpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAaxB;;OAEG;IACH,OAAO,CAAC,WAAW;IAwCnB;;OAEG;IACH,eAAe,IAAI,IAAI;IAOvB;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,mBAAmB,EAAE,MAAM,CAAA;QAC3B,kBAAkB,EAAE,OAAO,CAAA;KAC5B;IAQD;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI;IAI3C;;OAEG;IACH,OAAO,IAAI,IAAI;CAIhB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAA;AAE9C;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,CAAA;AAEvB;;GAEG;AACH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,CAAA;AAE1C;;GAEG;AAEH,wBAAgB,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAE5C;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAEhD;AAED,wBAAgB,aAAa,IAAI,UAAU,CAAC,OAAO,YAAY,CAAC,QAAQ,CAAC,CAExE;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,IAAI,CAE/D"}

package/dist/packages/core/src/monitoring/alerts.js

@@ -0,0 +1,325 @@
+/**
+ * Alert System
+ *
+ * Manages alert channels (logger, Sentry, console) and alert delivery.
+ * Provides configurable thresholds and aggregation for production.
+ */
+import { logger } from '../utils/logger-server.js';
+import { getRequestContext } from '../utils/request-context.js';
+/**
+ * Get Sentry client if available
+ * Using dynamic import with string variable to avoid build-time resolution
+ */
+async function getSentryClient() {
+    try {
+        // Use string variable to prevent static analysis and bundler resolution
+        const moduleName = '@sentry' + '/node';
+        const sentry = await import(/* webpackIgnore: true */ moduleName);
+        return sentry;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Synchronous version that caches the client
+ */
+let sentryClientCache;
+function getSentryClientSync() {
+    if (sentryClientCache !== undefined) {
+        return sentryClientCache;
+    }
+    // Initialize asynchronously in the background
+    getSentryClient()
+        .then((client) => {
+        sentryClientCache = client;
+    })
+        .catch(() => {
+        sentryClientCache = null;
+    });
+    return null;
+}
+/**
+ * Default alert configuration
+ */
+const DEFAULT_ALERT_CONFIG = {
+    channels: ['logger', 'console'],
+    aggregateInProduction: true,
+    aggregationInterval: 5 * 60 * 1000, // 5 minutes
+    sentryProductionOnly: true,
+};
+/**
+ * Alert manager class
+ */
+class AlertManager {
+    config;
+    alertQueue = [];
+    aggregationTimer = null;
+    lastAggregationTime = 0;
+    sentryClient = null;
+    constructor(config = {}, sentryClient) {
+        this.config = { ...DEFAULT_ALERT_CONFIG, ...config };
+        this.sentryClient = sentryClient !== undefined ? sentryClient : getSentryClientSync();
+        // Start aggregation timer if enabled
+        if (this.config.aggregateInProduction && this.isProduction()) {
+            this.startAggregation();
+        }
+    }
+    /**
+     * Send an alert through configured channels
+     */
+    sendAlert(alert) {
+        if (this.config.aggregateInProduction && this.isProduction()) {
+            // In production, queue alerts for aggregation
+            this.alertQueue.push(alert);
+        }
+        else {
+            // In development, send immediately
+            this.deliverAlert(alert);
+        }
+    }
+    /**
+     * Send multiple alerts
+     */
+    sendAlerts(alerts) {
+        for (const alert of alerts) {
+            this.sendAlert(alert);
+        }
+    }
+    /**
+     * Deliver an alert to configured channels
+     */
+    deliverAlert(alert) {
+        for (const channel of this.config.channels) {
+            switch (channel) {
+                case 'logger':
+                    this.sendToLogger(alert);
+                    break;
+                case 'console':
+                    this.sendToConsole(alert);
+                    break;
+                case 'sentry':
+                    if (!this.config.sentryProductionOnly || this.isProduction()) {
+                        this.sendToSentry(alert);
+                    }
+                    break;
+            }
+        }
+    }
+    /**
+     * Send alert to logger
+     */
+    sendToLogger(alert) {
+        // Get request context for additional metadata
+        const context = getRequestContext();
+        const logData = {
+            metric: alert.metric,
+            value: alert.value,
+            threshold: alert.threshold,
+            timestamp: alert.timestamp,
+            // Include request context if available
+            ...(context?.userId && { userId: context.userId }),
+            ...(context?.path && { path: context.path }),
+            ...(context?.method && { method: context.method }),
+            ...(context?.ip && { ip: context.ip }),
+        };
+        if (alert.level === 'critical') {
+            logger.error(alert.message, logData);
+        }
+        else {
+            logger.warn(alert.message, logData);
+        }
+    }
+    /**
+     * Send alert to console (uses logger for structured output)
+     */
+    sendToConsole(alert) {
+        const logLevel = alert.level === 'critical' ? 'error' : 'warn';
+        const prefix = alert.level === 'critical' ? '🔴 CRITICAL' : '⚠️  WARNING';
+        logger[logLevel](`${prefix}: ${alert.message}`, {
+            metric: alert.metric,
+            value: alert.value,
+            threshold: alert.threshold,
+            timestamp: alert.timestamp,
+        });
+    }
+    /**
+     * Send alert to Sentry
+     */
+    sendToSentry(alert) {
+        // Only send critical alerts to Sentry
+        if (alert.level !== 'critical')
+            return;
+        // Check if Sentry is available
+        if (!this.sentryClient) {
+            logger.debug('Sentry not available for alert delivery');
+            return;
+        }
+        try {
+            // Get request context for rich tracing
+            const context = getRequestContext();
+            // Build tags (indexed, searchable fields)
+            const tags = {
+                metric: alert.metric,
+                alert_level: alert.level,
+            };
+            // Add request context to tags for better filtering
+            if (context?.requestId)
+                tags.request_id = context.requestId;
+            if (context?.userId)
+                tags.user_id = context.userId;
+            if (context?.path)
+                tags.path = context.path;
+            if (context?.method)
+                tags.method = context.method;
+            // Build extra context (non-indexed, rich data)
+            const extra = {
+                value: alert.value,
+                threshold: alert.threshold,
+                timestamp: alert.timestamp,
+            };
+            // Add full request context for debugging
+            if (context) {
+                extra.request_context = {
+                    requestId: context.requestId,
+                    startTime: context.startTime,
+                    duration: Date.now() - context.startTime,
+                    userId: context.userId,
+                    path: context.path,
+                    method: context.method,
+                    ip: context.ip,
+                    userAgent: context.userAgent,
+                };
+            }
+            // Set user context if available (for Sentry user tracking)
+            if (context?.userId) {
+                this.sentryClient.setUser({
+                    id: context.userId,
+                    ip_address: context.ip,
+                });
+            }
+            // Capture the alert as a Sentry event
+            this.sentryClient.captureMessage(alert.message, {
+                level: 'error',
+                tags,
+                extra,
+            });
+        }
+        catch (error) {
+            // Sentry error, log and continue
+            logger.debug('Sentry not available for alert delivery', { error });
+        }
+    }
+    /**
+     * Start aggregation timer
+     */
+    startAggregation() {
+        if (this.aggregationTimer)
+            return;
+        this.aggregationTimer = setInterval(() => {
+            this.flushAlerts();
+        }, this.config.aggregationInterval);
+        // Don't keep process alive
+        this.aggregationTimer.unref();
+        this.lastAggregationTime = Date.now();
+    }
+    /**
+     * Flush aggregated alerts
+     */
+    flushAlerts() {
+        if (this.alertQueue.length === 0)
+            return;
+        // Group alerts by metric and level
+        const grouped = new Map();
+        for (const alert of this.alertQueue) {
+            const key = `${alert.metric}:${alert.level}`;
+            const existing = grouped.get(key) || [];
+            existing.push(alert);
+            grouped.set(key, existing);
+        }
+        // Send aggregated alerts
+        for (const [_key, alerts] of Array.from(grouped.entries())) {
+            if (alerts.length === 0)
+                continue;
+            const first = alerts[0];
+            if (!first)
+                continue;
+            const count = alerts.length;
+            const avgValue = alerts.reduce((sum, a) => sum + a.value, 0) / count;
+            const aggregatedAlert = {
+                level: first.level,
+                metric: first.metric,
+                value: first.value,
+                threshold: first.threshold,
+                message: `${first.message} (occurred ${count} times, avg value: ${Math.round(avgValue)})`,
+                timestamp: Date.now(),
+            };
+            this.deliverAlert(aggregatedAlert);
+        }
+        // Clear queue
+        this.alertQueue = [];
+        this.lastAggregationTime = Date.now();
+    }
+    /**
+     * Stop aggregation timer
+     */
+    stopAggregation() {
+        if (this.aggregationTimer) {
+            clearInterval(this.aggregationTimer);
+            this.aggregationTimer = null;
+        }
+    }
+    /**
+     * Check if running in production
+     */
+    isProduction() {
+        return process.env.NODE_ENV === 'production';
+    }
+    /**
+     * Get alert queue stats
+     */
+    getStats() {
+        return {
+            queueSize: this.alertQueue.length,
+            lastAggregationTime: this.lastAggregationTime,
+            aggregationEnabled: this.config.aggregateInProduction && this.isProduction(),
+        };
+    }
+    /**
+     * Configure alert channels
+     */
+    setChannels(channels) {
+        this.config.channels = channels;
+    }
+    /**
+     * Cleanup resources
+     */
+    dispose() {
+        this.stopAggregation();
+        this.flushAlerts(); // Flush remaining alerts
+    }
+}
+/**
+ * Singleton instance
+ */
+export const alertManager = new AlertManager();
+/**
+ * Export AlertManager class for testing
+ */
+export { AlertManager };
+/**
+ * Convenience functions
+ */
+export function sendAlert(alert) {
+    alertManager.sendAlert(alert);
+}
+export function sendAlerts(alerts) {
+    alertManager.sendAlerts(alerts);
+}
+export function getAlertStats() {
+    return alertManager.getStats();
+}
+export function setAlertChannels(channels) {
+    alertManager.setChannels(channels);
+}
+//# sourceMappingURL=alerts.js.map

package/dist/packages/core/src/monitoring/alerts.js.map

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

package/dist/packages/core/src/monitoring/cleanup-manager.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Cleanup Manager
+ *
+ * Global cleanup handler registry and graceful shutdown coordination.
+ * Ensures all resources are properly released when the process exits.
+ */
+import type { CleanupHandler, CleanupRegistration } from './types.js';
+/**
+ * Cleanup manager class
+ */
+declare class CleanupManager {
+    private handlers;
+    private isShuttingDown;
+    private shutdownTimeout;
+    private signalHandlersRegistered;
+    /**
+     * Register a cleanup handler
+     */
+    register(id: string, handler: CleanupHandler, description: string, priority?: number): void;
+    /**
+     * Unregister a cleanup handler
+     */
+    unregister(id: string): void;
+    /**
+     * Execute all cleanup handlers
+     */
+    cleanup(signal?: string): Promise<void>;
+    /**
+     * Execute cleanup handlers in sequence
+     */
+    private executeHandlers;
+    /**
+     * Register signal handlers for graceful shutdown
+     */
+    private registerSignalHandlers;
+    /**
+     * Force immediate cleanup (skip timeout)
+     */
+    forceCleanup(): Promise<void>;
+    /**
+     * Get registered handlers
+     */
+    getHandlers(): CleanupRegistration[];
+    /**
+     * Check if shutdown is in progress
+     */
+    isShutdownInProgress(): boolean;
+    /**
+     * Set shutdown timeout
+     */
+    setShutdownTimeout(ms: number): void;
+    /**
+     * Clear all handlers
+     */
+    clear(): void;
+}
+/**
+ * Singleton instance
+ */
+export declare const cleanupManager: CleanupManager;
+/**
+ * Convenience functions
+ */
+export declare function registerCleanupHandler(id: string, handler: CleanupHandler, description: string, priority?: number): void;
+export declare function unregisterCleanupHandler(id: string): void;
+export declare function initiateCleanup(signal?: string): Promise<void>;
+export declare function forceCleanup(): Promise<void>;
+export declare function getCleanupHandlers(): CleanupRegistration[];
+export declare function isShutdownInProgress(): boolean;
+export {};
+//# sourceMappingURL=cleanup-manager.d.ts.map

package/dist/packages/core/src/monitoring/cleanup-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-manager.d.ts","sourceRoot":"","sources":["../../../../../../core/src/monitoring/cleanup-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAErE;;GAEG;AACH,cAAM,cAAc;IAClB,OAAO,CAAC,QAAQ,CAA8C;IAC9D,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,wBAAwB,CAAQ;IAExC;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,IAAI;IAqBtF;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAM5B;;OAEG;IACG,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmD7C;;OAEG;YACW,eAAe;IAsC7B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAmD9B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAWnC;;OAEG;IACH,WAAW,IAAI,mBAAmB,EAAE;IAIpC;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpC;;OAEG;IACH,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,gBAAuB,CAAA;AAElD;;GAEG;AAEH,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,SAAI,GACX,IAAI,CAEN;AAED,wBAAgB,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAEzD;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,wBAAgB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5C;AAED,wBAAgB,kBAAkB,IAAI,mBAAmB,EAAE,CAE1D;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAE9C"}