start the path to rust

dist_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 {};

dist_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;

dist_ts/mail/delivery/smtpserver/utils/logging.d.ts

@@ -0,0 +1,106 @@
+/**
+ * SMTP Logging Utilities
+ * Provides structured logging for SMTP server components
+ */
+import * as plugins from '../../../../plugins.js';
+import { SecurityLogLevel, SecurityEventType } from '../constants.js';
+import type { ISmtpSession } from '../interfaces.js';
+/**
+ * SMTP connection metadata to include in logs
+ */
+export interface IConnectionMetadata {
+    remoteAddress?: string;
+    remotePort?: number;
+    socketId?: string;
+    secure?: boolean;
+    sessionId?: string;
+}
+/**
+ * Log levels for SMTP server
+ */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Options for SMTP log
+ */
+export interface ISmtpLogOptions {
+    level?: LogLevel;
+    sessionId?: string;
+    sessionState?: string;
+    remoteAddress?: string;
+    remotePort?: number;
+    command?: string;
+    error?: Error;
+    [key: string]: any;
+}
+/**
+ * SMTP logger - provides structured logging for SMTP server
+ */
+export declare class SmtpLogger {
+    /**
+     * Log a message with context
+     * @param level - Log level
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static log(level: LogLevel, message: string, options?: ISmtpLogOptions): void;
+    /**
+     * Log debug level message
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static debug(message: string, options?: ISmtpLogOptions): void;
+    /**
+     * Log info level message
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static info(message: string, options?: ISmtpLogOptions): void;
+    /**
+     * Log warning level message
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static warn(message: string, options?: ISmtpLogOptions): void;
+    /**
+     * Log error level message
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static error(message: string, options?: ISmtpLogOptions): void;
+    /**
+     * Log command received from client
+     * @param command - The command string
+     * @param socket - The client socket
+     * @param session - The SMTP session
+     */
+    static logCommand(command: string, socket: plugins.net.Socket | plugins.tls.TLSSocket, session?: ISmtpSession): void;
+    /**
+     * Log response sent to client
+     * @param response - The response string
+     * @param socket - The client socket
+     */
+    static logResponse(response: string, socket: plugins.net.Socket | plugins.tls.TLSSocket): void;
+    /**
+     * Log client connection event
+     * @param socket - The client socket
+     * @param eventType - Type of connection event (connect, close, error)
+     * @param session - The SMTP session
+     * @param error - Optional error object for error events
+     */
+    static logConnection(socket: plugins.net.Socket | plugins.tls.TLSSocket, eventType: 'connect' | 'close' | 'error', session?: ISmtpSession, error?: Error): void;
+    /**
+     * Log security event
+     * @param level - Security log level
+     * @param type - Security event type
+     * @param message - Log message
+     * @param details - Event details
+     * @param ipAddress - Client IP address
+     * @param domain - Optional domain involved
+     * @param success - Whether the security check was successful
+     */
+    static logSecurityEvent(level: SecurityLogLevel, type: SecurityEventType, message: string, details: Record<string, any>, ipAddress?: string, domain?: string, success?: boolean): void;
+}
+/**
+ * Default instance for backward compatibility
+ */
+export declare const smtpLogger: typeof SmtpLogger;

dist_ts/mail/delivery/smtpserver/utils/validation.d.ts

@@ -0,0 +1,69 @@
+/**
+ * SMTP Validation Utilities
+ * Provides validation functions for SMTP server
+ */
+import { SmtpState } from '../interfaces.js';
+/**
+ * Detects header injection attempts in input strings
+ * @param input - The input string to check
+ * @param context - The context where this input is being used ('smtp-command' or 'email-header')
+ * @returns true if header injection is detected, false otherwise
+ */
+export declare function detectHeaderInjection(input: string, context?: 'smtp-command' | 'email-header'): boolean;
+/**
+ * Sanitizes input by removing or escaping potentially dangerous characters
+ * @param input - The input string to sanitize
+ * @returns Sanitized string
+ */
+export declare function sanitizeInput(input: string): string;
+/**
+ * Validates an email address
+ * @param email - Email address to validate
+ * @returns Whether the email address is valid
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Validates the MAIL FROM command syntax
+ * @param args - Arguments string from the MAIL FROM command
+ * @returns Object with validation result and extracted data
+ */
+export declare function validateMailFrom(args: string): {
+    isValid: boolean;
+    address?: string;
+    params?: Record<string, string>;
+    errorMessage?: string;
+};
+/**
+ * Validates the RCPT TO command syntax
+ * @param args - Arguments string from the RCPT TO command
+ * @returns Object with validation result and extracted data
+ */
+export declare function validateRcptTo(args: string): {
+    isValid: boolean;
+    address?: string;
+    params?: Record<string, string>;
+    errorMessage?: string;
+};
+/**
+ * Validates the EHLO command syntax
+ * @param args - Arguments string from the EHLO command
+ * @returns Object with validation result and extracted data
+ */
+export declare function validateEhlo(args: string): {
+    isValid: boolean;
+    hostname?: string;
+    errorMessage?: string;
+};
+/**
+ * Validates command in the current SMTP state
+ * @param command - SMTP command
+ * @param currentState - Current SMTP state
+ * @returns Whether the command is valid in the current state
+ */
+export declare function isValidCommandSequence(command: string, currentState: SmtpState): boolean;
+/**
+ * Validates if a hostname is valid according to RFC 5321
+ * @param hostname - Hostname to validate
+ * @returns Whether the hostname is valid
+ */
+export declare function isValidHostname(hostname: string): boolean;