@serve.zone/dcrouter 8.1.0 → 9.1.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@serve.zone/dcrouter',
-    version: '8.1.0',
+    version: '9.1.0',
     description: 'A multifaceted routing service handling mail and SMS delivery functions.'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxzQkFBc0I7SUFDNUIsT0FBTyxFQUFFLE9BQU87SUFDaEIsV0FBVyxFQUFFLDBFQUEwRTtDQUN4RixDQUFBIn0=

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

@@ -0,0 +1,169 @@
+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;
+    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;
+        }>;
+    };
+}