@serve.zone/dcrouter 2.12.4

package/dist_ts/ts/mail/delivery/smtpserver/utils/adaptive-logging.d.ts

@@ -0,0 +1,117 @@
+/**
+ * Adaptive SMTP Logging System
+ * Automatically switches between logging modes based on server load (active connections)
+ * to maintain performance during high-concurrency scenarios
+ */
+import * as plugins from '../../../../plugins.js';
+import { SecurityLogLevel, SecurityEventType } from '../constants.js';
+import type { ISmtpSession } from '../interfaces.js';
+import type { LogLevel, ISmtpLogOptions } from './logging.js';
+/**
+ * Log modes based on server load
+ */
+export declare enum LogMode {
+    VERBOSE = "VERBOSE",// < 20 connections: Full detailed logging
+    REDUCED = "REDUCED",// 20-40 connections: Limited command/response logging, full error logging
+    MINIMAL = "MINIMAL"
+}
+/**
+ * Configuration for adaptive logging thresholds
+ */
+export interface IAdaptiveLogConfig {
+    verboseThreshold: number;
+    reducedThreshold: number;
+    aggregationInterval: number;
+    maxAggregatedEntries: number;
+}
+/**
+ * Connection metadata for aggregation tracking
+ */
+interface IConnectionTracker {
+    activeConnections: number;
+    peakConnections: number;
+    totalConnections: number;
+    connectionsPerSecond: number;
+    lastConnectionTime: number;
+}
+/**
+ * Adaptive SMTP Logger that scales logging based on server load
+ */
+export declare class AdaptiveSmtpLogger {
+    private static instance;
+    private currentMode;
+    private config;
+    private aggregatedEntries;
+    private aggregationTimer;
+    private connectionTracker;
+    private constructor();
+    /**
+     * Get singleton instance
+     */
+    static getInstance(config?: Partial<IAdaptiveLogConfig>): AdaptiveSmtpLogger;
+    /**
+     * Update active connection count and adjust log mode if needed
+     */
+    updateConnectionCount(activeConnections: number): void;
+    /**
+     * Track new connection for rate calculation
+     */
+    trackConnection(): void;
+    /**
+     * Get current logging mode
+     */
+    getCurrentMode(): LogMode;
+    /**
+     * Get connection statistics
+     */
+    getConnectionStats(): IConnectionTracker;
+    /**
+     * Log a message with adaptive behavior
+     */
+    log(level: LogLevel, message: string, options?: ISmtpLogOptions): void;
+    /**
+     * Log command with adaptive behavior
+     */
+    logCommand(command: string, socket: plugins.net.Socket | plugins.tls.TLSSocket, session?: ISmtpSession): void;
+    /**
+     * Log response with adaptive behavior
+     */
+    logResponse(response: string, socket: plugins.net.Socket | plugins.tls.TLSSocket): void;
+    /**
+     * Log connection event with adaptive behavior
+     */
+    logConnection(socket: plugins.net.Socket | plugins.tls.TLSSocket, eventType: 'connect' | 'close' | 'error', session?: ISmtpSession, error?: Error): void;
+    /**
+     * Log security event (always logged regardless of mode)
+     */
+    logSecurityEvent(level: SecurityLogLevel, type: SecurityEventType, message: string, details: Record<string, any>, ipAddress?: string, domain?: string, success?: boolean): void;
+    /**
+     * Determine appropriate log mode based on connection count
+     */
+    private determineLogMode;
+    /**
+     * Switch to a new log mode
+     */
+    private switchLogMode;
+    /**
+     * Add entry to aggregation buffer
+     */
+    private aggregateEntry;
+    /**
+     * Start the aggregation timer
+     */
+    private startAggregationTimer;
+    /**
+     * Flush aggregated entries to logs
+     */
+    private flushAggregatedEntries;
+    /**
+     * Cleanup resources
+     */
+    destroy(): void;
+}
+/**
+ * Default instance for easy access
+ */
+export declare const adaptiveLogger: AdaptiveSmtpLogger;
+export {};

package/dist_ts/ts/mail/delivery/smtpserver/utils/adaptive-logging.js

@@ -0,0 +1,411 @@
+/**
+ * Adaptive SMTP Logging System
+ * Automatically switches between logging modes based on server load (active connections)
+ * to maintain performance during high-concurrency scenarios
+ */
+import * as plugins from '../../../../plugins.js';
+import { logger } from '../../../../logger.js';
+import { SecurityLogLevel, SecurityEventType } from '../constants.js';
+/**
+ * Log modes based on server load
+ */
+export var LogMode;
+(function (LogMode) {
+    LogMode["VERBOSE"] = "VERBOSE";
+    LogMode["REDUCED"] = "REDUCED";
+    LogMode["MINIMAL"] = "MINIMAL"; // 40+ connections: Aggregated logging only, critical errors only
+})(LogMode || (LogMode = {}));
+/**
+ * Adaptive SMTP Logger that scales logging based on server load
+ */
+export class AdaptiveSmtpLogger {
+    constructor(config) {
+        this.currentMode = LogMode.VERBOSE;
+        this.aggregatedEntries = new Map();
+        this.aggregationTimer = null;
+        this.connectionTracker = {
+            activeConnections: 0,
+            peakConnections: 0,
+            totalConnections: 0,
+            connectionsPerSecond: 0,
+            lastConnectionTime: Date.now()
+        };
+        this.config = {
+            verboseThreshold: 20,
+            reducedThreshold: 40,
+            aggregationInterval: 30000, // 30 seconds
+            maxAggregatedEntries: 100,
+            ...config
+        };
+        this.startAggregationTimer();
+    }
+    /**
+     * Get singleton instance
+     */
+    static getInstance(config) {
+        if (!AdaptiveSmtpLogger.instance) {
+            AdaptiveSmtpLogger.instance = new AdaptiveSmtpLogger(config);
+        }
+        return AdaptiveSmtpLogger.instance;
+    }
+    /**
+     * Update active connection count and adjust log mode if needed
+     */
+    updateConnectionCount(activeConnections) {
+        this.connectionTracker.activeConnections = activeConnections;
+        this.connectionTracker.peakConnections = Math.max(this.connectionTracker.peakConnections, activeConnections);
+        const newMode = this.determineLogMode(activeConnections);
+        if (newMode !== this.currentMode) {
+            this.switchLogMode(newMode);
+        }
+    }
+    /**
+     * Track new connection for rate calculation
+     */
+    trackConnection() {
+        this.connectionTracker.totalConnections++;
+        const now = Date.now();
+        const timeDiff = (now - this.connectionTracker.lastConnectionTime) / 1000;
+        if (timeDiff > 0) {
+            this.connectionTracker.connectionsPerSecond = 1 / timeDiff;
+        }
+        this.connectionTracker.lastConnectionTime = now;
+    }
+    /**
+     * Get current logging mode
+     */
+    getCurrentMode() {
+        return this.currentMode;
+    }
+    /**
+     * Get connection statistics
+     */
+    getConnectionStats() {
+        return { ...this.connectionTracker };
+    }
+    /**
+     * Log a message with adaptive behavior
+     */
+    log(level, message, options = {}) {
+        // Always log structured data
+        const errorInfo = options.error ? {
+            errorMessage: options.error.message,
+            errorStack: options.error.stack,
+            errorName: options.error.name
+        } : {};
+        const logData = {
+            component: 'smtp-server',
+            logMode: this.currentMode,
+            activeConnections: this.connectionTracker.activeConnections,
+            ...options,
+            ...errorInfo
+        };
+        if (logData.error) {
+            delete logData.error;
+        }
+        logger.log(level, message, logData);
+        // Adaptive console logging based on mode
+        switch (this.currentMode) {
+            case LogMode.VERBOSE:
+                // Full console logging
+                if (level === 'error' || level === 'warn') {
+                    console[level](`[SMTP] ${message}`, logData);
+                }
+                break;
+            case LogMode.REDUCED:
+                // Only errors and warnings to console
+                if (level === 'error' || level === 'warn') {
+                    console[level](`[SMTP] ${message}`, logData);
+                }
+                break;
+            case LogMode.MINIMAL:
+                // Only critical errors to console
+                if (level === 'error' && (message.includes('critical') || message.includes('security') || message.includes('crash'))) {
+                    console[level](`[SMTP] ${message}`, logData);
+                }
+                break;
+        }
+    }
+    /**
+     * Log command with adaptive behavior
+     */
+    logCommand(command, socket, session) {
+        const clientInfo = {
+            remoteAddress: socket.remoteAddress,
+            remotePort: socket.remotePort,
+            secure: socket instanceof plugins.tls.TLSSocket,
+            sessionId: session?.id,
+            sessionState: session?.state
+        };
+        switch (this.currentMode) {
+            case LogMode.VERBOSE:
+                this.log('info', `Command received: ${command}`, {
+                    ...clientInfo,
+                    command: command.split(' ')[0]?.toUpperCase()
+                });
+                console.log(`← ${command}`);
+                break;
+            case LogMode.REDUCED:
+                // Aggregate commands instead of logging each one
+                this.aggregateEntry('command', 'info', `Command: ${command.split(' ')[0]?.toUpperCase()}`, clientInfo);
+                // Only show error commands
+                if (command.toUpperCase().startsWith('QUIT') || command.includes('error')) {
+                    console.log(`← ${command}`);
+                }
+                break;
+            case LogMode.MINIMAL:
+                // Only aggregate, no console output unless it's an error command
+                this.aggregateEntry('command', 'info', `Command: ${command.split(' ')[0]?.toUpperCase()}`, clientInfo);
+                break;
+        }
+    }
+    /**
+     * Log response with adaptive behavior
+     */
+    logResponse(response, socket) {
+        const clientInfo = {
+            remoteAddress: socket.remoteAddress,
+            remotePort: socket.remotePort,
+            secure: socket instanceof plugins.tls.TLSSocket
+        };
+        const responseCode = response.substring(0, 3);
+        const isError = responseCode.startsWith('4') || responseCode.startsWith('5');
+        switch (this.currentMode) {
+            case LogMode.VERBOSE:
+                if (responseCode.startsWith('2') || responseCode.startsWith('3')) {
+                    this.log('debug', `Response sent: ${response}`, clientInfo);
+                }
+                else if (responseCode.startsWith('4')) {
+                    this.log('warn', `Temporary error response: ${response}`, clientInfo);
+                }
+                else if (responseCode.startsWith('5')) {
+                    this.log('error', `Permanent error response: ${response}`, clientInfo);
+                }
+                console.log(`→ ${response}`);
+                break;
+            case LogMode.REDUCED:
+                // Log errors normally, aggregate success responses
+                if (isError) {
+                    if (responseCode.startsWith('4')) {
+                        this.log('warn', `Temporary error response: ${response}`, clientInfo);
+                    }
+                    else {
+                        this.log('error', `Permanent error response: ${response}`, clientInfo);
+                    }
+                    console.log(`→ ${response}`);
+                }
+                else {
+                    this.aggregateEntry('response', 'debug', `Response: ${responseCode}xx`, clientInfo);
+                }
+                break;
+            case LogMode.MINIMAL:
+                // Only log critical errors
+                if (responseCode.startsWith('5')) {
+                    this.log('error', `Permanent error response: ${response}`, clientInfo);
+                    console.log(`→ ${response}`);
+                }
+                else {
+                    this.aggregateEntry('response', 'debug', `Response: ${responseCode}xx`, clientInfo);
+                }
+                break;
+        }
+    }
+    /**
+     * Log connection event with adaptive behavior
+     */
+    logConnection(socket, eventType, session, error) {
+        const clientInfo = {
+            remoteAddress: socket.remoteAddress,
+            remotePort: socket.remotePort,
+            secure: socket instanceof plugins.tls.TLSSocket,
+            sessionId: session?.id,
+            sessionState: session?.state
+        };
+        if (eventType === 'connect') {
+            this.trackConnection();
+        }
+        switch (this.currentMode) {
+            case LogMode.VERBOSE:
+                // Full connection logging
+                switch (eventType) {
+                    case 'connect':
+                        this.log('info', `New ${clientInfo.secure ? 'secure ' : ''}connection from ${clientInfo.remoteAddress}:${clientInfo.remotePort}`, clientInfo);
+                        break;
+                    case 'close':
+                        this.log('info', `Connection closed from ${clientInfo.remoteAddress}:${clientInfo.remotePort}`, clientInfo);
+                        break;
+                    case 'error':
+                        this.log('error', `Connection error from ${clientInfo.remoteAddress}:${clientInfo.remotePort}`, {
+                            ...clientInfo,
+                            error
+                        });
+                        break;
+                }
+                break;
+            case LogMode.REDUCED:
+                // Aggregate normal connections, log errors
+                if (eventType === 'error') {
+                    this.log('error', `Connection error from ${clientInfo.remoteAddress}:${clientInfo.remotePort}`, {
+                        ...clientInfo,
+                        error
+                    });
+                }
+                else {
+                    this.aggregateEntry('connection', 'info', `Connection ${eventType}`, clientInfo);
+                }
+                break;
+            case LogMode.MINIMAL:
+                // Only aggregate, except for critical errors
+                if (eventType === 'error' && error && (error.message.includes('security') || error.message.includes('critical'))) {
+                    this.log('error', `Critical connection error from ${clientInfo.remoteAddress}:${clientInfo.remotePort}`, {
+                        ...clientInfo,
+                        error
+                    });
+                }
+                else {
+                    this.aggregateEntry('connection', 'info', `Connection ${eventType}`, clientInfo);
+                }
+                break;
+        }
+    }
+    /**
+     * Log security event (always logged regardless of mode)
+     */
+    logSecurityEvent(level, type, message, details, ipAddress, domain, success) {
+        const logLevel = level === SecurityLogLevel.DEBUG ? 'debug' :
+            level === SecurityLogLevel.INFO ? 'info' :
+                level === SecurityLogLevel.WARN ? 'warn' : 'error';
+        // Security events are always logged in full detail
+        this.log(logLevel, message, {
+            component: 'smtp-security',
+            eventType: type,
+            success,
+            ipAddress,
+            domain,
+            ...details
+        });
+    }
+    /**
+     * Determine appropriate log mode based on connection count
+     */
+    determineLogMode(activeConnections) {
+        if (activeConnections >= this.config.reducedThreshold) {
+            return LogMode.MINIMAL;
+        }
+        else if (activeConnections >= this.config.verboseThreshold) {
+            return LogMode.REDUCED;
+        }
+        else {
+            return LogMode.VERBOSE;
+        }
+    }
+    /**
+     * Switch to a new log mode
+     */
+    switchLogMode(newMode) {
+        const oldMode = this.currentMode;
+        this.currentMode = newMode;
+        // Log the mode switch
+        console.log(`[SMTP] Adaptive logging switched from ${oldMode} to ${newMode} (${this.connectionTracker.activeConnections} active connections)`);
+        this.log('info', `Adaptive logging mode changed to ${newMode}`, {
+            oldMode,
+            newMode,
+            activeConnections: this.connectionTracker.activeConnections,
+            peakConnections: this.connectionTracker.peakConnections,
+            totalConnections: this.connectionTracker.totalConnections
+        });
+        // If switching to more verbose mode, flush aggregated entries
+        if ((oldMode === LogMode.MINIMAL && newMode !== LogMode.MINIMAL) ||
+            (oldMode === LogMode.REDUCED && newMode === LogMode.VERBOSE)) {
+            this.flushAggregatedEntries();
+        }
+    }
+    /**
+     * Add entry to aggregation buffer
+     */
+    aggregateEntry(type, level, message, options) {
+        const key = `${type}:${message}`;
+        const now = Date.now();
+        if (this.aggregatedEntries.has(key)) {
+            const entry = this.aggregatedEntries.get(key);
+            entry.count++;
+            entry.lastSeen = now;
+        }
+        else {
+            this.aggregatedEntries.set(key, {
+                type,
+                count: 1,
+                firstSeen: now,
+                lastSeen: now,
+                sample: { message, level, options }
+            });
+        }
+        // Force flush if we have too many entries
+        if (this.aggregatedEntries.size >= this.config.maxAggregatedEntries) {
+            this.flushAggregatedEntries();
+        }
+    }
+    /**
+     * Start the aggregation timer
+     */
+    startAggregationTimer() {
+        if (this.aggregationTimer) {
+            clearInterval(this.aggregationTimer);
+        }
+        this.aggregationTimer = setInterval(() => {
+            this.flushAggregatedEntries();
+        }, this.config.aggregationInterval);
+        // Unref the timer so it doesn't keep the process alive
+        if (this.aggregationTimer && typeof this.aggregationTimer.unref === 'function') {
+            this.aggregationTimer.unref();
+        }
+    }
+    /**
+     * Flush aggregated entries to logs
+     */
+    flushAggregatedEntries() {
+        if (this.aggregatedEntries.size === 0) {
+            return;
+        }
+        const summary = {};
+        let totalAggregated = 0;
+        for (const [key, entry] of this.aggregatedEntries.entries()) {
+            summary[entry.type] = (summary[entry.type] || 0) + entry.count;
+            totalAggregated += entry.count;
+            // Log a sample of high-frequency entries
+            if (entry.count >= 10) {
+                this.log(entry.sample.level, `${entry.sample.message} (aggregated: ${entry.count} occurrences)`, {
+                    ...entry.sample.options,
+                    aggregated: true,
+                    occurrences: entry.count,
+                    timeSpan: entry.lastSeen - entry.firstSeen
+                });
+            }
+        }
+        // Log aggregation summary
+        console.log(`[SMTP] Aggregated ${totalAggregated} log entries: ${JSON.stringify(summary)}`);
+        this.log('info', 'Aggregated log summary', {
+            totalEntries: totalAggregated,
+            breakdown: summary,
+            logMode: this.currentMode,
+            activeConnections: this.connectionTracker.activeConnections
+        });
+        // Clear aggregated entries
+        this.aggregatedEntries.clear();
+    }
+    /**
+     * Cleanup resources
+     */
+    destroy() {
+        if (this.aggregationTimer) {
+            clearInterval(this.aggregationTimer);
+            this.aggregationTimer = null;
+        }
+        this.flushAggregatedEntries();
+    }
+}
+/**
+ * Default instance for easy access
+ */
+export const adaptiveLogger = AdaptiveSmtpLogger.getInstance();
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYWRhcHRpdmUtbG9nZ2luZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cHNlcnZlci91dGlscy9hZGFwdGl2ZS1sb2dnaW5nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7O0dBSUc7QUFFSCxPQUFPLEtBQUssT0FBTyxNQUFNLHdCQUF3QixDQUFDO0FBQ2xELE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUMvQyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxpQkFBaUIsQ0FBQztBQUl0RTs7R0FFRztBQUNILE1BQU0sQ0FBTixJQUFZLE9BSVg7QUFKRCxXQUFZLE9BQU87SUFDakIsOEJBQW1CLENBQUE7SUFDbkIsOEJBQW1CLENBQUE7SUFDbkIsOEJBQW1CLENBQUEsQ0FBTSxpRUFBaUU7QUFDNUYsQ0FBQyxFQUpXLE9BQU8sS0FBUCxPQUFPLFFBSWxCO0FBc0NEOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGtCQUFrQjtJQWM3QixZQUFvQixNQUFvQztRQVpoRCxnQkFBVyxHQUFZLE9BQU8sQ0FBQyxPQUFPLENBQUM7UUFFdkMsc0JBQWlCLEdBQXFDLElBQUksR0FBRyxFQUFFLENBQUM7UUFDaEUscUJBQWdCLEdBQTBCLElBQUksQ0FBQztRQUMvQyxzQkFBaUIsR0FBdUI7WUFDOUMsaUJBQWlCLEVBQUUsQ0FBQztZQUNwQixlQUFlLEVBQUUsQ0FBQztZQUNsQixnQkFBZ0IsRUFBRSxDQUFDO1lBQ25CLG9CQUFvQixFQUFFLENBQUM7WUFDdkIsa0JBQWtCLEVBQUUsSUFBSSxDQUFDLEdBQUcsRUFBRTtTQUMvQixDQUFDO1FBR0EsSUFBSSxDQUFDLE1BQU0sR0FBRztZQUNaLGdCQUFnQixFQUFFLEVBQUU7WUFDcEIsZ0JBQWdCLEVBQUUsRUFBRTtZQUNwQixtQkFBbUIsRUFBRSxLQUFLLEVBQUUsYUFBYTtZQUN6QyxvQkFB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

package/dist_ts/ts/mail/delivery/smtpserver/utils/helpers.d.ts

@@ -0,0 +1,78 @@
+/**
+ * SMTP Helper Functions
+ * Provides utility functions for SMTP server implementation
+ */
+import * as plugins from '../../../../plugins.js';
+import type { ISmtpServerOptions } from '../interfaces.js';
+/**
+ * Formats a multi-line SMTP response according to RFC 5321
+ * @param code - Response code
+ * @param lines - Response lines
+ * @returns Formatted SMTP response
+ */
+export declare function formatMultilineResponse(code: number, lines: string[]): string;
+/**
+ * Generates a unique session ID
+ * @returns Unique session ID
+ */
+export declare function generateSessionId(): string;
+/**
+ * Safely parses an integer from string with a default value
+ * @param value - String value to parse
+ * @param defaultValue - Default value if parsing fails
+ * @returns Parsed integer or default value
+ */
+export declare function safeParseInt(value: string | undefined, defaultValue: number): number;
+/**
+ * Safely gets the socket details
+ * @param socket - Socket to get details from
+ * @returns Socket details object
+ */
+export declare function getSocketDetails(socket: plugins.net.Socket | plugins.tls.TLSSocket): {
+    remoteAddress: string;
+    remotePort: number;
+    remoteFamily: string;
+    localAddress: string;
+    localPort: number;
+    encrypted: boolean;
+};
+/**
+ * Gets TLS details if socket is TLS
+ * @param socket - Socket to get TLS details from
+ * @returns TLS details or undefined if not TLS
+ */
+export declare function getTlsDetails(socket: plugins.net.Socket | plugins.tls.TLSSocket): {
+    protocol?: string;
+    cipher?: string;
+    authorized?: boolean;
+} | undefined;
+/**
+ * Merges default options with provided options
+ * @param options - User provided options
+ * @returns Merged options with defaults
+ */
+export declare function mergeWithDefaults(options: Partial<ISmtpServerOptions>): ISmtpServerOptions;
+/**
+ * Creates a text response formatter for the SMTP server
+ * @param socket - Socket to send responses to
+ * @returns Function to send formatted response
+ */
+export declare function createResponseFormatter(socket: plugins.net.Socket | plugins.tls.TLSSocket): (response: string) => void;
+/**
+ * Extracts SMTP command name from a command line
+ * @param commandLine - Full command line
+ * @returns Command name in uppercase
+ */
+export declare function extractCommandName(commandLine: string): string;
+/**
+ * Extracts SMTP command arguments from a command line
+ * @param commandLine - Full command line
+ * @returns Arguments string
+ */
+export declare function extractCommandArgs(commandLine: string): string;
+/**
+ * Sanitizes data for logging (hides sensitive info)
+ * @param data - Data to sanitize
+ * @returns Sanitized data
+ */
+export declare function sanitizeForLogging(data: any): any;