@serve.zone/dcrouter 2.12.4 → 5.0.3

package/dist_ts/errors/mta.errors.js

@@ -1,472 +0,0 @@
-import { PlatformError, NetworkError, AuthenticationError, OperationError, ConfigurationError } from './base.errors.js';
-import { MTA_CONNECTION_ERROR, MTA_AUTHENTICATION_ERROR, MTA_DELIVERY_ERROR, MTA_CONFIGURATION_ERROR, MTA_DNS_ERROR, MTA_TIMEOUT_ERROR, MTA_PROTOCOL_ERROR } from './error.codes.js';
-/**
- * Base class for MTA connection errors
- */
-export class MtaConnectionError extends NetworkError {
-    /**
-     * Creates a new MTA connection error
-     *
-     * @param message Error message
-     * @param context Additional context
-     */
-    constructor(message, context = {}) {
-        super(message, MTA_CONNECTION_ERROR, context);
-    }
-    /**
-     * Creates a new instance with updated context
-     */
-    createWithContext(context) {
-        return new this.constructor(this.message, context);
-    }
-    /**
-     * Creates an instance for a DNS resolution error
-     *
-     * @param hostname Hostname that failed to resolve
-     * @param originalError Original error
-     * @param context Additional context
-     */
-    static dnsError(hostname, originalError, context = {}) {
-        const errorMsg = originalError ? `: ${originalError.message}` : '';
-        return new MtaConnectionError(`Failed to resolve DNS for ${hostname}${errorMsg}`, {
-            ...context,
-            data: {
-                ...context.data,
-                hostname,
-                originalError: originalError ? {
-                    message: originalError.message,
-                    stack: originalError.stack
-                } : undefined
-            },
-            userMessage: `Could not connect to mail server for ${hostname}.`
-        });
-    }
-    /**
-     * Creates an instance for a connection timeout
-     *
-     * @param hostname Hostname that timed out
-     * @param port Port number
-     * @param timeout Timeout in milliseconds
-     * @param context Additional context
-     */
-    static timeout(hostname, port, timeout, context = {}) {
-        return new MtaConnectionError(`Connection to ${hostname}:${port} timed out after ${timeout}ms`, {
-            ...context,
-            data: {
-                ...context.data,
-                hostname,
-                port,
-                timeout
-            },
-            userMessage: `Connection to mail server timed out.`
-        });
-    }
-    /**
-     * Creates an instance for a connection refused error
-     *
-     * @param hostname Hostname that refused connection
-     * @param port Port number
-     * @param context Additional context
-     */
-    static refused(hostname, port, context = {}) {
-        return new MtaConnectionError(`Connection to ${hostname}:${port} refused`, {
-            ...context,
-            data: {
-                ...context.data,
-                hostname,
-                port
-            },
-            userMessage: `Connection to mail server was refused.`
-        });
-    }
-}
-/**
- * Error class for MTA authentication errors
- */
-export class MtaAuthenticationError extends AuthenticationError {
-    /**
-     * Creates a new MTA authentication error
-     *
-     * @param message Error message
-     * @param context Additional context
-     */
-    constructor(message, context = {}) {
-        super(message, MTA_AUTHENTICATION_ERROR, context);
-    }
-    /**
-     * Creates a new instance with updated context
-     */
-    createWithContext(context) {
-        return new this.constructor(this.message, context);
-    }
-    /**
-     * Creates an instance for invalid credentials
-     *
-     * @param hostname Hostname where authentication failed
-     * @param username Username that failed authentication
-     * @param context Additional context
-     */
-    static invalidCredentials(hostname, username, context = {}) {
-        return new MtaAuthenticationError(`Authentication failed for user ${username} at ${hostname}`, {
-            ...context,
-            data: {
-                ...context.data,
-                hostname,
-                username
-            },
-            userMessage: `Authentication to mail server failed.`
-        });
-    }
-    /**
-     * Creates an instance for unsupported authentication method
-     *
-     * @param hostname Hostname
-     * @param method Authentication method that is not supported
-     * @param supportedMethods List of supported authentication methods
-     * @param context Additional context
-     */
-    static unsupportedMethod(hostname, method, supportedMethods = [], context = {}) {
-        return new MtaAuthenticationError(`Authentication method ${method} not supported by ${hostname}${supportedMethods.length > 0 ? `. Supported methods: ${supportedMethods.join(', ')}` : ''}`, {
-            ...context,
-            data: {
-                ...context.data,
-                hostname,
-                method,
-                supportedMethods
-            },
-            userMessage: `The mail server doesn't support the required authentication method.`
-        });
-    }
-}
-/**
- * Error class for MTA delivery errors
- */
-export class MtaDeliveryError extends OperationError {
-    /**
-     * Creates a new MTA delivery error
-     *
-     * @param message Error message
-     * @param context Additional context
-     */
-    constructor(message, context = {}) {
-        super(message, MTA_DELIVERY_ERROR, context);
-    }
-    /**
-     * Creates a new instance with updated context
-     */
-    createWithContext(context) {
-        return new this.constructor(this.message, context);
-    }
-    /**
-     * Creates an instance for a permanent delivery failure
-     *
-     * @param message Error message
-     * @param recipientAddress Recipient email address
-     * @param statusCode SMTP status code
-     * @param smtpResponse Full SMTP response
-     * @param context Additional context
-     */
-    static permanent(message, recipientAddress, statusCode, smtpResponse, context = {}) {
-        const statusCodeStr = statusCode ? ` (${statusCode})` : '';
-        return new MtaDeliveryError(`Permanent delivery failure to ${recipientAddress}${statusCodeStr}: ${message}`, {
-            ...context,
-            data: {
-                ...context.data,
-                recipientAddress,
-                statusCode,
-                smtpResponse,
-                permanent: true
-            },
-            userMessage: `The email could not be delivered to ${recipientAddress}.`
-        });
-    }
-    /**
-     * Creates an instance for a temporary delivery failure
-     *
-     * @param message Error message
-     * @param recipientAddress Recipient email address
-     * @param statusCode SMTP status code
-     * @param smtpResponse Full SMTP response
-     * @param maxRetries Maximum number of retries
-     * @param currentRetry Current retry count
-     * @param retryDelay Delay between retries in ms
-     * @param context Additional context
-     */
-    static temporary(message, recipientAddress, statusCode, smtpResponse, maxRetries = 3, currentRetry = 0, retryDelay = 60000, context = {}) {
-        const statusCodeStr = statusCode ? ` (${statusCode})` : '';
-        const error = new MtaDeliveryError(`Temporary delivery failure to ${recipientAddress}${statusCodeStr}: ${message}`, {
-            ...context,
-            data: {
-                ...context.data,
-                recipientAddress,
-                statusCode,
-                smtpResponse,
-                permanent: false
-            },
-            userMessage: `The email delivery to ${recipientAddress} failed temporarily. It will be retried.`
-        });
-        return error.withRetry(maxRetries, currentRetry, retryDelay);
-    }
-    /**
-     * Check if this is a permanent delivery failure
-     */
-    isPermanent() {
-        return !!this.context.data?.permanent;
-    }
-    /**
-     * Get the recipient address associated with this delivery error
-     */
-    getRecipientAddress() {
-        return this.context.data?.recipientAddress;
-    }
-    /**
-     * Get the SMTP status code associated with this delivery error
-     */
-    getStatusCode() {
-        return this.context.data?.statusCode;
-    }
-}
-/**
- * Error class for MTA configuration errors
- */
-export class MtaConfigurationError extends ConfigurationError {
-    /**
-     * Creates a new MTA configuration error
-     *
-     * @param message Error message
-     * @param context Additional context
-     */
-    constructor(message, context = {}) {
-        super(message, MTA_CONFIGURATION_ERROR, context);
-    }
-    /**
-     * Creates a new instance with updated context
-     */
-    createWithContext(context) {
-        return new this.constructor(this.message, context);
-    }
-    /**
-     * Creates an instance for a missing configuration value
-     *
-     * @param propertyPath Path to the missing property
-     * @param context Additional context
-     */
-    static missingConfig(propertyPath, context = {}) {
-        return new MtaConfigurationError(`Missing required configuration: ${propertyPath}`, {
-            ...context,
-            data: {
-                ...context.data,
-                propertyPath
-            },
-            userMessage: `The mail server is missing required configuration.`
-        });
-    }
-    /**
-     * Creates an instance for an invalid configuration value
-     *
-     * @param propertyPath Path to the invalid property
-     * @param value Current value
-     * @param expectedType Expected type or format
-     * @param context Additional context
-     */
-    static invalidConfig(propertyPath, value, expectedType, context = {}) {
-        return new MtaConfigurationError(`Invalid configuration value for ${propertyPath}: got ${value} (${typeof value}), expected ${expectedType}`, {
-            ...context,
-            data: {
-                ...context.data,
-                propertyPath,
-                value,
-                expectedType
-            },
-            userMessage: `The mail server has an invalid configuration value.`
-        });
-    }
-}
-/**
- * Error class for MTA DNS errors
- */
-export class MtaDnsError extends NetworkError {
-    /**
-     * Creates a new MTA DNS error
-     *
-     * @param message Error message
-     * @param context Additional context
-     */
-    constructor(message, context = {}) {
-        super(message, MTA_DNS_ERROR, context);
-    }
-    /**
-     * Creates a new instance with updated context
-     */
-    createWithContext(context) {
-        return new this.constructor(this.message, context);
-    }
-    /**
-     * Creates an instance for an MX record lookup failure
-     *
-     * @param domain Domain that failed MX lookup
-     * @param originalError Original error
-     * @param context Additional context
-     */
-    static mxLookupFailed(domain, originalError, context = {}) {
-        const errorMsg = originalError ? `: ${originalError.message}` : '';
-        return new MtaDnsError(`Failed to lookup MX records for ${domain}${errorMsg}`, {
-            ...context,
-            data: {
-                ...context.data,
-                domain,
-                recordType: 'MX',
-                originalError: originalError ? {
-                    message: originalError.message,
-                    stack: originalError.stack
-                } : undefined
-            },
-            userMessage: `Could not find mail servers for ${domain}.`
-        });
-    }
-    /**
-     * Creates an instance for a TXT record lookup failure
-     *
-     * @param domain Domain that failed TXT lookup
-     * @param recordPrefix Optional record prefix (e.g., 'spf', 'dkim', 'dmarc')
-     * @param originalError Original error
-     * @param context Additional context
-     */
-    static txtLookupFailed(domain, recordPrefix, originalError, context = {}) {
-        const recordType = recordPrefix ? `${recordPrefix} TXT` : 'TXT';
-        const errorMsg = originalError ? `: ${originalError.message}` : '';
-        return new MtaDnsError(`Failed to lookup ${recordType} records for ${domain}${errorMsg}`, {
-            ...context,
-            data: {
-                ...context.data,
-                domain,
-                recordType,
-                recordPrefix,
-                originalError: originalError ? {
-                    message: originalError.message,
-                    stack: originalError.stack
-                } : undefined
-            },
-            userMessage: `Could not verify ${recordPrefix || ''} records for ${domain}.`
-        });
-    }
-}
-/**
- * Error class for MTA timeout errors
- */
-export class MtaTimeoutError extends NetworkError {
-    /**
-     * Creates a new MTA timeout error
-     *
-     * @param message Error message
-     * @param context Additional context
-     */
-    constructor(message, context = {}) {
-        super(message, MTA_TIMEOUT_ERROR, context);
-    }
-    /**
-     * Creates a new instance with updated context
-     */
-    createWithContext(context) {
-        return new this.constructor(this.message, context);
-    }
-    /**
-     * Creates an instance for an SMTP command timeout
-     *
-     * @param command SMTP command that timed out
-     * @param server Server hostname
-     * @param timeout Timeout in milliseconds
-     * @param context Additional context
-     */
-    static commandTimeout(command, server, timeout, context = {}) {
-        return new MtaTimeoutError(`SMTP command ${command} to ${server} timed out after ${timeout}ms`, {
-            ...context,
-            data: {
-                ...context.data,
-                command,
-                server,
-                timeout
-            },
-            userMessage: `The mail server took too long to respond.`
-        });
-    }
-    /**
-     * Creates an instance for an overall transaction timeout
-     *
-     * @param server Server hostname
-     * @param timeout Timeout in milliseconds
-     * @param context Additional context
-     */
-    static transactionTimeout(server, timeout, context = {}) {
-        return new MtaTimeoutError(`SMTP transaction with ${server} timed out after ${timeout}ms`, {
-            ...context,
-            data: {
-                ...context.data,
-                server,
-                timeout
-            },
-            userMessage: `The mail server transaction took too long to complete.`
-        });
-    }
-}
-/**
- * Error class for MTA protocol errors
- */
-export class MtaProtocolError extends OperationError {
-    /**
-     * Creates a new MTA protocol error
-     *
-     * @param message Error message
-     * @param context Additional context
-     */
-    constructor(message, context = {}) {
-        super(message, MTA_PROTOCOL_ERROR, context);
-    }
-    /**
-     * Creates a new instance with updated context
-     */
-    createWithContext(context) {
-        return new this.constructor(this.message, context);
-    }
-    /**
-     * Creates an instance for an unexpected server response
-     *
-     * @param command SMTP command that received unexpected response
-     * @param response Unexpected response
-     * @param expected Expected response pattern
-     * @param server Server hostname
-     * @param context Additional context
-     */
-    static unexpectedResponse(command, response, expected, server, context = {}) {
-        return new MtaProtocolError(`Unexpected SMTP response from ${server} for command ${command}: got "${response}", expected "${expected}"`, {
-            ...context,
-            data: {
-                ...context.data,
-                command,
-                response,
-                expected,
-                server
-            },
-            userMessage: `Received an unexpected response from the mail server.`
-        });
-    }
-    /**
-     * Creates an instance for a syntax error
-     *
-     * @param details Error details
-     * @param server Server hostname
-     * @param context Additional context
-     */
-    static syntaxError(details, server, context = {}) {
-        return new MtaProtocolError(`SMTP syntax error in communication with ${server}: ${details}`, {
-            ...context,
-            data: {
-                ...context.data,
-                details,
-                server
-            },
-            userMessage: `There was a protocol error communicating with the mail server.`
-        });
-    }
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibXRhLmVycm9ycy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Vycm9ycy9tdGEuZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCxhQUFhLEVBQ2IsWUFBWSxFQUNaLG1CQUFtQixFQUNuQixjQUFjLEVBQ2Qsa0JBQWtCLEVBQ25CLE1BQU0sa0JBQWtCLENBQUM7QUFHMUIsT0FBTyxFQUNMLG9CQUFvQixFQUNwQix3QkFBd0IsRUFDeEIsa0JBQWtCLEVBQ2xCLHVCQUF1QixFQUN2QixhQUFhLEVBQ2IsaUJBQWlCLEVBQ2pCLGtCQUFrQixFQUNuQixNQUFNLGtCQUFrQixDQUFDO0FBRTFCOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGtCQUFtQixTQUFRLFlBQVk7SUFDbEQ7Ozs7O09BS0c7SUFDSCxZQUNFLE9BQWUsRUFDZixVQUF5QixFQUFFO1FBRTNCLEtBQUssQ0FBQyxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDaEQsQ0FBQztJQUVEOztPQUVHO0lBQ08saUJBQWlCLENBQUMsT0FBc0I7UUFDaEQsT0FBTyxJQUFLLElBQUksQ0FBQyxXQUF5QyxDQUN4RCxJQUFJLENBQUMsT0FBTyxFQUNaLE9BQU8sQ0FDUixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNJLE1BQU0sQ0FBQyxRQUFRLENBQ3BCLFFBQWdCLEVBQ2hCLGFBQXFCLEVBQ3JCLFVBQXlCLEVBQUU7UUFFM0IsTUFBTSxRQUFRLEdBQUcsYUFBYSxDQUFDLENBQUMsQ0FBQyxLQUFLLGFBQWEsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ25FLE9BQU8sSUFBSSxrQkFBa0IsQ0FDM0IsNkJBQTZCLFFBQVEsR0FBRyxRQUFRLEVBQUUsRUFDbEQ7WUFDRSxHQUFHLE9BQU87WUFDVixJQUFJLEVBQUU7Z0JBQ0osR0FBRyxPQUFPLENBQUMsSUFBSTtnQkFDZixRQUFRO2dCQUNS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

package/dist_ts/mail/core/classes.bouncemanager.d.ts

@@ -1,200 +0,0 @@
-import type { Email } from './classes.email.js';
-/**
- * Bounce types for categorizing the reasons for bounces
- */
-export declare enum BounceType {
-    INVALID_RECIPIENT = "invalid_recipient",
-    DOMAIN_NOT_FOUND = "domain_not_found",
-    MAILBOX_FULL = "mailbox_full",
-    MAILBOX_INACTIVE = "mailbox_inactive",
-    BLOCKED = "blocked",
-    SPAM_RELATED = "spam_related",
-    POLICY_RELATED = "policy_related",
-    SERVER_UNAVAILABLE = "server_unavailable",
-    TEMPORARY_FAILURE = "temporary_failure",
-    QUOTA_EXCEEDED = "quota_exceeded",
-    NETWORK_ERROR = "network_error",
-    TIMEOUT = "timeout",
-    AUTO_RESPONSE = "auto_response",
-    CHALLENGE_RESPONSE = "challenge_response",
-    UNKNOWN = "unknown"
-}
-/**
- * Hard vs soft bounce classification
- */
-export declare enum BounceCategory {
-    HARD = "hard",
-    SOFT = "soft",
-    AUTO_RESPONSE = "auto_response",
-    UNKNOWN = "unknown"
-}
-/**
- * Bounce data structure
- */
-export interface BounceRecord {
-    id: string;
-    originalEmailId?: string;
-    recipient: string;
-    sender: string;
-    domain: string;
-    subject?: string;
-    bounceType: BounceType;
-    bounceCategory: BounceCategory;
-    timestamp: number;
-    smtpResponse?: string;
-    diagnosticCode?: string;
-    statusCode?: string;
-    headers?: Record<string, string>;
-    processed: boolean;
-    retryCount?: number;
-    nextRetryTime?: number;
-}
-/**
- * Retry strategy configuration for soft bounces
- */
-interface RetryStrategy {
-    maxRetries: number;
-    initialDelay: number;
-    maxDelay: number;
-    backoffFactor: number;
-}
-/**
- * Manager for handling email bounces
- */
-export declare class BounceManager {
-    private retryStrategy;
-    private bounceStore;
-    private bounceCache;
-    private suppressionList;
-    private storageManager?;
-    constructor(options?: {
-        retryStrategy?: Partial<RetryStrategy>;
-        maxCacheSize?: number;
-        cacheTTL?: number;
-        storageManager?: any;
-    });
-    /**
-     * Process a bounce notification
-     * @param bounceData Bounce data to process
-     * @returns Processed bounce record
-     */
-    processBounce(bounceData: Partial<BounceRecord>): Promise<BounceRecord>;
-    /**
-     * Process an SMTP failure as a bounce
-     * @param recipient Recipient email
-     * @param smtpResponse SMTP error response
-     * @param options Additional options
-     * @returns Processed bounce record
-     */
-    processSmtpFailure(recipient: string, smtpResponse: string, options?: {
-        sender?: string;
-        originalEmailId?: string;
-        statusCode?: string;
-        headers?: Record<string, string>;
-    }): Promise<BounceRecord>;
-    /**
-     * Process a bounce notification email
-     * @param bounceEmail The email containing bounce information
-     * @returns Processed bounce record or null if not a bounce
-     */
-    processBounceEmail(bounceEmail: Email): Promise<BounceRecord | null>;
-    /**
-     * Handle a hard bounce by adding to suppression list
-     * @param bounce The bounce record
-     */
-    private handleHardBounce;
-    /**
-     * Handle a soft bounce by scheduling a retry if eligible
-     * @param bounce The bounce record
-     */
-    private handleSoftBounce;
-    /**
-     * Add an email address to the suppression list
-     * @param email Email address to suppress
-     * @param reason Reason for suppression
-     * @param expiresAt Expiration timestamp (undefined for permanent)
-     */
-    addToSuppressionList(email: string, reason: string, expiresAt?: number): void;
-    /**
-     * Remove an email address from the suppression list
-     * @param email Email address to remove
-     */
-    removeFromSuppressionList(email: string): void;
-    /**
-     * Check if an email is on the suppression list
-     * @param email Email address to check
-     * @returns Whether the email is suppressed
-     */
-    isEmailSuppressed(email: string): boolean;
-    /**
-     * Get suppression information for an email
-     * @param email Email address to check
-     * @returns Suppression information or null if not suppressed
-     */
-    getSuppressionInfo(email: string): {
-        reason: string;
-        timestamp: number;
-        expiresAt?: number;
-    } | null;
-    /**
-     * Save suppression list to disk
-     */
-    private saveSuppressionList;
-    /**
-     * Load suppression list from disk
-     */
-    private loadSuppressionList;
-    /**
-     * Save bounce record to disk
-     * @param bounce Bounce record to save
-     */
-    private saveBounceRecord;
-    /**
-     * Update bounce cache with new bounce information
-     * @param bounce Bounce record to update cache with
-     */
-    private updateBounceCache;
-    /**
-     * Check bounce history for an email address
-     * @param email Email address to check
-     * @returns Bounce information or null if no bounces
-     */
-    getBounceInfo(email: string): {
-        lastBounce: number;
-        count: number;
-        type: BounceType;
-        category: BounceCategory;
-    } | null;
-    /**
-     * Analyze SMTP response and diagnostic codes to determine bounce type
-     * @param smtpResponse SMTP response string
-     * @param diagnosticCode Diagnostic code from bounce
-     * @param statusCode Status code from bounce
-     * @returns Detected bounce type and category
-     */
-    private detectBounceType;
-    /**
-     * Check if text matches any pattern for a bounce type
-     * @param text Text to check against patterns
-     * @param bounceType Bounce type to get patterns for
-     * @returns Whether the text matches any pattern
-     */
-    private matchesPattern;
-    /**
-     * Get all known hard bounced addresses
-     * @returns Array of hard bounced email addresses
-     */
-    getHardBouncedAddresses(): string[];
-    /**
-     * Get suppression list
-     * @returns Array of suppressed email addresses
-     */
-    getSuppressionList(): string[];
-    /**
-     * Clear old bounce records (for maintenance)
-     * @param olderThan Timestamp to remove records older than
-     * @returns Number of records removed
-     */
-    clearOldBounceRecords(olderThan: number): number;
-}
-export {};