@serve.zone/dcrouter 11.0.22 → 11.0.23

package/dist_ts/logger.js

@@ -0,0 +1,81 @@
+import * as plugins from './plugins.js';
+import { randomUUID } from 'node:crypto';
+import { SmartlogDestinationBuffer } from '@push.rocks/smartlog/destination-buffer';
+// Map NODE_ENV to valid TEnvironment
+const nodeEnv = process.env.NODE_ENV || 'production';
+const envMap = {
+    'development': 'local',
+    'test': 'test',
+    'staging': 'staging',
+    'production': 'production'
+};
+// In-memory log buffer for the OpsServer UI
+export const logBuffer = new SmartlogDestinationBuffer({ maxEntries: 2000 });
+// Default Smartlog instance (exported so OpsServer can add push destinations)
+export const baseLogger = new plugins.smartlog.Smartlog({
+    logContext: {
+        environment: envMap[nodeEnv] || 'production',
+        runtime: 'node',
+        zone: 'serve.zone',
+    }
+});
+// Wire the buffer destination so all logs are captured
+baseLogger.addLogDestination(logBuffer);
+// Extended logger compatible with the original enhanced logger API
+class StandardLogger {
+    defaultContext = {};
+    correlationId = null;
+    constructor() { }
+    // Log methods
+    log(level, message, context = {}) {
+        const combinedContext = {
+            ...this.defaultContext,
+            ...context
+        };
+        if (this.correlationId) {
+            combinedContext.correlation_id = this.correlationId;
+        }
+        baseLogger.log(level, message, combinedContext);
+    }
+    error(message, context = {}) {
+        this.log('error', message, context);
+    }
+    warn(message, context = {}) {
+        this.log('warn', message, context);
+    }
+    info(message, context = {}) {
+        this.log('info', message, context);
+    }
+    success(message, context = {}) {
+        this.log('success', message, context);
+    }
+    debug(message, context = {}) {
+        this.log('debug', message, context);
+    }
+    // Context management
+    setContext(context, overwrite = false) {
+        if (overwrite) {
+            this.defaultContext = context;
+        }
+        else {
+            this.defaultContext = {
+                ...this.defaultContext,
+                ...context
+            };
+        }
+    }
+    // Correlation ID management
+    setCorrelationId(id = null) {
+        this.correlationId = id || randomUUID();
+        return this.correlationId;
+    }
+    getCorrelationId() {
+        return this.correlationId;
+    }
+    clearCorrelationId() {
+        this.correlationId = null;
+    }
+}
+// Export a singleton instance (build verification)
+export const logger = new StandardLogger();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvbG9nZ2VyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxPQUFPLE1BQU0sY0FBYyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDekMsT0FBTyxFQUFFLHlCQUF5QixFQUFFLE1BQU0seUNBQXlDLENBQUM7QUFFcEYscUNBQXFDO0FBQ3JDLE1BQU0sT0FBTyxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsUUFBUSxJQUFJLFlBQVksQ0FBQztBQUNyRCxNQUFNLE1BQU0sR0FBZ0U7SUFDMUUsYUFBYSxFQUFFLE9BQU87SUFDdEIsTUFBTSxFQUFFLE1BQU07SUFDZCxTQUFTLEVBQUUsU0FBUztJQUNwQixZQUFZLEVBQUUsWUFBWTtDQUMzQixDQUFDO0FBRUYsNENBQTRDO0FBQzVDLE1BQU0sQ0FBQyxNQUFNLFNBQVMsR0FBRyxJQUFJLHlCQUF5QixDQUFDLEVBQUUsVUFBVSxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7QUFFN0UsOEVBQThFO0FBQzlFLE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRyxJQUFJLE9BQU8sQ0FBQyxRQUFRLENBQUMsUUFBUSxDQUFDO0lBQ3RELFVBQVUsRUFBRTtRQUNWLFdBQVcsRUFBRSxNQUFNLENBQUMsT0FBTyxDQUFDLElBQUksWUFBWTtRQUM1QyxPQUFPLEVBQUUsTUFBTTtRQUNmLElBQUksRUFBRSxZQUFZO0tBQ25CO0NBQ0YsQ0FBQyxDQUFDO0FBRUgsdURBQXVEO0FBQ3ZELFVBQVUsQ0FBQyxpQkFBaUIsQ0FBQyxTQUFTLENBQUMsQ0FBQztBQUV4QyxtRUFBbUU7QUFDbkUsTUFBTSxjQUFjO0lBQ1YsY0FBYyxHQUF3QixFQUFFLENBQUM7SUFDekMsYUFBYSxHQUFrQixJQUFJLENBQUM7SUFFNUMsZ0JBQWUsQ0FBQztJQUVoQixjQUFjO0lBQ1AsR0FBRyxDQUFDLEtBQXNELEVBQUUsT0FBZSxFQUFFLFVBQStCLEVBQUU7UUFDbkgsTUFBTSxlQUFlLEdBQUc7WUFDdEIsR0FBRyxJQUFJLENBQUMsY0FBYztZQUN0QixHQUFHLE9BQU87U0FDWCxDQUFDO1FBRUYsSUFBSSxJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7WUFDdkIsZUFBZSxDQUFDLGNBQWMsR0FBRyxJQUFJLENBQUMsYUFBYSxDQUFDO1FBQ3RELENBQUM7UUFFRCxVQUFVLENBQUMsR0FBRyxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsZUFBZSxDQUFDLENBQUM7SUFDbEQsQ0FBQztJQUVNLEtBQUssQ0FBQyxPQUFlLEVBQUUsVUFBK0IsRUFBRTtRQUM3RCxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDdEMsQ0FBQztJQUVNLElBQUksQ0FBQyxPQUFlLEVBQUUsVUFBK0IsRUFBRTtRQUM1RCxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRSxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDckMsQ0FBQztJQUVNLElBQUksQ0FBQyxPQUFlLEVBQUUsVUFBK0IsRUFBRTtRQUM1RCxJQUFJLENBQUMsR0FBRyxDQUFDLE1BQU0sRUFBRSxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDckMsQ0FBQztJQUVNLE9BQU8sQ0FBQyxPQUFlLEVBQUUsVUFBK0IsRUFBRTtRQUMvRCxJQUFJLENBQUMsR0FBRyxDQUFDLFNBQVMsRUFBRSxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDeEMsQ0FBQztJQUVNLEtBQUssQ0FBQyxPQUFlLEVBQUUsVUFBK0IsRUFBRTtRQUM3RCxJQUFJLENBQUMsR0FBRyxDQUFDLE9BQU8sRUFBRSxPQUFPLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDdEMsQ0FBQztJQUVELHFCQUFxQjtJQUNkLFVBQVUsQ0FBQyxPQUE0QixFQUFFLFlBQXFCLEtBQUs7UUFDeEUsSUFBSSxTQUFTLEVBQUUsQ0FBQztZQUNkLElBQUksQ0FBQyxjQUFjLEdBQUcsT0FBTyxDQUFDO1FBQ2hDLENBQUM7YUFBTSxDQUFDO1lBQ04sSUFBSSxDQUFDLGNBQWMsR0FBRztnQkFDcEIsR0FBRyxJQUFJLENBQUMsY0FBYztnQkFDdEIsR0FBRyxPQUFPO2FBQ1gsQ0FBQztRQUNKLENBQUM7SUFDSCxDQUFDO0lBRUQsNEJBQTRCO0lBQ3JCLGdCQUFnQixDQUFDLEtBQW9CLElBQUk7UUFDOUMsSUFBSSxDQUFDLGFBQWEsR0FBRyxFQUFFLElBQUksVUFBVSxFQUFFLENBQUM7UUFDeEMsT0FBTyxJQUFJLENBQUMsYUFBYSxDQUFDO0lBQzVCLENBQUM7SUFFTSxnQkFBZ0I7UUFDckIsT0FBTyxJQUFJLENBQUMsYUFBYSxDQUFDO0lBQzVCLENBQUM7SUFFTSxrQkFBa0I7UUFDdkIsSUFBSSxDQUFDLGFBQWEsR0FBRyxJQUFJLENBQUM7SUFDNUIsQ0FBQztDQUNGO0FBRUQsbURBQW1EO0FBQ25ELE1BQU0sQ0FBQyxNQUFNLE1BQU0sR0FBRyxJQUFJLGNBQWMsRUFBRSxDQUFDIn0=

package/dist_ts/monitoring/classes.metricscache.d.ts

@@ -0,0 +1,32 @@
+export interface ICacheEntry<T> {
+    data: T;
+    timestamp: number;
+}
+export declare class MetricsCache {
+    private cache;
+    private readonly defaultTTL;
+    constructor(defaultTTL?: number);
+    /**
+     * Get cached data or compute and cache it
+     */
+    get<T>(key: string, computeFn: () => T | Promise<T>, ttl?: number): T | Promise<T>;
+    /**
+     * Invalidate a specific cache entry
+     */
+    invalidate(key: string): void;
+    /**
+     * Clear all cache entries
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    getStats(): {
+        size: number;
+        keys: string[];
+    };
+    /**
+     * Clean up expired entries
+     */
+    cleanup(): void;
+}

package/dist_ts/monitoring/classes.metricscache.js

@@ -0,0 +1,63 @@
+export class MetricsCache {
+    cache = new Map();
+    defaultTTL;
+    constructor(defaultTTL = 500) {
+        this.defaultTTL = defaultTTL;
+    }
+    /**
+     * Get cached data or compute and cache it
+     */
+    get(key, computeFn, ttl) {
+        const cached = this.cache.get(key);
+        const now = Date.now();
+        const actualTTL = ttl ?? this.defaultTTL;
+        if (cached && (now - cached.timestamp) < actualTTL) {
+            return cached.data;
+        }
+        const result = computeFn();
+        // Handle both sync and async compute functions
+        if (result instanceof Promise) {
+            return result.then(data => {
+                this.cache.set(key, { data, timestamp: now });
+                return data;
+            });
+        }
+        else {
+            this.cache.set(key, { data: result, timestamp: now });
+            return result;
+        }
+    }
+    /**
+     * Invalidate a specific cache entry
+     */
+    invalidate(key) {
+        this.cache.delete(key);
+    }
+    /**
+     * Clear all cache entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    getStats() {
+        return {
+            size: this.cache.size,
+            keys: Array.from(this.cache.keys())
+        };
+    }
+    /**
+     * Clean up expired entries
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (now - entry.timestamp > this.defaultTTL) {
+                this.cache.delete(key);
+            }
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xhc3Nlcy5tZXRyaWNzY2FjaGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9tb25pdG9yaW5nL2NsYXNzZXMubWV0cmljc2NhY2hlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUtBLE1BQU0sT0FBTyxZQUFZO0lBQ2YsS0FBSyxHQUFHLElBQUksR0FBRyxFQUE0QixDQUFDO0lBQ25DLFVBQVUsQ0FBUztJQUVwQyxZQUFZLGFBQXFCLEdBQUc7UUFDbEMsSUFBSSxDQUFDLFVBQVUsR0FBRyxVQUFVLENBQUM7SUFDL0IsQ0FBQztJQUVEOztPQUVHO0lBQ0ksR0FBRyxDQUFJLEdBQVcsRUFBRSxTQUErQixFQUFFLEdBQVk7UUFDdEUsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsR0FBRyxDQUFDLENBQUM7UUFDbkMsTUFBTSxHQUFHLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO1FBQ3ZCLE1BQU0sU0FBUyxHQUFHLEdBQUcsSUFBSSxJQUFJLENBQUMsVUFBVSxDQUFDO1FBRXpDLElBQUksTUFBTSxJQUFJLENBQUMsR0FBRyxHQUFHLE1BQU0sQ0FBQyxTQUFTLENBQUMsR0FBRyxTQUFTLEVBQUUsQ0FBQztZQUNuRCxPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUM7UUFDckIsQ0FBQztRQUVELE1BQU0sTUFBTSxHQUFHLFNBQVMsRUFBRSxDQUFDO1FBRTNCLCtDQUErQztRQUMvQyxJQUFJLE1BQU0sWUFBWSxPQUFPLEVBQUUsQ0FBQztZQUM5QixPQUFPLE1BQU0sQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLEVBQUU7Z0JBQ3hCLElBQUksQ0FBQyxLQUFLLENBQUMsR0FBRyxDQUFDLEdBQUcsRUFBRSxFQUFFLElBQUksRUFBRSxTQUFTLEVBQUUsR0FBRyxFQUFFLENBQUMsQ0FBQztnQkFDOUMsT0FBTyxJQUFJLENBQUM7WUFDZCxDQUFDLENBQUMsQ0FBQztRQUNMLENBQUM7YUFBTSxDQUFDO1lBQ04sSUFBSSxDQUFDLEtBQUssQ0FBQyxHQUFHLENBQUMsR0FBRyxFQUFFLEVBQUUsSUFBSSxFQUFFLE1BQU0sRUFBRSxTQUFTLEVBQUUsR0FBRyxFQUFFLENBQUMsQ0FBQztZQUN0RCxPQUFPLE1BQU0sQ0FBQztRQUNoQixDQUFDO0lBQ0gsQ0FBQztJQUVEOztPQUVHO0lBQ0ksVUFBVSxDQUFDLEdBQVc7UUFDM0IsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7SUFDekIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksS0FBSztRQUNWLElBQUksQ0FBQyxLQUFLLENBQUMsS0FBSyxFQUFFLENBQUM7SUFDckIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksUUFBUTtRQUNiLE9BQU87WUFDTCxJQUFJLEVBQUUsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJO1lBQ3JCLElBQUksRUFBRSxLQUFLLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxLQUFLLENBQUMsSUFBSSxFQUFFLENBQUM7U0FDcEMsQ0FBQztJQUNKLENBQUM7SUFFRDs7T0FFRztJQUNJLE9BQU87UUFDWixNQUFNLEdBQUcsR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFDdkIsS0FBSyxNQUFNLENBQUMsR0FBRyxFQUFFLEtBQUssQ0FBQyxJQUFJLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxFQUFFLEVBQUUsQ0FBQztZQUNoRCxJQUFJLEdBQUcsR0FBRyxLQUFLLENBQUMsU0FBUyxHQUFHLElBQUksQ0FBQyxVQUFVLEVBQUUsQ0FBQztnQkFDNUMsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLENBQUM7WUFDekIsQ0FBQztRQUNILENBQUM7SUFDSCxDQUFDO0NBQ0YifQ==

package/dist_ts/monitoring/classes.metricsmanager.d.ts

@@ -0,0 +1,178 @@
+import { DcRouter } from '../classes.dcrouter.js';
+export declare class MetricsManager {
+    private metricsLogger;
+    private smartMetrics;
+    private dcRouter;
+    private resetInterval?;
+    private metricsCache;
+    private readonly MAX_TOP_DOMAINS;
+    private emailMetrics;
+    private dnsMetrics;
+    private emailMinuteBuckets;
+    private dnsMinuteBuckets;
+    private securityMetrics;
+    constructor(dcRouter: DcRouter);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getServerStats(): Promise<{
+        uptime: number;
+        startTime: number;
+        memoryUsage: {
+            heapUsed: number;
+            heapTotal: number;
+            external: number;
+            rss: number;
+            maxMemoryMB: number;
+            actualUsageBytes: number;
+            actualUsagePercentage: number;
+        };
+        cpuUsage: {
+            user: number;
+            system: number;
+        };
+        activeConnections: any;
+        totalConnections: number;
+        requestsPerSecond: number;
+        throughput: {
+            bytesIn: number;
+            bytesOut: number;
+            bytesInPerSecond: number;
+            bytesOutPerSecond: number;
+        };
+    }>;
+    getEmailStats(): Promise<{
+        sentToday: number;
+        receivedToday: number;
+        failedToday: number;
+        bounceRate: number;
+        deliveryRate: number;
+        queueSize: number;
+        averageDeliveryTime: number;
+        topRecipients: {
+            email: string;
+            count: number;
+        }[];
+        recentActivity: {
+            timestamp: number;
+            type: string;
+            details: string;
+        }[];
+    }>;
+    getDnsStats(): Promise<{
+        queriesPerSecond: number;
+        totalQueries: number;
+        cacheHits: number;
+        cacheMisses: number;
+        cacheHitRate: number;
+        topDomains: {
+            domain: string;
+            count: number;
+        }[];
+        queryTypes: Record<string, number>;
+        averageResponseTime: number;
+        activeDomains: number;
+        recentQueries: {
+            timestamp: number;
+            domain: string;
+            type: string;
+            answered: boolean;
+            responseTimeMs: number;
+        }[];
+    }>;
+    /**
+     * Sync security metrics from the SecurityLogger singleton (last 24h).
+     * Called before returning security stats so counters reflect real events.
+     */
+    private syncFromSecurityLogger;
+    getSecurityStats(): Promise<{
+        blockedIPs: number;
+        authFailures: number;
+        spamDetected: number;
+        malwareDetected: number;
+        phishingDetected: number;
+        totalThreatsBlocked: number;
+        recentIncidents: {
+            timestamp: number;
+            type: string;
+            severity: string;
+            details: string;
+        }[];
+    }>;
+    getConnectionInfo(): Promise<any[]>;
+    trackEmailSent(recipient?: string, deliveryTimeMs?: number): void;
+    trackEmailReceived(sender?: string): void;
+    trackEmailFailed(recipient?: string, reason?: string): void;
+    trackEmailBounced(recipient?: string): void;
+    updateQueueSize(size: number): void;
+    trackDnsQuery(queryType: string, domain: string, cacheHit: boolean, responseTimeMs?: number, answered?: boolean): void;
+    trackBlockedIP(ip?: string, reason?: string): void;
+    trackAuthFailure(username?: string, ip?: string): void;
+    trackSpamDetected(sender?: string): void;
+    trackMalwareDetected(source?: string): void;
+    trackPhishingDetected(source?: string): void;
+    getNetworkStats(): Promise<{
+        connectionsByIP: Map<string, number>;
+        throughputRate: {
+            bytesInPerSecond: number;
+            bytesOutPerSecond: number;
+        };
+        topIPs: Array<{
+            ip: string;
+            count: number;
+        }>;
+        totalDataTransferred: {
+            bytesIn: number;
+            bytesOut: number;
+        };
+        throughputHistory: Array<{
+            timestamp: number;
+            in: number;
+            out: number;
+        }>;
+        throughputByIP: Map<string, {
+            in: number;
+            out: number;
+        }>;
+        requestsPerSecond: number;
+        requestsTotal: number;
+    }>;
+    private static minuteKey;
+    private incrementEmailBucket;
+    private incrementDnsBucket;
+    /**
+     * Increment the per-second query counter in the ring buffer.
+     * Zeros any stale slots between the last write and the current second.
+     */
+    private incrementQueryRing;
+    /**
+     * Sum query counts from the ring buffer for the last N seconds.
+     */
+    private getQueryRingSum;
+    private pruneOldBuckets;
+    /**
+     * Get email time-series data for the last N hours, aggregated per minute.
+     */
+    getEmailTimeSeries(hours?: number): {
+        sent: Array<{
+            timestamp: number;
+            value: number;
+        }>;
+        received: Array<{
+            timestamp: number;
+            value: number;
+        }>;
+        failed: Array<{
+            timestamp: number;
+            value: number;
+        }>;
+    };
+    /**
+     * Get DNS time-series data for the last N hours, aggregated per minute.
+     */
+    getDnsTimeSeries(hours?: number): {
+        queries: Array<{
+            timestamp: number;
+            value: number;
+        }>;
+    };
+}