@bernierllc/email-manager 0.1.1

package/dist/managers/email-scheduler.js

@@ -0,0 +1,288 @@
+/*
+Copyright (c) 2025 Bernier LLC
+
+This file is licensed to the client under a limited-use license.
+The client may use and modify this code *only within the scope of the project it was delivered for*.
+Redistribution or use in other products or commercial offerings is not permitted without written consent from Bernier LLC.
+*/
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * Email Scheduling System
+ * Handles queuing and scheduled delivery of emails
+ */
+export class EmailScheduler {
+    constructor(sendEmailCallback, config = {
+        enabled: true,
+        checkIntervalMs: 60000, // Check every minute
+        maxRetries: 3,
+        retryDelayMs: 300000 // 5 minutes
+    }) {
+        this.queue = [];
+        this.isRunning = false;
+        this.interval = null;
+        this.sendEmailCallback = sendEmailCallback;
+        this.config = config;
+    }
+    /**
+     * Schedule an email for future delivery
+     */
+    async scheduleEmail(email, scheduleTime) {
+        try {
+            // Validate schedule time
+            if (scheduleTime <= new Date()) {
+                return {
+                    success: false,
+                    scheduleId: '',
+                    scheduledFor: scheduleTime,
+                    emailId: '',
+                    status: 'cancelled'
+                };
+            }
+            const scheduleId = uuidv4();
+            const scheduledEmail = {
+                id: scheduleId,
+                email,
+                scheduledFor: scheduleTime,
+                status: 'scheduled',
+                createdAt: new Date()
+            };
+            // Add to queue and sort
+            this.queue.push(scheduledEmail);
+            this.sortQueue();
+            return {
+                success: true,
+                scheduleId,
+                scheduledFor: scheduleTime,
+                emailId: scheduleId,
+                status: 'scheduled'
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                scheduleId: '',
+                scheduledFor: scheduleTime,
+                emailId: '',
+                status: 'cancelled'
+            };
+        }
+    }
+    /**
+     * Cancel a scheduled email
+     */
+    async cancelScheduledEmail(scheduleId) {
+        try {
+            const index = this.queue.findIndex(item => item.id === scheduleId);
+            if (index === -1) {
+                return {
+                    success: false,
+                    error: 'Scheduled email not found'
+                };
+            }
+            const scheduledEmail = this.queue[index];
+            // Check if email can be cancelled (not already sent)
+            if (scheduledEmail.status === 'sent') {
+                return {
+                    success: false,
+                    error: 'Cannot cancel email that has already been sent'
+                };
+            }
+            // Update status and remove from queue
+            scheduledEmail.status = 'cancelled';
+            this.queue.splice(index, 1);
+            return {
+                success: true,
+                message: 'Scheduled email cancelled successfully'
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error occurred'
+            };
+        }
+    }
+    /**
+     * Get scheduled email by ID
+     */
+    getScheduledEmail(scheduleId) {
+        return this.queue.find(item => item.id === scheduleId) || null;
+    }
+    /**
+     * List all scheduled emails
+     */
+    listScheduledEmails(status) {
+        let filtered = [...this.queue];
+        if (status) {
+            filtered = filtered.filter(item => item.status === status);
+        }
+        // Sort by schedule time
+        filtered.sort((a, b) => a.scheduledFor.getTime() - b.scheduledFor.getTime());
+        return filtered;
+    }
+    /**
+     * Start the scheduler
+     */
+    startScheduler() {
+        if (!this.config.enabled || this.isRunning) {
+            return;
+        }
+        this.isRunning = true;
+        this.interval = setInterval(() => {
+            this.processQueue();
+        }, this.config.checkIntervalMs);
+        console.log('Email scheduler started');
+    }
+    /**
+     * Stop the scheduler
+     */
+    stopScheduler() {
+        if (!this.isRunning) {
+            return;
+        }
+        this.isRunning = false;
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+        console.log('Email scheduler stopped');
+    }
+    /**
+     * Process the email queue
+     */
+    async processQueue() {
+        if (!this.config.enabled) {
+            return;
+        }
+        const now = new Date();
+        const readyEmails = this.queue.filter(item => item.status === 'scheduled' && item.scheduledFor <= now);
+        console.log(`Processing ${readyEmails.length} scheduled emails`);
+        for (const scheduledEmail of readyEmails) {
+            await this.processSingleEmail(scheduledEmail);
+        }
+        // Clean up old completed emails (keep only last 1000)
+        this.cleanupCompletedEmails();
+    }
+    /**
+     * Process a single scheduled email
+     */
+    async processSingleEmail(scheduledEmail) {
+        try {
+            // Attempt to send email
+            const result = await this.sendEmailCallback(scheduledEmail.email);
+            // Update scheduled email status
+            scheduledEmail.status = result.success ? 'sent' : 'failed';
+            scheduledEmail.sentAt = new Date();
+            scheduledEmail.result = result;
+            // Remove from queue if sent successfully
+            if (result.success) {
+                const index = this.queue.findIndex(item => item.id === scheduledEmail.id);
+                if (index !== -1) {
+                    this.queue.splice(index, 1);
+                }
+            }
+            else {
+                // Handle retry logic for failed emails
+                await this.handleFailedEmail(scheduledEmail);
+            }
+            console.log(`Scheduled email ${scheduledEmail.id} ${result.success ? 'sent successfully' : 'failed to send'}`);
+        }
+        catch (error) {
+            console.error(`Failed to send scheduled email ${scheduledEmail.id}:`, error);
+            scheduledEmail.status = 'failed';
+            scheduledEmail.error = error instanceof Error ? error.message : 'Unknown error';
+            await this.handleFailedEmail(scheduledEmail);
+        }
+    }
+    /**
+     * Handle failed email delivery with retry logic
+     */
+    async handleFailedEmail(scheduledEmail) {
+        const retryCount = scheduledEmail.retryCount || 0;
+        if (retryCount < this.config.maxRetries) {
+            // Schedule retry
+            const retryTime = new Date(Date.now() + this.config.retryDelayMs);
+            scheduledEmail.retryCount = retryCount + 1;
+            scheduledEmail.scheduledFor = retryTime;
+            scheduledEmail.status = 'scheduled';
+            // Re-sort queue
+            this.sortQueue();
+            console.log(`Scheduled retry ${retryCount + 1}/${this.config.maxRetries} for email ${scheduledEmail.id} at ${retryTime.toISOString()}`);
+        }
+        else {
+            // Max retries reached, mark as permanently failed
+            console.error(`Email ${scheduledEmail.id} failed permanently after ${this.config.maxRetries} retries`);
+            // Remove from queue
+            const index = this.queue.findIndex(item => item.id === scheduledEmail.id);
+            if (index !== -1) {
+                this.queue.splice(index, 1);
+            }
+        }
+    }
+    /**
+     * Sort queue by scheduled time
+     */
+    sortQueue() {
+        this.queue.sort((a, b) => a.scheduledFor.getTime() - b.scheduledFor.getTime());
+    }
+    /**
+     * Clean up old completed emails to prevent memory issues
+     */
+    cleanupCompletedEmails() {
+        const completedEmails = this.queue.filter(item => item.status === 'sent' || item.status === 'cancelled');
+        if (completedEmails.length > 1000) {
+            // Remove oldest completed emails
+            const toRemove = completedEmails
+                .sort((a, b) => (a.sentAt || a.createdAt).getTime() - (b.sentAt || b.createdAt).getTime())
+                .slice(0, completedEmails.length - 1000);
+            for (const email of toRemove) {
+                const index = this.queue.findIndex(item => item.id === email.id);
+                if (index !== -1) {
+                    this.queue.splice(index, 1);
+                }
+            }
+        }
+    }
+    /**
+     * Get scheduler statistics
+     */
+    getStats() {
+        const now = new Date();
+        const scheduled = this.queue.filter(item => item.status === 'scheduled');
+        const overdue = scheduled.filter(item => item.scheduledFor <= now);
+        return {
+            isRunning: this.isRunning,
+            totalInQueue: this.queue.length,
+            scheduled: scheduled.length,
+            overdue: overdue.length,
+            nextScheduled: scheduled.length > 0
+                ? scheduled.sort((a, b) => a.scheduledFor.getTime() - b.scheduledFor.getTime())[0].scheduledFor
+                : null,
+            config: this.config
+        };
+    }
+    /**
+     * Update scheduler configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+        // Restart scheduler if interval changed
+        if (config.checkIntervalMs && this.isRunning) {
+            this.stopScheduler();
+            this.startScheduler();
+        }
+    }
+    /**
+     * Clear all scheduled emails (for testing)
+     */
+    clear() {
+        this.queue = [];
+    }
+    /**
+     * Get queue length
+     */
+    getQueueLength() {
+        return this.queue.length;
+    }
+}
+//# sourceMappingURL=email-scheduler.js.map

package/dist/managers/email-scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-scheduler.js","sourceRoot":"","sources":["../../src/managers/email-scheduler.ts"],"names":[],"mappings":"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"}

package/dist/managers/provider-manager.d.ts

@@ -0,0 +1,104 @@
+import { EmailSender } from '@bernierllc/email-sender';
+import { EmailProvider, EmailData, SendResult, ProviderResult, DeleteResult, ProviderList, ProviderStatus, TestResult } from '../types.js';
+/**
+ * Provider Management System
+ * Handles email provider configuration, fallback, and load balancing
+ */
+export declare class ProviderManager {
+    private providers;
+    private emailSender;
+    private activeProviders;
+    private usageTracking;
+    constructor(emailSender: EmailSender);
+    /**
+     * Add a new email provider
+     */
+    addProvider(provider: EmailProvider): Promise<ProviderResult>;
+    /**
+     * Remove a provider
+     */
+    removeProvider(providerId: string): Promise<DeleteResult>;
+    /**
+     * Get a provider by ID
+     */
+    getProvider(providerId: string): Promise<EmailProvider | null>;
+    /**
+     * List all providers
+     */
+    listProviders(): Promise<ProviderList>;
+    /**
+     * Send email with provider fallback
+     */
+    sendEmail(email: EmailData): Promise<SendResult>;
+    /**
+     * Get provider status
+     */
+    getProviderStatus(providerId: string): Promise<ProviderStatus | null>;
+    /**
+     * Test provider connection
+     */
+    testConnection(providerId: string): Promise<TestResult>;
+    /**
+     * Send email with specific provider
+     */
+    private sendWithProvider;
+    /**
+     * Get available providers sorted by priority
+     */
+    private getAvailableProviders;
+    /**
+     * Check if provider is within rate limits
+     */
+    private checkRateLimit;
+    /**
+     * Update usage tracking for a provider
+     */
+    private updateUsageTracking;
+    /**
+     * Initialize usage tracking for a provider
+     */
+    private initializeUsageTracking;
+    /**
+     * Reset usage counters based on time intervals
+     */
+    private resetUsageCounters;
+    /**
+     * Update the active providers list
+     */
+    private updateActiveProviders;
+    /**
+     * Validate provider configuration
+     */
+    private validateProvider;
+    /**
+     * Test provider connection
+     */
+    private testProviderConnection;
+    /**
+     * Get provider statistics
+     */
+    getStats(): {
+        total: number;
+        active: number;
+        inactive: number;
+        byType: Record<string, number>;
+        usageStats: Record<string, {
+            minute: number;
+            hour: number;
+            day: number;
+        }>;
+    };
+    /**
+     * Group providers by type
+     */
+    private groupByType;
+    /**
+     * Get usage statistics
+     */
+    private getUsageStats;
+    /**
+     * Clear all providers (for testing)
+     */
+    clear(): void;
+}
+//# sourceMappingURL=provider-manager.d.ts.map

package/dist/managers/provider-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-manager.d.ts","sourceRoot":"","sources":["../../src/managers/provider-manager.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EACL,aAAa,EACb,SAAS,EACT,UAAU,EACV,cAAc,EACd,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,UAAU,EAGX,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAyC;IAC1D,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,aAAa,CAA0F;gBAEnG,WAAW,EAAE,WAAW;IAOpC;;OAEG;IACG,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC;IA8CnE;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyB/D;;OAEG;IACG,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAIpE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,YAAY,CAAC;IAY5C;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;IAuCtD;;OAEG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAuB3E;;OAEG;IACG,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAY7D;;OAEG;YACW,gBAAgB;IAuC9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAiB7B;;OAEG;IACH,OAAO,CAAC,cAAc;IAiBtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAS/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAwB1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAsDxB;;OAEG;YACW,sBAAsB;IA0BpC;;OAEG;IACH,QAAQ;;;;;;oBA4B0C,MAAM;kBAAQ,MAAM;iBAAO,MAAM;;;IAhBnF;;OAEG;IACH,OAAO,CAAC,WAAW;IAUnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;IACH,KAAK,IAAI,IAAI;CAKd"}