@serve.zone/dcrouter 2.12.4

package/dist_ts/errors/mta.errors.js

@@ -0,0 +1,472 @@
+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,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibXRhLmVycm9ycy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3RzL2Vycm9ycy9tdGEuZXJyb3JzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFDTCxhQUFhLEVBQ2IsWUFBWSxFQUNaLG1CQUFtQixFQUNuQixjQUFjLEVBQ2Qsa0JBQWtCLEVBQ25CLE1BQU0sa0JBQWtCLENBQUM7QUFHMUIsT0FBTyxFQUNMLG9CQUFvQixFQUNwQix3QkFBd0IsRUFDeEIsa0JBQWtCLEVBQ2xCLHVCQUF1QixFQUN2QixhQUFhLEVBQ2IsaUJBQWlCLEVBQ2pCLGtCQUFrQixFQUNuQixNQUFNLGtCQUFrQixDQUFDO0FBRTFCOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGtCQUFtQixTQUFRLFlBQVk7SUFDbEQ7Ozs7O09BS0c7SUFDSCxZQUNFLE9BQWUsRUFDZixVQUF5QixFQUFFO1FBRTNCLEtBQUssQ0FBQyxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDaEQsQ0FBQztJQUVEOztPQUVHO0lBQ08saUJBQWlCLENBQUMsT0FBc0I7UUFDaEQsT0FBTyxJQUFLLElBQUksQ0FBQyxXQUF5QyxDQUN4RCxJQUFJLENBQUMsT0FBTyxFQUNaLE9BQU8sQ0FDUixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNJLE1BQU0sQ0FBQyxRQUFRLENBQ3BCLFFBQWdCLEVBQ2hCLGFBQXFCLEVBQ3JCLFVBQXlCLEVBQUU7UUFFM0IsTUFBTSxRQUFRLEdBQUcsYUFBYSxDQUFDLENBQUMsQ0FBQyxLQUFLLGFBQWEsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQ25FLE9BQU8sSUFBSSxrQkFBa0IsQ0FDM0IsNkJBQTZCLFFBQVEsR0FBRyxRQUFRLEVBQUUsRUFDbEQ7WUFDRSxHQUFHLE9BQU87WUFDVixJQUFJLEVBQUU7Z0JBQ0osR0FBRyxPQUFPLENBQUMsSUFBSTtnQkFDZixRQUFRO2dCQUNSLGFBQWEsRUFBRSxhQUFhLENBQUMsQ0FBQyxDQUFDO29CQUM3QixPQUFPLEVBQUUsYUFBYSxDQUFDLE9BQU87b0JBQzlCLEtBQUssRUFBRSxhQUFhLENBQUMsS0FBSztpQkFDM0IsQ0FBQyxDQUFDLENBQUMsU0FBUzthQUNkO1lBQ0QsV0FBVyxFQUFFLHdDQUF3QyxRQUFRLEdBQUc7U0FDakUsQ0FDRixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7O09BT0c7SUFDSSxNQUFNLENBQUMsT0FBTyxDQUNuQixRQUFnQixFQUNoQixJQUFZLEVBQ1osT0FBZSxFQUNmLFVBQXlCLEVBQUU7UUFFM0IsT0FBTyxJQUFJLGtCQUFrQixDQUMzQixpQkFBaUIsUUFBUSxJQUFJLElBQUksb0JBQW9CLE9BQU8sSUFBSSxFQUNoRTtZQUNFLEdBQUcsT0FBTztZQUNWLElBQUksRUFBRTtnQkFDSixHQUFHLE9BQU8sQ0FBQyxJQUFJO2dCQUNmLFFBQVE7Z0JBQ1IsSUFBSTtnQkFDSixPQUFPO2FBQ1I7WUFDRCxXQUFXLEVBQUUsc0NBQXNDO1NBQ3BELENBQ0YsQ0FBQztJQUNKLENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSSxNQUFNLENBQUMsT0FBTyxDQUNuQixRQUFnQixFQUNoQixJQUFZLEVBQ1osVUFBeUIsRUFBRTtRQUUzQixPQUFPLElBQUksa0JBQWtCLENBQzNCLGlCQUFpQixRQUFRLElBQUksSUFBSSxVQUFVLEVBQzNDO1lBQ0UsR0FBRyxPQUFPO1lBQ1YsSUFBSSxFQUFFO2dCQUNKLEdBQUcsT0FBTyxDQUFDLElBQUk7Z0JBQ2YsUUFBUTtnQkFDUixJQUFJO2FBQ0w7WUFDRCxXQUFXLEVBQUUsd0NBQXdDO1NBQ3RELENBQ0YsQ0FBQztJQUNKLENBQUM7Q0FDRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxPQUFPLHNCQUF1QixTQUFRLG1CQUFtQjtJQUM3RDs7Ozs7T0FLRztJQUNILFlBQ0UsT0FBZSxFQUNmLFVBQXlCLEVBQUU7UUFFM0IsS0FBSyxDQUFDLE9BQU8sRUFBRSx3QkFBd0IsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUNwRCxDQUFDO0lBRUQ7O09BRUc7SUFDTyxpQkFBaUIsQ0FBQyxPQUFzQjtRQUNoRCxPQUFPLElBQUssSUFBSSxDQUFDLFdBQTZDLENBQzVELElBQUksQ0FBQyxPQUFPLEVBQ1osT0FBTyxDQUNSLENBQUM7SUFDSixDQUFDO0lBRUQ7Ozs7OztPQU1HO0lBQ0ksTUFBTSxDQUFDLGtCQUFrQixDQUM5QixRQUFnQixFQUNoQixRQUFnQixFQUNoQixVQUF5QixFQUFFO1FBRTNCLE9BQU8sSUFBSSxzQkFBc0IsQ0FDL0Isa0NBQWtDLFFBQVEsT0FBTyxRQUFRLEVBQUUsRUFDM0Q7WUFDRSxHQUFHLE9BQU87WUFDVixJQUFJLEVBQUU7Z0JBQ0osR0FBRyxPQUFPLENBQUMsSUFBSTtnQkFDZixRQUFRO2dCQUNSLFFBQVE7YUFDVDtZQUNELFdBQVcsRUFBRSx1Q0FBdUM7U0FDckQsQ0FDRixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7O09BT0c7SUFDSSxNQUFNLENBQUMsaUJBQWlCLENBQzdCLFFBQWdCLEVBQ2hCLE1BQWMsRUFDZCxtQkFBNkIsRUFBRSxFQUMvQixVQUF5QixFQUFFO1FBRTNCLE9BQU8sSUFBSSxzQkFBc0IsQ0FDL0IseUJBQXlCLE1BQU0scUJBQXFCLFFBQVEsR0FBRyxnQkFBZ0IsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyx3QkFBd0IsZ0JBQWdCLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDLEVBQUUsRUFBRSxFQUN6SjtZQUNFLEdBQUcsT0FBTztZQUNWLElBQUksRUFBRTtnQkFDSixHQUFHLE9BQU8sQ0FBQyxJQUFJO2dCQUNmLFFBQVE7Z0JBQ1IsTUFBTTtnQkFDTixnQkFBZ0I7YUFDakI7WUFDRCxXQUFXLEVBQUUscUVBQXFFO1NBQ25GLENBQ0YsQ0FBQztJQUNKLENBQUM7Q0FDRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGdCQUFpQixTQUFRLGNBQWM7SUFDbEQ7Ozs7O09BS0c7SUFDSCxZQUNFLE9BQWUsRUFDZixVQUF5QixFQUFFO1FBRTNCLEtBQUssQ0FBQyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDOUMsQ0FBQztJQUVEOztPQUVHO0lBQ08saUJBQWlCLENBQUMsT0FBc0I7UUFDaEQsT0FBTyxJQUFLLElBQUksQ0FBQyxXQUF1QyxDQUN0RCxJQUFJLENBQUMsT0FBTyxFQUNaLE9BQU8sQ0FDUixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksTUFBTSxDQUFDLFNBQVMsQ0FDckIsT0FBZSxFQUNmLGdCQUF3QixFQUN4QixVQUFtQixFQUNuQixZQUFxQixFQUNyQixVQUF5QixFQUFFO1FBRTNCLE1BQU0sYUFBYSxHQUFHLFVBQVUsQ0FBQyxDQUFDLENBQUMsS0FBSyxVQUFVLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQzNELE9BQU8sSUFBSSxnQkFBZ0IsQ0FDekIsaUNBQWlDLGdCQUFnQixHQUFHLGFBQWEsS0FBSyxPQUFPLEVBQUUsRUFDL0U7WUFDRSxHQUFHLE9BQU87WUFDVixJQUFJLEVBQUU7Z0JBQ0osR0FBRyxPQUFPLENBQUMsSUFBSTtnQkFDZixnQkFBZ0I7Z0JBQ2hCLFVBQVU7Z0JBQ1YsWUFBWTtnQkFDWixTQUFTLEVBQUUsSUFBSTthQUNoQjtZQUNELFdBQVcsRUFBRSx1Q0FBdUMsZ0JBQWdCLEdBQUc7U0FDeEUsQ0FDRixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7Ozs7OztPQVdHO0lBQ0ksTUFBTSxDQUFDLFNBQVMsQ0FDckIsT0FBZSxFQUNmLGdCQUF3QixFQUN4QixVQUFtQixFQUNuQixZQUFxQixFQUNyQixhQUFxQixDQUFDLEVBQ3RCLGVBQXVCLENBQUMsRUFDeEIsYUFBcUIsS0FBSyxFQUMxQixVQUF5QixFQUFFO1FBRTNCLE1BQU0sYUFBYSxHQUFHLFVBQVUsQ0FBQyxDQUFDLENBQUMsS0FBSyxVQUFVLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBQzNELE1BQU0sS0FBSyxHQUFHLElBQUksZ0JBQWdCLENBQ2hDLGlDQUFpQyxnQkFBZ0IsR0FBRyxhQUFhLEtBQUssT0FBTyxFQUFFLEVBQy9FO1lBQ0UsR0FBRyxPQUFPO1lBQ1YsSUFBSSxFQUFFO2dCQUNKLEdBQUcsT0FBTyxDQUFDLElBQUk7Z0JBQ2YsZ0JBQWdCO2dCQUNoQixVQUFVO2dCQUNWLFlBQVk7Z0JBQ1osU0FBUyxFQUFFLEtBQUs7YUFDakI7WUFDRCxXQUFXLEVBQUUseUJBQXlCLGdCQUFnQiwwQ0FBMEM7U0FDakcsQ0FDRixDQUFDO1FBRUYsT0FBTyxLQUFLLENBQUMsU0FBUyxDQUFDLFVBQVUsRUFBRSxZQUFZLEVBQUUsVUFBVSxDQUFxQixDQUFDO0lBQ25GLENBQUM7SUFFRDs7T0FFRztJQUNJLFdBQVc7UUFDaEIsT0FBTyxDQUFDLENBQUMsSUFBSSxDQUFDLE9BQU8sQ0FBQyxJQUFJLEVBQUUsU0FBUyxDQUFDO0lBQ3hDLENBQUM7SUFFRDs7T0FFRztJQUNJLG1CQUFtQjtRQUN4QixPQUFPLElBQUksQ0FBQyxPQUFPLENBQUMsSUFBSSxFQUFFLGdCQUFnQixDQUFDO0lBQzdDLENBQUM7SUFFRDs7T0FFRztJQUNJLGFBQWE7UUFDbEIsT0FBTyxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksRUFBRSxVQUFVLENBQUM7SUFDdkMsQ0FBQztDQUNGO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLE9BQU8scUJBQXNCLFNBQVEsa0JBQWtCO0lBQzNEOzs7OztPQUtHO0lBQ0gsWUFDRSxPQUFlLEVBQ2YsVUFBeUIsRUFBRTtRQUUzQixLQUFLLENBQUMsT0FBTyxFQUFFLHVCQUF1QixFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ25ELENBQUM7SUFFRDs7T0FFRztJQUNPLGlCQUFpQixDQUFDLE9BQXNCO1FBQ2hELE9BQU8sSUFBSyxJQUFJLENBQUMsV0FBNEMsQ0FDM0QsSUFBSSxDQUFDLE9BQU8sRUFDWixPQUFPLENBQ1IsQ0FBQztJQUNKLENBQUM7SUFFRDs7Ozs7T0FLRztJQUNJLE1BQU0sQ0FBQyxhQUFhLENBQ3pCLFlBQW9CLEVBQ3BCLFVBQXlCLEVBQUU7UUFFM0IsT0FBTyxJQUFJLHFCQUFxQixDQUM5QixtQ0FBbUMsWUFBWSxFQUFFLEVBQ2pEO1lBQ0UsR0FBRyxPQUFPO1lBQ1YsSUFBSSxFQUFFO2dCQUNKLEdBQUcsT0FBTyxDQUFDLElBQUk7Z0JBQ2YsWUFBWTthQUNiO1lBQ0QsV0FBVyxFQUFFLG9EQUFvRDtTQUNsRSxDQUNGLENBQUM7SUFDSixDQUFDO0lBRUQ7Ozs7Ozs7T0FPRztJQUNJLE1BQU0sQ0FBQyxhQUFhLENBQ3pCLFlBQW9CLEVBQ3BCLEtBQVUsRUFDVixZQUFvQixFQUNwQixVQUF5QixFQUFFO1FBRTNCLE9BQU8sSUFBSSxxQkFBcUIsQ0FDOUIsbUNBQW1DLFlBQVksU0FBUyxLQUFLLEtBQUssT0FBTyxLQUFLLGVBQWUsWUFBWSxFQUFFLEVBQzNHO1lBQ0UsR0FBRyxPQUFPO1lBQ1YsSUFBSSxFQUFFO2dCQUNKLEdBQUcsT0FBTyxDQUFDLElBQUk7Z0JBQ2YsWUFBWTtnQkFDWixLQUFLO2dCQUNMLFlBQVk7YUFDYjtZQUNELFdBQVcsRUFBRSxxREFBcUQ7U0FDbkUsQ0FDRixDQUFDO0lBQ0osQ0FBQztDQUNGO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLE9BQU8sV0FBWSxTQUFRLFlBQVk7SUFDM0M7Ozs7O09BS0c7SUFDSCxZQUNFLE9BQWUsRUFDZixVQUF5QixFQUFFO1FBRTNCLEtBQUssQ0FBQyxPQUFPLEVBQUUsYUFBYSxFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ3pDLENBQUM7SUFFRDs7T0FFRztJQUNPLGlCQUFpQixDQUFDLE9BQXNCO1FBQ2hELE9BQU8sSUFBSyxJQUFJLENBQUMsV0FBa0MsQ0FDakQsSUFBSSxDQUFDLE9BQU8sRUFDWixPQUFPLENBQ1IsQ0FBQztJQUNKLENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSSxNQUFNLENBQUMsY0FBYyxDQUMxQixNQUFjLEVBQ2QsYUFBcUIsRUFDckIsVUFBeUIsRUFBRTtRQUUzQixNQUFNLFFBQVEsR0FBRyxhQUFhLENBQUMsQ0FBQyxDQUFDLEtBQUssYUFBYSxDQUFDLE9BQU8sRUFBRSxDQUFDLENBQUMsQ0FBQyxFQUFFLENBQUM7UUFDbkUsT0FBTyxJQUFJLFdBQVcsQ0FDcEIsbUNBQW1DLE1BQU0sR0FBRyxRQUFRLEVBQUUsRUFDdEQ7WUFDRSxHQUFHLE9BQU87WUFDVixJQUFJLEVBQUU7Z0JBQ0osR0FBRyxPQUFPLENBQUMsSUFBSTtnQkFDZixNQUFNO2dCQUNOLFVBQVUsRUFBRSxJQUFJO2dCQUNoQixhQUFhLEVBQUUsYUFBYSxDQUFDLENBQUMsQ0FBQztvQkFDN0IsT0FBTyxFQUFFLGFBQWEsQ0FBQyxPQUFPO29CQUM5QixLQUFLLEVBQUUsYUFBYSxDQUFDLEtBQUs7aUJBQzNCLENBQUMsQ0FBQyxDQUFDLFNBQVM7YUFDZDtZQUNELFdBQVcsRUFBRSxtQ0FBbUMsTUFBTSxHQUFHO1NBQzFELENBQ0YsQ0FBQztJQUNKLENBQUM7SUFFRDs7Ozs7OztPQU9HO0lBQ0ksTUFBTSxDQUFDLGVBQWUsQ0FDM0IsTUFBYyxFQUNkLFlBQXFCLEVBQ3JCLGFBQXFCLEVBQ3JCLFVBQXlCLEVBQUU7UUFFM0IsTUFBTSxVQUFVLEdBQUcsWUFBWSxDQUFDLENBQUMsQ0FBQyxHQUFHLFlBQVksTUFBTSxDQUFDLENBQUMsQ0FBQyxLQUFLLENBQUM7UUFDaEUsTUFBTSxRQUFRLEdBQUcsYUFBYSxDQUFDLENBQUMsQ0FBQyxLQUFLLGFBQWEsQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDO1FBRW5FLE9BQU8sSUFBSSxXQUFXLENBQ3BCLG9CQUFvQixVQUFVLGdCQUFnQixNQUFNLEdBQUcsUUFBUSxFQUFFLEVBQ2pFO1lBQ0UsR0FBRyxPQUFPO1lBQ1YsSUFBSSxFQUFFO2dCQUNKLEdBQUcsT0FBTyxDQUFDLElBQUk7Z0JBQ2YsTUFBTTtnQkFDTixVQUFVO2dCQUNWLFlBQVk7Z0JBQ1osYUFBYSxFQUFFLGFBQWEsQ0FBQyxDQUFDLENBQUM7b0JBQzdCLE9BQU8sRUFBRSxhQUFhLENBQUMsT0FBTztvQkFDOUIsS0FBSyxFQUFFLGFBQWEsQ0FBQyxLQUFLO2lCQUMzQixDQUFDLENBQUMsQ0FBQyxTQUFTO2FBQ2Q7WUFDRCxXQUFXLEVBQUUsb0JBQW9CLFlBQVksSUFBSSxFQUFFLGdCQUFnQixNQUFNLEdBQUc7U0FDN0UsQ0FDRixDQUFDO0lBQ0osQ0FBQztDQUNGO0FBRUQ7O0dBRUc7QUFDSCxNQUFNLE9BQU8sZUFBZ0IsU0FBUSxZQUFZO0lBQy9DOzs7OztPQUtHO0lBQ0gsWUFDRSxPQUFlLEVBQ2YsVUFBeUIsRUFBRTtRQUUzQixLQUFLLENBQUMsT0FBTyxFQUFFLGlCQUFpQixFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQzdDLENBQUM7SUFFRDs7T0FFRztJQUNPLGlCQUFpQixDQUFDLE9BQXNCO1FBQ2hELE9BQU8sSUFBSyxJQUFJLENBQUMsV0FBc0MsQ0FDckQsSUFBSSxDQUFDLE9BQU8sRUFDWixPQUFPLENBQ1IsQ0FBQztJQUNKLENBQUM7SUFFRDs7Ozs7OztPQU9HO0lBQ0ksTUFBTSxDQUFDLGNBQWMsQ0FDMUIsT0FBZSxFQUNmLE1BQWMsRUFDZCxPQUFlLEVBQ2YsVUFBeUIsRUFBRTtRQUUzQixPQUFPLElBQUksZUFBZSxDQUN4QixnQkFBZ0IsT0FBTyxPQUFPLE1BQU0sb0JBQW9CLE9BQU8sSUFBSSxFQUNuRTtZQUNFLEdBQUcsT0FBTztZQUNWLElBQUksRUFBRTtnQkFDSixHQUFHLE9BQU8sQ0FBQyxJQUFJO2dCQUNmLE9BQU87Z0JBQ1AsTUFBTTtnQkFDTixPQUFPO2FBQ1I7WUFDRCxXQUFXLEVBQUUsMkNBQTJDO1NBQ3pELENBQ0YsQ0FBQztJQUNKLENBQUM7SUFFRDs7Ozs7O09BTUc7SUFDSSxNQUFNLENBQUMsa0JBQWtCLENBQzlCLE1BQWMsRUFDZCxPQUFlLEVBQ2YsVUFBeUIsRUFBRTtRQUUzQixPQUFPLElBQUksZUFBZSxDQUN4Qix5QkFBeUIsTUFBTSxvQkFBb0IsT0FBTyxJQUFJLEVBQzlEO1lBQ0UsR0FBRyxPQUFPO1lBQ1YsSUFBSSxFQUFFO2dCQUNKLEdBQUcsT0FBTyxDQUFDLElBQUk7Z0JBQ2YsTUFBTTtnQkFDTixPQUFPO2FBQ1I7WUFDRCxXQUFXLEVBQUUsd0RBQXdEO1NBQ3RFLENBQ0YsQ0FBQztJQUNKLENBQUM7Q0FDRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxPQUFPLGdCQUFpQixTQUFRLGNBQWM7SUFDbEQ7Ozs7O09BS0c7SUFDSCxZQUNFLE9BQWUsRUFDZixVQUF5QixFQUFFO1FBRTNCLEtBQUssQ0FBQyxPQUFPLEVBQUUsa0JBQWtCLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFDOUMsQ0FBQztJQUVEOztPQUVHO0lBQ08saUJBQWlCLENBQUMsT0FBc0I7UUFDaEQsT0FBTyxJQUFLLElBQUksQ0FBQyxXQUF1QyxDQUN0RCxJQUFJLENBQUMsT0FBTyxFQUNaLE9BQU8sQ0FDUixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7OztPQVFHO0lBQ0ksTUFBTSxDQUFDLGtCQUFrQixDQUM5QixPQUFlLEVBQ2YsUUFBZ0IsRUFDaEIsUUFBZ0IsRUFDaEIsTUFBYyxFQUNkLFVBQXlCLEVBQUU7UUFFM0IsT0FBTyxJQUFJLGdCQUFnQixDQUN6QixpQ0FBaUMsTUFBTSxnQkFBZ0IsT0FBTyxVQUFVLFFBQVEsZ0JBQWdCLFFBQVEsR0FBRyxFQUMzRztZQUNFLEdBQUcsT0FBTztZQUNWLElBQUksRUFBRTtnQkFDSixHQUFHLE9BQU8sQ0FBQyxJQUFJO2dCQUNmLE9BQU87Z0JBQ1AsUUFBUTtnQkFDUixRQUFRO2dCQUNSLE1BQU07YUFDUDtZQUNELFdBQVcsRUFBRSx1REFBdUQ7U0FDckUsQ0FDRixDQUFDO0lBQ0osQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNJLE1BQU0sQ0FBQyxXQUFXLENBQ3ZCLE9BQWUsRUFDZixNQUFjLEVBQ2QsVUFBeUIsRUFBRTtRQUUzQixPQUFPLElBQUksZ0JBQWdCLENBQ3pCLDJDQUEyQyxNQUFNLEtBQUssT0FBTyxFQUFFLEVBQy9EO1lBQ0UsR0FBRyxPQUFPO1lBQ1YsSUFBSSxFQUFFO2dCQUNKLEdBQUcsT0FBTyxDQUFDLElBQUk7Z0JBQ2YsT0FBTztnQkFDUCxNQUFNO2FBQ1A7WUFDRCxXQUFXLEVBQUUsZ0VBQWdFO1NBQzlFLENBQ0YsQ0FBQztJQUNKLENBQUM7Q0FDRiJ9

package/dist_ts/errors/reputation.errors.d.ts

@@ -0,0 +1,183 @@
+import { PlatformError, OperationError, ResourceError } from './base.errors.js';
+import type { IErrorContext } from './base.errors.js';
+/**
+ * Base class for reputation-related errors
+ */
+export declare class ReputationError extends OperationError {
+    /**
+     * Creates a new reputation error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message: string, code: string, context?: IErrorContext);
+}
+/**
+ * Error class for reputation check errors
+ */
+export declare class ReputationCheckError extends ReputationError {
+    /**
+     * Creates a new reputation check error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+    /**
+     * Creates an instance for an IP reputation check error
+     *
+     * @param ip IP address
+     * @param provider Reputation provider
+     * @param originalError Original error
+     * @param context Additional context
+     */
+    static ipCheckFailed(ip: string, provider: string, originalError?: Error, context?: IErrorContext): ReputationCheckError;
+    /**
+     * Creates an instance for a domain reputation check error
+     *
+     * @param domain Domain
+     * @param provider Reputation provider
+     * @param originalError Original error
+     * @param context Additional context
+     */
+    static domainCheckFailed(domain: string, provider: string, originalError?: Error, context?: IErrorContext): ReputationCheckError;
+}
+/**
+ * Error class for reputation data errors
+ */
+export declare class ReputationDataError extends ReputationError {
+    /**
+     * Creates a new reputation data error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+    /**
+     * Creates an instance for a data access error
+     *
+     * @param entity Entity type (domain, ip)
+     * @param entityId Entity identifier
+     * @param operation Operation that failed (read, write, update)
+     * @param originalError Original error
+     * @param context Additional context
+     */
+    static dataAccessFailed(entity: string, entityId: string, operation: string, originalError?: Error, context?: IErrorContext): ReputationDataError;
+}
+/**
+ * Error class for blocklist-related errors
+ */
+export declare class BlocklistError extends ReputationError {
+    /**
+     * Creates a new blocklist error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+    /**
+     * Creates an instance for an entity found on a blocklist
+     *
+     * @param entity Entity type (domain, ip)
+     * @param entityId Entity identifier
+     * @param blocklist Blocklist name
+     * @param reason Reason for listing (if available)
+     * @param context Additional context
+     */
+    static entityBlocked(entity: string, entityId: string, blocklist: string, reason?: string, context?: IErrorContext): BlocklistError;
+}
+/**
+ * Error class for reputation update errors
+ */
+export declare class ReputationUpdateError extends ReputationError {
+    /**
+     * Creates a new reputation update error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+}
+/**
+ * Error class for IP warmup allocation errors
+ */
+export declare class WarmupAllocationError extends ReputationError {
+    /**
+     * Creates a new warmup allocation error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+    /**
+     * Creates an instance for no available IPs
+     *
+     * @param domain Domain requesting an IP
+     * @param policy Allocation policy that was used
+     * @param context Additional context
+     */
+    static noAvailableIps(domain: string, policy: string, context?: IErrorContext): WarmupAllocationError;
+}
+/**
+ * Error class for IP warmup limit exceeded errors
+ */
+export declare class WarmupLimitError extends ResourceError {
+    /**
+     * Creates a new warmup limit error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+    /**
+     * Creates an instance for daily sending limit exceeded
+     *
+     * @param ip IP address
+     * @param domain Domain
+     * @param limit Daily limit
+     * @param sent Number of emails sent
+     * @param context Additional context
+     */
+    static dailyLimitExceeded(ip: string, domain: string, limit: number, sent: number, context?: IErrorContext): WarmupLimitError;
+}
+/**
+ * Error class for IP warmup schedule errors
+ */
+export declare class WarmupScheduleError extends ReputationError {
+    /**
+     * Creates a new warmup schedule error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+}