@serve.zone/dcrouter 2.12.4

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

package/dist_ts/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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29uc3RhbnRzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vLi4vdHMvbWFpbC9kZWxpdmVyeS9zbXRwY2xpZW50L2NvbnN0YW50cy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0c7QUFFSDs7R0FFRztBQUNILE1BQU0sQ0FBQyxNQUFNLFVBQVUsR0FBRztJQUN4Qiw4QkFBOEI7SUFDOUIsYUFBYSxFQUFFLEdBQUc7SUFDbEIsZUFBZSxFQUFFLEdBQUc7SUFDcEIseUJBQXlCLEVBQUUsR0FBRztJQUM5QixtQkFBbUIsRUFBRSxHQUFHO0lBQ3hCLGNBQWMsRUFBRSxHQUFHO0lBQ25CLGtCQUFrQixFQUFFLEdBQUc7SUFFdkIsZ0NBQWdDO0lBQ2hDLGdCQUFnQixFQUFFLEdBQUc7SUFFckIsd0NBQXdDO0lBQ3hDLHFCQUFxQixFQUFFLEdBQUc7SUFDMUIsWUFBWSxFQUFFLEdBQUc7SUFDakIsV0FBVyxFQUFFLEdBQUc7SUFDaEIsb0JBQW9CLEVBQUUsR0FBRztJQUN6QixxQkFBcUIsRUFBRSxHQUFHO0lBRTFCLHdDQUF3QztJQUN4QyxZQUFZLEVBQUUsR0FBRztJQUNqQix1QkFBdUIsRUFBRSxHQUFHO0lBQzVCLHVCQUF1QixFQUFFLEdBQUc7SUFDNUIsWUFBWSxFQUFFLEdBQUc7SUFDakIseUJBQXlCLEVBQUUsR0FBRztJQUM5QixtQkFBbUIsRUFBRSxHQUFHO0lBQ3hCLDBCQUEwQixFQUFFLEdBQUc7SUFDL0IsZ0JBQWdCLEVBQUUsR0FBRztJQUNyQix3QkFBd0IsRUFBRSxHQUFHO0lBQzdCLGtCQUFrQixFQUFFLEdBQUc7Q0FDZixDQUFDO0FBRVg7O0dBRUc7QUFDSCxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUc7SUFDM0IsSUFBSSxFQUFFLE1BQU07SUFDWixJQUFJLEVBQUUsTUFBTTtJQUNaLFNBQVMsRUFBRSxXQUFXO0lBQ3RCLE9BQU8sRUFBRSxTQUFTO0lBQ2xCLElBQUksRUFBRSxNQUFNO0lBQ1os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

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

package/dist_ts/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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3JlYXRlLWNsaWVudC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cGNsaWVudC9jcmVhdGUtY2xpZW50LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQztBQUM1RCxPQUFPLEVBQUUsY0FBYyxFQUFFLE1BQU0sc0JBQXNCLENBQUM7QUFDdEQsT0FBTyxFQUFFLFdBQVcsRUFBRSxNQUFNLG1CQUFtQixDQUFDO0FBQ2hELE9BQU8sRUFBRSxVQUFVLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM5QyxPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUV0RCxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSx1QkFBdUIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sZ0JBQWdCLENBQUM7QUFFMUM7O0dBRUc7QUFDSCxNQUFNLFVBQVUsZ0JBQWdCLENBQUMsT0FBMkI7SUFDMUQsbUJBQW1CO0lBQ25CLE1BQU0sTUFBTSxHQUFHLHFCQUFxQixDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQzlDLElBQUksTUFBTSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUN0QixNQUFNLElBQUksS0FBSyxDQUFDLDJCQUEyQixNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUNsRSxDQUFDO0lBRUQsaUJBQWlCO0lBQ2pCLE1BQU0sYUFBYSxHQUF1QjtRQUN4QyxpQkFBaUIsRUFBRSxRQUFRLENBQUMsa0JBQWtCO1FBQzlDLGFBQWEsRUFBRSxRQUFRLENBQUMsY0FBYztRQUN0QyxjQUFjLEVBQUUsUUFBUSxDQUFDLGVBQWU7UUFDeEMsV0FBVyxFQUFFLFFBQVEsQ0FBQyxZQUFZO1FBQ2xDLElBQUksRUFBRSxLQUFLO1FBQ1gsTUFBTSxFQUFFLEtBQUs7UUFDYixLQUFLLEVBQUUsS0FBSztRQUNaLEdBQUcsT0FBTztLQUNYLENBQUM7SUFFRixrQkFBa0I7SUFDbEIsTUFBTSxZQUFZLEdBQUcsSUFBSSxnQkFBZ0IsQ0FBQyxhQUFhLENBQUMsQ0FBQztJQUN6RCxNQUFNLGlCQUFpQixHQUFHLElBQUksaUJBQWlCLENBQUMsYUFBYSxDQUFDLENBQUM7SUFDL0QsTUFBTSxjQUFjLEdBQUcsSUFBSSxjQUFjLENBQUMsYUFBYSxDQUFDLENBQUM7SUFDekQsTUFBTSxXQUFXLEdBQUcsSUFBSSxXQUFXLENBQUMsYUFBYSxFQUFFLGNBQWMsQ0FBQyxDQUFDO0lBQ25FLE1BQU0sVUFBVSxHQUFHLElBQUksVUFBVSxDQUFDLGFBQWEsRUFBRSxjQUFjLENBQUMsQ0FBQztJQUVqRSxnQ0FBZ0M7SUFDaEMsT0FBTyxJQUFJLFVBQVUsQ0FBQztRQUNwQixPQUFPLEVBQUUsYUFBYTtRQUN0QixpQkFBaUI7UUFDakIsY0FBYztRQUNkLFdBQVc7UUFDWCxVQUFVO1FBQ1YsWUFBWTtLQUNiLENBQUMsQ0FBQztBQUNMLENBQUM7QUFFRDs7R0FFRztBQUNILE1BQU0sVUFBVSxzQkFBc0IsQ0FBQyxPQUEyQjtJQUNoRSxPQUFPLGdCQUFnQixDQUFDO1FBQ3RCLEdBQUcsT0FBTztRQUNWLElBQUksRUFBRSxJQUFJO1FBQ1YsY0FBYyxFQUFFLE9BQU8sQ0FBQyxjQUFjLElBQUksUUFBUSxDQUFDLGVBQWU7UUFDbEUsV0FBVyxFQUFFLE9BQU8sQ0FBQyxXQUFXLElBQUksUUFBUSxDQUFDLFlBQVk7S0FDMUQsQ0FBQyxDQUFDO0FBQ0wsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLG9CQUFvQixDQUFDLE9BQTJCO0lBQzlELE9BQU8sZ0JBQWdCLENBQUM7UUFDdEIsR0FBRyxPQUFPO1FBQ1YsSUFBSSxFQUFFLElBQUk7UUFDVixjQUFjLEVBQUUsSUFBSSxDQUFDLEdBQUcsQ0FBQyxPQUFPLENBQUMsY0FBYyxJQUFJLEVBQUUsRUFBRSxFQUFFLENBQUM7UUFDMUQsV0FBVyxFQUFFLElBQUksQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDLFdBQVcsSUFBSSxJQUFJLEVBQUUsSUFBSSxDQUFDO1FBQ3hELGlCQUFpQixFQUFFLE9BQU8sQ0FBQyxpQkFBaUIsSUFBSSxLQUFLO1FBQ3JELGFBQWEsRUFBRSxPQUFPLENBQUMsYUFBYSxJQUFJLE1BQU07S0FDL0MsQ0FBQyxDQUFDO0FBQ0wsQ0FBQztBQUVEOztHQUVHO0FBQ0gsTUFBTSxVQUFVLDZCQUE2QixDQUFDLE9BQTJCO0lBQ3ZFLE9BQU8sZ0JBQWdCLENBQUM7UUFDdEIsR0FBRyxPQUFPO1FBQ1YsSUFBSSxFQUFFLEtBQUssRUFBRSxpREFBaUQ7UUFDOUQsY0FBYyxFQUFFLENBQUM7UUFDakIsV0FBVyxFQUFFLENBQUM7UUFDZCxpQkFBaUIsRUFBRSxPQUFPLENBQUMsaUJBQWlCLElBQUksS0FBSztRQUNyRCxhQUFhLEVBQUUsT0FBTyxDQUFDLGFBQWEsSUFBSSxLQUFLO0tBQzlDLENBQUMsQ0FBQztBQUNMLENBQUMifQ==

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

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

@@ -0,0 +1,110 @@
+/**
+ * SMTP Client Error Handler
+ * Error classification and recovery strategies
+ */
+import { SmtpErrorType } from './constants.js';
+import { logDebug } from './utils/logging.js';
+export class SmtpErrorHandler {
+    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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3ItaGFuZGxlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uLy4uL3RzL21haWwvZGVsaXZlcnkvc210cGNsaWVudC9lcnJvci1oYW5kbGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7R0FHRztBQUVILE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxnQkFBZ0IsQ0FBQztBQUUvQyxPQUFPLEVBQUUsUUFBUSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFFOUMsTUFBTSxPQUFPLGdCQUFnQjtJQUczQixZQUFZLE9BQTJCO1FBQ3JDLElBQUksQ0FBQyxPQUFPLEdBQUcsT0FBTyxDQUFDO0lBQ3pCLENBQUM7SUFFRDs7T0FFRztJQUNJLGFBQWEsQ0FBQyxLQUE0QixFQUFFLE9BQTJCO1FBQzVFLFFBQVEsQ0FBQyxtQkFBbUIsRUFBRSxJQUFJLENBQUMsT0FBTyxFQUFFLEVBQUUsWUFBWSxFQUFFLEtBQUssWUFBWSxLQUFLLENBQUMsQ0FBQyxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxLQUFLLENBQUMsRUFBRSxPQUFPLEVBQUUsQ0FBQyxDQUFDO1FBRS9ILHVCQUF1QjtRQUN2QixJQUFJLEtBQUssWUFBWSxLQUFLLEVBQUUsQ0FBQztZQUMzQixPQUFPLElBQUksQ0FBQyxzQkFBc0IsQ0FBQyxLQUFLLENBQUMsQ0FBQztRQUM1QyxDQUFDO1FBRUQsNkJBQTZCO1FBQzdCLElBQUksT0FBTyxLQUFLLEtBQUssUUFBUSxJQUFJLE1BQU0sSUFBSSxLQUFLLEVBQUUsQ0FBQztZQUNqRCxPQUFPLElBQUksQ0FBQyxtQkFBbUIsQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7UUFDOUMsQ0FBQztRQUVELE9BQU8sYUFBYSxDQUFDLGFBQWEsQ0FBQztJQUNyQyxDQUFDO0lBRUQ7O09BRUc7SUFDSSxXQUFXLENBQUMsU0FBd0IsRUFBRSxRQUF3QjtRQUNuRSxRQUFRLFNBQVMsRUFB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

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

package/dist_ts/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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi90cy9tYWlsL2RlbGl2ZXJ5L3NtdHBjbGllbnQvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7OztHQUdHO0FBRUgsZ0NBQWdDO0FBQ2hDLGNBQWMsa0JBQWtCLENBQUM7QUFDakMsY0FBYyxvQkFBb0IsQ0FBQztBQUVuQyxnQkFBZ0I7QUFDaEIsY0FBYyx5QkFBeUIsQ0FBQztBQUN4QyxjQUFjLHNCQUFzQixDQUFDO0FBQ3JDLGNBQWMsbUJBQW1CLENBQUM7QUFDbEMsY0FBYyxrQkFBa0IsQ0FBQztBQUNqQyxjQUFjLG9CQUFvQixDQUFDO0FBRW5DLHVCQUF1QjtBQUN2QixjQUFjLGlCQUFpQixDQUFDO0FBQ2hDLGNBQWMsZ0JBQWdCLENBQUM7QUFFL0IsWUFBWTtBQUNaLGNBQWMsdUJBQXVCLENBQUM7QUFDdEMsY0FBYyxvQkFBb0IsQ0FBQztBQUNuQyxjQUFjLG9CQUFvQixDQUFDIn0=