@serve.zone/dcrouter 2.12.4

package/dist_ts/ts/errors/error-handler.js

@@ -0,0 +1,282 @@
+import { PlatformError } from './base.errors.js';
+import { ErrorCategory, ErrorRecoverability, ErrorSeverity } from './error.codes.js';
+import { logger } from '../logger.js';
+/**
+ * Global error handler configuration
+ */
+const config = {
+    logErrors: true,
+    includeStacksInProd: false,
+    retry: {
+        maxAttempts: 3,
+        baseDelay: 1000,
+        maxDelay: 30000,
+        backoffFactor: 2
+    }
+};
+/**
+ * Error handler utility
+ * Provides methods for consistent error handling across the platform
+ */
+export class ErrorHandler {
+    /**
+     * Current configuration
+     */
+    static { this.config = config; }
+    /**
+     * Update error handler configuration
+     *
+     * @param newConfig New configuration (partial)
+     */
+    static configure(newConfig) {
+        ErrorHandler.config = {
+            ...ErrorHandler.config,
+            ...newConfig,
+            retry: {
+                ...ErrorHandler.config.retry,
+                ...(newConfig.retry || {})
+            }
+        };
+    }
+    /**
+     * Convert any error to a PlatformError
+     *
+     * @param error Error to convert
+     * @param defaultCode Default error code if not a PlatformError
+     * @param context Additional context
+     * @returns PlatformError instance
+     */
+    static toPlatformError(error, defaultCode, context = {}) {
+        // If already a PlatformError, just add context
+        if (error instanceof PlatformError) {
+            // Add context if provided
+            if (Object.keys(context).length > 0) {
+                return new error.constructor(error.message, error.code, error.severity, error.category, error.recoverability, {
+                    ...error.context,
+                    ...context,
+                    data: {
+                        ...(error.context.data || {}),
+                        ...(context.data || {})
+                    }
+                });
+            }
+            return error;
+        }
+        // Convert standard Error to PlatformError
+        if (error instanceof Error) {
+            return new PlatformError(error.message, defaultCode, ErrorSeverity.MEDIUM, ErrorCategory.OPERATION, ErrorRecoverability.NON_RECOVERABLE, {
+                ...context,
+                data: {
+                    ...(context.data || {}),
+                    originalError: {
+                        name: error.name,
+                        message: error.message,
+                        stack: error.stack
+                    }
+                }
+            });
+        }
+        // Not an Error instance
+        return new PlatformError(typeof error === 'string' ? error : 'Unknown error', defaultCode, ErrorSeverity.MEDIUM, ErrorCategory.OPERATION, ErrorRecoverability.NON_RECOVERABLE, context);
+    }
+    /**
+     * Format an error for API responses
+     * Sanitizes errors for safe external exposure
+     *
+     * @param error Error to format
+     * @param includeDetails Whether to include detailed information
+     * @returns Formatted error object
+     */
+    static formatErrorForResponse(error, includeDetails = false) {
+        const platformError = ErrorHandler.toPlatformError(error, 'PLATFORM_OPERATION_ERROR');
+        // Basic error information
+        const responseError = {
+            code: platformError.code,
+            message: platformError.getUserMessage(),
+            requestId: platformError.context.requestId
+        };
+        // Include more details if requested
+        if (includeDetails) {
+            responseError.details = {
+                severity: platformError.severity,
+                category: platformError.category,
+                rawMessage: platformError.message,
+                data: platformError.context.data
+            };
+            // Only include stack trace in non-production or if explicitly enabled
+            if (process.env.NODE_ENV !== 'production' || ErrorHandler.config.includeStacksInProd) {
+                responseError.details.stack = platformError.stack;
+            }
+        }
+        return responseError;
+    }
+    /**
+     * Handle an error with consistent logging and formatting
+     *
+     * @param error Error to handle
+     * @param defaultCode Default error code if not a PlatformError
+     * @param context Additional context
+     * @returns Formatted error for response
+     */
+    static handleError(error, defaultCode, context = {}) {
+        const platformError = ErrorHandler.toPlatformError(error, defaultCode, context);
+        // Log the error if enabled
+        if (ErrorHandler.config.logErrors) {
+            logger.error(platformError.message, {
+                error_code: platformError.code,
+                error_name: platformError.name,
+                error_severity: platformError.severity,
+                error_category: platformError.category,
+                error_recoverability: platformError.recoverability,
+                ...platformError.context,
+                stack: platformError.stack
+            });
+        }
+        // Return formatted error for response
+        const isDetailedMode = process.env.NODE_ENV !== 'production';
+        return ErrorHandler.formatErrorForResponse(platformError, isDetailedMode);
+    }
+    /**
+     * Execute a function with error handling
+     *
+     * @param fn Function to execute
+     * @param defaultCode Default error code if the function throws
+     * @param context Additional context
+     * @returns Function result or error
+     */
+    static async execute(fn, defaultCode, context = {}) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            throw ErrorHandler.toPlatformError(error, defaultCode, context);
+        }
+    }
+    /**
+     * Execute a function with retries and exponential backoff
+     *
+     * @param fn Function to execute
+     * @param defaultCode Default error code if the function throws
+     * @param options Retry options
+     * @param context Additional context
+     * @returns Function result or error after max retries
+     */
+    static async executeWithRetry(fn, defaultCode, options = {}, context = {}) {
+        const { maxAttempts = ErrorHandler.config.retry.maxAttempts, baseDelay = ErrorHandler.config.retry.baseDelay, maxDelay = ErrorHandler.config.retry.maxDelay, backoffFactor = ErrorHandler.config.retry.backoffFactor, retryableErrorCodes = [], retryableErrorPatterns = [], onRetry = () => { } } = options;
+        let lastError;
+        for (let attempt = 0; attempt < maxAttempts; attempt++) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                // Convert to PlatformError
+                const platformError = ErrorHandler.toPlatformError(error, defaultCode, {
+                    ...context,
+                    retry: {
+                        currentRetry: attempt,
+                        maxRetries: maxAttempts,
+                        nextRetryAt: 0 // Will be set below if retrying
+                    }
+                });
+                lastError = platformError;
+                // Check if we should retry
+                const isLastAttempt = attempt >= maxAttempts - 1;
+                if (isLastAttempt) {
+                    // No more retries
+                    throw platformError;
+                }
+                // Check if error is retryable
+                const isRetryable = 
+                // Built-in recoverability
+                platformError.recoverability === ErrorRecoverability.RECOVERABLE ||
+                    platformError.recoverability === ErrorRecoverability.MAYBE_RECOVERABLE ||
+                    platformError.recoverability === ErrorRecoverability.TRANSIENT ||
+                    // Specifically included error codes
+                    retryableErrorCodes.includes(platformError.code) ||
+                    // Matches error message patterns
+                    retryableErrorPatterns.some(pattern => pattern.test(platformError.message));
+                if (!isRetryable) {
+                    throw platformError;
+                }
+                // Calculate delay with exponential backoff
+                const delay = Math.min(baseDelay * Math.pow(backoffFactor, attempt), maxDelay);
+                // Add jitter to prevent thundering herd problem (±20%)
+                const jitter = 0.8 + Math.random() * 0.4;
+                const actualDelay = Math.floor(delay * jitter);
+                // Update nextRetryAt in error context
+                const nextRetryAt = Date.now() + actualDelay;
+                platformError.context.retry.nextRetryAt = nextRetryAt;
+                // Log retry attempt
+                logger.warn(`Retrying operation after error (attempt ${attempt + 1}/${maxAttempts}): ${platformError.message}`, {
+                    error_code: platformError.code,
+                    retry_attempt: attempt + 1,
+                    retry_max_attempts: maxAttempts,
+                    retry_delay_ms: actualDelay,
+                    retry_next_at: new Date(nextRetryAt).toISOString()
+                });
+                // Call onRetry callback
+                onRetry(platformError, attempt + 1, actualDelay);
+                // Wait before next retry
+                await new Promise(resolve => setTimeout(resolve, actualDelay));
+            }
+        }
+        // This should never happen, but TypeScript needs it
+        throw lastError;
+    }
+}
+/**
+ * Create a middleware for handling errors in HTTP requests
+ *
+ * @returns Middleware function
+ */
+export function createErrorHandlerMiddleware() {
+    return (error, req, res, next) => {
+        // Add request context
+        const context = {
+            requestId: req.headers['x-request-id'] || req.headers['x-correlation-id'],
+            component: 'HttpServer',
+            operation: `${req.method} ${req.url}`,
+            data: {
+                method: req.method,
+                url: req.url,
+                query: req.query,
+                params: req.params,
+                ip: req.ip || req.connection.remoteAddress,
+                userAgent: req.headers['user-agent']
+            }
+        };
+        // Handle the error
+        const formattedError = ErrorHandler.handleError(error, 'PLATFORM_OPERATION_ERROR', context);
+        // Set status code based on error type
+        let statusCode = 500;
+        if (error instanceof PlatformError) {
+            // Map error categories to HTTP status codes
+            switch (error.category) {
+                case ErrorCategory.VALIDATION:
+                    statusCode = 400;
+                    break;
+                case ErrorCategory.AUTHENTICATION:
+                    statusCode = 401;
+                    break;
+                case ErrorCategory.RESOURCE:
+                    statusCode = 429;
+                    break;
+                case ErrorCategory.OPERATION:
+                    statusCode = 400;
+                    break;
+                default:
+                    statusCode = 500;
+            }
+        }
+        else if (error.statusCode) {
+            // Use provided status code if available
+            statusCode = error.statusCode;
+        }
+        // Send error response
+        res.status(statusCode).json({
+            success: false,
+            error: formattedError
+        });
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3ItaGFuZGxlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL2Vycm9ycy9lcnJvci1oYW5kbGVyLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxhQUFhLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUVqRCxPQUFPLEVBQUUsYUFBYSxFQUFFLG1CQUFtQixFQUFFLGFBQWEsRUFBRSxNQUFNLGtCQUFrQixDQUFDO0FBQ3JGLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxjQUFjLENBQUM7QUE0QnRDOztHQUVHO0FBQ0gsTUFBTSxNQUFNLEdBQXdCO0lBQ2xDLFNBQVMsRUFBRSxJQUFJO0lBQ2YsbUJBQW1CLEVBQUUsS0FBSztJQUMxQixLQUFLLEVBQUU7UUFDTCxXQUFXLEVBQUUsQ0FBQztRQUNkLFNBQVMsRUFBRSxJQUFJO1FBQ2YsUUFBUSxFQUFFLEtBQUs7UUFDZixhQUFhLEVBQUUsQ0FBQztLQUNqQjtDQUNGLENBQUM7QUFFRjs7O0dBR0c7QUFDSCxNQUFNLE9BQU8sWUFBWTtJQUN2Qjs7T0FFRzthQUNXLFdBQU0sR0FBRyxNQUFNLENBQUM7SUFFOUI7Ozs7T0FJRztJQUNJLE1BQU0sQ0FBQyxTQUFTLENBQUMsU0FBdUM7UUFDN0QsWUFBWSxDQUFDLE1BQU0sR0FBRztZQUNwQixHQUFHLFlBQVksQ0FBQyxNQUFNO1lBQ3RCLEdBQUcsU0FBUztZQUNaLEtBQUssRUFBRTtnQkFDTCxHQUFHLFlBQVksQ0FBQyxNQUFNLENBQUMsS0FBSztnQkFDNUIsR0FBRyxDQUFDLFNBQVMsQ0FBQyxLQUFLLElBQUksRUFBRSxDQUFDO2FBQzNCO1NBQ0YsQ0FBQztJQUNKLENBQUM7SUFFRDs7Ozs7OztPQU9HO0lBQ0ksTUFBTSxDQUFDLGVBQWUsQ0FDM0IsS0FBVSxFQUNWLFdBQW1CLEVBQ25CLFVBQXlCLEVBQUU7UUFFM0IsK0NBQStDO1FBQy9DLElBQUksS0FBSyxZQUFZLGFBQWEsRUFBRSxDQUFDO1lBQ25D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

package/dist_ts/ts/errors/error.codes.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Platform Service Error Codes
+ *
+ * This file contains all error codes used across the platform service.
+ *
+ * Format: PREFIX_ERROR_TYPE
+ * - PREFIX: Component/domain prefix (e.g., EMAIL, MTA, SMS)
+ * - ERROR_TYPE: Specific error type within the domain
+ */
+export declare const PLATFORM_INITIALIZATION_ERROR = "PLATFORM_INITIALIZATION_ERROR";
+export declare const PLATFORM_CONFIGURATION_ERROR = "PLATFORM_CONFIGURATION_ERROR";
+export declare const PLATFORM_OPERATION_ERROR = "PLATFORM_OPERATION_ERROR";
+export declare const PLATFORM_NOT_IMPLEMENTED = "PLATFORM_NOT_IMPLEMENTED";
+export declare const PLATFORM_NOT_SUPPORTED = "PLATFORM_NOT_SUPPORTED";
+export declare const PLATFORM_SERVICE_UNAVAILABLE = "PLATFORM_SERVICE_UNAVAILABLE";
+export declare const EMAIL_SERVICE_ERROR = "EMAIL_SERVICE_ERROR";
+export declare const EMAIL_TEMPLATE_ERROR = "EMAIL_TEMPLATE_ERROR";
+export declare const EMAIL_VALIDATION_ERROR = "EMAIL_VALIDATION_ERROR";
+export declare const EMAIL_SEND_ERROR = "EMAIL_SEND_ERROR";
+export declare const EMAIL_RECEIVE_ERROR = "EMAIL_RECEIVE_ERROR";
+export declare const EMAIL_ATTACHMENT_ERROR = "EMAIL_ATTACHMENT_ERROR";
+export declare const EMAIL_PARSE_ERROR = "EMAIL_PARSE_ERROR";
+export declare const EMAIL_RATE_LIMIT_EXCEEDED = "EMAIL_RATE_LIMIT_EXCEEDED";
+export declare const MTA_CONNECTION_ERROR = "MTA_CONNECTION_ERROR";
+export declare const MTA_AUTHENTICATION_ERROR = "MTA_AUTHENTICATION_ERROR";
+export declare const MTA_DELIVERY_ERROR = "MTA_DELIVERY_ERROR";
+export declare const MTA_CONFIGURATION_ERROR = "MTA_CONFIGURATION_ERROR";
+export declare const MTA_DNS_ERROR = "MTA_DNS_ERROR";
+export declare const MTA_TIMEOUT_ERROR = "MTA_TIMEOUT_ERROR";
+export declare const MTA_PROTOCOL_ERROR = "MTA_PROTOCOL_ERROR";
+export declare const BOUNCE_PROCESSING_ERROR = "BOUNCE_PROCESSING_ERROR";
+export declare const BOUNCE_STORAGE_ERROR = "BOUNCE_STORAGE_ERROR";
+export declare const BOUNCE_CLASSIFICATION_ERROR = "BOUNCE_CLASSIFICATION_ERROR";
+export declare const AUTH_SPF_ERROR = "AUTH_SPF_ERROR";
+export declare const AUTH_DKIM_ERROR = "AUTH_DKIM_ERROR";
+export declare const AUTH_DMARC_ERROR = "AUTH_DMARC_ERROR";
+export declare const AUTH_KEY_ERROR = "AUTH_KEY_ERROR";
+export declare const SCAN_ANALYSIS_ERROR = "SCAN_ANALYSIS_ERROR";
+export declare const SCAN_MALWARE_DETECTED = "SCAN_MALWARE_DETECTED";
+export declare const SCAN_PHISHING_DETECTED = "SCAN_PHISHING_DETECTED";
+export declare const SCAN_CONTENT_REJECTED = "SCAN_CONTENT_REJECTED";
+export declare const REPUTATION_CHECK_ERROR = "REPUTATION_CHECK_ERROR";
+export declare const REPUTATION_DATA_ERROR = "REPUTATION_DATA_ERROR";
+export declare const REPUTATION_BLOCKLIST_ERROR = "REPUTATION_BLOCKLIST_ERROR";
+export declare const REPUTATION_UPDATE_ERROR = "REPUTATION_UPDATE_ERROR";
+export declare const WARMUP_ALLOCATION_ERROR = "WARMUP_ALLOCATION_ERROR";
+export declare const WARMUP_LIMIT_EXCEEDED = "WARMUP_LIMIT_EXCEEDED";
+export declare const WARMUP_SCHEDULE_ERROR = "WARMUP_SCHEDULE_ERROR";
+export declare const NETWORK_CONNECTION_ERROR = "NETWORK_CONNECTION_ERROR";
+export declare const NETWORK_TIMEOUT = "NETWORK_TIMEOUT";
+export declare const NETWORK_DNS_ERROR = "NETWORK_DNS_ERROR";
+export declare const NETWORK_TLS_ERROR = "NETWORK_TLS_ERROR";
+export declare const QUEUE_FULL_ERROR = "QUEUE_FULL_ERROR";
+export declare const QUEUE_PROCESSING_ERROR = "QUEUE_PROCESSING_ERROR";
+export declare const QUEUE_PERSISTENCE_ERROR = "QUEUE_PERSISTENCE_ERROR";
+export declare const QUEUE_ITEM_NOT_FOUND = "QUEUE_ITEM_NOT_FOUND";
+export declare const DCR_ROUTING_ERROR = "DCR_ROUTING_ERROR";
+export declare const DCR_CONFIGURATION_ERROR = "DCR_CONFIGURATION_ERROR";
+export declare const DCR_PROXY_ERROR = "DCR_PROXY_ERROR";
+export declare const DCR_DOMAIN_ERROR = "DCR_DOMAIN_ERROR";
+export declare const SMS_SERVICE_ERROR = "SMS_SERVICE_ERROR";
+export declare const SMS_SEND_ERROR = "SMS_SEND_ERROR";
+export declare const SMS_VALIDATION_ERROR = "SMS_VALIDATION_ERROR";
+export declare const SMS_RATE_LIMIT_EXCEEDED = "SMS_RATE_LIMIT_EXCEEDED";
+export declare const STORAGE_WRITE_ERROR = "STORAGE_WRITE_ERROR";
+export declare const STORAGE_READ_ERROR = "STORAGE_READ_ERROR";
+export declare const STORAGE_DELETE_ERROR = "STORAGE_DELETE_ERROR";
+export declare const STORAGE_QUOTA_EXCEEDED = "STORAGE_QUOTA_EXCEEDED";
+export declare const RULE_VALIDATION_ERROR = "RULE_VALIDATION_ERROR";
+export declare const RULE_EXECUTION_ERROR = "RULE_EXECUTION_ERROR";
+export declare const RULE_NOT_FOUND = "RULE_NOT_FOUND";
+export declare enum ErrorSeverity {
+    /** Critical errors that require immediate attention */
+    CRITICAL = "CRITICAL",
+    /** High-impact errors that may affect service functioning */
+    HIGH = "HIGH",
+    /** Medium-impact errors that cause partial degradation */
+    MEDIUM = "MEDIUM",
+    /** Low-impact errors that have minimal or local impact */
+    LOW = "LOW",
+    /** Informational errors that are not problematic */
+    INFO = "INFO"
+}
+export declare enum ErrorCategory {
+    /** Errors related to configuration */
+    CONFIGURATION = "CONFIGURATION",
+    /** Errors related to network connectivity */
+    CONNECTIVITY = "CONNECTIVITY",
+    /** Errors related to authentication/authorization */
+    AUTHENTICATION = "AUTHENTICATION",
+    /** Errors related to data validation */
+    VALIDATION = "VALIDATION",
+    /** Errors related to resource availability */
+    RESOURCE = "RESOURCE",
+    /** Errors related to service operations */
+    OPERATION = "OPERATION",
+    /** Errors related to third-party integrations */
+    INTEGRATION = "INTEGRATION",
+    /** Errors related to security */
+    SECURITY = "SECURITY",
+    /** Errors related to data storage */
+    STORAGE = "STORAGE",
+    /** Errors that don't fit into other categories */
+    OTHER = "OTHER"
+}
+export declare enum ErrorRecoverability {
+    /** Error cannot be automatically recovered from */
+    NON_RECOVERABLE = "NON_RECOVERABLE",
+    /** Error might be recoverable with retry */
+    MAYBE_RECOVERABLE = "MAYBE_RECOVERABLE",
+    /** Error is definitely recoverable with retries */
+    RECOVERABLE = "RECOVERABLE",
+    /** Error is transient and should resolve without action */
+    TRANSIENT = "TRANSIENT"
+}

package/dist_ts/ts/errors/error.codes.js

@@ -0,0 +1,136 @@
+/**
+ * Platform Service Error Codes
+ *
+ * This file contains all error codes used across the platform service.
+ *
+ * Format: PREFIX_ERROR_TYPE
+ * - PREFIX: Component/domain prefix (e.g., EMAIL, MTA, SMS)
+ * - ERROR_TYPE: Specific error type within the domain
+ */
+// General platform errors (PLATFORM_*)
+export const PLATFORM_INITIALIZATION_ERROR = 'PLATFORM_INITIALIZATION_ERROR';
+export const PLATFORM_CONFIGURATION_ERROR = 'PLATFORM_CONFIGURATION_ERROR';
+export const PLATFORM_OPERATION_ERROR = 'PLATFORM_OPERATION_ERROR';
+export const PLATFORM_NOT_IMPLEMENTED = 'PLATFORM_NOT_IMPLEMENTED';
+export const PLATFORM_NOT_SUPPORTED = 'PLATFORM_NOT_SUPPORTED';
+export const PLATFORM_SERVICE_UNAVAILABLE = 'PLATFORM_SERVICE_UNAVAILABLE';
+// Email service errors (EMAIL_*)
+export const EMAIL_SERVICE_ERROR = 'EMAIL_SERVICE_ERROR';
+export const EMAIL_TEMPLATE_ERROR = 'EMAIL_TEMPLATE_ERROR';
+export const EMAIL_VALIDATION_ERROR = 'EMAIL_VALIDATION_ERROR';
+export const EMAIL_SEND_ERROR = 'EMAIL_SEND_ERROR';
+export const EMAIL_RECEIVE_ERROR = 'EMAIL_RECEIVE_ERROR';
+export const EMAIL_ATTACHMENT_ERROR = 'EMAIL_ATTACHMENT_ERROR';
+export const EMAIL_PARSE_ERROR = 'EMAIL_PARSE_ERROR';
+export const EMAIL_RATE_LIMIT_EXCEEDED = 'EMAIL_RATE_LIMIT_EXCEEDED';
+// MTA-specific errors (MTA_*)
+export const MTA_CONNECTION_ERROR = 'MTA_CONNECTION_ERROR';
+export const MTA_AUTHENTICATION_ERROR = 'MTA_AUTHENTICATION_ERROR';
+export const MTA_DELIVERY_ERROR = 'MTA_DELIVERY_ERROR';
+export const MTA_CONFIGURATION_ERROR = 'MTA_CONFIGURATION_ERROR';
+export const MTA_DNS_ERROR = 'MTA_DNS_ERROR';
+export const MTA_TIMEOUT_ERROR = 'MTA_TIMEOUT_ERROR';
+export const MTA_PROTOCOL_ERROR = 'MTA_PROTOCOL_ERROR';
+// Bounce management errors (BOUNCE_*)
+export const BOUNCE_PROCESSING_ERROR = 'BOUNCE_PROCESSING_ERROR';
+export const BOUNCE_STORAGE_ERROR = 'BOUNCE_STORAGE_ERROR';
+export const BOUNCE_CLASSIFICATION_ERROR = 'BOUNCE_CLASSIFICATION_ERROR';
+// Email authentication errors (AUTH_*)
+export const AUTH_SPF_ERROR = 'AUTH_SPF_ERROR';
+export const AUTH_DKIM_ERROR = 'AUTH_DKIM_ERROR';
+export const AUTH_DMARC_ERROR = 'AUTH_DMARC_ERROR';
+export const AUTH_KEY_ERROR = 'AUTH_KEY_ERROR';
+// Content scanning errors (SCAN_*)
+export const SCAN_ANALYSIS_ERROR = 'SCAN_ANALYSIS_ERROR';
+export const SCAN_MALWARE_DETECTED = 'SCAN_MALWARE_DETECTED';
+export const SCAN_PHISHING_DETECTED = 'SCAN_PHISHING_DETECTED';
+export const SCAN_CONTENT_REJECTED = 'SCAN_CONTENT_REJECTED';
+// IP and reputation errors (REPUTATION_*)
+export const REPUTATION_CHECK_ERROR = 'REPUTATION_CHECK_ERROR';
+export const REPUTATION_DATA_ERROR = 'REPUTATION_DATA_ERROR';
+export const REPUTATION_BLOCKLIST_ERROR = 'REPUTATION_BLOCKLIST_ERROR';
+export const REPUTATION_UPDATE_ERROR = 'REPUTATION_UPDATE_ERROR';
+// IP warmup errors (WARMUP_*)
+export const WARMUP_ALLOCATION_ERROR = 'WARMUP_ALLOCATION_ERROR';
+export const WARMUP_LIMIT_EXCEEDED = 'WARMUP_LIMIT_EXCEEDED';
+export const WARMUP_SCHEDULE_ERROR = 'WARMUP_SCHEDULE_ERROR';
+// Network and connectivity errors (NETWORK_*)
+export const NETWORK_CONNECTION_ERROR = 'NETWORK_CONNECTION_ERROR';
+export const NETWORK_TIMEOUT = 'NETWORK_TIMEOUT';
+export const NETWORK_DNS_ERROR = 'NETWORK_DNS_ERROR';
+export const NETWORK_TLS_ERROR = 'NETWORK_TLS_ERROR';
+// Queue and processing errors (QUEUE_*)
+export const QUEUE_FULL_ERROR = 'QUEUE_FULL_ERROR';
+export const QUEUE_PROCESSING_ERROR = 'QUEUE_PROCESSING_ERROR';
+export const QUEUE_PERSISTENCE_ERROR = 'QUEUE_PERSISTENCE_ERROR';
+export const QUEUE_ITEM_NOT_FOUND = 'QUEUE_ITEM_NOT_FOUND';
+// DcRouter errors (DCR_*)
+export const DCR_ROUTING_ERROR = 'DCR_ROUTING_ERROR';
+export const DCR_CONFIGURATION_ERROR = 'DCR_CONFIGURATION_ERROR';
+export const DCR_PROXY_ERROR = 'DCR_PROXY_ERROR';
+export const DCR_DOMAIN_ERROR = 'DCR_DOMAIN_ERROR';
+// SMS service errors (SMS_*)
+export const SMS_SERVICE_ERROR = 'SMS_SERVICE_ERROR';
+export const SMS_SEND_ERROR = 'SMS_SEND_ERROR';
+export const SMS_VALIDATION_ERROR = 'SMS_VALIDATION_ERROR';
+export const SMS_RATE_LIMIT_EXCEEDED = 'SMS_RATE_LIMIT_EXCEEDED';
+// Storage errors (STORAGE_*)
+export const STORAGE_WRITE_ERROR = 'STORAGE_WRITE_ERROR';
+export const STORAGE_READ_ERROR = 'STORAGE_READ_ERROR';
+export const STORAGE_DELETE_ERROR = 'STORAGE_DELETE_ERROR';
+export const STORAGE_QUOTA_EXCEEDED = 'STORAGE_QUOTA_EXCEEDED';
+// Rule management errors (RULE_*)
+export const RULE_VALIDATION_ERROR = 'RULE_VALIDATION_ERROR';
+export const RULE_EXECUTION_ERROR = 'RULE_EXECUTION_ERROR';
+export const RULE_NOT_FOUND = 'RULE_NOT_FOUND';
+// Type definitions for error severity
+export var ErrorSeverity;
+(function (ErrorSeverity) {
+    /** Critical errors that require immediate attention */
+    ErrorSeverity["CRITICAL"] = "CRITICAL";
+    /** High-impact errors that may affect service functioning */
+    ErrorSeverity["HIGH"] = "HIGH";
+    /** Medium-impact errors that cause partial degradation */
+    ErrorSeverity["MEDIUM"] = "MEDIUM";
+    /** Low-impact errors that have minimal or local impact */
+    ErrorSeverity["LOW"] = "LOW";
+    /** Informational errors that are not problematic */
+    ErrorSeverity["INFO"] = "INFO";
+})(ErrorSeverity || (ErrorSeverity = {}));
+// Type definitions for error categories
+export var ErrorCategory;
+(function (ErrorCategory) {
+    /** Errors related to configuration */
+    ErrorCategory["CONFIGURATION"] = "CONFIGURATION";
+    /** Errors related to network connectivity */
+    ErrorCategory["CONNECTIVITY"] = "CONNECTIVITY";
+    /** Errors related to authentication/authorization */
+    ErrorCategory["AUTHENTICATION"] = "AUTHENTICATION";
+    /** Errors related to data validation */
+    ErrorCategory["VALIDATION"] = "VALIDATION";
+    /** Errors related to resource availability */
+    ErrorCategory["RESOURCE"] = "RESOURCE";
+    /** Errors related to service operations */
+    ErrorCategory["OPERATION"] = "OPERATION";
+    /** Errors related to third-party integrations */
+    ErrorCategory["INTEGRATION"] = "INTEGRATION";
+    /** Errors related to security */
+    ErrorCategory["SECURITY"] = "SECURITY";
+    /** Errors related to data storage */
+    ErrorCategory["STORAGE"] = "STORAGE";
+    /** Errors that don't fit into other categories */
+    ErrorCategory["OTHER"] = "OTHER";
+})(ErrorCategory || (ErrorCategory = {}));
+// Type definitions for error recoverability
+export var ErrorRecoverability;
+(function (ErrorRecoverability) {
+    /** Error cannot be automatically recovered from */
+    ErrorRecoverability["NON_RECOVERABLE"] = "NON_RECOVERABLE";
+    /** Error might be recoverable with retry */
+    ErrorRecoverability["MAYBE_RECOVERABLE"] = "MAYBE_RECOVERABLE";
+    /** Error is definitely recoverable with retries */
+    ErrorRecoverability["RECOVERABLE"] = "RECOVERABLE";
+    /** Error is transient and should resolve without action */
+    ErrorRecoverability["TRANSIENT"] = "TRANSIENT";
+})(ErrorRecoverability || (ErrorRecoverability = {}));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3IuY29kZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9lcnJvcnMvZXJyb3IuY29kZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7O0dBUUc7QUFFSCx1Q0FBdUM7QUFDdkMsTUFBTSxDQUFDLE1BQU0sNkJBQTZCLEdBQUcsK0JBQStCLENBQUM7QUFDN0UsTUFBTSxDQUFDLE1BQU0sNEJBQTRCLEdBQUcsOEJBQThCLENBQUM7QUFDM0UsTUFBTSxDQUFDLE1BQU0sd0JBQXdCLEdBQUcsMEJBQTBCLENBQUM7QUFDbkUsTUFBTSxDQUFDLE1BQU0sd0JBQXdCLEdBQUcsMEJBQTBCLENBQUM7QUFDbkUsTUFBTSxDQUFDLE1BQU0sc0JBQXNCLEdBQUcsd0JBQXdCLENBQUM7QUFDL0QsTUFBTSxDQUFDLE1BQU0sNEJBQTRCLEdBQUcsOEJBQThCLENBQUM7QUFFM0UsaUNBQWlDO0FBQ2pDLE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLHFCQUFxQixDQUFDO0FBQ3pELE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHLHNCQUFzQixDQUFDO0FBQzNELE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHLHdCQUF3QixDQUFDO0FBQy9ELE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFHLGtCQUFrQixDQUFDO0FBQ25ELE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLHFCQUFxQixDQUFDO0FBQ3pELE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHLHdCQUF3QixDQUFDO0FBQy9ELE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLG1CQUFtQixDQUFDO0FBQ3JELE1BQU0sQ0FBQyxNQUFNLHlCQUF5QixHQUFHLDJCQUEyQixDQUFDO0FBRXJFLDhCQUE4QjtBQUM5QixNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBRyxzQkFBc0IsQ0FBQztBQUMzRCxNQUFNLENBQUMsTUFBTSx3QkFBd0IsR0FBRywwQkFBMEIsQ0FBQztBQUNuRSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxvQkFBb0IsQ0FBQztBQUN2RCxNQUFNLENBQUMsTUFBTSx1QkFBdUIsR0FBRyx5QkFBeUIsQ0FBQztBQUNqRSxNQUFNLENBQUMsTUFBTSxhQUFhLEdBQUcsZUFBZSxDQUFDO0FBQzdDLE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLG1CQUFtQixDQUFDO0FBQ3JELE1BQU0sQ0FBQyxNQUFNLGtCQUFrQixHQUFHLG9CQUFvQixDQUFDO0FBRXZELHNDQUFzQztBQUN0QyxNQUFNLENBQUMsTUFBTSx1QkFBdUIsR0FBRyx5QkFBeUIsQ0FBQztBQUNqRSxNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBRyxzQkFBc0IsQ0FBQztBQUMzRCxNQUFNLENBQUMsTUFBTSwyQkFBMkIsR0FBRyw2QkFBNkIsQ0FBQztBQUV6RSx1Q0FBdUM7QUFDdkMsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFHLGdCQUFnQixDQUFDO0FBQy9DLE1BQU0sQ0FBQyxNQUFNLGVBQWUsR0FBRyxpQkFBaUIsQ0FBQztBQUNqRCxNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxrQkFBa0IsQ0FBQztBQUNuRCxNQUFNLENBQUMsTUFBTSxjQUFjLEdBQUcsZ0JBQWdCLENBQUM7QUFFL0MsbUNBQW1DO0FBQ25DLE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLHFCQUFxQixDQUFDO0FBQ3pELE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLHVCQUF1QixDQUFDO0FBQzdELE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHLHdCQUF3QixDQUFDO0FBQy9ELE1BQU0sQ0FBQyxNQUFNLHFCQUFxQixHQUFHLHVCQUF1QixDQUFDO0FBRTdELDBDQUEwQztBQUMxQyxNQUFNLENBQUMsTUFBTSxzQkFBc0IsR0FBRyx3QkFBd0IsQ0FBQztBQUMvRCxNQUFNLENBQUMsTUFBTSxxQkFBcUIsR0FBRyx1QkFBdUIsQ0FBQztBQUM3RCxNQUFNLENBQUMsTUFBTSwwQkFBMEIsR0FBRyw0QkFBNEIsQ0FBQztBQUN2RSxNQUFNLENBQUMsTUFBTSx1QkFBdUIsR0FBRyx5QkFBeUIsQ0FBQztBQUVqRSw4QkFBOEI7QUFDOUIsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQUcseUJBQXlCLENBQUM7QUFDakUsTUFBTSxDQUFDLE1BQU0scUJBQXFCLEdBQUcsdUJBQXVCLENBQUM7QUFDN0QsTUFBTSxDQUFDLE1BQU0scUJBQXFCLEdBQUcsdUJBQXVCLENBQUM7QUFFN0QsOENBQThDO0FBQzlDLE1BQU0sQ0FBQyxNQUFNLHdCQUF3QixHQUFHLDBCQUEwQixDQUFDO0FBQ25FLE1BQU0sQ0FBQyxNQUFNLGVBQWUsR0FBRyxpQkFBaUIsQ0FBQztBQUNqRCxNQUFNLENBQUMsTUFBTSxpQkFBaUIsR0FBRyxtQkFBbUIsQ0FBQztBQUNyRCxNQUFNLENBQUMsTUFBTSxpQkFBaUIsR0FBRyxtQkFBbUIsQ0FBQztBQUVyRCx3Q0FBd0M7QUFDeEMsTUFBTSxDQUFDLE1BQU0sZ0JBQWdCLEdBQUcsa0JBQWtCLENBQUM7QUFDbkQsTUFBTSxDQUFDLE1BQU0sc0JBQXNCLEdBQUcsd0JBQXdCLENBQUM7QUFDL0QsTUFBTSxDQUFDLE1BQU0sdUJBQXVCLEdBQUcseUJBQXlCLENBQUM7QUFDakUsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUcsc0JBQXNCLENBQUM7QUFFM0QsMEJBQTBCO0FBQzFCLE1BQU0sQ0FBQyxNQUFNLGlCQUFpQixHQUFHLG1CQUFtQixDQUFDO0FBQ3JELE1BQU0sQ0FBQyxNQUFNLHVCQUF1QixHQUFHLHlCQUF5QixDQUFDO0FBQ2pFLE1BQU0sQ0FBQyxNQUFNLGVBQWUsR0FBRyxpQkFBaUIsQ0FBQztBQUNqRCxNQUFNLENBQUMsTUFBTSxnQkFBZ0IsR0FBRyxrQkFBa0IsQ0FBQztBQUVuRCw2QkFBNkI7QUFDN0IsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQUcsbUJBQW1CLENBQUM7QUFDckQsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFHLGdCQUFnQixDQUFDO0FBQy9DLE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHLHNCQUFzQixDQUFDO0FBQzNELE1BQU0sQ0FBQyxNQUFNLHVCQUF1QixHQUFHLHlCQUF5QixDQUFDO0FBRWpFLDZCQUE2QjtBQUM3QixNQUFNLENBQUMsTUFBTSxtQkFBbUIsR0FBRyxxQkFBcUIsQ0FBQztBQUN6RCxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyxvQkFBb0IsQ0FBQztBQUN2RCxNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBRyxzQkFBc0IsQ0FBQztBQUMzRCxNQUFNLENBQUMsTUFBTSxzQkFBc0IsR0FBRyx3QkFBd0IsQ0FBQztBQUUvRCxrQ0FBa0M7QUFDbEMsTUFBTSxDQUFDLE1BQU0scUJBQXFCLEdBQUcsdUJBQXVCLENBQUM7QUFDN0QsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUcsc0JBQXNCLENBQUM7QUFDM0QsTUFBTSxDQUFDLE1BQU0sY0FBYyxHQUFHLGdCQUFnQixDQUFDO0FBRS9DLHNDQUFzQztBQUN0QyxNQUFNLENBQU4sSUFBWSxhQWVYO0FBZkQsV0FBWSxhQUFhO0lBQ3ZCLHVEQUF1RDtJQUN2RCxzQ0FBcUIsQ0FBQTtJQUVyQiw2REFBNkQ7SUFDN0QsOEJBQWEsQ0FBQTtJQUViLDBEQUEwRDtJQUMxRCxrQ0FBaUIsQ0FBQTtJQUVqQiwwREFBMEQ7SUFDMUQsNEJBQVcsQ0FBQTtJQUVYLG9EQUFvRDtJQUNwRCw4QkFBYSxDQUFBO0FBQ2YsQ0FBQyxFQWZXLGFBQWEsS0FBYixhQUFhLFFBZXhCO0FBRUQsd0NBQXdDO0FBQ3hDLE1BQU0sQ0FBTixJQUFZLGFBOEJYO0FBOUJELFdBQVksYUFBYTtJQUN2QixzQ0FBc0M7SUFDdEMsZ0RBQStCLENBQUE7SUFFL0IsNkNBQTZDO0lBQzdDLDhDQUE2QixDQUFBO0lBRTdCLHFEQUFxRDtJQUNyRCxrREFBaUMsQ0FBQTtJQUVqQyx3Q0FBd0M7SUFDeEMsMENBQXlCLENBQUE7SUFFekIsOENBQThDO0lBQzlDLHNDQUFxQixDQUFBO0lBRXJCLDJDQUEyQztJQUMzQyx3Q0FBdUIsQ0FBQTtJQUV2QixpREFBaUQ7SUFDakQsNENBQTJCLENBQUE7SUFFM0IsaUNBQWlDO0lBQ2pDLHNDQUFxQixDQUFBO0lBRXJCLHFDQUFxQztJQUNyQyxvQ0FBbUIsQ0FBQTtJQUVuQixrREFBa0Q7SUFDbEQsZ0NBQWUsQ0FBQTtBQUNqQixDQUFDLEVBOUJXLGFBQWEsS0FBYixhQUFhLFFBOEJ4QjtBQUVELDRDQUE0QztBQUM1QyxNQUFNLENBQU4sSUFBWSxtQkFZWDtBQVpELFdBQVksbUJBQW1CO0lBQzdCLG1EQUFtRDtJQUNuRCwwREFBbUMsQ0FBQTtJQUVuQyw0Q0FBNEM7SUFDNUMsOERBQXVDLENBQUE7SUFFdkMsbURBQW1EO0lBQ25ELGtEQUEyQixDQUFBO0lBRTNCLDJEQUEyRDtJQUMzRCw4Q0FBdUIsQ0FBQTtBQUN6QixDQUFDLEVBWlcsbUJBQW1CLEtBQW5CLG1CQUFtQixRQVk5QiJ9

package/dist_ts/ts/errors/index.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Platform Service Error System
+ *
+ * This module provides a comprehensive error handling system for the Platform Service,
+ * with structured error types, error codes, and consistent patterns for logging and recovery.
+ */
+export * from './error.codes.js';
+export * from './base.errors.js';
+export * from './email.errors.js';
+export * from './mta.errors.js';
+export * from './reputation.errors.js';
+export * from './error-handler.js';
+import { getErrorClassForCategory } from './base.errors.js';
+export { getErrorClassForCategory };
+import { PlatformError } from './base.errors.js';
+/**
+ * Create a typed error from a standard Error
+ * Useful for converting errors from external libraries or APIs
+ *
+ * @param error Standard error to convert
+ * @param code Error code to assign
+ * @param contextData Additional context data
+ * @returns Typed PlatformError
+ */
+export declare function fromError(error: Error, code: string, contextData?: Record<string, any>): PlatformError;
+/**
+ * Determine if an error is retryable
+ *
+ * @param error Error to check
+ * @returns Boolean indicating if the error should be retried
+ */
+export declare function isRetryable(error: any): boolean;
+/**
+ * Create a wrapped version of a function that catches errors
+ * and converts them to typed PlatformErrors
+ *
+ * @param fn Function to wrap
+ * @param errorCode Default error code to use
+ * @param contextData Additional context data
+ * @returns Wrapped function
+ */
+export declare function withErrorHandling<T extends (...args: any[]) => Promise<any>>(fn: T, errorCode: string, contextData?: Record<string, any>): T;
+/**
+ * Retry a function with exponential backoff
+ *
+ * @param fn Function to retry
+ * @param options Retry options
+ * @returns Function result or throws after max retries
+ */
+export declare function retry<T>(fn: () => Promise<T>, options?: {
+    maxRetries?: number;
+    initialDelay?: number;
+    maxDelay?: number;
+    backoffFactor?: number;
+    retryableErrors?: Array<string | RegExp>;
+}): Promise<T>;