@serve.zone/dcrouter 2.12.4

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

@@ -0,0 +1,208 @@
+/**
+ * SMTP Helper Functions
+ * Provides utility functions for SMTP server implementation
+ */
+import * as plugins from '../../../../plugins.js';
+import { SMTP_DEFAULTS } from '../constants.js';
+/**
+ * Formats a multi-line SMTP response according to RFC 5321
+ * @param code - Response code
+ * @param lines - Response lines
+ * @returns Formatted SMTP response
+ */
+export function formatMultilineResponse(code, lines) {
+    if (!lines || lines.length === 0) {
+        return `${code} `;
+    }
+    if (lines.length === 1) {
+        return `${code} ${lines[0]}`;
+    }
+    let response = '';
+    for (let i = 0; i < lines.length - 1; i++) {
+        response += `${code}-${lines[i]}${SMTP_DEFAULTS.CRLF}`;
+    }
+    response += `${code} ${lines[lines.length - 1]}`;
+    return response;
+}
+/**
+ * Generates a unique session ID
+ * @returns Unique session ID
+ */
+export function generateSessionId() {
+    return `${Date.now()}-${Math.floor(Math.random() * 10000)}`;
+}
+/**
+ * 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 function safeParseInt(value, defaultValue) {
+    if (!value) {
+        return defaultValue;
+    }
+    const parsed = parseInt(value, 10);
+    return isNaN(parsed) ? defaultValue : parsed;
+}
+/**
+ * Safely gets the socket details
+ * @param socket - Socket to get details from
+ * @returns Socket details object
+ */
+export function getSocketDetails(socket) {
+    return {
+        remoteAddress: socket.remoteAddress || 'unknown',
+        remotePort: socket.remotePort || 0,
+        remoteFamily: socket.remoteFamily || 'unknown',
+        localAddress: socket.localAddress || 'unknown',
+        localPort: socket.localPort || 0,
+        encrypted: socket instanceof plugins.tls.TLSSocket
+    };
+}
+/**
+ * Gets TLS details if socket is TLS
+ * @param socket - Socket to get TLS details from
+ * @returns TLS details or undefined if not TLS
+ */
+export function getTlsDetails(socket) {
+    if (!(socket instanceof plugins.tls.TLSSocket)) {
+        return undefined;
+    }
+    return {
+        protocol: socket.getProtocol(),
+        cipher: socket.getCipher()?.name,
+        authorized: socket.authorized
+    };
+}
+/**
+ * Merges default options with provided options
+ * @param options - User provided options
+ * @returns Merged options with defaults
+ */
+export function mergeWithDefaults(options) {
+    return {
+        port: options.port || SMTP_DEFAULTS.SMTP_PORT,
+        key: options.key || '',
+        cert: options.cert || '',
+        hostname: options.hostname || SMTP_DEFAULTS.HOSTNAME,
+        host: options.host,
+        securePort: options.securePort,
+        ca: options.ca,
+        maxSize: options.size || SMTP_DEFAULTS.MAX_MESSAGE_SIZE,
+        maxConnections: options.maxConnections || SMTP_DEFAULTS.MAX_CONNECTIONS,
+        socketTimeout: options.socketTimeout || SMTP_DEFAULTS.SOCKET_TIMEOUT,
+        connectionTimeout: options.connectionTimeout || SMTP_DEFAULTS.CONNECTION_TIMEOUT,
+        cleanupInterval: options.cleanupInterval || SMTP_DEFAULTS.CLEANUP_INTERVAL,
+        maxRecipients: options.maxRecipients || SMTP_DEFAULTS.MAX_RECIPIENTS,
+        size: options.size || SMTP_DEFAULTS.MAX_MESSAGE_SIZE,
+        dataTimeout: options.dataTimeout || SMTP_DEFAULTS.DATA_TIMEOUT,
+        auth: options.auth,
+    };
+}
+/**
+ * Creates a text response formatter for the SMTP server
+ * @param socket - Socket to send responses to
+ * @returns Function to send formatted response
+ */
+export function createResponseFormatter(socket) {
+    return (response) => {
+        try {
+            socket.write(`${response}${SMTP_DEFAULTS.CRLF}`);
+            console.log(`→ ${response}`);
+        }
+        catch (error) {
+            console.error(`Error sending response: ${error instanceof Error ? error.message : String(error)}`);
+            socket.destroy();
+        }
+    };
+}
+/**
+ * Extracts SMTP command name from a command line
+ * @param commandLine - Full command line
+ * @returns Command name in uppercase
+ */
+export function extractCommandName(commandLine) {
+    if (!commandLine || typeof commandLine !== 'string') {
+        return '';
+    }
+    // Handle specific command patterns first
+    const ehloMatch = commandLine.match(/^(EHLO|HELO)\b/i);
+    if (ehloMatch) {
+        return ehloMatch[1].toUpperCase();
+    }
+    const mailMatch = commandLine.match(/^MAIL\b/i);
+    if (mailMatch) {
+        return 'MAIL';
+    }
+    const rcptMatch = commandLine.match(/^RCPT\b/i);
+    if (rcptMatch) {
+        return 'RCPT';
+    }
+    // Default handling
+    const parts = commandLine.trim().split(/\s+/);
+    return (parts[0] || '').toUpperCase();
+}
+/**
+ * Extracts SMTP command arguments from a command line
+ * @param commandLine - Full command line
+ * @returns Arguments string
+ */
+export function extractCommandArgs(commandLine) {
+    if (!commandLine || typeof commandLine !== 'string') {
+        return '';
+    }
+    const command = extractCommandName(commandLine);
+    if (!command) {
+        return commandLine.trim();
+    }
+    // Special handling for specific commands
+    if (command === 'EHLO' || command === 'HELO') {
+        const match = commandLine.match(/^(?:EHLO|HELO)\s+(.+)$/i);
+        return match ? match[1].trim() : '';
+    }
+    if (command === 'MAIL') {
+        return commandLine.replace(/^MAIL\s+/i, '');
+    }
+    if (command === 'RCPT') {
+        return commandLine.replace(/^RCPT\s+/i, '');
+    }
+    // Default extraction
+    const firstSpace = commandLine.indexOf(' ');
+    if (firstSpace === -1) {
+        return '';
+    }
+    return commandLine.substring(firstSpace + 1).trim();
+}
+/**
+ * Sanitizes data for logging (hides sensitive info)
+ * @param data - Data to sanitize
+ * @returns Sanitized data
+ */
+export function sanitizeForLogging(data) {
+    if (!data) {
+        return data;
+    }
+    if (typeof data !== 'object') {
+        return data;
+    }
+    const result = Array.isArray(data) ? [] : {};
+    for (const key in data) {
+        if (Object.prototype.hasOwnProperty.call(data, key)) {
+            // Sanitize sensitive fields
+            if (key.toLowerCase().includes('password') ||
+                key.toLowerCase().includes('token') ||
+                key.toLowerCase().includes('secret') ||
+                key.toLowerCase().includes('credential')) {
+                result[key] = '********';
+            }
+            else if (typeof data[key] === 'object' && data[key] !== null) {
+                result[key] = sanitizeForLogging(data[key]);
+            }
+            else {
+                result[key] = data[key];
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cHNlcnZlci91dGlscy9oZWxwZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sS0FBSyxPQUFPLE1BQU0sd0JBQXdCLENBQUM7QUFDbEQsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBR2hEOzs7OztHQUtHO0FBQ0gsTUFBTSxVQUFVLHVCQUF1QixDQUFDLElBQVksRUFBRSxLQUFlO0lBQ25FLElBQUksQ0FBQyxLQUFLLElBQUksS0FBSyxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUNqQyxPQUFPLEdBQUcsSUFBSSxHQUFHLENBQUM7SUFDcEIsQ0FBQztJQUVELElBQUksS0FBSyxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUUsQ0FBQztRQUN2QixPQUFPLEdBQUcsSUFBSSxJQUFJLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO0lBQy9CLENBQUM7SUFFRCxJQUFJLFFBQVEsR0FBRyxFQUFFLENBQUM7SUFDbEIsS0FBSyxJQUFJLENBQUMsR0FBRyxDQUFDLEVBQUUsQ0FBQyxHQUFHLEtBQUssQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7UUFDMUMsUUFBUSxJQUFJLEdBQUcsSUFBSSxJQUFJLEtBQUssQ0FBQyxDQUFDLENBQUMsR0FBRyxhQUFhLENBQUMsSUFBSSxFQUFFLENBQUM7SUFDekQsQ0FBQztJQUNELFFBQVEsSUFBSSxHQUFHLElBQUksSUFBSSxLQUFLLENBQUMsS0FBSyxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUMsRUFBRSxDQUFDO0lBRWpELE9BQU8sUUFBUSxDQUFDO0FBQ2xCLENBQUM7QUFFRDs7O0dBR0c7QUFDSCxNQUFNLFVBQVUsaUJBQWlCO0lBQy9CLE9BQU8sR0FBRyxJQUFJLENB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

package/dist_ts/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;

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

@@ -0,0 +1,181 @@
+/**
+ * SMTP Logging Utilities
+ * Provides structured logging for SMTP server components
+ */
+import * as plugins from '../../../../plugins.js';
+import { logger } from '../../../../logger.js';
+import { SecurityLogLevel, SecurityEventType } from '../constants.js';
+/**
+ * SMTP logger - provides structured logging for SMTP server
+ */
+export class SmtpLogger {
+    /**
+     * Log a message with context
+     * @param level - Log level
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static log(level, message, options = {}) {
+        // Extract error information if provided
+        const errorInfo = options.error ? {
+            errorMessage: options.error.message,
+            errorStack: options.error.stack,
+            errorName: options.error.name
+        } : {};
+        // Structure log data
+        const logData = {
+            component: 'smtp-server',
+            ...options,
+            ...errorInfo
+        };
+        // Remove error from log data to avoid duplication
+        if (logData.error) {
+            delete logData.error;
+        }
+        // Log through the main logger
+        logger.log(level, message, logData);
+        // Also console log for immediate visibility during development
+        if (level === 'error' || level === 'warn') {
+            console[level](`[SMTP] ${message}`, logData);
+        }
+    }
+    /**
+     * Log debug level message
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static debug(message, options = {}) {
+        this.log('debug', message, options);
+    }
+    /**
+     * Log info level message
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static info(message, options = {}) {
+        this.log('info', message, options);
+    }
+    /**
+     * Log warning level message
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static warn(message, options = {}) {
+        this.log('warn', message, options);
+    }
+    /**
+     * Log error level message
+     * @param message - Log message
+     * @param options - Additional log options
+     */
+    static error(message, options = {}) {
+        this.log('error', message, options);
+    }
+    /**
+     * Log command received from client
+     * @param command - The command string
+     * @param socket - The client socket
+     * @param session - The SMTP session
+     */
+    static logCommand(command, socket, session) {
+        const clientInfo = {
+            remoteAddress: socket.remoteAddress,
+            remotePort: socket.remotePort,
+            secure: socket instanceof plugins.tls.TLSSocket,
+            sessionId: session?.id,
+            sessionState: session?.state
+        };
+        this.info(`Command received: ${command}`, {
+            ...clientInfo,
+            command: command.split(' ')[0]?.toUpperCase()
+        });
+        // Also log to console for easy debugging
+        console.log(`← ${command}`);
+    }
+    /**
+     * Log response sent to client
+     * @param response - The response string
+     * @param socket - The client socket
+     */
+    static logResponse(response, socket) {
+        const clientInfo = {
+            remoteAddress: socket.remoteAddress,
+            remotePort: socket.remotePort,
+            secure: socket instanceof plugins.tls.TLSSocket
+        };
+        // Get the response code from the beginning of the response
+        const responseCode = response.substring(0, 3);
+        // Log different levels based on response code
+        if (responseCode.startsWith('2') || responseCode.startsWith('3')) {
+            this.debug(`Response sent: ${response}`, clientInfo);
+        }
+        else if (responseCode.startsWith('4')) {
+            this.warn(`Temporary error response: ${response}`, clientInfo);
+        }
+        else if (responseCode.startsWith('5')) {
+            this.error(`Permanent error response: ${response}`, clientInfo);
+        }
+        // Also log to console for easy debugging
+        console.log(`→ ${response}`);
+    }
+    /**
+     * 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, eventType, session, error) {
+        const clientInfo = {
+            remoteAddress: socket.remoteAddress,
+            remotePort: socket.remotePort,
+            secure: socket instanceof plugins.tls.TLSSocket,
+            sessionId: session?.id,
+            sessionState: session?.state
+        };
+        switch (eventType) {
+            case 'connect':
+                this.info(`New ${clientInfo.secure ? 'secure ' : ''}connection from ${clientInfo.remoteAddress}:${clientInfo.remotePort}`, clientInfo);
+                break;
+            case 'close':
+                this.info(`Connection closed from ${clientInfo.remoteAddress}:${clientInfo.remotePort}`, clientInfo);
+                break;
+            case 'error':
+                this.error(`Connection error from ${clientInfo.remoteAddress}:${clientInfo.remotePort}`, {
+                    ...clientInfo,
+                    error
+                });
+                break;
+        }
+    }
+    /**
+     * 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, type, message, details, ipAddress, domain, success) {
+        // Map security log level to system log level
+        const logLevel = level === SecurityLogLevel.DEBUG ? 'debug' :
+            level === SecurityLogLevel.INFO ? 'info' :
+                level === SecurityLogLevel.WARN ? 'warn' : 'error';
+        // Log the security event
+        this.log(logLevel, message, {
+            component: 'smtp-security',
+            eventType: type,
+            success,
+            ipAddress,
+            domain,
+            ...details
+        });
+    }
+}
+/**
+ * Default instance for backward compatibility
+ */
+export const smtpLogger = SmtpLogger;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nZ2luZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cHNlcnZlci91dGlscy9sb2dnaW5nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sS0FBSyxPQUFPLE1BQU0sd0JBQXdCLENBQUM7QUFDbEQsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQy9DLE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBaUN0RTs7R0FFRztBQUNILE1BQU0sT0FBTyxVQUFVO0lBQ3JCOzs7OztPQUtHO0lBQ0ksTUFBTSxDQUFDLEdBQUcsQ0FBQyxLQUFlLEVBQUUsT0FBZSxFQUFFLFVBQTJCLEVBQUU7UUFDL0Usd0NBQXdDO1FBQ3hDLE1BQU0sU0FBUyxHQUFHLE9BQU8sQ0FBQyxLQUFLLENBQUMsQ0FBQyxDQUFDO1lBQ2hDLFlBQVksRUFBRSxPQUFPLENBQUMsS0FBSyxDQUFDLE9BQU87WUFDbkMsVUFBVSxFQUFFLE9BQU8sQ0FBQyxLQUFLLENBQUMsS0FBSztZQUMvQixTQUFTLEVBQUUsT0FBTyxDQUFDLEtBQUssQ0FBQyxJQUFJO1NBQzlCLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztRQUVQLHFCQUFxQjtRQUNyQixNQUFNLE9BQU8sR0FBRztZQUNkLFNBQVMsRUFBRSxhQUFhO1lBQ3hCLEdBQUcsT0FBTztZQUNWLEdBQUcsU0FBUztTQUNiLENBQUM7UUFFRixrREFBa0Q7UUFDbEQsSUFBSSxPQUFPLENBQUMsS0FBSyxFQUFFLENBQUM7WUFDbEIsT0FBTyxPQUFPLENBQUMsS0FBSyxDQUFDO1FBQ3ZCLENBQUM7UUFFRCw4QkFBOEI7UUFDOUIsTUFBTSxDQUFDLEdBQUcsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLE9BQU8sQ0FBQyxDQUFDO1FBRXBDLCtEQUErRDtRQUMvRCxJQUFJ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

package/dist_ts/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;