@bernierllc/email-manager 0.1.1

package/dist/managers/email-analytics.js

@@ -0,0 +1,375 @@
+/*
+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.
+*/
+/**
+ * Email Analytics System
+ * Handles email performance tracking and reporting
+ */
+export class EmailAnalytics {
+    constructor(config = {
+        enabled: true,
+        trackOpens: true,
+        trackClicks: true,
+        trackBounces: true,
+        maxEvents: 10000
+    }) {
+        this.events = [];
+        this.stats = new Map();
+        this.config = config;
+    }
+    /**
+     * Track email sent event
+     */
+    trackEmailSent(emailId, provider, recipient) {
+        if (!this.config.enabled)
+            return;
+        this.recordEvent({
+            type: 'sent',
+            emailId,
+            provider,
+            recipient,
+            timestamp: new Date()
+        });
+        this.updateEmailStats(emailId, 'sent');
+    }
+    /**
+     * Track email delivered event
+     */
+    trackEmailDelivered(emailId, recipient) {
+        if (!this.config.enabled)
+            return;
+        this.recordEvent({
+            type: 'delivered',
+            emailId,
+            recipient,
+            timestamp: new Date()
+        });
+        this.updateEmailStats(emailId, 'delivered');
+    }
+    /**
+     * Track email opened event
+     */
+    trackEmailOpened(emailId, recipient) {
+        if (!this.config.enabled || !this.config.trackOpens)
+            return;
+        this.recordEvent({
+            type: 'opened',
+            emailId,
+            recipient,
+            timestamp: new Date()
+        });
+        this.updateEmailStats(emailId, 'opened');
+    }
+    /**
+     * Track email clicked event
+     */
+    trackEmailClicked(emailId, recipient, url) {
+        if (!this.config.enabled || !this.config.trackClicks)
+            return;
+        this.recordEvent({
+            type: 'clicked',
+            emailId,
+            recipient,
+            url,
+            timestamp: new Date()
+        });
+        this.updateEmailStats(emailId, 'clicked');
+    }
+    /**
+     * Track email bounced event
+     */
+    trackEmailBounced(emailId, recipient, reason) {
+        if (!this.config.enabled || !this.config.trackBounces)
+            return;
+        this.recordEvent({
+            type: 'bounced',
+            emailId,
+            recipient,
+            reason,
+            timestamp: new Date()
+        });
+        this.updateEmailStats(emailId, 'bounced');
+    }
+    /**
+     * Get email statistics for a specific email
+     */
+    getEmailStats(emailId) {
+        const existingStats = this.stats.get(emailId);
+        if (existingStats) {
+            return existingStats;
+        }
+        // Calculate stats from events if not cached
+        const events = this.events.filter(event => event.emailId === emailId);
+        const stats = {
+            emailId,
+            sent: events.filter(e => e.type === 'sent').length,
+            delivered: events.filter(e => e.type === 'delivered').length,
+            opened: events.filter(e => e.type === 'opened').length,
+            clicked: events.filter(e => e.type === 'clicked').length,
+            bounced: events.filter(e => e.type === 'bounced').length,
+            deliveryRate: 0,
+            openRate: 0,
+            clickRate: 0
+        };
+        // Calculate rates
+        stats.deliveryRate = this.calculateDeliveryRate(events);
+        stats.openRate = this.calculateOpenRate(events);
+        stats.clickRate = this.calculateClickRate(events);
+        // Cache the stats
+        this.stats.set(emailId, stats);
+        return stats;
+    }
+    /**
+     * Get delivery report for a time period
+     */
+    getDeliveryReport(options = {}) {
+        const startDate = options.startDate || new Date(Date.now() - 30 * 24 * 60 * 60 * 1000); // 30 days ago
+        const endDate = options.endDate || new Date();
+        let relevantEvents = this.events.filter(event => event.timestamp >= startDate && event.timestamp <= endDate);
+        // Filter by provider if specified
+        if (options.provider) {
+            relevantEvents = relevantEvents.filter(event => event.provider === options.provider);
+        }
+        // Filter by template if specified
+        if (options.templateId) {
+            // Note: This would require tracking templateId in events, which we could add
+            // For now, we'll include all events
+        }
+        const totalSent = relevantEvents.filter(e => e.type === 'sent').length;
+        const totalDelivered = relevantEvents.filter(e => e.type === 'delivered').length;
+        const totalOpened = relevantEvents.filter(e => e.type === 'opened').length;
+        const totalClicked = relevantEvents.filter(e => e.type === 'clicked').length;
+        const totalBounced = relevantEvents.filter(e => e.type === 'bounced').length;
+        return {
+            period: { startDate, endDate },
+            totalSent,
+            totalDelivered,
+            totalOpened,
+            totalClicked,
+            totalBounced,
+            deliveryRate: totalSent > 0 ? (totalDelivered / totalSent) * 100 : 0,
+            openRate: totalDelivered > 0 ? (totalOpened / totalDelivered) * 100 : 0,
+            clickRate: totalDelivered > 0 ? (totalClicked / totalDelivered) * 100 : 0,
+            bounceRate: totalSent > 0 ? (totalBounced / totalSent) * 100 : 0
+        };
+    }
+    /**
+     * Get bounce report for a time period
+     */
+    getBounceReport(options = {}) {
+        const startDate = options.startDate || new Date(Date.now() - 30 * 24 * 60 * 60 * 1000); // 30 days ago
+        const endDate = options.endDate || new Date();
+        let bounceEvents = this.events.filter(event => event.type === 'bounced' &&
+            event.timestamp >= startDate &&
+            event.timestamp <= endDate);
+        // Filter by provider if specified
+        if (options.provider) {
+            bounceEvents = bounceEvents.filter(event => event.provider === options.provider);
+        }
+        const totalBounces = bounceEvents.length;
+        const totalSent = this.events.filter(event => event.type === 'sent' &&
+            event.timestamp >= startDate &&
+            event.timestamp <= endDate &&
+            (!options.provider || event.provider === options.provider)).length;
+        // Group bounces by reason
+        const bouncesByReason = {};
+        bounceEvents.forEach(event => {
+            const reason = event.reason || 'unknown';
+            bouncesByReason[reason] = (bouncesByReason[reason] || 0) + 1;
+        });
+        // Group bounces by provider
+        const bouncesByProvider = {};
+        bounceEvents.forEach(event => {
+            const provider = event.provider || 'unknown';
+            bouncesByProvider[provider] = (bouncesByProvider[provider] || 0) + 1;
+        });
+        return {
+            period: { startDate, endDate },
+            totalBounces,
+            bouncesByReason,
+            bouncesByProvider,
+            bounceRate: totalSent > 0 ? (totalBounces / totalSent) * 100 : 0
+        };
+    }
+    /**
+     * Get analytics summary
+     */
+    getSummary(days = 30) {
+        const startDate = new Date(Date.now() - days * 24 * 60 * 60 * 1000);
+        const endDate = new Date();
+        const deliveryReport = this.getDeliveryReport({ startDate, endDate });
+        const bounceReport = this.getBounceReport({ startDate, endDate });
+        // Get top providers by volume
+        const providerStats = {};
+        this.events
+            .filter(e => e.type === 'sent' && e.timestamp >= startDate && e.timestamp <= endDate)
+            .forEach(event => {
+            const provider = event.provider || 'unknown';
+            providerStats[provider] = (providerStats[provider] || 0) + 1;
+        });
+        const topProviders = Object.entries(providerStats)
+            .sort(([, a], [, b]) => b - a)
+            .slice(0, 5)
+            .map(([provider, count]) => ({ provider, count }));
+        // Get daily stats for the period
+        const dailyStats = this.getDailyStats(startDate, endDate);
+        return {
+            period: { startDate, endDate, days },
+            overview: {
+                totalSent: deliveryReport.totalSent,
+                deliveryRate: deliveryReport.deliveryRate,
+                openRate: deliveryReport.openRate,
+                clickRate: deliveryReport.clickRate,
+                bounceRate: bounceReport.bounceRate
+            },
+            topProviders,
+            dailyStats,
+            totalEvents: this.events.length,
+            uniqueEmails: new Set(this.events.map(e => e.emailId)).size
+        };
+    }
+    /**
+     * Get daily statistics for a period
+     */
+    getDailyStats(startDate, endDate) {
+        const dailyStats = {};
+        // Initialize all days in the period
+        const currentDate = new Date(startDate);
+        while (currentDate <= endDate) {
+            const dateKey = currentDate.toISOString().split('T')[0];
+            dailyStats[dateKey] = {
+                date: new Date(currentDate),
+                sent: 0,
+                delivered: 0,
+                opened: 0,
+                clicked: 0,
+                bounced: 0
+            };
+            currentDate.setDate(currentDate.getDate() + 1);
+        }
+        // Populate with actual data
+        this.events
+            .filter(e => e.timestamp >= startDate && e.timestamp <= endDate)
+            .forEach(event => {
+            const dateKey = event.timestamp.toISOString().split('T')[0];
+            if (dailyStats[dateKey]) {
+                dailyStats[dateKey][event.type]++;
+            }
+        });
+        return Object.values(dailyStats).sort((a, b) => a.date.getTime() - b.date.getTime());
+    }
+    /**
+     * Record an event
+     */
+    recordEvent(event) {
+        this.events.push(event);
+        // Maintain max events limit to prevent memory issues
+        if (this.events.length > this.config.maxEvents) {
+            // Remove oldest events (keep most recent maxEvents/2)
+            const keepCount = Math.floor(this.config.maxEvents / 2);
+            this.events = this.events.slice(-keepCount);
+            // Clear stats cache as some events were removed
+            this.stats.clear();
+        }
+    }
+    /**
+     * Update email stats cache
+     */
+    updateEmailStats(emailId, eventType) {
+        const stats = this.stats.get(emailId) || {
+            emailId,
+            sent: 0,
+            delivered: 0,
+            opened: 0,
+            clicked: 0,
+            bounced: 0,
+            deliveryRate: 0,
+            openRate: 0,
+            clickRate: 0
+        };
+        // Increment the appropriate counter
+        switch (eventType) {
+            case 'sent':
+                stats.sent++;
+                break;
+            case 'delivered':
+                stats.delivered++;
+                break;
+            case 'opened':
+                stats.opened++;
+                break;
+            case 'clicked':
+                stats.clicked++;
+                break;
+            case 'bounced':
+                stats.bounced++;
+                break;
+        }
+        // Recalculate rates
+        stats.deliveryRate = stats.sent > 0 ? (stats.delivered / stats.sent) * 100 : 0;
+        stats.openRate = stats.delivered > 0 ? (stats.opened / stats.delivered) * 100 : 0;
+        stats.clickRate = stats.delivered > 0 ? (stats.clicked / stats.delivered) * 100 : 0;
+        this.stats.set(emailId, stats);
+    }
+    /**
+     * Calculate delivery rate from events
+     */
+    calculateDeliveryRate(events) {
+        const sent = events.filter(e => e.type === 'sent').length;
+        const delivered = events.filter(e => e.type === 'delivered').length;
+        return sent > 0 ? (delivered / sent) * 100 : 0;
+    }
+    /**
+     * Calculate open rate from events
+     */
+    calculateOpenRate(events) {
+        const delivered = events.filter(e => e.type === 'delivered').length;
+        const opened = events.filter(e => e.type === 'opened').length;
+        return delivered > 0 ? (opened / delivered) * 100 : 0;
+    }
+    /**
+     * Calculate click rate from events
+     */
+    calculateClickRate(events) {
+        const delivered = events.filter(e => e.type === 'delivered').length;
+        const clicked = events.filter(e => e.type === 'clicked').length;
+        return delivered > 0 ? (clicked / delivered) * 100 : 0;
+    }
+    /**
+     * Update analytics configuration
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    /**
+     * Export events data (for backup or migration)
+     */
+    exportEvents() {
+        return [...this.events];
+    }
+    /**
+     * Import events data (for restore or migration)
+     */
+    importEvents(events) {
+        this.events = events.slice(0, this.config.maxEvents);
+        this.stats.clear(); // Clear cache to force recalculation
+    }
+    /**
+     * Clear all analytics data (for testing)
+     */
+    clear() {
+        this.events = [];
+        this.stats.clear();
+    }
+    /**
+     * Get total event count
+     */
+    getEventCount() {
+        return this.events.length;
+    }
+}
+//# sourceMappingURL=email-analytics.js.map

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

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

package/dist/managers/email-scheduler.d.ts

@@ -0,0 +1,81 @@
+import { EmailData, ScheduledEmail, ScheduleResult, CancelResult, SchedulingConfig } from '../types.js';
+/**
+ * Email Scheduling System
+ * Handles queuing and scheduled delivery of emails
+ */
+export declare class EmailScheduler {
+    private queue;
+    private isRunning;
+    private interval;
+    private config;
+    private sendEmailCallback;
+    constructor(sendEmailCallback: (email: EmailData) => Promise<any>, config?: SchedulingConfig);
+    /**
+     * Schedule an email for future delivery
+     */
+    scheduleEmail(email: EmailData, scheduleTime: Date): Promise<ScheduleResult>;
+    /**
+     * Cancel a scheduled email
+     */
+    cancelScheduledEmail(scheduleId: string): Promise<CancelResult>;
+    /**
+     * Get scheduled email by ID
+     */
+    getScheduledEmail(scheduleId: string): ScheduledEmail | null;
+    /**
+     * List all scheduled emails
+     */
+    listScheduledEmails(status?: 'scheduled' | 'cancelled' | 'sent' | 'failed'): ScheduledEmail[];
+    /**
+     * Start the scheduler
+     */
+    startScheduler(): void;
+    /**
+     * Stop the scheduler
+     */
+    stopScheduler(): void;
+    /**
+     * Process the email queue
+     */
+    private processQueue;
+    /**
+     * Process a single scheduled email
+     */
+    private processSingleEmail;
+    /**
+     * Handle failed email delivery with retry logic
+     */
+    private handleFailedEmail;
+    /**
+     * Sort queue by scheduled time
+     */
+    private sortQueue;
+    /**
+     * Clean up old completed emails to prevent memory issues
+     */
+    private cleanupCompletedEmails;
+    /**
+     * Get scheduler statistics
+     */
+    getStats(): {
+        isRunning: boolean;
+        totalInQueue: number;
+        scheduled: number;
+        overdue: number;
+        nextScheduled: Date | null;
+        config: SchedulingConfig;
+    };
+    /**
+     * Update scheduler configuration
+     */
+    updateConfig(config: Partial<SchedulingConfig>): void;
+    /**
+     * Clear all scheduled emails (for testing)
+     */
+    clear(): void;
+    /**
+     * Get queue length
+     */
+    getQueueLength(): number;
+}
+//# sourceMappingURL=email-scheduler.d.ts.map

package/dist/managers/email-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-scheduler.d.ts","sourceRoot":"","sources":["../../src/managers/email-scheduler.ts"],"names":[],"mappings":"AASA,OAAO,EACL,SAAS,EACT,cAAc,EACd,cAAc,EACd,YAAY,EACZ,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,iBAAiB,CAAqC;gBAG5D,iBAAiB,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,OAAO,CAAC,GAAG,CAAC,EACrD,MAAM,GAAE,gBAKP;IAMH;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,GAAG,OAAO,CAAC,cAAc,CAAC;IA6ClF;;OAEG;IACG,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAqCrE;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAI5D;;OAEG;IACH,mBAAmB,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,QAAQ,GAAG,cAAc,EAAE;IAa7F;;OAEG;IACH,cAAc,IAAI,IAAI;IAatB;;OAEG;IACH,aAAa,IAAI,IAAI;IAcrB;;OAEG;YACW,YAAY;IAoB1B;;OAEG;YACW,kBAAkB;IAgChC;;OAEG;YACW,iBAAiB;IA2B/B;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAoB9B;;OAEG;IACH,QAAQ;;;;;;;;IAiBR;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,IAAI;IAUrD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB"}