@serve.zone/dcrouter 2.12.4

package/dist_ts/ts/mail/delivery/smtpclient/tls-handler.js

@@ -0,0 +1,202 @@
+/**
+ * SMTP Client TLS Handler
+ * TLS and STARTTLS client functionality
+ */
+import * as tls from 'node:tls';
+import * as net from 'node:net';
+import { DEFAULTS } from './constants.js';
+import { CONNECTION_STATES } from './constants.js';
+import { logTLS, logDebug } from './utils/logging.js';
+import { isSuccessCode } from './utils/helpers.js';
+export class TlsHandler {
+    constructor(options, commandHandler) {
+        this.options = options;
+        this.commandHandler = commandHandler;
+    }
+    /**
+     * Upgrade connection to TLS using STARTTLS
+     */
+    async upgradeToTLS(connection) {
+        if (connection.secure) {
+            logDebug('Connection already secure', this.options);
+            return;
+        }
+        // Check if STARTTLS is supported
+        if (!connection.capabilities?.starttls) {
+            throw new Error('Server does not support STARTTLS');
+        }
+        logTLS('starttls_start', this.options);
+        try {
+            // Send STARTTLS command
+            const response = await this.commandHandler.sendStartTls(connection);
+            if (!isSuccessCode(response.code)) {
+                throw new Error(`STARTTLS command failed: ${response.message}`);
+            }
+            // Upgrade the socket to TLS
+            await this.performTLSUpgrade(connection);
+            // Clear capabilities as they may have changed after TLS
+            connection.capabilities = undefined;
+            connection.secure = true;
+            logTLS('starttls_success', this.options);
+        }
+        catch (error) {
+            logTLS('starttls_failure', this.options, { error });
+            throw error;
+        }
+    }
+    /**
+     * Create a direct TLS connection
+     */
+    async createTLSConnection(host, port) {
+        return new Promise((resolve, reject) => {
+            const timeout = this.options.connectionTimeout || DEFAULTS.CONNECTION_TIMEOUT;
+            const tlsOptions = {
+                host,
+                port,
+                ...this.options.tls,
+                // Default TLS options for email
+                secureProtocol: 'TLS_method',
+                ciphers: 'HIGH:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!SRP:!CAMELLIA',
+                rejectUnauthorized: this.options.tls?.rejectUnauthorized !== false
+            };
+            logTLS('tls_connected', this.options, { host, port });
+            const socket = tls.connect(tlsOptions);
+            const timeoutHandler = setTimeout(() => {
+                socket.destroy();
+                reject(new Error(`TLS connection timeout after ${timeout}ms`));
+            }, timeout);
+            socket.once('secureConnect', () => {
+                clearTimeout(timeoutHandler);
+                if (!socket.authorized && this.options.tls?.rejectUnauthorized !== false) {
+                    socket.destroy();
+                    reject(new Error(`TLS certificate verification failed: ${socket.authorizationError}`));
+                    return;
+                }
+                logDebug('TLS connection established', this.options, {
+                    authorized: socket.authorized,
+                    protocol: socket.getProtocol(),
+                    cipher: socket.getCipher()
+                });
+                resolve(socket);
+            });
+            socket.once('error', (error) => {
+                clearTimeout(timeoutHandler);
+                reject(error);
+            });
+        });
+    }
+    /**
+     * Validate TLS certificate
+     */
+    validateCertificate(socket) {
+        if (!socket.authorized) {
+            logDebug('TLS certificate not authorized', this.options, {
+                error: socket.authorizationError
+            });
+            // Allow self-signed certificates if explicitly configured
+            if (this.options.tls?.rejectUnauthorized === false) {
+                logDebug('Accepting unauthorized certificate (rejectUnauthorized: false)', this.options);
+                return true;
+            }
+            return false;
+        }
+        const cert = socket.getPeerCertificate();
+        if (!cert) {
+            logDebug('No peer certificate available', this.options);
+            return false;
+        }
+        // Additional certificate validation
+        const now = new Date();
+        if (cert.valid_from && new Date(cert.valid_from) > now) {
+            logDebug('Certificate not yet valid', this.options, { validFrom: cert.valid_from });
+            return false;
+        }
+        if (cert.valid_to && new Date(cert.valid_to) < now) {
+            logDebug('Certificate expired', this.options, { validTo: cert.valid_to });
+            return false;
+        }
+        logDebug('TLS certificate validated', this.options, {
+            subject: cert.subject,
+            issuer: cert.issuer,
+            validFrom: cert.valid_from,
+            validTo: cert.valid_to
+        });
+        return true;
+    }
+    /**
+     * Get TLS connection information
+     */
+    getTLSInfo(socket) {
+        if (!(socket instanceof tls.TLSSocket)) {
+            return null;
+        }
+        return {
+            authorized: socket.authorized,
+            authorizationError: socket.authorizationError,
+            protocol: socket.getProtocol(),
+            cipher: socket.getCipher(),
+            peerCertificate: socket.getPeerCertificate(),
+            alpnProtocol: socket.alpnProtocol
+        };
+    }
+    /**
+     * Check if TLS upgrade is required or recommended
+     */
+    shouldUseTLS(connection) {
+        // Already secure
+        if (connection.secure) {
+            return false;
+        }
+        // Direct TLS connection configured
+        if (this.options.secure) {
+            return false; // Already handled in connection establishment
+        }
+        // STARTTLS available and not explicitly disabled
+        if (connection.capabilities?.starttls) {
+            return this.options.tls !== null && this.options.tls !== undefined; // Use TLS if configured
+        }
+        return false;
+    }
+    async performTLSUpgrade(connection) {
+        return new Promise((resolve, reject) => {
+            const plainSocket = connection.socket;
+            const timeout = this.options.connectionTimeout || DEFAULTS.CONNECTION_TIMEOUT;
+            const tlsOptions = {
+                socket: plainSocket,
+                host: this.options.host,
+                ...this.options.tls,
+                // Default TLS options for STARTTLS
+                secureProtocol: 'TLS_method',
+                ciphers: 'HIGH:!aNULL:!eNULL:!EXPORT:!DES:!RC4:!MD5:!PSK:!SRP:!CAMELLIA',
+                rejectUnauthorized: this.options.tls?.rejectUnauthorized !== false
+            };
+            const timeoutHandler = setTimeout(() => {
+                reject(new Error(`TLS upgrade timeout after ${timeout}ms`));
+            }, timeout);
+            // Create TLS socket from existing connection
+            const tlsSocket = tls.connect(tlsOptions);
+            tlsSocket.once('secureConnect', () => {
+                clearTimeout(timeoutHandler);
+                // Validate certificate if required
+                if (!this.validateCertificate(tlsSocket)) {
+                    tlsSocket.destroy();
+                    reject(new Error('TLS certificate validation failed'));
+                    return;
+                }
+                // Replace the socket in the connection
+                connection.socket = tlsSocket;
+                connection.secure = true;
+                logDebug('STARTTLS upgrade completed', this.options, {
+                    protocol: tlsSocket.getProtocol(),
+                    cipher: tlsSocket.getCipher()
+                });
+                resolve();
+            });
+            tlsSocket.once('error', (error) => {
+                clearTimeout(timeoutHandler);
+                reject(error);
+            });
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGxzLWhhbmRsZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi90cy9tYWlsL2RlbGl2ZXJ5L3NtdHBjbGllbnQvdGxzLWhhbmRsZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsT0FBTyxLQUFLLEdBQUcsTUFBTSxVQUFVLENBQUM7QUFDaEMsT0FBTyxLQUFLLEdBQUcsTUFBTSxVQUFVLENBQUM7QUFDaEMsT0FBTyxFQUFFLFFBQVEsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBTTFDLE9BQU8sRUFBRSxpQkFBaUIsRUFBRSxNQUFNLGdCQUFnQixDQUFDO0FBQ25ELE9BQU8sRUFBRSxNQUFNLEVBQUUsUUFBUSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDdEQsT0FBTyxFQUFFLGFBQWEsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBR25ELE1BQU0sT0FBTyxVQUFVO0lBSXJCLFlBQVksT0FBMkIsRUFBRSxjQUE4QjtRQUNyRSxJQUFJLENBQUMsT0FBTyxHQUFHLE9BQU8sQ0FBQztRQUN2QixJQUFJLENBQUMsY0FBYyxHQUFHLGNBQWMsQ0FBQztJQUN2QyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsWUFBWSxDQUFDLFVBQTJCO1FBQ25ELElBQUksVUFBVSxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ3RCLFFBQVEsQ0FBQywyQkFBMkIsRUFBRSxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUM7WUFDcEQsT0FBTztRQUNULENBQUM7UUFFRCxpQ0FBaUM7UUFDakMsSUFBSSxDQUFDLFVBQVUsQ0FBQyxZQUFZLEVBQUUsUUFBUSxFQUFFLENBQUM7WUFDdkMsTUFBTSxJQUFJLEtBQUssQ0FBQyxrQ0FBa0MsQ0FBQyxDQUFDO1FBQ3RELENBQUM7UUFFRCxNQUFNLENBQUMsZ0JBQWdCLEVBQUUsSUFBSSxDQUFDLE9BQU8sQ0FBQyxDQUFDO1FBRXZDLElBQUksQ0FBQztZQUNILHdCQUF3QjtZQUN4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

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

@@ -0,0 +1,77 @@
+/**
+ * SMTP Client Helper Functions
+ * Protocol helper functions and utilities
+ */
+import type { ISmtpResponse, ISmtpCapabilities } from '../interfaces.js';
+/**
+ * Parse SMTP server response
+ */
+export declare function parseSmtpResponse(data: string): ISmtpResponse;
+/**
+ * Parse EHLO response and extract capabilities
+ */
+export declare function parseEhloResponse(response: string): ISmtpCapabilities;
+/**
+ * Format SMTP command with proper line ending
+ */
+export declare function formatCommand(command: string, ...args: string[]): string;
+/**
+ * Encode authentication string for AUTH PLAIN
+ */
+export declare function encodeAuthPlain(username: string, password: string): string;
+/**
+ * Encode authentication string for AUTH LOGIN
+ */
+export declare function encodeAuthLogin(value: string): string;
+/**
+ * Generate OAuth2 authentication string
+ */
+export declare function generateOAuth2String(username: string, accessToken: string): string;
+/**
+ * Check if response code indicates success
+ */
+export declare function isSuccessCode(code: number): boolean;
+/**
+ * Check if response code indicates temporary failure
+ */
+export declare function isTemporaryFailure(code: number): boolean;
+/**
+ * Check if response code indicates permanent failure
+ */
+export declare function isPermanentFailure(code: number): boolean;
+/**
+ * Escape email address for SMTP commands
+ */
+export declare function escapeEmailAddress(email: string): string;
+/**
+ * Extract email address from angle brackets
+ */
+export declare function extractEmailAddress(email: string): string;
+/**
+ * Generate unique connection ID
+ */
+export declare function generateConnectionId(): string;
+/**
+ * Format timeout duration for human readability
+ */
+export declare function formatTimeout(milliseconds: number): string;
+/**
+ * Validate and normalize email data size
+ */
+export declare function validateEmailSize(emailData: string, maxSize?: number): boolean;
+/**
+ * Clean sensitive data from logs
+ */
+export declare function sanitizeForLogging(data: any): any;
+/**
+ * Calculate exponential backoff delay
+ */
+export declare function calculateBackoffDelay(attempt: number, baseDelay?: number): number;
+/**
+ * Parse enhanced status code
+ */
+export declare function parseEnhancedStatusCode(code: string): {
+    class: number;
+    subject: number;
+    detail: number;
+} | null;

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

@@ -0,0 +1,196 @@
+/**
+ * SMTP Client Helper Functions
+ * Protocol helper functions and utilities
+ */
+import { SMTP_CODES, REGEX_PATTERNS, LINE_ENDINGS } from '../constants.js';
+/**
+ * Parse SMTP server response
+ */
+export function parseSmtpResponse(data) {
+    const lines = data.trim().split(/\r?\n/);
+    const firstLine = lines[0];
+    const match = firstLine.match(REGEX_PATTERNS.RESPONSE_CODE);
+    if (!match) {
+        return {
+            code: 500,
+            message: 'Invalid server response',
+            raw: data
+        };
+    }
+    const code = parseInt(match[1], 10);
+    const separator = match[2];
+    const message = lines.map(line => line.substring(4)).join(' ');
+    // Check for enhanced status code
+    const enhancedMatch = message.match(REGEX_PATTERNS.ENHANCED_STATUS);
+    const enhancedCode = enhancedMatch ? enhancedMatch[1] : undefined;
+    return {
+        code,
+        message: enhancedCode ? message.substring(enhancedCode.length + 1) : message,
+        enhancedCode,
+        raw: data
+    };
+}
+/**
+ * Parse EHLO response and extract capabilities
+ */
+export function parseEhloResponse(response) {
+    const lines = response.trim().split(/\r?\n/);
+    const capabilities = {
+        extensions: new Set(),
+        authMethods: new Set(),
+        pipelining: false,
+        starttls: false,
+        eightBitMime: false
+    };
+    for (const line of lines.slice(1)) { // Skip first line (greeting)
+        const extensionLine = line.substring(4); // Remove "250-" or "250 "
+        const parts = extensionLine.split(/\s+/);
+        const extension = parts[0].toUpperCase();
+        capabilities.extensions.add(extension);
+        switch (extension) {
+            case 'PIPELINING':
+                capabilities.pipelining = true;
+                break;
+            case 'STARTTLS':
+                capabilities.starttls = true;
+                break;
+            case '8BITMIME':
+                capabilities.eightBitMime = true;
+                break;
+            case 'SIZE':
+                if (parts[1]) {
+                    capabilities.maxSize = parseInt(parts[1], 10);
+                }
+                break;
+            case 'AUTH':
+                // Parse authentication methods
+                for (let i = 1; i < parts.length; i++) {
+                    capabilities.authMethods.add(parts[i].toUpperCase());
+                }
+                break;
+        }
+    }
+    return capabilities;
+}
+/**
+ * Format SMTP command with proper line ending
+ */
+export function formatCommand(command, ...args) {
+    const fullCommand = args.length > 0 ? `${command} ${args.join(' ')}` : command;
+    return fullCommand + LINE_ENDINGS.CRLF;
+}
+/**
+ * Encode authentication string for AUTH PLAIN
+ */
+export function encodeAuthPlain(username, password) {
+    const authString = `\0${username}\0${password}`;
+    return Buffer.from(authString, 'utf8').toString('base64');
+}
+/**
+ * Encode authentication string for AUTH LOGIN
+ */
+export function encodeAuthLogin(value) {
+    return Buffer.from(value, 'utf8').toString('base64');
+}
+/**
+ * Generate OAuth2 authentication string
+ */
+export function generateOAuth2String(username, accessToken) {
+    const authString = `user=${username}\x01auth=Bearer ${accessToken}\x01\x01`;
+    return Buffer.from(authString, 'utf8').toString('base64');
+}
+/**
+ * Check if response code indicates success
+ */
+export function isSuccessCode(code) {
+    return code >= 200 && code < 300;
+}
+/**
+ * Check if response code indicates temporary failure
+ */
+export function isTemporaryFailure(code) {
+    return code >= 400 && code < 500;
+}
+/**
+ * Check if response code indicates permanent failure
+ */
+export function isPermanentFailure(code) {
+    return code >= 500;
+}
+/**
+ * Escape email address for SMTP commands
+ */
+export function escapeEmailAddress(email) {
+    return `<${email.trim()}>`;
+}
+/**
+ * Extract email address from angle brackets
+ */
+export function extractEmailAddress(email) {
+    const match = email.match(/^<(.+)>$/);
+    return match ? match[1] : email.trim();
+}
+/**
+ * Generate unique connection ID
+ */
+export function generateConnectionId() {
+    return `smtp-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+}
+/**
+ * Format timeout duration for human readability
+ */
+export function formatTimeout(milliseconds) {
+    if (milliseconds < 1000) {
+        return `${milliseconds}ms`;
+    }
+    else if (milliseconds < 60000) {
+        return `${Math.round(milliseconds / 1000)}s`;
+    }
+    else {
+        return `${Math.round(milliseconds / 60000)}m`;
+    }
+}
+/**
+ * Validate and normalize email data size
+ */
+export function validateEmailSize(emailData, maxSize) {
+    const size = Buffer.byteLength(emailData, 'utf8');
+    return !maxSize || size <= maxSize;
+}
+/**
+ * Clean sensitive data from logs
+ */
+export function sanitizeForLogging(data) {
+    if (typeof data !== 'object' || data === null) {
+        return data;
+    }
+    const sanitized = { ...data };
+    const sensitiveFields = ['password', 'pass', 'accessToken', 'refreshToken', 'clientSecret'];
+    for (const field of sensitiveFields) {
+        if (field in sanitized) {
+            sanitized[field] = '[REDACTED]';
+        }
+    }
+    return sanitized;
+}
+/**
+ * Calculate exponential backoff delay
+ */
+export function calculateBackoffDelay(attempt, baseDelay = 1000) {
+    return Math.min(baseDelay * Math.pow(2, attempt - 1), 30000); // Max 30 seconds
+}
+/**
+ * Parse enhanced status code
+ */
+export function parseEnhancedStatusCode(code) {
+    const match = code.match(/^(\d)\.(\d)\.(\d)$/);
+    if (!match) {
+        return null;
+    }
+    return {
+        class: parseInt(match[1], 10),
+        subject: parseInt(match[2], 10),
+        detail: parseInt(match[3], 10)
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaGVscGVycy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cGNsaWVudC91dGlscy9oZWxwZXJzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sRUFBRSxVQUFVLEVBQUUsY0FBYyxFQUFFLFlBQVksRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBRzNFOztHQUVHO0FBQ0gsTUFBTSxVQUFVLGlCQUFpQixDQUFDLElBQVk7SUFDNUMsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLElBQUksRUFBRSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztJQUN6QyxNQUFNLFNBQVMsR0FBRyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDM0IsTUFBTSxLQUFLLEdBQUcsU0FBUyxDQUFDLEtBQUssQ0FBQyxjQUFjLENBQUMsYUFBYSxDQUFDLENBQUM7SUFFNUQsSUFBSSxDQUFDLEtBQUssRUFBRSxDQUFDO1FBQ1gsT0FBTztZQUNMLElBQUksRUFBRSxHQUFHO1lBQ1QsT0FBTyxFQUFFLHlCQUF5QjtZQUNsQyxHQUFHLEVBQUUsSUFBSTtTQUNWLENBQUM7SUFDSixDQUFDO0lBRUQsTUFBTSxJQUFJLEdBQUcsUUFBUSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRSxFQUFFLENBQUMsQ0FBQztJQUNwQyxNQUFNLFNBQVMsR0FBRyxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDM0IsTUFBTSxPQUFPLEdBQUcsS0FBSyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLElBQUksQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsR0FBRyxDQUFDLENBQUM7SUFFL0QsaUNBQWlDO0lBQ2pDLE1BQU0sYUFBYSxHQUFHLE9BQU8sQ0FBQyxLQUFLLENBQUMsY0FBYyxDQUFDLGVBQWUsQ0FBQyxDQUFDO0lBQ3BF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

package/dist_ts/ts/mail/delivery/smtpclient/utils/logging.d.ts

@@ -0,0 +1,46 @@
+/**
+ * SMTP Client Logging Utilities
+ * Client-side logging utilities for SMTP operations
+ */
+import type { ISmtpResponse, ISmtpClientOptions } from '../interfaces.js';
+export interface ISmtpClientLogData {
+    component: string;
+    host?: string;
+    port?: number;
+    secure?: boolean;
+    command?: string;
+    response?: ISmtpResponse;
+    error?: Error;
+    connectionId?: string;
+    messageId?: string;
+    duration?: number;
+    [key: string]: any;
+}
+/**
+ * Log SMTP client connection events
+ */
+export declare function logConnection(event: 'connecting' | 'connected' | 'disconnected' | 'error', options: ISmtpClientOptions, data?: Partial<ISmtpClientLogData>): void;
+/**
+ * Log SMTP command execution
+ */
+export declare function logCommand(command: string, response?: ISmtpResponse, options?: ISmtpClientOptions, data?: Partial<ISmtpClientLogData>): void;
+/**
+ * Log authentication events
+ */
+export declare function logAuthentication(event: 'start' | 'success' | 'failure', method: string, options: ISmtpClientOptions, data?: Partial<ISmtpClientLogData>): void;
+/**
+ * Log TLS/STARTTLS events
+ */
+export declare function logTLS(event: 'starttls_start' | 'starttls_success' | 'starttls_failure' | 'tls_connected', options: ISmtpClientOptions, data?: Partial<ISmtpClientLogData>): void;
+/**
+ * Log email sending events
+ */
+export declare function logEmailSend(event: 'start' | 'success' | 'failure', recipients: string[], options: ISmtpClientOptions, data?: Partial<ISmtpClientLogData>): void;
+/**
+ * Log performance metrics
+ */
+export declare function logPerformance(operation: string, duration: number, options: ISmtpClientOptions, data?: Partial<ISmtpClientLogData>): void;
+/**
+ * Log debug information (only when debug is enabled)
+ */
+export declare function logDebug(message: string, options: ISmtpClientOptions, data?: Partial<ISmtpClientLogData>): void;