@bernierllc/email-sender 0.2.0

package/dist/providers/sendgrid.js

@@ -0,0 +1,407 @@
+"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.SendGridProvider = void 0;
+/**
+ * SendGrid Email Provider implementation
+ */
+const base_1 = require("./base");
+class SendGridProvider extends base_1.EmailProvider {
+    constructor(config) {
+        super(config);
+        this.baseUrl = 'https://api.sendgrid.com/v3';
+        if (this.config.provider !== 'sendgrid') {
+            throw new Error('SendGridProvider requires provider to be "sendgrid"');
+        }
+        this.apiKey = this.config.apiKey || '';
+    }
+    /**
+     * 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(', ')}`,
+                };
+            }
+            // Prepare SendGrid mail data
+            const toRecipient = { email: email.toEmail };
+            if (email.toName) {
+                toRecipient.name = email.toName;
+            }
+            const fromAddress = {
+                email: email.fromEmail || this.config.fromEmail,
+            };
+            if (email.fromName) {
+                fromAddress.name = email.fromName;
+            }
+            else if (this.config.fromName) {
+                fromAddress.name = this.config.fromName;
+            }
+            const mailData = {
+                to: [toRecipient],
+                from: fromAddress,
+                subject: email.subject,
+                content: [],
+            };
+            // Add content
+            if (email.htmlContent) {
+                mailData.content.push({
+                    type: 'text/html',
+                    value: email.htmlContent,
+                });
+            }
+            if (email.textContent) {
+                mailData.content.push({
+                    type: 'text/plain',
+                    value: email.textContent,
+                });
+            }
+            // Add reply-to
+            if (email.replyTo) {
+                mailData.reply_to = { email: email.replyTo };
+            }
+            // Add headers
+            if (email.headers) {
+                mailData.headers = email.headers;
+            }
+            // Add attachments
+            if (email.attachments && email.attachments.length > 0) {
+                mailData.attachments = email.attachments.map(attachment => {
+                    const sendGridAttachment = {
+                        content: attachment.content,
+                        filename: attachment.filename,
+                    };
+                    if (attachment.contentType) {
+                        sendGridAttachment.type = attachment.contentType;
+                    }
+                    if (attachment.disposition) {
+                        sendGridAttachment.disposition = attachment.disposition;
+                    }
+                    return sendGridAttachment;
+                });
+            }
+            // Send email via SendGrid API
+            const response = await this.makeApiRequest('/mail/send', {
+                method: 'POST',
+                body: JSON.stringify(mailData),
+            });
+            if (response.statusCode >= 200 && response.statusCode < 300) {
+                const responseBody = JSON.parse(response.body);
+                return {
+                    success: true,
+                    messageId: responseBody.id || this.generateMessageId(),
+                    providerResponse: responseBody,
+                    metadata: {
+                        statusCode: response.statusCode,
+                        headers: response.headers,
+                    },
+                };
+            }
+            else {
+                const errorBody = JSON.parse(response.body);
+                return {
+                    success: false,
+                    errorMessage: errorBody.errors?.[0]?.message || `HTTP ${response.statusCode}`,
+                    providerResponse: errorBody,
+                };
+            }
+        }
+        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
+     */
+    async getDeliveryStatus(messageId) {
+        try {
+            const response = await this.makeApiRequest(`/messages/${messageId}`, {
+                method: 'GET',
+            });
+            if (response.statusCode === 200) {
+                const data = JSON.parse(response.body);
+                const deliveryStatus = {
+                    messageId,
+                    status: this.mapSendGridStatus(data.status),
+                    metadata: data,
+                };
+                if (data.delivered_at) {
+                    deliveryStatus.deliveredAt = new Date(data.delivered_at);
+                }
+                if (data.opened_at) {
+                    deliveryStatus.openedAt = new Date(data.opened_at);
+                }
+                if (data.clicked_at) {
+                    deliveryStatus.clickedAt = new Date(data.clicked_at);
+                }
+                if (data.bounced_at) {
+                    deliveryStatus.bouncedAt = new Date(data.bounced_at);
+                }
+                if (data.reason) {
+                    deliveryStatus.reason = data.reason;
+                }
+                return deliveryStatus;
+            }
+            return null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Process webhook events from SendGrid
+     */
+    async processWebhook(payload, signature) {
+        try {
+            // Verify webhook signature if secret is provided
+            if (this.config.webhookSecret) {
+                const isValid = this.verifyWebhookSignature(payload, signature);
+                if (!isValid) {
+                    throw new Error('Invalid webhook signature');
+                }
+            }
+            const events = [];
+            // SendGrid webhooks can be single event or array of events
+            const webhookEvents = Array.isArray(payload) ? payload : [payload];
+            for (const event of webhookEvents) {
+                events.push({
+                    messageId: event.sg_message_id,
+                    eventType: event.event,
+                    timestamp: new Date(event.timestamp * 1000),
+                    email: event.email,
+                    reason: event.reason,
+                    response: event.response,
+                    metadata: event,
+                });
+            }
+            return events;
+        }
+        catch (error) {
+            throw new Error(`Failed to process webhook: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Override capabilities for SendGrid
+     */
+    getCapabilities() {
+        return {
+            supportsBatch: true,
+            supportsTemplates: true,
+            supportsWebhooks: true,
+            supportsAttachments: true,
+            supportsDeliveryTracking: true,
+            maxBatchSize: 1000,
+            maxAttachmentSize: 30 * 1024 * 1024, // 30MB
+        };
+    }
+    /**
+     * Create a template in SendGrid
+     */
+    async createTemplate(templateData) {
+        try {
+            const response = await this.makeApiRequest('/templates', {
+                method: 'POST',
+                body: JSON.stringify({
+                    name: templateData.name,
+                    generation: 'dynamic',
+                }),
+            });
+            if (response.statusCode >= 200 && response.statusCode < 300) {
+                const data = JSON.parse(response.body);
+                const templateId = data.id;
+                // Create the template version
+                await this.makeApiRequest(`/templates/${templateId}/versions`, {
+                    method: 'POST',
+                    body: JSON.stringify({
+                        name: 'version_1',
+                        subject: templateData.subject,
+                        html_content: templateData.htmlContent,
+                        plain_content: templateData.textContent,
+                        active: 1,
+                    }),
+                });
+                return templateId;
+            }
+            else {
+                throw new Error(`Failed to create template: ${response.statusCode}`);
+            }
+        }
+        catch (error) {
+            throw new Error(`Failed to create template: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+    }
+    /**
+     * Send an email using a SendGrid template
+     */
+    async sendTemplateEmail(templateId, toEmail, templateData, toName) {
+        try {
+            const toRecipient = { email: toEmail };
+            if (toName) {
+                toRecipient.name = toName;
+            }
+            const fromAddress = {
+                email: this.config.fromEmail,
+            };
+            if (this.config.fromName) {
+                fromAddress.name = this.config.fromName;
+            }
+            const mailData = {
+                to: [toRecipient],
+                from: fromAddress,
+                subject: 'Template Email', // Subject is defined in template
+                content: [], // Required by SendGridMailData interface
+                template_id: templateId,
+                dynamic_template_data: templateData,
+            };
+            const response = await this.makeApiRequest('/mail/send', {
+                method: 'POST',
+                body: JSON.stringify(mailData),
+            });
+            if (response.statusCode >= 200 && response.statusCode < 300) {
+                const responseBody = JSON.parse(response.body);
+                return {
+                    success: true,
+                    messageId: responseBody.id || this.generateMessageId(),
+                    providerResponse: responseBody,
+                };
+            }
+            else {
+                const errorBody = JSON.parse(response.body);
+                return {
+                    success: false,
+                    errorMessage: errorBody.errors?.[0]?.message || `HTTP ${response.statusCode}`,
+                    providerResponse: errorBody,
+                };
+            }
+        }
+        catch (error) {
+            return {
+                success: false,
+                errorMessage: error instanceof Error ? error.message : 'Unknown error occurred',
+                providerResponse: error,
+            };
+        }
+    }
+    /**
+     * Test the SendGrid connection
+     */
+    async testConnection() {
+        try {
+            const response = await this.makeApiRequest('/user/profile', {
+                method: 'GET',
+            });
+            return response.statusCode === 200;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Override configuration validation for SendGrid
+     */
+    validateConfiguration() {
+        const errors = [];
+        const warnings = [];
+        if (!this.config.apiKey) {
+            errors.push('SendGrid API key is required');
+        }
+        if (!this.config.fromEmail) {
+            errors.push('fromEmail is required');
+        }
+        return {
+            isValid: errors.length === 0,
+            errors,
+            warnings,
+        };
+    }
+    /**
+     * Make API request to SendGrid
+     */
+    async makeApiRequest(endpoint, options) {
+        const url = `${this.baseUrl}${endpoint}`;
+        const response = await fetch(url, {
+            method: options.method,
+            headers: {
+                'Authorization': `Bearer ${this.apiKey}`,
+                'Content-Type': 'application/json',
+            },
+            body: options.body || null,
+        });
+        const body = await response.text();
+        return {
+            statusCode: response.status,
+            headers: Object.fromEntries(response.headers.entries()),
+            body,
+        };
+    }
+    /**
+     * Verify webhook signature
+     */
+    verifyWebhookSignature(_payload, _signature) {
+        // This is a simplified implementation
+        // In production, you should use crypto to verify the signature
+        // See: https://docs.sendgrid.com/for-developers/tracking-events/event#authentication
+        return true;
+    }
+    /**
+     * Map SendGrid status to our status enum
+     */
+    mapSendGridStatus(sendGridStatus) {
+        switch (sendGridStatus?.toLowerCase()) {
+            case 'delivered':
+                return 'delivered';
+            case 'bounce':
+                return 'bounced';
+            case 'dropped':
+                return 'failed';
+            case 'pending':
+                return 'pending';
+            case 'sent':
+                return 'sent';
+            case 'open':
+                return 'opened';
+            case 'click':
+                return 'clicked';
+            case 'spamreport':
+                return 'spam';
+            case 'unsubscribe':
+                return 'unsubscribed';
+            default:
+                return 'pending';
+        }
+    }
+    /**
+     * Generate a message ID for tracking
+     */
+    generateMessageId() {
+        return `sg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+}
+exports.SendGridProvider = SendGridProvider;
+//# sourceMappingURL=sendgrid.js.map

package/dist/providers/sendgrid.js.map

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

package/dist/providers/ses.d.ts

@@ -0,0 +1,38 @@
+/**
+ * AWS SES Email Provider
+ * Handles email sending through Amazon Simple Email Service
+ */
+import { EmailProvider } from './base';
+import type { EmailMessage, SendResult, EmailProviderConfig, EmailProviderCapabilities, EmailValidationResult, EmailTemplate, DeliveryStatus, WebhookEvent } from '../types';
+interface SesConfig extends EmailProviderConfig {
+    provider: 'ses';
+    apiKey: string;
+    secretKey: string;
+    region: string;
+    endpoint?: string;
+    sandbox?: boolean;
+}
+export declare class SesProvider extends EmailProvider {
+    private sesClient;
+    constructor(config: SesConfig);
+    private initializeClient;
+    sendEmail(message: EmailMessage): Promise<SendResult>;
+    sendBatch(emails: EmailMessage[]): Promise<SendResult[]>;
+    private sendBatchChunk;
+    sendTemplateEmail(templateId: string, toEmail: string, variables: Record<string, any>): Promise<SendResult>;
+    createTemplate(template: Omit<EmailTemplate, 'id' | 'createdAt' | 'updatedAt'>): Promise<string>;
+    updateTemplate(template: EmailTemplate): Promise<void>;
+    deleteTemplate(templateId: string): Promise<void>;
+    getTemplate(templateId: string): Promise<EmailTemplate | null>;
+    listTemplates(): Promise<EmailTemplate[]>;
+    getDeliveryStatus(messageId: string): Promise<DeliveryStatus | null>;
+    processWebhook(_payload: any, _signature: string): Promise<WebhookEvent[]>;
+    testConnection(): Promise<boolean>;
+    validateConfiguration(): EmailValidationResult;
+    validateEmailMessage(message: EmailMessage): EmailValidationResult;
+    getCapabilities(): EmailProviderCapabilities;
+    private convertToSesMessage;
+    private formatSesError;
+}
+export {};
+//# sourceMappingURL=ses.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ses.d.ts","sourceRoot":"","sources":["../../src/providers/ses.ts"],"names":[],"mappings":"AAQA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,KAAK,EACV,YAAY,EACZ,UAAU,EACV,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,YAAY,EACb,MAAM,UAAU,CAAC;AAElB,UAAU,SAAU,SAAQ,mBAAmB;IAC7C,QAAQ,EAAE,KAAK,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAkCD,qBAAa,WAAY,SAAQ,aAAa;IAC5C,OAAO,CAAC,SAAS,CAAM;gBAEX,MAAM,EAAE,SAAS;IAK7B,OAAO,CAAC,gBAAgB;IAiBlB,SAAS,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC;IAmCrD,SAAS,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;YA2BhD,cAAc;IAyCb,iBAAiB,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,OAAO,CAAC,UAAU,CAAC;IAuCP,cAAc,CAAC,QAAQ,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,WAAW,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBzG,cAAc,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBtD,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYjD,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IA2B9D,aAAa,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAkBhC,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAiBpE,cAAc,CAAC,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAM1E,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAUxC,qBAAqB,IAAI,qBAAqB;IA+B9C,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,qBAAqB;IA6BlE,eAAe,IAAI,yBAAyB;IAYrD,OAAO,CAAC,mBAAmB;IA4C3B,OAAO,CAAC,cAAc;CAsBvB"}