@push.rocks/smartmta 5.1.2 → 5.2.0

package/dist_ts/mail/delivery/classes.delivery.system.d.ts

@@ -0,0 +1,160 @@
+import { EventEmitter } from 'node:events';
+import { UnifiedDeliveryQueue, type IQueueItem } from './classes.delivery.queue.js';
+import type { UnifiedEmailServer } from '../routing/classes.unified.email.server.js';
+/**
+ * Delivery status enumeration
+ */
+export declare enum DeliveryStatus {
+    PENDING = "pending",
+    DELIVERING = "delivering",
+    DELIVERED = "delivered",
+    DEFERRED = "deferred",
+    FAILED = "failed"
+}
+/**
+ * Delivery handler interface
+ */
+export interface IDeliveryHandler {
+    deliver(item: IQueueItem): Promise<any>;
+}
+/**
+ * Delivery options
+ */
+export interface IMultiModeDeliveryOptions {
+    connectionPoolSize?: number;
+    socketTimeout?: number;
+    concurrentDeliveries?: number;
+    sendTimeout?: number;
+    verifyCertificates?: boolean;
+    tlsMinVersion?: string;
+    forwardHandler?: IDeliveryHandler;
+    deliveryHandler?: IDeliveryHandler;
+    processHandler?: IDeliveryHandler;
+    globalRateLimit?: number;
+    perPatternRateLimit?: Record<string, number>;
+    processBounces?: boolean;
+    bounceHandler?: {
+        processSmtpFailure: (recipient: string, smtpResponse: string, options: any) => Promise<any>;
+    };
+    onDeliveryStart?: (item: IQueueItem) => Promise<void>;
+    onDeliverySuccess?: (item: IQueueItem, result: any) => Promise<void>;
+    onDeliveryFailed?: (item: IQueueItem, error: string) => Promise<void>;
+}
+/**
+ * Delivery system statistics
+ */
+export interface IDeliveryStats {
+    activeDeliveries: number;
+    totalSuccessful: number;
+    totalFailed: number;
+    avgDeliveryTime: number;
+    byMode: {
+        forward: {
+            successful: number;
+            failed: number;
+        };
+        mta: {
+            successful: number;
+            failed: number;
+        };
+        process: {
+            successful: number;
+            failed: number;
+        };
+    };
+    rateLimiting: {
+        currentRate: number;
+        globalLimit: number;
+        throttled: number;
+    };
+}
+/**
+ * Handles delivery for all email processing modes
+ */
+export declare class MultiModeDeliverySystem extends EventEmitter {
+    private queue;
+    private options;
+    private stats;
+    private deliveryTimes;
+    private activeDeliveries;
+    private running;
+    private throttled;
+    private rateLimitLastCheck;
+    private rateLimitCounter;
+    private emailServer?;
+    /**
+     * Create a new multi-mode delivery system
+     * @param queue Unified delivery queue
+     * @param options Delivery options
+     * @param emailServer Optional reference to unified email server for outbound delivery
+     */
+    constructor(queue: UnifiedDeliveryQueue, options: IMultiModeDeliveryOptions, emailServer?: UnifiedEmailServer);
+    /**
+     * Start the delivery system
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the delivery system
+     */
+    stop(): Promise<void>;
+    /**
+     * Process ready items from the queue
+     * @param items Queue items ready for processing
+     */
+    private processItems;
+    /**
+     * Deliver an item from the queue
+     * @param item Queue item to deliver
+     */
+    private deliverItem;
+    /**
+     * Default handler for forward mode delivery
+     * @param item Queue item
+     */
+    private handleForwardDelivery;
+    /**
+     * Resolve MX records for a domain, sorted by priority (lowest first).
+     * Falls back to the domain itself as an A record per RFC 5321.
+     */
+    private resolveMxForDomain;
+    /**
+     * Group recipient addresses by their domain part.
+     */
+    private groupRecipientsByDomain;
+    /**
+     * Default handler for MTA mode delivery
+     * @param item Queue item
+     */
+    private handleMtaDelivery;
+    /**
+     * Default handler for process mode delivery
+     * @param item Queue item
+     */
+    private handleProcessDelivery;
+    /**
+     * Get file extension from filename
+     */
+    private getFileExtension;
+    /**
+     * Apply DKIM signing to an email
+     */
+    private applyDkimSigning;
+    /**
+     * Update delivery time statistics
+     */
+    private updateDeliveryTimeStats;
+    /**
+     * Check if rate limit is exceeded
+     * @returns True if rate limited, false otherwise
+     */
+    private checkRateLimit;
+    /**
+     * Update delivery options
+     * @param options New options
+     */
+    updateOptions(options: Partial<IMultiModeDeliveryOptions>): void;
+    /**
+     * Get delivery statistics
+     */
+    getStats(): IDeliveryStats;
+}