@serve.zone/dcrouter 2.12.4

package/dist_ts/errors/email.errors.d.ts

@@ -0,0 +1,175 @@
+import { PlatformError, ValidationError, ResourceError, OperationError } from './base.errors.js';
+import type { IErrorContext } from './base.errors.js';
+/**
+ * Base class for all email service related errors
+ */
+export declare class EmailServiceError extends OperationError {
+    /**
+     * Creates a new email service 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 email template errors
+ */
+export declare class EmailTemplateError extends OperationError {
+    /**
+     * Creates a new email template 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 email validation errors
+ */
+export declare class EmailValidationError extends ValidationError {
+    /**
+     * Creates a new email validation 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 email sending errors
+ */
+export declare class EmailSendError extends OperationError {
+    /**
+     * Creates a new email send 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 permanently failed send
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    static permanent(message: string, context?: IErrorContext): EmailSendError;
+    /**
+     * Creates an instance for a temporary failed send
+     *
+     * @param message Error message
+     * @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: string, maxRetries?: number, currentRetry?: number, retryDelay?: number, context?: IErrorContext): EmailSendError;
+    /**
+     * Check if this is a permanent send failure
+     */
+    isPermanent(): boolean;
+}
+/**
+ * Error class for email receiving errors
+ */
+export declare class EmailReceiveError extends OperationError {
+    /**
+     * Creates a new email receive 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 email attachment errors
+ */
+export declare class EmailAttachmentError extends ValidationError {
+    /**
+     * Creates a new email attachment error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message: string, context?: IErrorContext);
+    /**
+     * Creates an instance for an attachment too large error
+     *
+     * @param size Attachment size in bytes
+     * @param maxSize Maximum allowed size in bytes
+     * @param filename Attachment filename
+     * @param context Additional context
+     */
+    static tooLarge(size: number, maxSize: number, filename?: string, context?: IErrorContext): EmailAttachmentError;
+    /**
+     * Creates an instance for an invalid attachment type error
+     *
+     * @param contentType Attachment content type
+     * @param filename Attachment filename
+     * @param allowedTypes List of allowed content types
+     * @param context Additional context
+     */
+    static invalidType(contentType: string, filename: string, allowedTypes: string[], context?: IErrorContext): EmailAttachmentError;
+}
+/**
+ * Error class for email parsing errors
+ */
+export declare class EmailParseError extends OperationError {
+    /**
+     * Creates a new email parse 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 email rate limit exceeded errors
+ */
+export declare class EmailRateLimitError extends ResourceError {
+    /**
+     * Creates a new email rate 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 with rate limit information
+     *
+     * @param limit Rate limit
+     * @param remaining Remaining quota
+     * @param resetAt Time when the quota resets
+     * @param scope Rate limit scope (global, domain, user, etc.)
+     * @param context Additional context
+     */
+    static withLimitInfo(limit: number, remaining: number, resetAt: Date | number, scope?: string, context?: IErrorContext): EmailRateLimitError;
+}

package/dist_ts/errors/email.errors.js

@@ -0,0 +1,265 @@
+import { PlatformError, ValidationError, NetworkError, ResourceError, OperationError } from './base.errors.js';
+import { EMAIL_SERVICE_ERROR, EMAIL_TEMPLATE_ERROR, EMAIL_VALIDATION_ERROR, EMAIL_SEND_ERROR, EMAIL_RECEIVE_ERROR, EMAIL_ATTACHMENT_ERROR, EMAIL_PARSE_ERROR, EMAIL_RATE_LIMIT_EXCEEDED } from './error.codes.js';
+/**
+ * Base class for all email service related errors
+ */
+export class EmailServiceError extends OperationError {
+    /**
+     * Creates a new email service error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message, context = {}) {
+        super(message, EMAIL_SERVICE_ERROR, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, context);
+    }
+}
+/**
+ * Error class for email template errors
+ */
+export class EmailTemplateError extends OperationError {
+    /**
+     * Creates a new email template error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message, context = {}) {
+        super(message, EMAIL_TEMPLATE_ERROR, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, context);
+    }
+}
+/**
+ * Error class for email validation errors
+ */
+export class EmailValidationError extends ValidationError {
+    /**
+     * Creates a new email validation error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message, context = {}) {
+        super(message, EMAIL_VALIDATION_ERROR, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, context);
+    }
+}
+/**
+ * Error class for email sending errors
+ */
+export class EmailSendError extends OperationError {
+    /**
+     * Creates a new email send error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message, context = {}) {
+        super(message, EMAIL_SEND_ERROR, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, context);
+    }
+    /**
+     * Creates an instance for a permanently failed send
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    static permanent(message, context = {}) {
+        return new EmailSendError(`Permanent send failure: ${message}`, {
+            ...context,
+            data: {
+                ...context.data,
+                permanent: true
+            },
+            userMessage: 'The email could not be delivered due to a permanent failure.'
+        });
+    }
+    /**
+     * Creates an instance for a temporary failed send
+     *
+     * @param message Error message
+     * @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, maxRetries = 3, currentRetry = 0, retryDelay = 60000, context = {}) {
+        const error = new EmailSendError(`Temporary send failure: ${message}`, {
+            ...context,
+            data: {
+                ...context.data,
+                permanent: false
+            },
+            userMessage: 'The email delivery failed temporarily. It will be retried.'
+        });
+        return error.withRetry(maxRetries, currentRetry, retryDelay);
+    }
+    /**
+     * Check if this is a permanent send failure
+     */
+    isPermanent() {
+        return !!this.context.data?.permanent;
+    }
+}
+/**
+ * Error class for email receiving errors
+ */
+export class EmailReceiveError extends OperationError {
+    /**
+     * Creates a new email receive error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message, context = {}) {
+        super(message, EMAIL_RECEIVE_ERROR, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, context);
+    }
+}
+/**
+ * Error class for email attachment errors
+ */
+export class EmailAttachmentError extends ValidationError {
+    /**
+     * Creates a new email attachment error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message, context = {}) {
+        super(message, EMAIL_ATTACHMENT_ERROR, context);
+    }
+    /**
+     * Creates an instance for an attachment too large error
+     *
+     * @param size Attachment size in bytes
+     * @param maxSize Maximum allowed size in bytes
+     * @param filename Attachment filename
+     * @param context Additional context
+     */
+    static tooLarge(size, maxSize, filename, context = {}) {
+        const filenameText = filename ? ` (${filename})` : '';
+        return new EmailAttachmentError(`Attachment${filenameText} size ${size} bytes exceeds maximum allowed size of ${maxSize} bytes`, {
+            ...context,
+            data: {
+                ...context.data,
+                size,
+                maxSize,
+                filename
+            },
+            userMessage: `The attachment${filenameText} is too large. Maximum size is ${Math.round(maxSize / 1024 / 1024)} MB.`
+        });
+    }
+    /**
+     * Creates an instance for an invalid attachment type error
+     *
+     * @param contentType Attachment content type
+     * @param filename Attachment filename
+     * @param allowedTypes List of allowed content types
+     * @param context Additional context
+     */
+    static invalidType(contentType, filename, allowedTypes, context = {}) {
+        return new EmailAttachmentError(`Attachment '${filename}' with content type '${contentType}' is not allowed. Allowed types: ${allowedTypes.join(', ')}`, {
+            ...context,
+            data: {
+                ...context.data,
+                contentType,
+                filename,
+                allowedTypes
+            },
+            userMessage: `The attachment type ${contentType} is not allowed.`
+        });
+    }
+}
+/**
+ * Error class for email parsing errors
+ */
+export class EmailParseError extends OperationError {
+    /**
+     * Creates a new email parse error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message, context = {}) {
+        super(message, EMAIL_PARSE_ERROR, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, context);
+    }
+}
+/**
+ * Error class for email rate limit exceeded errors
+ */
+export class EmailRateLimitError extends ResourceError {
+    /**
+     * Creates a new email rate limit error
+     *
+     * @param message Error message
+     * @param context Additional context
+     */
+    constructor(message, context = {}) {
+        super(message, EMAIL_RATE_LIMIT_EXCEEDED, context);
+    }
+    /**
+     * Creates a new instance with updated context
+     */
+    createWithContext(context) {
+        return new this.constructor(this.message, context);
+    }
+    /**
+     * Creates an instance with rate limit information
+     *
+     * @param limit Rate limit
+     * @param remaining Remaining quota
+     * @param resetAt Time when the quota resets
+     * @param scope Rate limit scope (global, domain, user, etc.)
+     * @param context Additional context
+     */
+    static withLimitInfo(limit, remaining, resetAt, scope = 'global', context = {}) {
+        const resetTime = typeof resetAt === 'number' ? new Date(resetAt) : resetAt;
+        const resetTimeStr = resetTime.toISOString();
+        return new EmailRateLimitError(`Email rate limit exceeded: ${remaining}/${limit} remaining in ${scope} scope, resets at ${resetTimeStr}`, {
+            ...context,
+            data: {
+                ...context.data,
+                limit,
+                remaining,
+                resetAt: resetTime.getTime(),
+                resetTimeStr,
+                scope
+            },
+            userMessage: `You've reached the email sending limit. Please try again later.`
+        });
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZW1haWwuZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vdHMvZXJyb3JzL2VtYWlsLmVycm9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQ0wsYUFBYSxFQUNiLGVBQWUsRUFDZixZQUFZLEVBQ1osYUFBYSxFQUNiLGNBQWMsRUFDZixNQUFNLGtCQUFrQixDQUFDO0FBRzFCLE9BQU8sRUFDTCxtQkFBbUIsRUFDbkIsb0JBQW9CLEVBQ3BCLHNCQUFzQixFQUN0QixnQkFBZ0IsRUFDaEIsbUJBQW1CLEVBQ25CLHNCQUFzQixFQUN0QixpQkFBaUIsRUFDakIseUJBQXlCLEVBQzFCLE1BQU0sa0JBQWtCLENBQUM7QUFFMUI7O0dBRUc7QUFDSCxNQUFNLE9BQU8saUJBQWtCLFNBQVEsY0FBYztJQUNuRDs7Ozs7T0FLRztJQUNILFlBQ0UsT0FBZSxFQUNmLFVBQXlCLEVBQUU7UUFFM0IsS0FBSyxDQUFDLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUMvQyxDQUFDO0lBRUQ7O09BRUc7SUFDTyxpQkFBaUIsQ0FBQyxPQUFzQjtRQUNoRCxPQUFPLElBQUssSUFBSSxDQUFDLFdBQXdDLENBQ3ZELElBQUksQ0FBQyxPQUFPLEVBQ1osT0FBTyxDQUNSLENBQUM7SUFDSixDQUFDO0NBQ0Y7QUFFRDs7R0FFRztBQUNILE1BQU0sT0FBTyxrQkFBbUIsU0FBUSxjQUFjO0lBQ3BEOzs7OztPQUtHO0lBQ0gsWUFDRSxPQUFlLEVBQ2YsVUFBeUIsRUFBRTtRQUUzQixLQUFLLENBQUMsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE9BQU8sQ0FBQyxDQUFDO0lBQ2hELENBQUM7SUFFRDs7T0FFRztJQUNPLGlCQUFpQixDQUFDLE9BQXNCO1FBQ2hELE9BQU8sSUFBSyxJQUFJLENBQUMsV0FBeUMsQ0FDeEQsSUFBSSxDQUFDLE9BQU8sRUFDWixPQUFPLENBQ1IsQ0FBQztJQUNKLENBQUM7Q0FDRjtBQUVEOztH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

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

@@ -0,0 +1,98 @@
+import { PlatformError } from './base.errors.js';
+import type { IErrorContext } from './base.errors.js';
+/**
+ * Error handler configuration
+ */
+export interface IErrorHandlerConfig {
+    /** Whether to log errors automatically */
+    logErrors: boolean;
+    /** Whether to include stack traces in prod environment */
+    includeStacksInProd: boolean;
+    /** Default retry options */
+    retry: {
+        /** Maximum retry attempts */
+        maxAttempts: number;
+        /** Base delay between retries in ms */
+        baseDelay: number;
+        /** Maximum delay between retries in ms */
+        maxDelay: number;
+        /** Backoff factor for exponential backoff */
+        backoffFactor: number;
+    };
+}
+/**
+ * Error handler utility
+ * Provides methods for consistent error handling across the platform
+ */
+export declare class ErrorHandler {
+    /**
+     * Current configuration
+     */
+    static config: IErrorHandlerConfig;
+    /**
+     * Update error handler configuration
+     *
+     * @param newConfig New configuration (partial)
+     */
+    static configure(newConfig: Partial<IErrorHandlerConfig>): void;
+    /**
+     * 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: any, defaultCode: string, context?: IErrorContext): PlatformError;
+    /**
+     * 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: any, includeDetails?: boolean): Record<string, any>;
+    /**
+     * 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: any, defaultCode: string, context?: IErrorContext): Record<string, any>;
+    /**
+     * 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 execute<T>(fn: () => Promise<T>, defaultCode: string, context?: IErrorContext): Promise<T>;
+    /**
+     * 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 executeWithRetry<T>(fn: () => Promise<T>, defaultCode: string, options?: {
+        maxAttempts?: number;
+        baseDelay?: number;
+        maxDelay?: number;
+        backoffFactor?: number;
+        retryableErrorCodes?: string[];
+        retryableErrorPatterns?: RegExp[];
+        onRetry?: (error: PlatformError, attempt: number, delay: number) => void;
+    }, context?: IErrorContext): Promise<T>;
+}
+/**
+ * Create a middleware for handling errors in HTTP requests
+ *
+ * @returns Middleware function
+ */
+export declare function createErrorHandlerMiddleware(): (error: any, req: any, res: any, next: any) => void;