@serve.zone/dcrouter 11.0.27 → 11.0.29

package/dist_ts/errors/base.errors.d.ts

@@ -0,0 +1,224 @@
+import { ErrorSeverity, ErrorCategory, ErrorRecoverability } from './error.codes.js';
+/**
+ * Context information added to structured errors
+ */
+export interface IErrorContext {
+    /** Component or service where the error occurred */
+    component?: string;
+    /** Operation that was being performed */
+    operation?: string;
+    /** Unique request ID if available */
+    requestId?: string;
+    /** Error occurred at timestamp */
+    timestamp?: number;
+    /** User-visible message (safe to display to end-users) */
+    userMessage?: string;
+    /** Additional structured data for debugging */
+    data?: Record<string, any>;
+    /** Related entity IDs if applicable */
+    entity?: {
+        type: string;
+        id: string | number;
+    };
+    /** Stack trace (if enabled in configuration) */
+    stack?: string;
+    /** Retry information if applicable */
+    retry?: {
+        /** Maximum number of retries allowed */
+        maxRetries?: number;
+        /** Current retry count */
+        currentRetry?: number;
+        /** Next retry timestamp */
+        nextRetryAt?: number;
+        /** Delay between retries (in ms) */
+        retryDelay?: number;
+    };
+}
+/**
+ * Base class for all errors in the Platform Service
+ * Adds structured error information, logging, and error tracking
+ */
+export declare class PlatformError extends Error {
+    /** Error code identifying the specific error type */
+    readonly code: string;
+    /** Error severity level */
+    readonly severity: ErrorSeverity;
+    /** Error category for grouping related errors */
+    readonly category: ErrorCategory;
+    /** Whether the error can be recovered from automatically */
+    readonly recoverability: ErrorRecoverability;
+    /** Additional context information */
+    readonly context: IErrorContext;
+    /**
+     * Creates a new PlatformError
+     *
+     * @param message Error message
+     * @param code Error code from error.codes.ts
+     * @param severity Error severity level
+     * @param category Error category
+     * @param recoverability Error recoverability indication
+     * @param context Additional context information
+     */
+    constructor(message: string, code: string, severity?: ErrorSeverity, category?: ErrorCategory, recoverability?: ErrorRecoverability, context?: IErrorContext);
+    /**
+     * Logs the error using the platform logger
+     */
+    private logError;
+    /**
+     * Maps severity levels to log levels
+     */
+    private getLogLevelFromSeverity;
+    /**
+     * Returns a JSON representation of the error
+     */
+    toJSON(): Record<string, any>;
+    /**
+     * Creates an instance with retry information
+     *
+     * @param maxRetries Maximum number of retries
+     * @param currentRetry Current retry count
+     * @param retryDelay Delay between retries in ms
+     */
+    withRetry(maxRetries: number, currentRetry?: number, retryDelay?: number): PlatformError;
+    /**
+     * Protected method to create a new instance with updated context
+     * Subclasses can override this to handle their own constructor signatures
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+    /**
+     * Checks if the error should be retried based on retry information
+     */
+    shouldRetry(): boolean;
+    /**
+     * Returns a user-friendly message that is safe to display to end users
+     */
+    getUserMessage(): string;
+}
+/**
+ * Error class for validation errors
+ */
+export declare class ValidationError extends PlatformError {
+    /**
+     * Creates a new validation error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message: string, code: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle ValidationError's constructor signature
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+}
+/**
+ * Error class for configuration errors
+ */
+export declare class ConfigurationError extends PlatformError {
+    /**
+     * Creates a new configuration error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message: string, code: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle ConfigurationError's constructor signature
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+}
+/**
+ * Error class for network-related errors
+ */
+export declare class NetworkError extends PlatformError {
+    /**
+     * Creates a new network error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message: string, code: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle NetworkError's constructor signature
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+}
+/**
+ * Error class for resource availability errors (rate limits, quotas)
+ */
+export declare class ResourceError extends PlatformError {
+    /**
+     * Creates a new resource error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message: string, code: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle ResourceError's constructor signature
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+}
+/**
+ * Error class for authentication/authorization errors
+ */
+export declare class AuthenticationError extends PlatformError {
+    /**
+     * Creates a new authentication error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message: string, code: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle AuthenticationError's constructor signature
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+}
+/**
+ * Error class for operation errors (API calls, processing)
+ */
+export declare class OperationError extends PlatformError {
+    /**
+     * Creates a new operation error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message: string, code: string, context?: IErrorContext);
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle OperationError's constructor signature
+     */
+    protected createWithContext(context: IErrorContext): PlatformError;
+}
+/**
+ * Error class for critical system errors
+ */
+export declare class SystemError extends PlatformError {
+    /**
+     * Creates a new system error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message: string, code: string, context?: IErrorContext);
+}
+/**
+ * Helper to get the appropriate error class based on error category
+ *
+ * @param category Error category
+ * @returns The appropriate error class
+ */
+export declare function getErrorClassForCategory(category: ErrorCategory): any;

package/dist_ts/errors/base.errors.js

@@ -0,0 +1,320 @@
+import { ErrorSeverity, ErrorCategory, ErrorRecoverability } from './error.codes.js';
+import { logger } from '../logger.js';
+/**
+ * Base class for all errors in the Platform Service
+ * Adds structured error information, logging, and error tracking
+ */
+export class PlatformError extends Error {
+    /** Error code identifying the specific error type */
+    code;
+    /** Error severity level */
+    severity;
+    /** Error category for grouping related errors */
+    category;
+    /** Whether the error can be recovered from automatically */
+    recoverability;
+    /** Additional context information */
+    context;
+    /**
+     * Creates a new PlatformError
+     *
+     * @param message Error message
+     * @param code Error code from error.codes.ts
+     * @param severity Error severity level
+     * @param category Error category
+     * @param recoverability Error recoverability indication
+     * @param context Additional context information
+     */
+    constructor(message, code, severity = ErrorSeverity.MEDIUM, category = ErrorCategory.OTHER, recoverability = ErrorRecoverability.NON_RECOVERABLE, context = {}) {
+        super(message);
+        // Set error metadata
+        this.name = this.constructor.name;
+        this.code = code;
+        this.severity = severity;
+        this.category = category;
+        this.recoverability = recoverability;
+        // Add timestamp if not provided
+        this.context = {
+            ...context,
+            timestamp: context.timestamp || Date.now(),
+        };
+        // Capture stack trace
+        Error.captureStackTrace(this, this.constructor);
+        // Log the error automatically unless explicitly disabled
+        if (!context.data?.skipLogging) {
+            this.logError();
+        }
+    }
+    /**
+     * Logs the error using the platform logger
+     */
+    logError() {
+        const logLevel = this.getLogLevelFromSeverity();
+        // Construct structured log entry
+        const logData = {
+            error_code: this.code,
+            error_name: this.name,
+            severity: this.severity,
+            category: this.category,
+            recoverability: this.recoverability,
+            ...this.context
+        };
+        // Log with appropriate level
+        logger.log(logLevel, this.message, logData);
+    }
+    /**
+     * Maps severity levels to log levels
+     */
+    getLogLevelFromSeverity() {
+        switch (this.severity) {
+            case ErrorSeverity.CRITICAL:
+            case ErrorSeverity.HIGH:
+                return 'error';
+            case ErrorSeverity.MEDIUM:
+                return 'warn';
+            case ErrorSeverity.LOW:
+                return 'info';
+            case ErrorSeverity.INFO:
+                return 'debug';
+            default:
+                return 'error';
+        }
+    }
+    /**
+     * Returns a JSON representation of the error
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            code: this.code,
+            severity: this.severity,
+            category: this.category,
+            recoverability: this.recoverability,
+            context: this.context,
+            stack: process.env.NODE_ENV !== 'production' ? this.stack : undefined
+        };
+    }
+    /**
+     * Creates an instance with retry information
+     *
+     * @param maxRetries Maximum number of retries
+     * @param currentRetry Current retry count
+     * @param retryDelay Delay between retries in ms
+     */
+    withRetry(maxRetries, currentRetry = 0, retryDelay = 1000) {
+        const nextRetryAt = Date.now() + retryDelay;
+        // Clone the error with updated context
+        const newContext = {
+            ...this.context,
+            retry: {
+                maxRetries,
+                currentRetry,
+                nextRetryAt,
+                retryDelay
+            }
+        };
+        // Create a new instance using the protected method that subclasses can override
+        const newError = this.createWithContext(newContext);
+        // Update recoverability if we can retry
+        if (currentRetry < maxRetries && newError.recoverability === ErrorRecoverability.NON_RECOVERABLE) {
+            newError.recoverability = ErrorRecoverability.MAYBE_RECOVERABLE;
+        }
+        return newError;
+    }
+    /**
+     * Protected method to create a new instance with updated context
+     * Subclasses can override this to handle their own constructor signatures
+     */
+    createWithContext(context) {
+        // Default implementation for PlatformError
+        return new this.constructor(this.message, this.code, this.severity, this.category, this.recoverability, context);
+    }
+    /**
+     * Checks if the error should be retried based on retry information
+     */
+    shouldRetry() {
+        const { retry } = this.context;
+        if (!retry)
+            return false;
+        return retry.currentRetry < retry.maxRetries;
+    }
+    /**
+     * Returns a user-friendly message that is safe to display to end users
+     */
+    getUserMessage() {
+        return this.context.userMessage || 'An unexpected error occurred.';
+    }
+}
+/**
+ * Error class for validation errors
+ */
+export class ValidationError extends PlatformError {
+    /**
+     * Creates a new validation error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message, code, context = {}) {
+        super(message, code, ErrorSeverity.LOW, ErrorCategory.VALIDATION, ErrorRecoverability.NON_RECOVERABLE, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle ValidationError's constructor signature
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, this.code, context);
+    }
+}
+/**
+ * Error class for configuration errors
+ */
+export class ConfigurationError extends PlatformError {
+    /**
+     * Creates a new configuration error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message, code, context = {}) {
+        super(message, code, ErrorSeverity.MEDIUM, ErrorCategory.CONFIGURATION, ErrorRecoverability.NON_RECOVERABLE, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle ConfigurationError's constructor signature
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, this.code, context);
+    }
+}
+/**
+ * Error class for network-related errors
+ */
+export class NetworkError extends PlatformError {
+    /**
+     * Creates a new network error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message, code, context = {}) {
+        super(message, code, ErrorSeverity.MEDIUM, ErrorCategory.CONNECTIVITY, ErrorRecoverability.MAYBE_RECOVERABLE, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle NetworkError's constructor signature
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, this.code, context);
+    }
+}
+/**
+ * Error class for resource availability errors (rate limits, quotas)
+ */
+export class ResourceError extends PlatformError {
+    /**
+     * Creates a new resource error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message, code, context = {}) {
+        super(message, code, ErrorSeverity.MEDIUM, ErrorCategory.RESOURCE, ErrorRecoverability.MAYBE_RECOVERABLE, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle ResourceError's constructor signature
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, this.code, context);
+    }
+}
+/**
+ * Error class for authentication/authorization errors
+ */
+export class AuthenticationError extends PlatformError {
+    /**
+     * Creates a new authentication error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message, code, context = {}) {
+        super(message, code, ErrorSeverity.HIGH, ErrorCategory.AUTHENTICATION, ErrorRecoverability.NON_RECOVERABLE, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle AuthenticationError's constructor signature
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, this.code, context);
+    }
+}
+/**
+ * Error class for operation errors (API calls, processing)
+ */
+export class OperationError extends PlatformError {
+    /**
+     * Creates a new operation error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message, code, context = {}) {
+        super(message, code, ErrorSeverity.MEDIUM, ErrorCategory.OPERATION, ErrorRecoverability.MAYBE_RECOVERABLE, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     * Overrides the base implementation to handle OperationError's constructor signature
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, this.code, context);
+    }
+}
+/**
+ * Error class for critical system errors
+ */
+export class SystemError extends PlatformError {
+    /**
+     * Creates a new system error
+     *
+     * @param message Error message
+     * @param code Error code
+     * @param context Additional context
+     */
+    constructor(message, code, context = {}) {
+        super(message, code, ErrorSeverity.CRITICAL, ErrorCategory.OTHER, ErrorRecoverability.NON_RECOVERABLE, context);
+    }
+}
+/**
+ * Helper to get the appropriate error class based on error category
+ *
+ * @param category Error category
+ * @returns The appropriate error class
+ */
+export function getErrorClassForCategory(category) {
+    switch (category) {
+        case ErrorCategory.VALIDATION:
+            return ValidationError;
+        case ErrorCategory.CONFIGURATION:
+            return ConfigurationError;
+        case ErrorCategory.CONNECTIVITY:
+            return NetworkError;
+        case ErrorCategory.RESOURCE:
+            return ResourceError;
+        case ErrorCategory.AUTHENTICATION:
+            return AuthenticationError;
+        case ErrorCategory.OPERATION:
+            return OperationError;
+        default:
+            return PlatformError;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFzZS5lcnJvcnMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi90cy9lcnJvcnMvYmFzZS5lcnJvcnMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGFBQWEsRUFBRSxhQUFhLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUNyRixPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sY0FBYyxDQUFDO0FBb0R0Qzs7O0dBR0c7QUFDSCxNQUFNLE9BQU8sYUFBYyxTQUFRLEtBQUs7SUFDdEMscURBQXFEO0lBQ3JDLElBQUksQ0FBUztJQUU3QiwyQkFBMkI7SUFDWCxRQUFRLENBQWdCO0lBRXhDLGlEQUFpRDtJQUNqQyxRQUFRLENBQWdCO0lBRXhDLDREQUE0RDtJQUM1QyxjQUFjLENBQXNCO0lBRXBELHFDQUFxQztJQUNyQixPQUFPLENBQWdCO0lBRXZDOzs7Ozs7Ozs7T0FTRztJQUNILFlBQ0UsT0FBZSxFQUNmLElBQVksRUFDWixXQUEwQixhQUFhLENBQUMsTUFBTSxFQUM5QyxXQUEwQixhQUFhLENBQUMsS0FBSyxFQUM3QyxpQkFBc0MsbUJBQW1CLENBQUMsZUFBZSxFQUN6RSxVQUF5QixFQUFFO1FBRTNCLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUVmLHFCQUFxQjtRQUNyQixJQUFJLENBQUMsSUFBSSxHQUFHLElBQUksQ0FBQyxXQUFXLENBQUMsSUFBSSxDQUFDO1FBQ2xDLElBQUksQ0FBQyxJQUFJLEdBQUcsSUFBSSxDQUFDO1FBQ2pCLElBQUksQ0FBQyxRQUFRLEdBQUcsUUFBUSxDQUFDO1FBQ3pCLElBQUksQ0FBQyxRQUFRLEdBQUcsUUFBUSxDQUFDO1FBQ3pCLElBQUksQ0FBQyxjQUFjLEdBQUcsY0FBYyxDQUFDO1FBRXJDLGdDQUFnQztRQUNoQyxJQUFJLENBQUMsT0FBTyxHQUFHO1lBQ2IsR0FBRyxPQUFPO1lBQ1YsU0FBUyxFQUFFLE9BQU8sQ0FBQyxTQUFTLElBQUksSUFB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

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