start the path to rust

dist_ts/mail/delivery/smtpclient/auth-handler.d.ts

@@ -0,0 +1,43 @@
+/**
+ * SMTP Client Authentication Handler
+ * Authentication mechanisms implementation
+ */
+import type { ISmtpConnection, ISmtpAuthOptions, ISmtpClientOptions } from './interfaces.js';
+import type { CommandHandler } from './command-handler.js';
+export declare class AuthHandler {
+    private options;
+    private commandHandler;
+    constructor(options: ISmtpClientOptions, commandHandler: CommandHandler);
+    /**
+     * Authenticate using the configured method
+     */
+    authenticate(connection: ISmtpConnection): Promise<void>;
+    /**
+     * Authenticate using AUTH PLAIN
+     */
+    private authenticatePlain;
+    /**
+     * Authenticate using AUTH LOGIN
+     */
+    private authenticateLogin;
+    /**
+     * Authenticate using OAuth2
+     */
+    private authenticateOAuth2;
+    /**
+     * Select appropriate authentication method
+     */
+    private selectAuthMethod;
+    /**
+     * Check if OAuth2 token is expired
+     */
+    private isTokenExpired;
+    /**
+     * Refresh OAuth2 access token
+     */
+    private refreshOAuth2Token;
+    /**
+     * Validate authentication configuration
+     */
+    validateAuthConfig(auth: ISmtpAuthOptions): string[];
+}

dist_ts/mail/delivery/smtpclient/command-handler.d.ts

@@ -0,0 +1,67 @@
+/**
+ * SMTP Client Command Handler
+ * SMTP command sending and response parsing
+ */
+import { EventEmitter } from 'node:events';
+import type { ISmtpConnection, ISmtpResponse, ISmtpClientOptions, ISmtpCapabilities } from './interfaces.js';
+export declare class CommandHandler extends EventEmitter {
+    private options;
+    private responseBuffer;
+    private pendingCommand;
+    private commandTimeout;
+    constructor(options: ISmtpClientOptions);
+    /**
+     * Send EHLO command and parse capabilities
+     */
+    sendEhlo(connection: ISmtpConnection, domain?: string): Promise<ISmtpCapabilities>;
+    /**
+     * Send MAIL FROM command
+     */
+    sendMailFrom(connection: ISmtpConnection, fromAddress: string): Promise<ISmtpResponse>;
+    /**
+     * Send RCPT TO command
+     */
+    sendRcptTo(connection: ISmtpConnection, toAddress: string): Promise<ISmtpResponse>;
+    /**
+     * Send DATA command
+     */
+    sendData(connection: ISmtpConnection): Promise<ISmtpResponse>;
+    /**
+     * Send email data content
+     */
+    sendDataContent(connection: ISmtpConnection, emailData: string): Promise<ISmtpResponse>;
+    /**
+     * Send RSET command
+     */
+    sendRset(connection: ISmtpConnection): Promise<ISmtpResponse>;
+    /**
+     * Send NOOP command
+     */
+    sendNoop(connection: ISmtpConnection): Promise<ISmtpResponse>;
+    /**
+     * Send QUIT command
+     */
+    sendQuit(connection: ISmtpConnection): Promise<ISmtpResponse>;
+    /**
+     * Send STARTTLS command
+     */
+    sendStartTls(connection: ISmtpConnection): Promise<ISmtpResponse>;
+    /**
+     * Send AUTH command
+     */
+    sendAuth(connection: ISmtpConnection, method: string, credentials?: string): Promise<ISmtpResponse>;
+    /**
+     * Send a generic SMTP command
+     */
+    sendCommand(connection: ISmtpConnection, command: string): Promise<ISmtpResponse>;
+    /**
+     * Send raw data without command formatting
+     */
+    sendRawData(connection: ISmtpConnection, data: string): Promise<ISmtpResponse>;
+    /**
+     * Wait for server greeting
+     */
+    waitForGreeting(connection: ISmtpConnection): Promise<ISmtpResponse>;
+    private handleIncomingData;
+    private isCompleteResponse;
+}

dist_ts/mail/delivery/smtpclient/connection-manager.d.ts

@@ -0,0 +1,48 @@
+/**
+ * SMTP Client Connection Manager
+ * Connection pooling and lifecycle management
+ */
+import { EventEmitter } from 'node:events';
+import type { ISmtpClientOptions, ISmtpConnection, IConnectionPoolStatus } from './interfaces.js';
+export declare class ConnectionManager extends EventEmitter {
+    private options;
+    private connections;
+    private pendingConnections;
+    private idleTimeout;
+    constructor(options: ISmtpClientOptions);
+    /**
+     * Get or create a connection
+     */
+    getConnection(): Promise<ISmtpConnection>;
+    /**
+     * Create a new connection
+     */
+    createConnection(): Promise<ISmtpConnection>;
+    /**
+     * Release a connection back to the pool or close it
+     */
+    releaseConnection(connection: ISmtpConnection): void;
+    /**
+     * Close a specific connection
+     */
+    closeConnection(connection: ISmtpConnection): void;
+    /**
+     * Close all connections
+     */
+    closeAllConnections(): void;
+    /**
+     * Get connection pool status
+     */
+    getPoolStatus(): IConnectionPoolStatus;
+    /**
+     * Update connection activity timestamp
+     */
+    updateActivity(connection: ISmtpConnection): void;
+    private establishSocket;
+    private setupSocketHandlers;
+    private findIdleConnection;
+    private shouldReuseConnection;
+    private getActiveConnectionCount;
+    private getConnectionId;
+    private setupIdleCleanup;
+}

dist_ts/mail/delivery/smtpclient/constants.d.ts

@@ -0,0 +1,129 @@
+/**
+ * SMTP Client Constants and Error Codes
+ * All constants, error codes, and enums for SMTP client operations
+ */
+/**
+ * SMTP response codes
+ */
+export declare const SMTP_CODES: {
+    readonly SERVICE_READY: 220;
+    readonly SERVICE_CLOSING: 221;
+    readonly AUTHENTICATION_SUCCESSFUL: 235;
+    readonly REQUESTED_ACTION_OK: 250;
+    readonly USER_NOT_LOCAL: 251;
+    readonly CANNOT_VERIFY_USER: 252;
+    readonly START_MAIL_INPUT: 354;
+    readonly SERVICE_NOT_AVAILABLE: 421;
+    readonly MAILBOX_BUSY: 450;
+    readonly LOCAL_ERROR: 451;
+    readonly INSUFFICIENT_STORAGE: 452;
+    readonly UNABLE_TO_ACCOMMODATE: 455;
+    readonly SYNTAX_ERROR: 500;
+    readonly SYNTAX_ERROR_PARAMETERS: 501;
+    readonly COMMAND_NOT_IMPLEMENTED: 502;
+    readonly BAD_SEQUENCE: 503;
+    readonly PARAMETER_NOT_IMPLEMENTED: 504;
+    readonly MAILBOX_UNAVAILABLE: 550;
+    readonly USER_NOT_LOCAL_TRY_FORWARD: 551;
+    readonly EXCEEDED_STORAGE: 552;
+    readonly MAILBOX_NAME_NOT_ALLOWED: 553;
+    readonly TRANSACTION_FAILED: 554;
+};
+/**
+ * SMTP command names
+ */
+export declare const SMTP_COMMANDS: {
+    readonly HELO: "HELO";
+    readonly EHLO: "EHLO";
+    readonly MAIL_FROM: "MAIL FROM";
+    readonly RCPT_TO: "RCPT TO";
+    readonly DATA: "DATA";
+    readonly RSET: "RSET";
+    readonly NOOP: "NOOP";
+    readonly QUIT: "QUIT";
+    readonly STARTTLS: "STARTTLS";
+    readonly AUTH: "AUTH";
+};
+/**
+ * Authentication methods
+ */
+export declare const AUTH_METHODS: {
+    readonly PLAIN: "PLAIN";
+    readonly LOGIN: "LOGIN";
+    readonly OAUTH2: "XOAUTH2";
+    readonly CRAM_MD5: "CRAM-MD5";
+};
+/**
+ * Common SMTP extensions
+ */
+export declare const SMTP_EXTENSIONS: {
+    readonly PIPELINING: "PIPELINING";
+    readonly SIZE: "SIZE";
+    readonly STARTTLS: "STARTTLS";
+    readonly AUTH: "AUTH";
+    readonly EIGHT_BIT_MIME: "8BITMIME";
+    readonly CHUNKING: "CHUNKING";
+    readonly ENHANCED_STATUS_CODES: "ENHANCEDSTATUSCODES";
+    readonly DSN: "DSN";
+};
+/**
+ * Default configuration values
+ */
+export declare const DEFAULTS: {
+    readonly CONNECTION_TIMEOUT: 60000;
+    readonly SOCKET_TIMEOUT: 300000;
+    readonly COMMAND_TIMEOUT: 30000;
+    readonly MAX_CONNECTIONS: 5;
+    readonly MAX_MESSAGES: 100;
+    readonly PORT_SMTP: 25;
+    readonly PORT_SUBMISSION: 587;
+    readonly PORT_SMTPS: 465;
+    readonly RETRY_ATTEMPTS: 3;
+    readonly RETRY_DELAY: 1000;
+    readonly POOL_IDLE_TIMEOUT: 30000;
+};
+/**
+ * Error types for classification
+ */
+export declare enum SmtpErrorType {
+    CONNECTION_ERROR = "CONNECTION_ERROR",
+    AUTHENTICATION_ERROR = "AUTHENTICATION_ERROR",
+    PROTOCOL_ERROR = "PROTOCOL_ERROR",
+    TIMEOUT_ERROR = "TIMEOUT_ERROR",
+    TLS_ERROR = "TLS_ERROR",
+    SYNTAX_ERROR = "SYNTAX_ERROR",
+    MAILBOX_ERROR = "MAILBOX_ERROR",
+    QUOTA_ERROR = "QUOTA_ERROR",
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Regular expressions for parsing
+ */
+export declare const REGEX_PATTERNS: {
+    readonly EMAIL_ADDRESS: RegExp;
+    readonly RESPONSE_CODE: RegExp;
+    readonly ENHANCED_STATUS: RegExp;
+    readonly AUTH_CAPABILITIES: RegExp;
+    readonly SIZE_EXTENSION: RegExp;
+};
+/**
+ * Line endings and separators
+ */
+export declare const LINE_ENDINGS: {
+    readonly CRLF: "\r\n";
+    readonly LF: "\n";
+    readonly CR: "\r";
+};
+/**
+ * Connection states for internal use
+ */
+export declare const CONNECTION_STATES: {
+    readonly DISCONNECTED: "disconnected";
+    readonly CONNECTING: "connecting";
+    readonly CONNECTED: "connected";
+    readonly AUTHENTICATED: "authenticated";
+    readonly READY: "ready";
+    readonly BUSY: "busy";
+    readonly CLOSING: "closing";
+    readonly ERROR: "error";
+};

dist_ts/mail/delivery/smtpclient/constants.js

@@ -0,0 +1,135 @@
+/**
+ * SMTP Client Constants and Error Codes
+ * All constants, error codes, and enums for SMTP client operations
+ */
+/**
+ * SMTP response codes
+ */
+export const SMTP_CODES = {
+    // Positive completion replies
+    SERVICE_READY: 220,
+    SERVICE_CLOSING: 221,
+    AUTHENTICATION_SUCCESSFUL: 235,
+    REQUESTED_ACTION_OK: 250,
+    USER_NOT_LOCAL: 251,
+    CANNOT_VERIFY_USER: 252,
+    // Positive intermediate replies
+    START_MAIL_INPUT: 354,
+    // Transient negative completion replies
+    SERVICE_NOT_AVAILABLE: 421,
+    MAILBOX_BUSY: 450,
+    LOCAL_ERROR: 451,
+    INSUFFICIENT_STORAGE: 452,
+    UNABLE_TO_ACCOMMODATE: 455,
+    // Permanent negative completion replies
+    SYNTAX_ERROR: 500,
+    SYNTAX_ERROR_PARAMETERS: 501,
+    COMMAND_NOT_IMPLEMENTED: 502,
+    BAD_SEQUENCE: 503,
+    PARAMETER_NOT_IMPLEMENTED: 504,
+    MAILBOX_UNAVAILABLE: 550,
+    USER_NOT_LOCAL_TRY_FORWARD: 551,
+    EXCEEDED_STORAGE: 552,
+    MAILBOX_NAME_NOT_ALLOWED: 553,
+    TRANSACTION_FAILED: 554
+};
+/**
+ * SMTP command names
+ */
+export const SMTP_COMMANDS = {
+    HELO: 'HELO',
+    EHLO: 'EHLO',
+    MAIL_FROM: 'MAIL FROM',
+    RCPT_TO: 'RCPT TO',
+    DATA: 'DATA',
+    RSET: 'RSET',
+    NOOP: 'NOOP',
+    QUIT: 'QUIT',
+    STARTTLS: 'STARTTLS',
+    AUTH: 'AUTH'
+};
+/**
+ * Authentication methods
+ */
+export const AUTH_METHODS = {
+    PLAIN: 'PLAIN',
+    LOGIN: 'LOGIN',
+    OAUTH2: 'XOAUTH2',
+    CRAM_MD5: 'CRAM-MD5'
+};
+/**
+ * Common SMTP extensions
+ */
+export const SMTP_EXTENSIONS = {
+    PIPELINING: 'PIPELINING',
+    SIZE: 'SIZE',
+    STARTTLS: 'STARTTLS',
+    AUTH: 'AUTH',
+    EIGHT_BIT_MIME: '8BITMIME',
+    CHUNKING: 'CHUNKING',
+    ENHANCED_STATUS_CODES: 'ENHANCEDSTATUSCODES',
+    DSN: 'DSN'
+};
+/**
+ * Default configuration values
+ */
+export const DEFAULTS = {
+    CONNECTION_TIMEOUT: 60000, // 60 seconds
+    SOCKET_TIMEOUT: 300000, // 5 minutes
+    COMMAND_TIMEOUT: 30000, // 30 seconds
+    MAX_CONNECTIONS: 5,
+    MAX_MESSAGES: 100,
+    PORT_SMTP: 25,
+    PORT_SUBMISSION: 587,
+    PORT_SMTPS: 465,
+    RETRY_ATTEMPTS: 3,
+    RETRY_DELAY: 1000,
+    POOL_IDLE_TIMEOUT: 30000 // 30 seconds
+};
+/**
+ * Error types for classification
+ */
+export var SmtpErrorType;
+(function (SmtpErrorType) {
+    SmtpErrorType["CONNECTION_ERROR"] = "CONNECTION_ERROR";
+    SmtpErrorType["AUTHENTICATION_ERROR"] = "AUTHENTICATION_ERROR";
+    SmtpErrorType["PROTOCOL_ERROR"] = "PROTOCOL_ERROR";
+    SmtpErrorType["TIMEOUT_ERROR"] = "TIMEOUT_ERROR";
+    SmtpErrorType["TLS_ERROR"] = "TLS_ERROR";
+    SmtpErrorType["SYNTAX_ERROR"] = "SYNTAX_ERROR";
+    SmtpErrorType["MAILBOX_ERROR"] = "MAILBOX_ERROR";
+    SmtpErrorType["QUOTA_ERROR"] = "QUOTA_ERROR";
+    SmtpErrorType["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+})(SmtpErrorType || (SmtpErrorType = {}));
+/**
+ * Regular expressions for parsing
+ */
+export const REGEX_PATTERNS = {
+    EMAIL_ADDRESS: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+    RESPONSE_CODE: /^(\d{3})([ -])(.*)/,
+    ENHANCED_STATUS: /^(\d\.\d\.\d)\s/,
+    AUTH_CAPABILITIES: /AUTH\s+(.+)/i,
+    SIZE_EXTENSION: /SIZE\s+(\d+)/i
+};
+/**
+ * Line endings and separators
+ */
+export const LINE_ENDINGS = {
+    CRLF: '\r\n',
+    LF: '\n',
+    CR: '\r'
+};
+/**
+ * Connection states for internal use
+ */
+export const CONNECTION_STATES = {
+    DISCONNECTED: 'disconnected',
+    CONNECTING: 'connecting',
+    CONNECTED: 'connected',
+    AUTHENTICATED: 'authenticated',
+    READY: 'ready',
+    BUSY: 'busy',
+    CLOSING: 'closing',
+    ERROR: 'error'
+};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vdHMvbWFpbC9kZWxpdmVyeS9zbXRwY2xpZW50L2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSDs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4Qiw4QkFBOEI7SUFDOUIsYUFBYSxFQUFFLEdBQUc7SUFDbEIsZUFBZSxFQUFFLEdBQUc7SUFDcEIseUJBQXlCLEVBQUUsR0FBRztJQUM5QixtQkFBbUIsRUFBRSxHQUFHO0lBQ3hCLGNBQWMsRUFBRSxHQUFHO0lBQ25CLGtCQUFrQixFQUFFLEdBQUc7SUFFdkIsZ0NBQWdDO0lBQ2hDLGdCQUFnQixFQUFFLEdBQUc7SUFFckIsd0NBQXdDO0lBQ3hDLHFCQUFxQixFQUFFLEdBQUc7SUFDMUIsWUFBWSxFQUFFLEdBQUc7SUFDakIsV0FBVyxFQUFFLEdBQUc7SUFDaEIsb0JBQW9CLEVBQUUsR0FBRztJQUN6QixxQkFBcUIsRUFBRSxHQUFHO0lBRTFCLHdDQUF3QztJQUN4QyxZQUFZLEVBQUUsR0FBRztJQUNqQix1QkFBdUIsRUFBRSxHQUFHO0lBQzVCLHVCQUF1QixFQUFFLEdBQUc7SUFDNUIsWUFBWSxFQUFFLEdBQUc7SUFDakIseUJBQXlCLEVBQUUsR0FBRztJQUM5QixtQkFBbUIsRUFBRSxHQUFHO0lBQ3hCLDBCQUEwQixFQUFFLEdBQUc7SUFDL0IsZ0JBQWdCLEVBQUUsR0FBRztJQUNyQix3QkFBd0IsRUFBRSxHQUFHO0lBQzdCLGtCQUFrQixFQUFFLEdBQUc7Q0FDZixDQUFDO0FBRVg7O0dBRUc7QUFDSCxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUc7SUFDM0IsSUFBSSxFQUFFLE1BQU07SUFDWixJQUFJLEVBQUUsTUFBTTtJQUNaLFNBQVMsRUFBRSxXQUFXO0lBQ3RCLE9BQU8sRUFBRSxTQUFTO0lBQ2xCLElBQUksRUFBRSxNQUFNO0lBQ1osSUFB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

dist_ts/mail/delivery/smtpclient/create-client.d.ts

@@ -0,0 +1,22 @@
+/**
+ * SMTP Client Factory
+ * Factory function for client creation and dependency injection
+ */
+import { SmtpClient } from './smtp-client.js';
+import type { ISmtpClientOptions } from './interfaces.js';
+/**
+ * Create a complete SMTP client with all components
+ */
+export declare function createSmtpClient(options: ISmtpClientOptions): SmtpClient;
+/**
+ * Create SMTP client with connection pooling enabled
+ */
+export declare function createPooledSmtpClient(options: ISmtpClientOptions): SmtpClient;
+/**
+ * Create SMTP client for high-volume sending
+ */
+export declare function createBulkSmtpClient(options: ISmtpClientOptions): SmtpClient;
+/**
+ * Create SMTP client for transactional emails
+ */
+export declare function createTransactionalSmtpClient(options: ISmtpClientOptions): SmtpClient;

dist_ts/mail/delivery/smtpclient/create-client.js

@@ -0,0 +1,86 @@
+/**
+ * SMTP Client Factory
+ * Factory function for client creation and dependency injection
+ */
+import { SmtpClient } from './smtp-client.js';
+import { ConnectionManager } from './connection-manager.js';
+import { CommandHandler } from './command-handler.js';
+import { AuthHandler } from './auth-handler.js';
+import { TlsHandler } from './tls-handler.js';
+import { SmtpErrorHandler } from './error-handler.js';
+import { validateClientOptions } from './utils/validation.js';
+import { DEFAULTS } from './constants.js';
+/**
+ * Create a complete SMTP client with all components
+ */
+export function createSmtpClient(options) {
+    // Validate options
+    const errors = validateClientOptions(options);
+    if (errors.length > 0) {
+        throw new Error(`Invalid client options: ${errors.join(', ')}`);
+    }
+    // Apply defaults
+    const clientOptions = {
+        connectionTimeout: DEFAULTS.CONNECTION_TIMEOUT,
+        socketTimeout: DEFAULTS.SOCKET_TIMEOUT,
+        maxConnections: DEFAULTS.MAX_CONNECTIONS,
+        maxMessages: DEFAULTS.MAX_MESSAGES,
+        pool: false,
+        secure: false,
+        debug: false,
+        ...options
+    };
+    // Create handlers
+    const errorHandler = new SmtpErrorHandler(clientOptions);
+    const connectionManager = new ConnectionManager(clientOptions);
+    const commandHandler = new CommandHandler(clientOptions);
+    const authHandler = new AuthHandler(clientOptions, commandHandler);
+    const tlsHandler = new TlsHandler(clientOptions, commandHandler);
+    // Create and return SMTP client
+    return new SmtpClient({
+        options: clientOptions,
+        connectionManager,
+        commandHandler,
+        authHandler,
+        tlsHandler,
+        errorHandler
+    });
+}
+/**
+ * Create SMTP client with connection pooling enabled
+ */
+export function createPooledSmtpClient(options) {
+    return createSmtpClient({
+        ...options,
+        pool: true,
+        maxConnections: options.maxConnections || DEFAULTS.MAX_CONNECTIONS,
+        maxMessages: options.maxMessages || DEFAULTS.MAX_MESSAGES
+    });
+}
+/**
+ * Create SMTP client for high-volume sending
+ */
+export function createBulkSmtpClient(options) {
+    return createSmtpClient({
+        ...options,
+        pool: true,
+        maxConnections: Math.max(options.maxConnections || 10, 10),
+        maxMessages: Math.max(options.maxMessages || 1000, 1000),
+        connectionTimeout: options.connectionTimeout || 30000,
+        socketTimeout: options.socketTimeout || 120000
+    });
+}
+/**
+ * Create SMTP client for transactional emails
+ */
+export function createTransactionalSmtpClient(options) {
+    return createSmtpClient({
+        ...options,
+        pool: false, // Use fresh connections for transactional emails
+        maxConnections: 1,
+        maxMessages: 1,
+        connectionTimeout: options.connectionTimeout || 10000,
+        socketTimeout: options.socketTimeout || 30000
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3JlYXRlLWNsaWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cGNsaWVudC9jcmVhdGUtY2xpZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUM1RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDdEQsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQ2hELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUV0RCxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFMUM7O0dBRUc7QUFDSCxNQUFNLFVBQVUsZ0JBQWdCLENBQUMsT0FBMkI7SUFDMUQsbUJBQW1CO0lBQ25CLE1BQU0sTUFBTSxHQUFHLHFCQUFxQixDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQzlDLElBQUksTUFBTSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUN0QixNQUFNLElBQUksS0FBSyxDQUFDLDJCQUEyQixNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUNsRSxDQUFDO0lBRUQsaUJBQWlCO0lBQ2pCLE1BQU0sYUFBYSxHQUF1QjtRQUN4QyxpQkFBaUIsRUFBRSxRQUFRLENBQUMsa0JBQWtCO1FBQzlDLGFBQWEsRUFBRSxRQUFRLENBQUMsY0FBYztRQUN0QyxjQUFjLEVBQUUsUUFBUSxDQUFDLGVBQWU7UUFDeEMsV0FBVyxFQUFFLFFBQVEsQ0FBQyxZQUFZO1FBQ2xDLElBQUksRUFBRSxLQUFLO1FBQ1gsTUFBTSxFQUFFLEtBQUs7UUFDYixLQUFLLEVBQUUsS0FBSztRQUNaLEdBQUcsT0FBTztLQUNYLENBQUM7SUFFRixrQkFBa0I7SUFDbEIsTUFBTSxZQUFZLEdBQUcsSUFBSSxnQkFBZ0IsQ0FBQyxhQUFhLENBQUMsQ0FBQztJQUN6RCxNQUFNLGlCQUFpQixHQUFHLElBQUksaUJBQWlCLENBQUMsYUFBYSxDQUFDLENBQUM7SUFDL0QsTUFBTSxjQUFjLEdBQUcsSUFBSSxjQUFjLENBQUMsYUFBYSxDQUFDLENBQUM7SUFDekQsTUFBTSxXQUFXLEdBQUcsSUFBSSxXQUFXLENBQUMsYUFBYSxFQUFFLGNBQWMsQ0FBQyxDQUFDO0lBQ25FLE1BQU0sVUFBVSxHQUFHLElBQUksVUFBVSxDQUFDLGFBQWEsRUFBRSxjQUFjLENBQUMsQ0FBQztJQUVqRSxnQ0FBZ0M7SUFDaEMsT0FBTyxJQUFJLFVBQVUsQ0FBQztRQUNwQixPQUFPLEVBQUUsYUFBYTtRQUN0QixpQkFBaUI7UUFDakIsY0FBYztRQUNkLFdBQVc7UUFDWCxVQUFVO1FBQ1YsWUFBWTtLQUNiLENBQUMsQ0FBQztBQUNMLENBQUM7QUFFRDs7R0FFRztBQUNILE1BQU0sVUFBVSxzQkFBc0IsQ0FBQyxPQUEyQjtJQUNoRSxPQUFPLGdCQUFnQixDQUFDO1FBQ3RCLEdBQUcsT0FBTztRQUNWLElBQUksRUFBRSxJQUFJO1FBQ1YsY0FBYyxFQUFFLE9BQU8sQ0FBQyxjQUFjLElBQUksUUFBUSxDQUFDLGVBQWU7UUFDbEUsV0FBVyxFQUFFLE9BQU8sQ0FBQyxXQUFXLElBQUksUUFBUSxDQUFDLFlBQVk7S0FDMUQsQ0FBQyxDQUFDO0FBQ0wsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLG9CQUFvQixDQUFDLE9BQTJCO0lBQzlELE9BQU8sZ0JBQWdCLENBQUM7UUFDdEIsR0FBRyxPQUFPO1FBQ1YsSUFBSSxFQUFFLElBQUk7UUFDVixjQUFjLEVBQUUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsY0FBYyxJQUFJLEVBQUUsRUFBRSxFQUFFLENBQUM7UUFDMUQsV0FBVyxFQUFFLElBQUksQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLFdBQVcsSUFBSSxJQUFJLEVBQUUsSUFBSSxDQUFDO1FBQ3hELGlCQUFpQixFQUFFLE9BQU8sQ0FBQyxpQkFBaUIsSUFBSSxLQUFLO1FBQ3JELGFBQWEsRUFBRSxPQUFPLENBQUMsYUFBYSxJQUFJLE1BQU07S0FDL0MsQ0FBQyxDQUFDO0FBQ0wsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLDZCQUE2QixDQUFDLE9BQTJCO0lBQ3ZFLE9BQU8sZ0JBQWdCLENBQUM7UUFDdEIsR0FBRyxPQUFPO1FBQ1YsSUFBSSxFQUFFLEtBQUssRUFBRSxpREFBaUQ7UUFDOUQsY0FBYyxFQUFFLENBQUM7UUFDakIsV0FBVyxFQUFFLENBQUM7UUFDZCxpQkFBaUIsRUFBRSxPQUFPLENBQUMsaUJBQWlCLElBQUksS0FBSztRQUNyRCxhQUFhLEVBQUUsT0FBTyxDQUFDLGFBQWEsSUFBSSxLQUFLO0tBQzlDLENBQUMsQ0FBQztBQUNMLENBQUMifQ==

dist_ts/mail/delivery/smtpclient/error-handler.d.ts

@@ -0,0 +1,28 @@
+/**
+ * SMTP Client Error Handler
+ * Error classification and recovery strategies
+ */
+import { SmtpErrorType } from './constants.js';
+import type { ISmtpResponse, ISmtpErrorContext, ISmtpClientOptions } from './interfaces.js';
+export declare class SmtpErrorHandler {
+    private options;
+    constructor(options: ISmtpClientOptions);
+    /**
+     * Classify error type based on response or error
+     */
+    classifyError(error: Error | ISmtpResponse, context?: ISmtpErrorContext): SmtpErrorType;
+    /**
+     * Determine if error is retryable
+     */
+    isRetryable(errorType: SmtpErrorType, response?: ISmtpResponse): boolean;
+    /**
+     * Get retry delay for error type
+     */
+    getRetryDelay(attempt: number, errorType: SmtpErrorType): number;
+    /**
+     * Create enhanced error with context
+     */
+    createError(message: string, errorType: SmtpErrorType, context?: ISmtpErrorContext, originalError?: Error): Error;
+    private classifyErrorByMessage;
+    private classifyErrorByCode;
+}

dist_ts/mail/delivery/smtpclient/error-handler.js

@@ -0,0 +1,111 @@
+/**
+ * SMTP Client Error Handler
+ * Error classification and recovery strategies
+ */
+import { SmtpErrorType } from './constants.js';
+import { logDebug } from './utils/logging.js';
+export class SmtpErrorHandler {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Classify error type based on response or error
+     */
+    classifyError(error, context) {
+        logDebug('Classifying error', this.options, { errorMessage: error instanceof Error ? error.message : String(error), context });
+        // Handle Error objects
+        if (error instanceof Error) {
+            return this.classifyErrorByMessage(error);
+        }
+        // Handle SMTP response codes
+        if (typeof error === 'object' && 'code' in error) {
+            return this.classifyErrorByCode(error.code);
+        }
+        return SmtpErrorType.UNKNOWN_ERROR;
+    }
+    /**
+     * Determine if error is retryable
+     */
+    isRetryable(errorType, response) {
+        switch (errorType) {
+            case SmtpErrorType.CONNECTION_ERROR:
+            case SmtpErrorType.TIMEOUT_ERROR:
+                return true;
+            case SmtpErrorType.PROTOCOL_ERROR:
+                // Only retry on temporary failures (4xx codes)
+                return response ? response.code >= 400 && response.code < 500 : false;
+            case SmtpErrorType.AUTHENTICATION_ERROR:
+            case SmtpErrorType.TLS_ERROR:
+            case SmtpErrorType.SYNTAX_ERROR:
+            case SmtpErrorType.MAILBOX_ERROR:
+            case SmtpErrorType.QUOTA_ERROR:
+                return false;
+            default:
+                return false;
+        }
+    }
+    /**
+     * Get retry delay for error type
+     */
+    getRetryDelay(attempt, errorType) {
+        const baseDelay = 1000; // 1 second
+        const maxDelay = 30000; // 30 seconds
+        // Exponential backoff with jitter
+        const delay = Math.min(baseDelay * Math.pow(2, attempt - 1), maxDelay);
+        const jitter = Math.random() * 0.1 * delay; // 10% jitter
+        return Math.floor(delay + jitter);
+    }
+    /**
+     * Create enhanced error with context
+     */
+    createError(message, errorType, context, originalError) {
+        const error = new Error(message);
+        error.type = errorType;
+        error.context = context;
+        error.originalError = originalError;
+        return error;
+    }
+    classifyErrorByMessage(error) {
+        const message = error.message.toLowerCase();
+        if (message.includes('timeout') || message.includes('etimedout')) {
+            return SmtpErrorType.TIMEOUT_ERROR;
+        }
+        if (message.includes('connect') || message.includes('econnrefused') ||
+            message.includes('enotfound') || message.includes('enetunreach')) {
+            return SmtpErrorType.CONNECTION_ERROR;
+        }
+        if (message.includes('tls') || message.includes('ssl') ||
+            message.includes('certificate') || message.includes('handshake')) {
+            return SmtpErrorType.TLS_ERROR;
+        }
+        if (message.includes('auth')) {
+            return SmtpErrorType.AUTHENTICATION_ERROR;
+        }
+        return SmtpErrorType.UNKNOWN_ERROR;
+    }
+    classifyErrorByCode(code) {
+        if (code >= 500) {
+            // Permanent failures
+            if (code === 550 || code === 551 || code === 553) {
+                return SmtpErrorType.MAILBOX_ERROR;
+            }
+            if (code === 552) {
+                return SmtpErrorType.QUOTA_ERROR;
+            }
+            if (code === 500 || code === 501 || code === 502 || code === 504) {
+                return SmtpErrorType.SYNTAX_ERROR;
+            }
+            return SmtpErrorType.PROTOCOL_ERROR;
+        }
+        if (code >= 400) {
+            // Temporary failures
+            if (code === 450 || code === 451 || code === 452) {
+                return SmtpErrorType.QUOTA_ERROR;
+            }
+            return SmtpErrorType.PROTOCOL_ERROR;
+        }
+        return SmtpErrorType.UNKNOWN_ERROR;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3ItaGFuZGxlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cGNsaWVudC9lcnJvci1oYW5kbGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUUvQyxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFOUMsTUFBTSxPQUFPLGdCQUFnQjtJQUNuQixPQUFPLENBQXFCO0lBRXBDLFlBQVksT0FBMkI7UUFDckMsSUFBSSxDQUFDLE9BQU8sR0FBRyxPQUFPLENBQUM7SUFDekIsQ0FBQztJQUVEOztPQUVHO0lBQ0ksYUFBYSxDQUFDLEtBQTRCLEVBQUUsT0FBMkI7UUFDNUUsUUFBUSxDQUFDLG1CQUFtQixFQUFFLElBQUksQ0FBQyxPQUFPLEVBQUUsRUFBRSxZQUFZLEVBQUUsS0FBSyxZQUFZLEtBQUssQ0FBQyxDQUFDLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFDLEtBQUssQ0FBQyxFQUFFLE9BQU8sRUFBRSxDQUFDLENBQUM7UUFFL0gsdUJBQXVCO1FBQ3ZCLElBQUksS0FBSyxZQUFZLEtBQUssRUFBRSxDQUFDO1lBQzNCLE9BQU8sSUFBSSxDQUFDLHNCQUFzQixDQUFDLEtBQUssQ0FBQyxDQUFDO1FBQzVDLENBQUM7UUFFRCw2QkFBNkI7UUFDN0IsSUFBSSxPQUFPLEtBQUssS0FBSyxRQUFRLElBQUksTUFBTSxJQUFJLEtBQUssRUFBRSxDQUFDO1lBQ2pELE9BQU8sSUFBSSxDQUFDLG1CQUFtQixDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQztRQUM5QyxDQUFDO1FBRUQsT0FBTyxhQUFhLENBQUMsYUFBYSxDQUFDO0lBQ3JDLENBQUM7SUFFRDs7T0FFRztJQUNJLFdBQVcsQ0FBQyxTQUF3QixFQUFFLFFBQXdCO1FBQ25F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

dist_ts/mail/delivery/smtpclient/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * SMTP Client Module Exports
+ * Modular SMTP client implementation for robust email delivery
+ */
+export * from './smtp-client.js';
+export * from './create-client.js';
+export * from './connection-manager.js';
+export * from './command-handler.js';
+export * from './auth-handler.js';
+export * from './tls-handler.js';
+export * from './error-handler.js';
+export * from './interfaces.js';
+export * from './constants.js';
+export * from './utils/validation.js';
+export * from './utils/logging.js';
+export * from './utils/helpers.js';

dist_ts/mail/delivery/smtpclient/index.js

@@ -0,0 +1,21 @@
+/**
+ * SMTP Client Module Exports
+ * Modular SMTP client implementation for robust email delivery
+ */
+// Main client class and factory
+export * from './smtp-client.js';
+export * from './create-client.js';
+// Core handlers
+export * from './connection-manager.js';
+export * from './command-handler.js';
+export * from './auth-handler.js';
+export * from './tls-handler.js';
+export * from './error-handler.js';
+// Interfaces and types
+export * from './interfaces.js';
+export * from './constants.js';
+// Utilities
+export * from './utils/validation.js';
+export * from './utils/logging.js';
+export * from './utils/helpers.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi90cy9tYWlsL2RlbGl2ZXJ5L3NtdHBjbGllbnQvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsZ0NBQWdDO0FBQ2hDLGNBQWMsa0JBQWtCLENBQUM7QUFDakMsY0FBYyxvQkFBb0IsQ0FBQztBQUVuQyxnQkFBZ0I7QUFDaEIsY0FBYyx5QkFBeUIsQ0FBQztBQUN4QyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsbUJBQW1CLENBQUM7QUFDbEMsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLG9CQUFvQixDQUFDO0FBRW5DLHVCQUF1QjtBQUN2QixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsZ0JBQWdCLENBQUM7QUFFL0IsWUFBWTtBQUNaLGNBQWMsdUJBQXVCLENBQUM7QUFDdEMsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLG9CQUFvQixDQUFDIn0=

dist_ts/mail/delivery/smtpclient/interfaces.d.ts

@@ -0,0 +1,183 @@
+/**
+ * SMTP Client Interfaces and Types
+ * All interface definitions for the modular SMTP client
+ */
+import type * as tls from 'node:tls';
+import type * as net from 'node:net';
+/**
+ * SMTP client connection options
+ */
+export interface ISmtpClientOptions {
+    /** Hostname of the SMTP server */
+    host: string;
+    /** Port to connect to */
+    port: number;
+    /** Whether to use TLS for the connection */
+    secure?: boolean;
+    /** Connection timeout in milliseconds */
+    connectionTimeout?: number;
+    /** Socket timeout in milliseconds */
+    socketTimeout?: number;
+    /** Domain name for EHLO command */
+    domain?: string;
+    /** Authentication options */
+    auth?: ISmtpAuthOptions;
+    /** TLS options */
+    tls?: tls.ConnectionOptions;
+    /** Maximum number of connections in pool */
+    pool?: boolean;
+    maxConnections?: number;
+    maxMessages?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Proxy settings */
+    proxy?: string;
+}
+/**
+ * Authentication options for SMTP
+ */
+export interface ISmtpAuthOptions {
+    /** Username */
+    user?: string;
+    /** Password */
+    pass?: string;
+    /** OAuth2 settings */
+    oauth2?: IOAuth2Options;
+    /** Authentication method preference */
+    method?: 'PLAIN' | 'LOGIN' | 'OAUTH2' | 'AUTO';
+}
+/**
+ * OAuth2 authentication options
+ */
+export interface IOAuth2Options {
+    /** OAuth2 user identifier */
+    user: string;
+    /** OAuth2 client ID */
+    clientId: string;
+    /** OAuth2 client secret */
+    clientSecret: string;
+    /** OAuth2 refresh token */
+    refreshToken: string;
+    /** OAuth2 access token */
+    accessToken?: string;
+    /** Token expiry time */
+    expires?: number;
+}
+/**
+ * Result of an email send operation
+ */
+export interface ISmtpSendResult {
+    /** Whether the send was successful */
+    success: boolean;
+    /** Message ID from server */
+    messageId?: string;
+    /** List of accepted recipients */
+    acceptedRecipients: string[];
+    /** List of rejected recipients */
+    rejectedRecipients: string[];
+    /** Error information if failed */
+    error?: Error;
+    /** Server response */
+    response?: string;
+    /** Envelope information */
+    envelope?: ISmtpEnvelope;
+}
+/**
+ * SMTP envelope information
+ */
+export interface ISmtpEnvelope {
+    /** Sender address */
+    from: string;
+    /** Recipient addresses */
+    to: string[];
+}
+/**
+ * Connection pool status
+ */
+export interface IConnectionPoolStatus {
+    /** Total connections in pool */
+    total: number;
+    /** Active connections */
+    active: number;
+    /** Idle connections */
+    idle: number;
+    /** Pending connection requests */
+    pending: number;
+}
+/**
+ * SMTP command response
+ */
+export interface ISmtpResponse {
+    /** Response code */
+    code: number;
+    /** Response message */
+    message: string;
+    /** Enhanced status code */
+    enhancedCode?: string;
+    /** Raw response */
+    raw: string;
+}
+/**
+ * Connection state
+ */
+export declare enum ConnectionState {
+    DISCONNECTED = "disconnected",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    AUTHENTICATED = "authenticated",
+    READY = "ready",
+    BUSY = "busy",
+    CLOSING = "closing",
+    ERROR = "error"
+}
+/**
+ * SMTP capabilities
+ */
+export interface ISmtpCapabilities {
+    /** Supported extensions */
+    extensions: Set<string>;
+    /** Maximum message size */
+    maxSize?: number;
+    /** Supported authentication methods */
+    authMethods: Set<string>;
+    /** Support for pipelining */
+    pipelining: boolean;
+    /** Support for STARTTLS */
+    starttls: boolean;
+    /** Support for 8BITMIME */
+    eightBitMime: boolean;
+}
+/**
+ * Internal connection interface
+ */
+export interface ISmtpConnection {
+    /** Socket connection */
+    socket: net.Socket | tls.TLSSocket;
+    /** Connection state */
+    state: ConnectionState;
+    /** Server capabilities */
+    capabilities?: ISmtpCapabilities;
+    /** Connection options */
+    options: ISmtpClientOptions;
+    /** Whether connection is secure */
+    secure: boolean;
+    /** Connection creation time */
+    createdAt: Date;
+    /** Last activity time */
+    lastActivity: Date;
+    /** Number of messages sent */
+    messageCount: number;
+}
+/**
+ * Error context for detailed error reporting
+ */
+export interface ISmtpErrorContext {
+    /** Command that caused the error */
+    command?: string;
+    /** Server response */
+    response?: ISmtpResponse;
+    /** Connection state */
+    connectionState?: ConnectionState;
+    /** Additional context data */
+    data?: Record<string, any>;
+}

dist_ts/mail/delivery/smtpclient/interfaces.js

@@ -0,0 +1,19 @@
+/**
+ * SMTP Client Interfaces and Types
+ * All interface definitions for the modular SMTP client
+ */
+/**
+ * Connection state
+ */
+export var ConnectionState;
+(function (ConnectionState) {
+    ConnectionState["DISCONNECTED"] = "disconnected";
+    ConnectionState["CONNECTING"] = "connecting";
+    ConnectionState["CONNECTED"] = "connected";
+    ConnectionState["AUTHENTICATED"] = "authenticated";
+    ConnectionState["READY"] = "ready";
+    ConnectionState["BUSY"] = "busy";
+    ConnectionState["CLOSING"] = "closing";
+    ConnectionState["ERROR"] = "error";
+})(ConnectionState || (ConnectionState = {}));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlcy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cGNsaWVudC9pbnRlcmZhY2VzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQTZKSDs7R0FFRztBQUNILE1BQU0sQ0FBTixJQUFZLGVBU1g7QUFURCxXQUFZLGVBQWU7SUFDekIsZ0RBQTZCLENBQUE7SUFDN0IsNENBQXlCLENBQUE7SUFDekIsMENBQXVCLENBQUE7SUFDdkIsa0RBQStCLENBQUE7SUFDL0Isa0NBQWUsQ0FBQTtJQUNmLGdDQUFhLENBQUE7SUFDYixzQ0FBbUIsQ0FBQTtJQUNuQixrQ0FBZSxDQUFBO0FBQ2pCLENBQUMsRUFUVyxlQUFlLEtBQWYsZUFBZSxRQVMxQiJ9

dist_ts/mail/delivery/smtpclient/smtp-client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * SMTP Client Core Implementation
+ * Main client class with delegation to handlers
+ */
+import { EventEmitter } from 'node:events';
+import type { Email } from '../../core/classes.email.js';
+import type { ISmtpClientOptions, ISmtpSendResult, IConnectionPoolStatus } from './interfaces.js';
+import type { ConnectionManager } from './connection-manager.js';
+import type { CommandHandler } from './command-handler.js';
+import type { AuthHandler } from './auth-handler.js';
+import type { TlsHandler } from './tls-handler.js';
+import type { SmtpErrorHandler } from './error-handler.js';
+interface ISmtpClientDependencies {
+    options: ISmtpClientOptions;
+    connectionManager: ConnectionManager;
+    commandHandler: CommandHandler;
+    authHandler: AuthHandler;
+    tlsHandler: TlsHandler;
+    errorHandler: SmtpErrorHandler;
+}
+export declare class SmtpClient extends EventEmitter {
+    private options;
+    private connectionManager;
+    private commandHandler;
+    private authHandler;
+    private tlsHandler;
+    private errorHandler;
+    private isShuttingDown;
+    constructor(dependencies: ISmtpClientDependencies);
+    /**
+     * Send an email
+     */
+    sendMail(email: Email): Promise<ISmtpSendResult>;
+    /**
+     * Test connection to SMTP server
+     */
+    verify(): Promise<boolean>;
+    /**
+     * Check if client is connected
+     */
+    isConnected(): boolean;
+    /**
+     * Get connection pool status
+     */
+    getPoolStatus(): IConnectionPoolStatus;
+    /**
+     * Update client options
+     */
+    updateOptions(newOptions: Partial<ISmtpClientOptions>): void;
+    /**
+     * Close all connections and shutdown client
+     */
+    close(): Promise<void>;
+    private formatEmailData;
+    private extractMessageId;
+    private setupEventForwarding;
+}
+export {};

dist_ts/mail/delivery/smtpclient/tls-handler.d.ts

@@ -0,0 +1,33 @@
+/**
+ * SMTP Client TLS Handler
+ * TLS and STARTTLS client functionality
+ */
+import * as tls from 'node:tls';
+import type { ISmtpConnection, ISmtpClientOptions } from './interfaces.js';
+import type { CommandHandler } from './command-handler.js';
+export declare class TlsHandler {
+    private options;
+    private commandHandler;
+    constructor(options: ISmtpClientOptions, commandHandler: CommandHandler);
+    /**
+     * Upgrade connection to TLS using STARTTLS
+     */
+    upgradeToTLS(connection: ISmtpConnection): Promise<void>;
+    /**
+     * Create a direct TLS connection
+     */
+    createTLSConnection(host: string, port: number): Promise<tls.TLSSocket>;
+    /**
+     * Validate TLS certificate
+     */
+    validateCertificate(socket: tls.TLSSocket): boolean;
+    /**
+     * Get TLS connection information
+     */
+    getTLSInfo(socket: tls.TLSSocket): any;
+    /**
+     * Check if TLS upgrade is required or recommended
+     */
+    shouldUseTLS(connection: ISmtpConnection): boolean;
+    private performTLSUpgrade;
+}

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

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

dist_ts/mail/delivery/smtpclient/utils/logging.js

@@ -0,0 +1,153 @@
+/**
+ * SMTP Client Logging Utilities
+ * Client-side logging utilities for SMTP operations
+ */
+import { logger } from '../../../../logger.js';
+/**
+ * Log SMTP client connection events
+ */
+export function logConnection(event, options, data) {
+    const logData = {
+        component: 'smtp-client',
+        event,
+        host: options.host,
+        port: options.port,
+        secure: options.secure,
+        ...data
+    };
+    switch (event) {
+        case 'connecting':
+            logger.info('SMTP client connecting', logData);
+            break;
+        case 'connected':
+            logger.info('SMTP client connected', logData);
+            break;
+        case 'disconnected':
+            logger.info('SMTP client disconnected', logData);
+            break;
+        case 'error':
+            logger.error('SMTP client connection error', logData);
+            break;
+    }
+}
+/**
+ * Log SMTP command execution
+ */
+export function logCommand(command, response, options, data) {
+    const logData = {
+        component: 'smtp-client',
+        command,
+        response,
+        host: options?.host,
+        port: options?.port,
+        ...data
+    };
+    if (response && response.code >= 400) {
+        logger.warn('SMTP command failed', logData);
+    }
+    else {
+        logger.debug('SMTP command executed', logData);
+    }
+}
+/**
+ * Log authentication events
+ */
+export function logAuthentication(event, method, options, data) {
+    const logData = {
+        component: 'smtp-client',
+        event: `auth_${event}`,
+        authMethod: method,
+        host: options.host,
+        port: options.port,
+        ...data
+    };
+    switch (event) {
+        case 'start':
+            logger.debug('SMTP authentication started', logData);
+            break;
+        case 'success':
+            logger.info('SMTP authentication successful', logData);
+            break;
+        case 'failure':
+            logger.error('SMTP authentication failed', logData);
+            break;
+    }
+}
+/**
+ * Log TLS/STARTTLS events
+ */
+export function logTLS(event, options, data) {
+    const logData = {
+        component: 'smtp-client',
+        event,
+        host: options.host,
+        port: options.port,
+        ...data
+    };
+    if (event.includes('failure')) {
+        logger.error('SMTP TLS operation failed', logData);
+    }
+    else {
+        logger.info('SMTP TLS operation', logData);
+    }
+}
+/**
+ * Log email sending events
+ */
+export function logEmailSend(event, recipients, options, data) {
+    const logData = {
+        component: 'smtp-client',
+        event: `send_${event}`,
+        recipientCount: recipients.length,
+        recipients: recipients.slice(0, 5), // Only log first 5 recipients for privacy
+        host: options.host,
+        port: options.port,
+        ...data
+    };
+    switch (event) {
+        case 'start':
+            logger.info('SMTP email send started', logData);
+            break;
+        case 'success':
+            logger.info('SMTP email send successful', logData);
+            break;
+        case 'failure':
+            logger.error('SMTP email send failed', logData);
+            break;
+    }
+}
+/**
+ * Log performance metrics
+ */
+export function logPerformance(operation, duration, options, data) {
+    const logData = {
+        component: 'smtp-client',
+        operation,
+        duration,
+        host: options.host,
+        port: options.port,
+        ...data
+    };
+    if (duration > 10000) { // Log slow operations (>10s)
+        logger.warn('SMTP slow operation detected', logData);
+    }
+    else {
+        logger.debug('SMTP operation performance', logData);
+    }
+}
+/**
+ * Log debug information (only when debug is enabled)
+ */
+export function logDebug(message, options, data) {
+    if (!options.debug) {
+        return;
+    }
+    const logData = {
+        component: 'smtp-client-debug',
+        host: options.host,
+        port: options.port,
+        ...data
+    };
+    logger.debug(`[SMTP Client Debug] ${message}`, logData);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibG9nZ2luZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cGNsaWVudC91dGlscy9sb2dnaW5nLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQWlCL0M7O0dBRUc7QUFDSCxNQUFNLFVBQVUsYUFBYSxDQUMzQixLQUE0RCxFQUM1RCxPQUEyQixFQUMzQixJQUFrQztJQUVsQyxNQUFNLE9BQU8sR0FBdUI7UUFDbEMsU0FBUyxFQUFFLGFBQWE7UUFDeEIsS0FBSztRQUNMLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSTtRQUNsQixJQUFJLEVBQUUsT0FBTyxDQUFDLElBQUk7UUFDbEIsTUFBTSxFQUFFLE9BQU8sQ0FBQyxNQUFNO1FBQ3RCLEdBQUcsSUFBSTtLQUNSLENBQUM7SUFFRixRQUFRLEtBQUssRUFBRSxDQUFDO1FBQ2QsS0FBSyxZQUFZO1lBQ2YsTUFBTSxDQUFDLElBQUksQ0FBQyx3QkFBd0IsRUFBRSxPQUFPLENBQUMsQ0FBQztZQUMvQyxNQUFNO1FBQ1IsS0FBSyxXQUFXO1lBQ2QsTUFBTSxDQUFDLElBQUksQ0FBQyx1QkFBdUIsRUFBRSxPQUFPLENBQUMsQ0FBQztZQUM5QyxNQUFNO1FBQ1IsS0FBSyxjQUFjO1lBQ2pCLE1BQU0sQ0FBQyxJQUFJLENBQUMsMEJBQTBCLEVBQUUsT0FBTyxDQUFDLENBQUM7WUFDakQsTUFBTTtRQUNSLEtBQUssT0FBTztZQUNWLE1BQU0sQ0FBQyxLQUFLLENBQUMsOEJBQThCLEVBQUUsT0FBTyxDQUFDLENBQUM7WUFDdEQsTUFBTTtJQUNWLENBQUM7QUFDSCxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFVBQVUsVUFBVSxDQUN4QixPQUFlLEVBQ2YsUUFBd0IsRUFDeEIsT0FBNEIsRUFDNUIsSUFBa0M7SUFFbEMsTUFBTSxPQUFPLEdBQXVCO1FBQ2xDLFNBQVMsRUFBRSxhQUFhO1FBQ3hCLE9BQU87UUFDUCxRQUFRO1FBQ1IsSUFBSSxFQUFFLE9BQU8sRUFBRSxJQUFJO1FBQ25CLElBQUksRUFBRSxPQUFPLEVBQUUsSUFBSTtRQUNuQixHQUFHLElBQUk7S0FDUixDQUFDO0lBRUYsSUFBSSxRQUFRLElBQUksUUFBUSxDQUFDLElBQUksSUFBSSxHQUFHLEVBQUUsQ0FBQztRQUNyQyxNQUFNLENBQUMsSUFBSSxDQUFDLHFCQUFxQixFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQzlDLENBQUM7U0FBTSxDQUFDO1FBQ04sTUFBTSxDQUFDLEtBQUssQ0FBQyx1QkFBdUIsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUNqRCxDQUFDO0FBQ0gsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLGlCQUFpQixDQUMvQixLQUFzQyxFQUN0QyxNQUFjLEVBQ2QsT0FBMkIsRUFDM0IsSUFBa0M7SUFFbEMsTUFBTSxPQUFPLEdBQXVCO1FBQ2xDLFNBQVMsRUFBRSxhQUFhO1FBQ3hCLEtBQUssRUFBRSxRQUFRLEtBQUssRUFBRTtRQUN0QixVQUFVLEVBQUUsTUFBTTtRQUNsQixJQUFJLEVBQUUsT0FBTyxDQUFDLElBQUk7UUFDbEIsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO1FBQ2xCLEdBQUcsSUFBSTtLQUNSLENBQUM7SUFFRixRQUFRLEtBQUssRUFBRSxDQUFDO1FBQ2QsS0FBSyxPQUFPO1lBQ1YsTUFBTSxDQUFDLEtBQUssQ0FBQyw2QkFBNkIsRUFBRSxPQUFPLENBQUMsQ0FBQztZQUNyRCxNQUFNO1FBQ1IsS0FBSyxTQUFTO1lBQ1osTUFBTSxDQUFDLElBQUksQ0FBQyxnQ0FBZ0MsRUFBRSxPQUFPLENBQUMsQ0FBQztZQUN2RCxNQUFNO1FBQ1IsS0FBSyxTQUFTO1lBQ1osTUFBTSxDQUFDLEtBQUssQ0FBQyw0QkFBNEIsRUFBRSxPQUFPLENBQUMsQ0FBQztZQUNwRCxNQUFNO0lBQ1YsQ0FBQztBQUNILENBQUM7QUFFRDs7R0FFRztBQUNILE1BQU0sVUFBVSxNQUFNLENBQ3BCLEtBQW1GLEVBQ25GLE9BQTJCLEVBQzNCLElBQWtDO0lBRWxDLE1BQU0sT0FBTyxHQUF1QjtRQUNsQyxTQUFTLEVBQUUsYUFBYTtRQUN4QixLQUFLO1FBQ0wsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO1FBQ2xCLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSTtRQUNsQixHQUFHLElBQUk7S0FDUixDQUFDO0lBRUYsSUFBSSxLQUFLLENBQUMsUUFBUSxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUM7UUFDOUIsTUFBTSxDQUFDLEtBQUssQ0FBQywyQkFBMkIsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUNyRCxDQUFDO1NBQU0sQ0FBQztRQUNOLE1BQU0sQ0FBQyxJQUFJLENBQUMsb0JBQW9CLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDN0MsQ0FBQztBQUNILENBQUM7QUFFRDs7R0FFRztBQUNILE1BQU0sVUFBVSxZQUFZLENBQzFCLEtBQXNDLEVBQ3RDLFVBQW9CLEVBQ3BCLE9BQTJCLEVBQzNCLElBQWtDO0lBRWxDLE1BQU0sT0FBTyxHQUF1QjtRQUNsQyxTQUFTLEVBQUUsYUFBYTtRQUN4QixLQUFLLEVBQUUsUUFBUSxLQUFLLEVBQUU7UUFDdEIsY0FBYyxFQUFFLFVBQVUsQ0FBQyxNQUFNO1FBQ2pDLFVBQVUsRUFBRSxVQUFVLENBQUMsS0FBSyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsRUFBRSwwQ0FBMEM7UUFDOUUsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO1FBQ2xCLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSTtRQUNsQixHQUFHLElBQUk7S0FDUixDQUFDO0lBRUYsUUFBUSxLQUFLLEVBQUUsQ0FBQztRQUNkLEtBQUssT0FBTztZQUNWLE1BQU0sQ0FBQyxJQUFJLENBQUMseUJBQXlCLEVBQUUsT0FBTyxDQUFDLENBQUM7WUFDaEQsTUFBTTtRQUNSLEtBQUssU0FBUztZQUNaLE1BQU0sQ0FBQyxJQUFJLENBQUMsNEJBQTRCLEVBQUUsT0FBTyxDQUFDLENBQUM7WUFDbkQsTUFBTTtRQUNSLEtBQUssU0FBUztZQUNaLE1BQU0sQ0FBQyxLQUFLLENBQUMsd0JBQXdCLEVBQUUsT0FBTyxDQUFDLENBQUM7WUFDaEQsTUFBTTtJQUNWLENBQUM7QUFDSCxDQUFDO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLFVBQVUsY0FBYyxDQUM1QixTQUFpQixFQUNqQixRQUFnQixFQUNoQixPQUEyQixFQUMzQixJQUFrQztJQUVsQyxNQUFNLE9BQU8sR0FBdUI7UUFDbEMsU0FBUyxFQUFFLGFBQWE7UUFDeEIsU0FBUztRQUNULFFBQVE7UUFDUixJQUFJLEVBQUUsT0FBTyxDQUFDLElBQUk7UUFDbEIsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO1FBQ2xCLEdBQUcsSUFBSTtLQUNSLENBQUM7SUFFRixJQUFJLFFBQVEsR0FBRyxLQUFLLEVBQUUsQ0FBQyxDQUFDLDZCQUE2QjtRQUNuRCxNQUFNLENBQUMsSUFBSSxDQUFDLDhCQUE4QixFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ3ZELENBQUM7U0FBTSxDQUFDO1FBQ04sTUFBTSxDQUFDLEtBQUssQ0FBQyw0QkFBNEIsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUN0RCxDQUFDO0FBQ0gsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLFFBQVEsQ0FDdEIsT0FBZSxFQUNmLE9BQTJCLEVBQzNCLElBQWtDO0lBRWxDLElBQUksQ0FBQyxPQUFPLENBQUMsS0FBSyxFQUFFLENBQUM7UUFDbkIsT0FBTztJQUNULENBQUM7SUFFRCxNQUFNLE9BQU8sR0FBdUI7UUFDbEMsU0FBUyxFQUFFLG1CQUFtQjtRQUM5QixJQUFJLEVBQUUsT0FBTyxDQUFDLElBQUk7UUFDbEIsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJO1FBQ2xCLEdBQUcsSUFBSTtLQUNSLENBQUM7SUFFRixNQUFNLENBQUMsS0FBSyxDQUFDLHVCQUF1QixPQUFPLEVBQUUsRUFBRSxPQUFPLENBQUMsQ0FBQztBQUMxRCxDQUFDIn0=

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

@@ -0,0 +1,38 @@
+/**
+ * SMTP Client Validation Utilities
+ * Input validation functions for SMTP client operations
+ */
+import type { ISmtpClientOptions, ISmtpAuthOptions } from '../interfaces.js';
+/**
+ * Validate email address format
+ * Supports RFC-compliant addresses including empty return paths for bounces
+ */
+export declare function validateEmailAddress(email: string): boolean;
+/**
+ * Validate SMTP client options
+ */
+export declare function validateClientOptions(options: ISmtpClientOptions): string[];
+/**
+ * Validate authentication options
+ */
+export declare function validateAuthOptions(auth: ISmtpAuthOptions): string[];
+/**
+ * Validate hostname format
+ */
+export declare function validateHostname(hostname: string): boolean;
+/**
+ * Validate port number
+ */
+export declare function validatePort(port: number): boolean;
+/**
+ * Sanitize and validate domain name for EHLO
+ */
+export declare function validateAndSanitizeDomain(domain: string): string;
+/**
+ * Validate recipient list
+ */
+export declare function validateRecipients(recipients: string | string[]): string[];
+/**
+ * Validate sender address
+ */
+export declare function validateSender(sender: string): boolean;