@bernierllc/email-sender 0.2.0

package/dist/providers/ses.js

@@ -0,0 +1,404 @@
+"use strict";
+/*
+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.
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SesProvider = void 0;
+/**
+ * AWS SES Email Provider
+ * Handles email sending through Amazon Simple Email Service
+ */
+const base_1 = require("./base");
+class SesProvider extends base_1.EmailProvider {
+    constructor(config) {
+        super(config);
+        this.initializeClient();
+    }
+    initializeClient() {
+        try {
+            // Dynamically import AWS SDK to avoid bundling issues
+            const AWS = require('aws-sdk');
+            this.sesClient = new AWS.SES({
+                accessKeyId: this.config.apiKey,
+                secretAccessKey: this.config.secretKey,
+                region: this.config.region,
+                endpoint: this.config.endpoint,
+                apiVersion: '2010-12-01'
+            });
+        }
+        catch (error) {
+            throw new Error(`Failed to initialize AWS SES client: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    async sendEmail(message) {
+        try {
+            const sesMessage = this.convertToSesMessage(message);
+            const params = {
+                ...sesMessage,
+                ConfigurationSetName: this.config.sandbox ? 'sandbox' : undefined
+            };
+            const result = await this.sesClient.sendEmail(params).promise();
+            return {
+                success: true,
+                messageId: result.MessageId,
+                providerResponse: result,
+                metadata: {
+                    provider: 'ses',
+                    region: this.config.region,
+                    timestamp: new Date().toISOString()
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                errorMessage: this.formatSesError(error),
+                providerResponse: error,
+                metadata: {
+                    provider: 'ses',
+                    region: this.config.region,
+                    timestamp: new Date().toISOString()
+                }
+            };
+        }
+    }
+    async sendBatch(emails) {
+        try {
+            const batchSize = Math.min(emails.length, this.getCapabilities().maxBatchSize);
+            const results = [];
+            // Process emails in batches
+            for (let i = 0; i < emails.length; i += batchSize) {
+                const batch = emails.slice(i, i + batchSize);
+                const batchResults = await this.sendBatchChunk(batch);
+                results.push(...batchResults);
+            }
+            return results;
+        }
+        catch (error) {
+            // If batch fails, return individual error results
+            return emails.map(() => ({
+                success: false,
+                errorMessage: this.formatSesError(error),
+                metadata: {
+                    provider: 'ses',
+                    region: this.config.region,
+                    timestamp: new Date().toISOString()
+                }
+            }));
+        }
+    }
+    async sendBatchChunk(emails) {
+        try {
+            const batchRequests = emails.map(email => ({
+                Id: `email-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+                ...this.convertToSesMessage(email)
+            }));
+            const params = {
+                Source: this.config.fromEmail,
+                Destinations: batchRequests
+            };
+            const result = await this.sesClient.sendBulkTemplatedEmail(params).promise();
+            return batchRequests.map((_, index) => {
+                const status = result.Status[index];
+                return {
+                    success: status.Status === 'Success',
+                    messageId: status.MessageId,
+                    errorMessage: status.Status === 'Failed' ? status.Error : undefined,
+                    providerResponse: status,
+                    metadata: {
+                        provider: 'ses',
+                        region: this.config.region,
+                        timestamp: new Date().toISOString()
+                    }
+                };
+            });
+        }
+        catch (error) {
+            return emails.map(() => ({
+                success: false,
+                errorMessage: this.formatSesError(error),
+                metadata: {
+                    provider: 'ses',
+                    region: this.config.region,
+                    timestamp: new Date().toISOString()
+                }
+            }));
+        }
+    }
+    async sendTemplateEmail(templateId, toEmail, variables) {
+        try {
+            const params = {
+                Source: this.config.fromEmail,
+                Destination: {
+                    ToAddresses: [toEmail]
+                },
+                Template: templateId,
+                TemplateData: JSON.stringify(variables)
+            };
+            const result = await this.sesClient.sendTemplatedEmail(params).promise();
+            return {
+                success: true,
+                messageId: result.MessageId,
+                providerResponse: result,
+                metadata: {
+                    provider: 'ses',
+                    region: this.config.region,
+                    templateId,
+                    timestamp: new Date().toISOString()
+                }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                errorMessage: this.formatSesError(error),
+                providerResponse: error,
+                metadata: {
+                    provider: 'ses',
+                    region: this.config.region,
+                    templateId,
+                    timestamp: new Date().toISOString()
+                }
+            };
+        }
+    }
+    async createTemplate(template) {
+        try {
+            const params = {
+                Template: {
+                    TemplateName: template.name,
+                    SubjectPart: template.subject,
+                    HtmlPart: template.htmlContent,
+                    TextPart: template.textContent
+                }
+            };
+            await this.sesClient.createTemplate(params).promise();
+            return template.name; // SES uses template name as ID
+        }
+        catch (error) {
+            throw new Error(`Failed to create SES template: ${this.formatSesError(error)}`);
+        }
+    }
+    async updateTemplate(template) {
+        try {
+            const params = {
+                Template: {
+                    TemplateName: template.id,
+                    SubjectPart: template.subject,
+                    HtmlPart: template.htmlContent,
+                    TextPart: template.textContent
+                }
+            };
+            await this.sesClient.updateTemplate(params).promise();
+        }
+        catch (error) {
+            throw new Error(`Failed to update SES template: ${this.formatSesError(error)}`);
+        }
+    }
+    async deleteTemplate(templateId) {
+        try {
+            const params = {
+                TemplateName: templateId
+            };
+            await this.sesClient.deleteTemplate(params).promise();
+        }
+        catch (error) {
+            throw new Error(`Failed to delete SES template: ${this.formatSesError(error)}`);
+        }
+    }
+    async getTemplate(templateId) {
+        try {
+            const params = {
+                TemplateName: templateId
+            };
+            const result = await this.sesClient.getTemplate(params).promise();
+            const template = result.Template;
+            return {
+                id: template.TemplateName,
+                name: template.TemplateName,
+                subject: template.SubjectPart,
+                htmlContent: template.HtmlPart,
+                textContent: template.TextPart,
+                variables: [], // SES doesn't provide variable list
+                createdAt: new Date(), // SES doesn't provide creation date
+                updatedAt: new Date() // SES doesn't provide update date
+            };
+        }
+        catch (error) {
+            if (error.code === 'TemplateDoesNotExist') {
+                return null;
+            }
+            throw new Error(`Failed to get SES template: ${this.formatSesError(error)}`);
+        }
+    }
+    async listTemplates() {
+        try {
+            const result = await this.sesClient.listTemplates().promise();
+            const templates = [];
+            for (const template of result.TemplatesMetadata || []) {
+                const fullTemplate = await this.getTemplate(template.Name);
+                if (fullTemplate) {
+                    templates.push(fullTemplate);
+                }
+            }
+            return templates;
+        }
+        catch (error) {
+            throw new Error(`Failed to list SES templates: ${this.formatSesError(error)}`);
+        }
+    }
+    async getDeliveryStatus(messageId) {
+        try {
+            // SES doesn't provide direct delivery status via API
+            // This would typically be handled via SNS notifications
+            return {
+                messageId,
+                status: 'sent', // Default status
+                metadata: {
+                    provider: 'ses',
+                    region: this.config.region
+                }
+            };
+        }
+        catch (error) {
+            return null;
+        }
+    }
+    async processWebhook(_payload, _signature) {
+        // SES uses SNS for webhooks, not direct webhooks
+        // This would need to be implemented based on SNS message format
+        return [];
+    }
+    async testConnection() {
+        try {
+            // Test by getting sending statistics
+            await this.sesClient.getSendStatistics().promise();
+            return true;
+        }
+        catch (error) {
+            return false;
+        }
+    }
+    validateConfiguration() {
+        const errors = [];
+        const warnings = [];
+        if (!this.config.apiKey) {
+            errors.push('AWS Access Key ID is required');
+        }
+        if (!this.config.secretKey) {
+            errors.push('AWS Secret Access Key is required');
+        }
+        if (!this.config.region) {
+            errors.push('AWS region is required');
+        }
+        if (!this.config.fromEmail) {
+            errors.push('From email is required');
+        }
+        if (this.config.sandbox) {
+            warnings.push('SES sandbox mode is enabled - emails can only be sent to verified addresses');
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    validateEmailMessage(message) {
+        const errors = [];
+        const warnings = [];
+        if (!message.toEmail) {
+            errors.push('Recipient email is required');
+        }
+        else if (!this.isValidEmail(message.toEmail)) {
+            errors.push('Invalid recipient email format');
+        }
+        if (!message.subject) {
+            errors.push('Email subject is required');
+        }
+        if (!message.htmlContent && !message.textContent) {
+            errors.push('Either HTML or text content is required');
+        }
+        if (message.attachments && message.attachments.length > 0) {
+            warnings.push('SES has limited attachment support - consider using S3 for large files');
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings
+        };
+    }
+    getCapabilities() {
+        return {
+            supportsBatch: true,
+            supportsTemplates: true,
+            supportsWebhooks: false, // SES uses SNS for notifications
+            supportsAttachments: true,
+            supportsDeliveryTracking: true,
+            maxBatchSize: 50,
+            maxAttachmentSize: 10 * 1024 * 1024 // 10MB
+        };
+    }
+    convertToSesMessage(message) {
+        const sesMessage = {
+            Source: message.fromEmail || this.config.fromEmail,
+            Destination: {
+                ToAddresses: [message.toEmail]
+            },
+            Message: {
+                Subject: {
+                    Data: message.subject,
+                    Charset: 'UTF-8'
+                },
+                Body: {}
+            }
+        };
+        if (message.htmlContent) {
+            sesMessage.Message.Body.Html = {
+                Data: message.htmlContent,
+                Charset: 'UTF-8'
+            };
+        }
+        if (message.textContent) {
+            sesMessage.Message.Body.Text = {
+                Data: message.textContent,
+                Charset: 'UTF-8'
+            };
+        }
+        if (message.replyTo) {
+            sesMessage.ReplyToAddresses = [message.replyTo];
+        }
+        if (message.headers) {
+            // Convert headers to SES tags
+            sesMessage.Tags = Object.entries(message.headers).map(([key, value]) => ({
+                Name: key,
+                Value: value
+            }));
+        }
+        return sesMessage;
+    }
+    formatSesError(error) {
+        if (error.code) {
+            switch (error.code) {
+                case 'MessageRejected':
+                    return 'Message rejected by SES';
+                case 'MailFromDomainNotVerified':
+                    return 'From domain is not verified in SES';
+                case 'ConfigurationSetDoesNotExist':
+                    return 'Configuration set does not exist';
+                case 'TemplateDoesNotExist':
+                    return 'Template does not exist';
+                case 'InvalidParameterValue':
+                    return 'Invalid parameter value provided';
+                default:
+                    return `SES Error (${error.code}): ${error.message || 'Unknown error'}`;
+            }
+        }
+        return error.message || 'Unknown SES error';
+    }
+}
+exports.SesProvider = SesProvider;
+//# sourceMappingURL=ses.js.map

package/dist/providers/ses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ses.js","sourceRoot":"","sources":["../../src/providers/ses.ts"],"names":[],"mappings":";AAAA;;;;;;EAME;;;AAEF;;;GAGG;AAEH,iCAAuC;AAqDvC,MAAa,WAAY,SAAQ,oBAAa;IAG5C,YAAY,MAAiB;QAC3B,KAAK,CAAC,MAAM,CAAC,CAAC;QACd,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAEO,gBAAgB;QACtB,IAAI,CAAC;YACH,sDAAsD;YACtD,MAAM,GAAG,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;YAE/B,IAAI,CAAC,SAAS,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC;gBAC3B,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC/B,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBACtC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC1B,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAC9B,UAAU,EAAE,YAAY;aACzB,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,wCAAwC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,EAAE,CAAC,CAAC;QACtH,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,OAAqB;QACnC,IAAI,CAAC;YACH,MAAM,UAAU,GAAG,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,CAAC;YAErD,MAAM,MAAM,GAAG;gBACb,GAAG,UAAU;gBACb,oBAAoB,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;aAClE,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YAEhE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,gBAAgB,EAAE,MAAM;gBACxB,QAAQ,EAAE;oBACR,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBACxC,gBAAgB,EAAE,KAAK;gBACvB,QAAQ,EAAE;oBACR,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,MAAsB;QACpC,IAAI,CAAC;YACH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,eAAe,EAAE,CAAC,YAAY,CAAC,CAAC;YAC/E,MAAM,OAAO,GAAiB,EAAE,CAAC;YAEjC,4BAA4B;YAC5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;gBAC7C,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;YAChC,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,kDAAkD;YAClD,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;gBACvB,OAAO,EAAE,KAAK;gBACd,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBACxC,QAAQ,EAAE;oBACR,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,MAAsB;QACjD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACzC,EAAE,EAAE,SAAS,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBACpE,GAAG,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;aACnC,CAAC,CAAC,CAAC;YAEJ,MAAM,MAAM,GAAG;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBAC7B,YAAY,EAAE,aAAa;aAC5B,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,sBAAsB,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YAE7E,OAAO,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE;gBACpC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACpC,OAAO;oBACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,SAAS;oBACpC,SAAS,EAAE,MAAM,CAAC,SAAS;oBAC3B,YAAY,EAAE,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;oBACnE,gBAAgB,EAAE,MAAM;oBACxB,QAAQ,EAAE;wBACR,QAAQ,EAAE,KAAK;wBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;wBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;qBACpC;iBACF,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;gBACvB,OAAO,EAAE,KAAK;gBACd,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBACxC,QAAQ,EAAE;oBACR,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC;IAEQ,KAAK,CAAC,iBAAiB,CAC9B,UAAkB,EAClB,OAAe,EACf,SAA8B;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;gBAC7B,WAAW,EAAE;oBACX,WAAW,EAAE,CAAC,OAAO,CAAC;iBACvB;gBACD,QAAQ,EAAE,UAAU;gBACpB,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC;aACxC,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YAEzE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,gBAAgB,EAAE,MAAM;gBACxB,QAAQ,EAAE;oBACR,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC1B,UAAU;oBACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,YAAY,EAAE,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC;gBACxC,gBAAgB,EAAE,KAAK;gBACvB,QAAQ,EAAE;oBACR,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;oBAC1B,UAAU;oBACV,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBACpC;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IAEQ,KAAK,CAAC,cAAc,CAAC,QAA+D;QAC3F,IAAI,CAAC;YACH,MAAM,MAAM,GAAG;gBACb,QAAQ,EAAE;oBACR,YAAY,EAAE,QAAQ,CAAC,IAAI;oBAC3B,WAAW,EAAE,QAAQ,CAAC,OAAO;oBAC7B,QAAQ,EAAE,QAAQ,CAAC,WAAW;oBAC9B,QAAQ,EAAE,QAAQ,CAAC,WAAW;iBAC/B;aACF,CAAC;YAEF,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YACtD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,+BAA+B;QACvD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,QAAuB;QAC1C,IAAI,CAAC;YACH,MAAM,MAAM,GAAG;gBACb,QAAQ,EAAE;oBACR,YAAY,EAAE,QAAQ,CAAC,EAAE;oBACzB,WAAW,EAAE,QAAQ,CAAC,OAAO;oBAC7B,QAAQ,EAAE,QAAQ,CAAC,WAAW;oBAC9B,QAAQ,EAAE,QAAQ,CAAC,WAAW;iBAC/B;aACF,CAAC;YAEF,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG;gBACb,YAAY,EAAE,UAAU;aACzB,CAAC;YAEF,MAAM,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAClF,CAAC;IACH,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,UAAkB;QAClC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG;gBACb,YAAY,EAAE,UAAU;aACzB,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC;YAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;YAEjC,OAAO;gBACL,EAAE,EAAE,QAAQ,CAAC,YAAY;gBACzB,IAAI,EAAE,QAAQ,CAAC,YAAY;gBAC3B,OAAO,EAAE,QAAQ,CAAC,WAAW;gBAC7B,WAAW,EAAE,QAAQ,CAAC,QAAQ;gBAC9B,WAAW,EAAE,QAAQ,CAAC,QAAQ;gBAC9B,SAAS,EAAE,EAAE,EAAE,oCAAoC;gBACnD,SAAS,EAAE,IAAI,IAAI,EAAE,EAAE,oCAAoC;gBAC3D,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,kCAAkC;aACzD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,IAAI,KAAK,CAAC,IAAI,KAAK,sBAAsB,EAAE,CAAC;gBAC1C,OAAO,IAAI,CAAC;YACd,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,+BAA+B,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC;YAE9D,MAAM,SAAS,GAAoB,EAAE,CAAC;YACtC,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,iBAAiB,IAAI,EAAE,EAAE,CAAC;gBACtD,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;gBAC3D,IAAI,YAAY,EAAE,CAAC;oBACjB,SAAS,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;gBAC/B,CAAC;YACH,CAAC;YAED,OAAO,SAAS,CAAC;QACnB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,iCAAiC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACjF,CAAC;IACH,CAAC;IAEQ,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QAChD,IAAI,CAAC;YACH,qDAAqD;YACrD,wDAAwD;YACxD,OAAO;gBACL,SAAS;gBACT,MAAM,EAAE,MAAM,EAAE,iBAAiB;gBACjC,QAAQ,EAAE;oBACR,QAAQ,EAAE,KAAK;oBACf,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;iBAC3B;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEQ,KAAK,CAAC,cAAc,CAAC,QAAa,EAAE,UAAkB;QAC7D,iDAAiD;QACjD,gEAAgE;QAChE,OAAO,EAAE,CAAC;IACZ,CAAC;IAEQ,KAAK,CAAC,cAAc;QAC3B,IAAI,CAAC;YACH,qCAAqC;YACrC,MAAM,IAAI,CAAC,SAAS,CAAC,iBAAiB,EAAE,CAAC,OAAO,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAEQ,qBAAqB;QAC5B,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC;QACnD,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxC,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,6EAA6E,CAAC,CAAC;QAC/F,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAEQ,oBAAoB,CAAC,OAAqB;QACjD,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAa,EAAE,CAAC;QAE9B,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC7C,CAAC;aAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC/C,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAChD,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACrB,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;YACjD,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1D,QAAQ,CAAC,IAAI,CAAC,wEAAwE,CAAC,CAAC;QAC1F,CAAC;QAED,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC;YAC5B,MAAM;YACN,QAAQ;SACT,CAAC;IACJ,CAAC;IAEQ,eAAe;QACtB,OAAO;YACL,aAAa,EAAE,IAAI;YACnB,iBAAiB,EAAE,IAAI;YACvB,gBAAgB,EAAE,KAAK,EAAE,iCAAiC;YAC1D,mBAAmB,EAAE,IAAI;YACzB,wBAAwB,EAAE,IAAI;YAC9B,YAAY,EAAE,EAAE;YAChB,iBAAiB,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO;SAC5C,CAAC;IACJ,CAAC;IAEO,mBAAmB,CAAC,OAAqB;QAC/C,MAAM,UAAU,GAAoB;YAClC,MAAM,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS;YAClD,WAAW,EAAE;gBACX,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC;aAC/B;YACD,OAAO,EAAE;gBACP,OAAO,EAAE;oBACP,IAAI,EAAE,OAAO,CAAC,OAAO;oBACrB,OAAO,EAAE,OAAO;iBACjB;gBACD,IAAI,EAAE,EAAE;aACT;SACF,CAAC;QAEF,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG;gBAC7B,IAAI,EAAE,OAAO,CAAC,WAAW;gBACzB,OAAO,EAAE,OAAO;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG;gBAC7B,IAAI,EAAE,OAAO,CAAC,WAAW;gBACzB,OAAO,EAAE,OAAO;aACjB,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,UAAU,CAAC,gBAAgB,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAClD,CAAC;QAED,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,8BAA8B;YAC9B,UAAU,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;gBACvE,IAAI,EAAE,GAAG;gBACT,KAAK,EAAE,KAAK;aACb,CAAC,CAAC,CAAC;QACN,CAAC;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAEO,cAAc,CAAC,KAAU;QAC/B,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;YACf,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;gBACnB,KAAK,iBAAiB;oBACpB,OAAO,yBAAyB,CAAC;gBACnC,KAAK,2BAA2B;oBAC9B,OAAO,oCAAoC,CAAC;gBAC9C,KAAK,8BAA8B;oBACjC,OAAO,kCAAkC,CAAC;gBAC5C,KAAK,sBAAsB;oBACzB,OAAO,yBAAyB,CAAC;gBACnC,KAAK,uBAAuB;oBAC1B,OAAO,kCAAkC,CAAC;gBAC5C;oBACE,OAAO,cAAc,KAAK,CAAC,IAAI,MAAM,KAAK,CAAC,OAAO,IAAI,eAAe,EAAE,CAAC;YAC5E,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAC,OAAO,IAAI,mBAAmB,CAAC;IAC9C,CAAC;CAGF;AAlbD,kCAkbC"}

package/dist/providers/smtp.d.ts

@@ -0,0 +1,61 @@
+import { EmailProvider } from './base';
+import { EmailMessage, SendResult, DeliveryStatus, WebhookEvent, EmailProviderConfig } from '../types';
+export declare class SmtpProvider extends EmailProvider {
+    private transporter;
+    constructor(config: EmailProviderConfig);
+    /**
+     * Initialize the nodemailer transporter
+     */
+    private initializeTransporter;
+    /**
+     * Send a single email
+     */
+    sendEmail(email: EmailMessage): Promise<SendResult>;
+    /**
+     * Send multiple emails
+     */
+    sendBatch(emails: EmailMessage[]): Promise<SendResult[]>;
+    /**
+     * Get delivery status for a message
+     * Note: SMTP doesn't provide delivery tracking by default
+     */
+    getDeliveryStatus(_messageId: string): Promise<DeliveryStatus | null>;
+    /**
+     * Process webhook events from the provider
+     * Note: SMTP doesn't support webhooks by default
+     */
+    processWebhook(_payload: any, _signature: string): Promise<WebhookEvent[]>;
+    /**
+     * Override capabilities for SMTP
+     */
+    getCapabilities(): {
+        supportsBatch: boolean;
+        supportsTemplates: boolean;
+        supportsWebhooks: boolean;
+        supportsAttachments: boolean;
+        supportsDeliveryTracking: boolean;
+        maxBatchSize: number;
+        maxAttachmentSize: number;
+    };
+    /**
+     * Test the SMTP connection
+     */
+    testConnection(): Promise<boolean>;
+    /**
+     * Format from address
+     */
+    private formatFromAddress;
+    /**
+     * Format to address
+     */
+    private formatToAddress;
+    /**
+     * Override configuration validation for SMTP
+     */
+    validateConfiguration(): {
+        isValid: boolean;
+        errors: string[];
+        warnings: string[];
+    };
+}
+//# sourceMappingURL=smtp.d.ts.map

package/dist/providers/smtp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.d.ts","sourceRoot":"","sources":["../../src/providers/smtp.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEvG,qBAAa,YAAa,SAAQ,aAAa;IAC7C,OAAO,CAAC,WAAW,CAAuC;gBAE9C,MAAM,EAAE,mBAAmB;IAKvC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAkB7B;;OAEG;IACG,SAAS,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IA0DzD;;OAEG;IACG,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAW9D;;;OAGG;IACG,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAK3E;;;OAGG;IACG,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAKhF;;OAEG;IACM,eAAe;;;;;;;;;IAYxB;;OAEG;IACY,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAajD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACM,qBAAqB;;;;;CA0B/B"}

package/dist/providers/smtp.js

@@ -0,0 +1,201 @@
+"use strict";
+/*
+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.
+*/
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmtpProvider = void 0;
+/**
+ * SMTP Email Provider implementation using nodemailer
+ */
+const nodemailer_1 = __importDefault(require("nodemailer"));
+const base_1 = require("./base");
+class SmtpProvider extends base_1.EmailProvider {
+    constructor(config) {
+        super(config);
+        this.transporter = null;
+        this.initializeTransporter();
+    }
+    /**
+     * Initialize the nodemailer transporter
+     */
+    initializeTransporter() {
+        if (this.config.provider !== 'smtp') {
+            throw new Error('SmtpProvider requires provider to be "smtp"');
+        }
+        const smtpConfig = {
+            host: this.config.host,
+            port: this.config.port,
+            secure: this.config.secure ?? false,
+            auth: {
+                user: this.config.username,
+                pass: this.config.password,
+            },
+        };
+        this.transporter = nodemailer_1.default.createTransport(smtpConfig);
+    }
+    /**
+     * Send a single email
+     */
+    async sendEmail(email) {
+        try {
+            // Validate email message
+            const validation = this.validateEmailMessage(email);
+            if (!validation.isValid) {
+                return {
+                    success: false,
+                    errorMessage: `Email validation failed: ${validation.errors.join(', ')}`,
+                };
+            }
+            if (!this.transporter) {
+                throw new Error('SMTP transporter not initialized');
+            }
+            // Prepare nodemailer options
+            const mailOptions = {
+                from: this.formatFromAddress(email.fromEmail, email.fromName),
+                to: this.formatToAddress(email.toEmail, email.toName),
+                subject: email.subject,
+                html: email.htmlContent,
+                text: email.textContent,
+                replyTo: email.replyTo,
+                headers: email.headers,
+            };
+            // Add attachments if present
+            if (email.attachments && email.attachments.length > 0) {
+                mailOptions.attachments = email.attachments.map(attachment => ({
+                    filename: attachment.filename,
+                    content: Buffer.from(attachment.content, 'base64'),
+                    contentType: attachment.contentType,
+                    contentDisposition: attachment.disposition,
+                }));
+            }
+            // Send email
+            const result = await this.transporter.sendMail(mailOptions);
+            return {
+                success: true,
+                messageId: result.messageId,
+                providerResponse: result,
+                metadata: {
+                    accepted: result.accepted,
+                    rejected: result.rejected,
+                    response: result.response,
+                },
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                errorMessage: error instanceof Error ? error.message : 'Unknown error occurred',
+                providerResponse: error,
+            };
+        }
+    }
+    /**
+     * Send multiple emails
+     */
+    async sendBatch(emails) {
+        const results = [];
+        for (const email of emails) {
+            const result = await this.sendEmail(email);
+            results.push(result);
+        }
+        return results;
+    }
+    /**
+     * Get delivery status for a message
+     * Note: SMTP doesn't provide delivery tracking by default
+     */
+    async getDeliveryStatus(_messageId) {
+        // SMTP doesn't provide delivery tracking
+        return null;
+    }
+    /**
+     * Process webhook events from the provider
+     * Note: SMTP doesn't support webhooks by default
+     */
+    async processWebhook(_payload, _signature) {
+        // SMTP doesn't support webhooks
+        return [];
+    }
+    /**
+     * Override capabilities for SMTP
+     */
+    getCapabilities() {
+        return {
+            supportsBatch: true,
+            supportsTemplates: false,
+            supportsWebhooks: false,
+            supportsAttachments: true,
+            supportsDeliveryTracking: false,
+            maxBatchSize: 100,
+            maxAttachmentSize: 25 * 1024 * 1024, // 25MB
+        };
+    }
+    /**
+     * Test the SMTP connection
+     */
+    async testConnection() {
+        try {
+            if (!this.transporter) {
+                return false;
+            }
+            await this.transporter.verify();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Format from address
+     */
+    formatFromAddress(email, name) {
+        const fromEmail = email || this.config.fromEmail;
+        const fromName = name || this.config.fromName;
+        if (fromName) {
+            return `"${fromName}" <${fromEmail}>`;
+        }
+        return fromEmail;
+    }
+    /**
+     * Format to address
+     */
+    formatToAddress(email, name) {
+        if (name) {
+            return `"${name}" <${email}>`;
+        }
+        return email;
+    }
+    /**
+     * Override configuration validation for SMTP
+     */
+    validateConfiguration() {
+        const errors = [];
+        const warnings = [];
+        if (!this.config.host) {
+            errors.push('SMTP host is required');
+        }
+        if (!this.config.port) {
+            errors.push('SMTP port is required');
+        }
+        if (this.config.username && !this.config.password) {
+            warnings.push('SMTP username provided but no password');
+        }
+        if (this.config.password && !this.config.username) {
+            warnings.push('SMTP password provided but no username');
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+}
+exports.SmtpProvider = SmtpProvider;
+//# sourceMappingURL=smtp.js.map