@bernierllc/email-manager 0.1.1

package/dist/email-manager.js

@@ -0,0 +1,360 @@
+/*
+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 { EmailSender } from '@bernierllc/email-sender';
+// import { MagicLinkManager } from '@bernierllc/magic-link';
+import { v4 as uuidv4 } from 'uuid';
+import { SimpleTemplateEngine } from './utils/simple-template-engine.js';
+import { TemplateManager } from './managers/template-manager.js';
+import { ProviderManager } from './managers/provider-manager.js';
+import { EmailScheduler } from './managers/email-scheduler.js';
+import { EmailAnalytics } from './managers/email-analytics.js';
+import { EmailDataSchema } from './types.js';
+/**
+ * EmailManager - Main orchestration service for email operations
+ *
+ * This service orchestrates email-sender, template-engine, and magic-link packages
+ * to provide comprehensive email management with templates, scheduling, and analytics.
+ */
+export class EmailManager {
+    constructor(config) {
+        this.config = config;
+        // Initialize core dependencies  
+        this.emailSender = new EmailSender({
+            provider: 'smtp',
+            fromEmail: 'noreply@example.com'
+        });
+        this.templateEngine = new SimpleTemplateEngine();
+        // this.magicLinkManager = new MagicLinkManager({
+        //   encryptionKey: process.env.MAGIC_LINK_SECRET || 'default-secret-key-32chars',
+        //   defaultExpiryHours: 0.5 // 30 minutes
+        // });
+        // Initialize managers
+        this.templateManager = new TemplateManager(this.templateEngine);
+        this.providerManager = new ProviderManager(this.emailSender);
+        this.scheduler = new EmailScheduler((email) => this.sendEmail(email), config.scheduling);
+        this.analytics = new EmailAnalytics(config.analytics);
+        // Initialize with configuration
+        this.initializeFromConfig();
+        // Start scheduler if enabled
+        if (config.scheduling?.enabled !== false) {
+            this.scheduler.startScheduler();
+        }
+    }
+    // ======================
+    // Core Email Methods
+    // ======================
+    /**
+     * Send an email immediately
+     */
+    async sendEmail(email) {
+        try {
+            // Validate email data
+            const validation = EmailDataSchema.safeParse(email);
+            if (!validation.success) {
+                return {
+                    success: false,
+                    provider: 'none',
+                    sentAt: new Date(),
+                    errors: validation.error.errors.map(e => ({
+                        code: 'VALIDATION_ERROR',
+                        message: `${e.path.join('.')}: ${e.message}`
+                    }))
+                };
+            }
+            const emailId = uuidv4();
+            // Track send attempt
+            const recipients = Array.isArray(email.to) ? email.to : [email.to];
+            recipients.forEach(recipient => {
+                this.analytics.trackEmailSent(emailId, email.provider || 'default', recipient);
+            });
+            // Send via provider manager
+            const result = await this.providerManager.sendEmail(email);
+            if (result.success) {
+                // Track successful delivery
+                recipients.forEach(recipient => {
+                    this.analytics.trackEmailDelivered(emailId, recipient);
+                });
+            }
+            return {
+                ...result,
+                messageId: result.messageId || emailId
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'none',
+                sentAt: new Date(),
+                errors: [{
+                        code: 'SEND_ERROR',
+                        message: error instanceof Error ? error.message : 'Unknown error occurred'
+                    }]
+            };
+        }
+    }
+    /**
+     * Send a templated email
+     */
+    async sendTemplatedEmail(templateId, context, recipients) {
+        try {
+            // Render the template
+            const renderedTemplate = await this.templateManager.renderTemplate(templateId, context);
+            // Prepare email data
+            const emailData = {
+                to: recipients,
+                subject: renderedTemplate.subject,
+                html: renderedTemplate.html,
+                text: renderedTemplate.text,
+                templateId
+            };
+            // Send the email
+            return await this.sendEmail(emailData);
+        }
+        catch (error) {
+            return {
+                success: false,
+                provider: 'none',
+                sentAt: new Date(),
+                errors: [{
+                        code: 'TEMPLATE_ERROR',
+                        message: error instanceof Error ? error.message : 'Template processing failed'
+                    }]
+            };
+        }
+    }
+    /**
+     * Schedule an email for future delivery
+     */
+    async scheduleEmail(email, scheduleTime) {
+        return await this.scheduler.scheduleEmail(email, scheduleTime);
+    }
+    /**
+     * Cancel a scheduled email
+     */
+    async cancelScheduledEmail(scheduleId) {
+        return await this.scheduler.cancelScheduledEmail(scheduleId);
+    }
+    // ======================
+    // Template Management
+    // ======================
+    /**
+     * Create a new email template
+     */
+    async createTemplate(template) {
+        return await this.templateManager.createTemplate(template);
+    }
+    /**
+     * Update an existing template
+     */
+    async updateTemplate(templateId, template) {
+        return await this.templateManager.updateTemplate(templateId, template);
+    }
+    /**
+     * Delete a template
+     */
+    async deleteTemplate(templateId) {
+        return await this.templateManager.deleteTemplate(templateId);
+    }
+    /**
+     * Get a template by ID
+     */
+    async getTemplate(templateId) {
+        return await this.templateManager.getTemplate(templateId);
+    }
+    /**
+     * List templates with filtering and pagination
+     */
+    async listTemplates(options) {
+        return await this.templateManager.listTemplates(options);
+    }
+    /**
+     * Render a template with context (without sending)
+     */
+    async renderTemplate(templateId, context) {
+        return await this.templateManager.renderTemplate(templateId, context);
+    }
+    // ======================
+    // Provider Management
+    // ======================
+    /**
+     * Add an email provider
+     */
+    async addProvider(provider) {
+        return await this.providerManager.addProvider(provider);
+    }
+    /**
+     * Remove an email provider
+     */
+    async removeProvider(providerId) {
+        return await this.providerManager.removeProvider(providerId);
+    }
+    /**
+     * Get a provider by ID
+     */
+    async getProvider(providerId) {
+        return await this.providerManager.getProvider(providerId);
+    }
+    /**
+     * List all providers
+     */
+    async listProviders() {
+        return await this.providerManager.listProviders();
+    }
+    /**
+     * Get provider status and health
+     */
+    async getProviderStatus(providerId) {
+        return await this.providerManager.getProviderStatus(providerId);
+    }
+    /**
+     * Test provider connection
+     */
+    async testConnection(providerId) {
+        return await this.providerManager.testConnection(providerId);
+    }
+    // ======================
+    // Analytics and Monitoring
+    // ======================
+    /**
+     * Get email statistics for a specific email
+     */
+    async getEmailStats(emailId) {
+        return this.analytics.getEmailStats(emailId);
+    }
+    /**
+     * Get delivery report for a time period
+     */
+    async getDeliveryReport(options) {
+        return this.analytics.getDeliveryReport(options);
+    }
+    /**
+     * Get bounce report for a time period
+     */
+    async getBounceReport(options) {
+        return this.analytics.getBounceReport(options);
+    }
+    /**
+     * Get analytics summary
+     */
+    async getAnalyticsSummary(days = 30) {
+        return this.analytics.getSummary(days);
+    }
+    /**
+     * Track email events (for webhook integration)
+     */
+    trackEmailEvent(eventType, emailId, recipient, metadata) {
+        switch (eventType) {
+            case 'opened':
+                this.analytics.trackEmailOpened(emailId, recipient);
+                break;
+            case 'clicked':
+                this.analytics.trackEmailClicked(emailId, recipient, metadata?.url || '');
+                break;
+            case 'bounced':
+                this.analytics.trackEmailBounced(emailId, recipient, metadata?.reason || 'Unknown');
+                break;
+        }
+    }
+    // ======================
+    // Utility Methods
+    // ======================
+    /**
+     * Validate an email address
+     */
+    validateEmail(email) {
+        const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+        return emailRegex.test(email);
+    }
+    /**
+     * Generate a magic link for email authentication
+     */
+    async generateMagicLink(email, purpose, metadata) {
+        // TODO: Re-enable when magic-link package is properly built
+        throw new Error('Magic link functionality temporarily disabled');
+        // return this.magicLinkManager.generateMagicLink(email, purpose, {
+        //   metadata
+        // });
+    }
+    /**
+     * Verify a magic link
+     */
+    async verifyMagicLink(token) {
+        // TODO: Re-enable when magic-link package is properly built
+        throw new Error('Magic link functionality temporarily disabled');
+        // return this.magicLinkManager.validateToken(token);
+    }
+    /**
+     * Get overall system statistics
+     */
+    getSystemStats() {
+        return {
+            templates: this.templateManager.getStats(),
+            providers: this.providerManager.getStats(),
+            scheduler: this.scheduler.getStats(),
+            analytics: {
+                totalEvents: this.analytics.getEventCount()
+            }
+        };
+    }
+    /**
+     * Shutdown the email manager (cleanup resources)
+     */
+    shutdown() {
+        this.scheduler.stopScheduler();
+    }
+    // ======================
+    // Private Methods
+    // ======================
+    /**
+     * Initialize managers with configuration data
+     */
+    async initializeFromConfig() {
+        // Initialize providers
+        if (this.config.providers) {
+            for (const provider of this.config.providers) {
+                try {
+                    await this.providerManager.addProvider(provider);
+                }
+                catch (error) {
+                    console.error(`Failed to initialize provider ${provider.id}:`, error);
+                }
+            }
+        }
+        // Initialize templates
+        if (this.config.templates) {
+            for (const template of this.config.templates) {
+                try {
+                    await this.templateManager.createTemplate(template);
+                }
+                catch (error) {
+                    console.error(`Failed to initialize template ${template.id}:`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Get configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Update configuration
+     */
+    updateConfig(updates) {
+        this.config = { ...this.config, ...updates };
+        // Update dependent managers
+        if (updates.scheduling) {
+            this.scheduler.updateConfig(updates.scheduling);
+        }
+        if (updates.analytics) {
+            this.analytics.updateConfig(updates.analytics);
+        }
+    }
+}
+//# sourceMappingURL=email-manager.js.map

package/dist/email-manager.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { EmailManager } from './email-manager.js';
+export { TemplateManager } from './managers/template-manager.js';
+export { ProviderManager } from './managers/provider-manager.js';
+export { EmailScheduler } from './managers/email-scheduler.js';
+export { EmailAnalytics } from './managers/email-analytics.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAG/D,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/*
+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.
+*/
+// Main EmailManager class
+export { EmailManager } from './email-manager.js';
+// Manager classes (for advanced usage)
+export { TemplateManager } from './managers/template-manager.js';
+export { ProviderManager } from './managers/provider-manager.js';
+export { EmailScheduler } from './managers/email-scheduler.js';
+export { EmailAnalytics } from './managers/email-analytics.js';
+// Types and interfaces
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;EAME;AAEF,0BAA0B;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,uBAAuB;AACvB,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,92 @@
+import { EmailEvent, EmailStats, DeliveryReport, BounceReport, ReportOptions, AnalyticsConfig } from '../types.js';
+/**
+ * Email Analytics System
+ * Handles email performance tracking and reporting
+ */
+export declare class EmailAnalytics {
+    private events;
+    private stats;
+    private config;
+    constructor(config?: AnalyticsConfig);
+    /**
+     * Track email sent event
+     */
+    trackEmailSent(emailId: string, provider: string, recipient: string): void;
+    /**
+     * Track email delivered event
+     */
+    trackEmailDelivered(emailId: string, recipient: string): void;
+    /**
+     * Track email opened event
+     */
+    trackEmailOpened(emailId: string, recipient: string): void;
+    /**
+     * Track email clicked event
+     */
+    trackEmailClicked(emailId: string, recipient: string, url: string): void;
+    /**
+     * Track email bounced event
+     */
+    trackEmailBounced(emailId: string, recipient: string, reason: string): void;
+    /**
+     * Get email statistics for a specific email
+     */
+    getEmailStats(emailId: string): EmailStats;
+    /**
+     * Get delivery report for a time period
+     */
+    getDeliveryReport(options?: ReportOptions): DeliveryReport;
+    /**
+     * Get bounce report for a time period
+     */
+    getBounceReport(options?: ReportOptions): BounceReport;
+    /**
+     * Get analytics summary
+     */
+    getSummary(days?: number): any;
+    /**
+     * Get daily statistics for a period
+     */
+    private getDailyStats;
+    /**
+     * Record an event
+     */
+    private recordEvent;
+    /**
+     * Update email stats cache
+     */
+    private updateEmailStats;
+    /**
+     * Calculate delivery rate from events
+     */
+    private calculateDeliveryRate;
+    /**
+     * Calculate open rate from events
+     */
+    private calculateOpenRate;
+    /**
+     * Calculate click rate from events
+     */
+    private calculateClickRate;
+    /**
+     * Update analytics configuration
+     */
+    updateConfig(config: Partial<AnalyticsConfig>): void;
+    /**
+     * Export events data (for backup or migration)
+     */
+    exportEvents(): EmailEvent[];
+    /**
+     * Import events data (for restore or migration)
+     */
+    importEvents(events: EmailEvent[]): void;
+    /**
+     * Clear all analytics data (for testing)
+     */
+    clear(): void;
+    /**
+     * Get total event count
+     */
+    getEventCount(): number;
+}
+//# sourceMappingURL=email-analytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email-analytics.d.ts","sourceRoot":"","sources":["../../src/managers/email-analytics.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,UAAU,EACV,UAAU,EACV,cAAc,EACd,YAAY,EACZ,aAAa,EACb,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAAsC;IACnD,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,GAAE,eAMnB;IAID;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAc1E;;OAEG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAa7D;;OAEG;IACH,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAa1D;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAcxE;;OAEG;IACH,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAc3E;;OAEG;IACH,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU;IAgC1C;;OAEG;IACH,iBAAiB,CAAC,OAAO,GAAE,aAAkB,GAAG,cAAc;IAuC9D;;OAEG;IACH,eAAe,CAAC,OAAO,GAAE,aAAkB,GAAG,YAAY;IA8C1D;;OAEG;IACH,UAAU,CAAC,IAAI,GAAE,MAAW,GAAG,GAAG;IAwClC;;OAEG;IACH,OAAO,CAAC,aAAa;IA+BrB;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwCxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAM7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,IAAI;IAIpD;;OAEG;IACH,YAAY,IAAI,UAAU,EAAE;IAI5B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI;IAKxC;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,aAAa,IAAI,MAAM;CAGxB"}