@groundbrick/email-service 1.1.2 → 1.1.4

package/dist/providers/MockEmailProvider.js

@@ -0,0 +1,194 @@
+import { EmailStatus } from '../interfaces/IEmailProvider.js';
+export class MockEmailProvider {
+    simulateDelay;
+    simulateFailures;
+    defaultFrom;
+    sentEmails = new Map();
+    messageIdCounter = 1;
+    constructor(config) {
+        this.simulateDelay = config.simulateDelay || 0;
+        this.simulateFailures = config.simulateFailures || false;
+        this.defaultFrom = config.defaultFrom;
+    }
+    async send(message) {
+        // Simulate network delay
+        if (this.simulateDelay > 0) {
+            await this.delay(this.simulateDelay);
+        }
+        // Simulate random failures (10% chance)
+        if (this.simulateFailures && Math.random() < 0.1) {
+            return {
+                success: false,
+                status: EmailStatus.FAILED,
+                timestamp: new Date(),
+                error: 'Simulated failure'
+            };
+        }
+        // Generate message ID
+        const messageId = `mock-${this.messageIdCounter++}-${Date.now()}`;
+        // Store sent email
+        const sentEmail = {
+            id: messageId,
+            message,
+            sentAt: new Date(),
+            status: EmailStatus.DELIVERED
+        };
+        this.sentEmails.set(messageId, sentEmail);
+        // Log email (useful for debugging)
+        this.logEmail(messageId, message);
+        return {
+            success: true,
+            messageId,
+            status: EmailStatus.DELIVERED,
+            timestamp: new Date(),
+            providerResponse: { mock: true, stored: true }
+        };
+    }
+    async getDeliveryReport(messageId) {
+        const sentEmail = this.sentEmails.get(messageId);
+        if (!sentEmail) {
+            return null;
+        }
+        const recipient = Array.isArray(sentEmail.message.to)
+            ? sentEmail.message.to[0].address
+            : sentEmail.message.to.address;
+        return {
+            messageId,
+            status: sentEmail.status,
+            timestamp: sentEmail.sentAt,
+            recipient,
+            providerData: { mock: true }
+        };
+    }
+    validateWebhook(payload, signature, _options) {
+        // Mock provider doesn't validate webhooks
+        return {
+            isValid: false,
+            error: 'Mock provider does not support webhooks'
+        };
+    }
+    /**
+     * Get all sent emails (useful for testing)
+     */
+    getSentEmails() {
+        return Array.from(this.sentEmails.values());
+    }
+    /**
+     * Clear all sent emails (useful for testing)
+     */
+    clearSentEmails() {
+        this.sentEmails.clear();
+        this.messageIdCounter = 1;
+    }
+    /**
+     * Get a specific sent email by ID (useful for testing)
+     */
+    getSentEmail(messageId) {
+        return this.sentEmails.get(messageId);
+    }
+    /**
+     * Log email to console (only in development)
+     */
+    logEmail(messageId, message) {
+        const recipients = Array.isArray(message.to)
+            ? message.to.map(t => t.address).join(', ')
+            : message.to.address;
+        console.log('\n' + '='.repeat(80));
+        console.log('📧 MOCK EMAIL SENT');
+        console.log('='.repeat(80));
+        console.log(`Message ID: ${messageId}`);
+        console.log(`From: ${message.from?.address || this.defaultFrom.address}`);
+        console.log(`To: ${recipients}`);
+        if (message.cc && message.cc.length > 0) {
+            console.log(`CC: ${message.cc.map(c => c.address).join(', ')}`);
+        }
+        if (message.bcc && message.bcc.length > 0) {
+            console.log(`BCC: ${message.bcc.map(b => b.address).join(', ')}`);
+        }
+        console.log(`Subject: ${message.subject}`);
+        console.log('-'.repeat(80));
+        if (message.html) {
+            // Extract plain text from HTML for better readability
+            const plainText = this.htmlToPlainText(message.html);
+            console.log('📄 EMAIL CONTENT (Plain Text):');
+            console.log(plainText);
+            // Try to extract 2FA code if present
+            const code = this.extract2FACode(message.html);
+            if (code) {
+                console.log('\n' + '🔑 '.repeat(20));
+                console.log(`🔐 2FA CODE DETECTED: ${code}`);
+                console.log('🔑 '.repeat(20));
+            }
+        }
+        else if (message.text) {
+            console.log('📄 EMAIL CONTENT:');
+            console.log(message.text);
+            // Try to extract 2FA code from text
+            const code = this.extract2FACode(message.text);
+            if (code) {
+                console.log('\n' + '🔑 '.repeat(20));
+                console.log(`🔐 2FA CODE DETECTED: ${code}`);
+                console.log('🔑 '.repeat(20));
+            }
+        }
+        if (message.attachments && message.attachments.length > 0) {
+            console.log(`\n📎 Attachments: ${message.attachments.length} file(s)`);
+            message.attachments.forEach((att, i) => {
+                console.log(`  ${i + 1}. ${att.filename} (${att.contentType})`);
+            });
+        }
+        console.log('='.repeat(80) + '\n');
+    }
+    /**
+     * Convert HTML to plain text (basic implementation)
+     */
+    htmlToPlainText(html) {
+        return html
+            // Remove scripts and styles
+            .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+            .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+            // Replace block elements with newlines
+            .replace(/<\/?(div|p|br|h[1-6]|li|tr)[^>]*>/gi, '\n')
+            // Remove all other HTML tags
+            .replace(/<[^>]+>/g, '')
+            // Decode HTML entities
+            .replace(/&nbsp;/g, ' ')
+            .replace(/&amp;/g, '&')
+            .replace(/&lt;/g, '<')
+            .replace(/&gt;/g, '>')
+            .replace(/&quot;/g, '"')
+            // Clean up whitespace
+            .replace(/\n\s*\n/g, '\n\n')
+            .trim();
+    }
+    /**
+     * Extract 2FA/verification code from email content
+     * Looks for 6-digit codes commonly used in 2FA
+     */
+    extract2FACode(content) {
+        // Try to find 6-digit code in common patterns
+        const patterns = [
+            /\b(\d{6})\b/, // Simple 6 digits
+            /code.*?(\d{6})/i, // "code: 123456"
+            /verification.*?(\d{6})/i, // "verification code: 123456"
+            /login.*?code.*?(\d{6})/i, // "login code: 123456"
+            /<div[^>]*>(\d{6})<\/div>/i, // In a div
+            /font-size:\s*32px[^>]*>(\d{6})</i, // Large font (common for codes)
+            /letter-spacing[^>]*>(\d{6})</i // Letter-spaced (common for codes)
+        ];
+        for (const pattern of patterns) {
+            const match = content.match(pattern);
+            if (match && match[1]) {
+                return match[1];
+            }
+        }
+        return null;
+    }
+    /**
+     * Simple delay helper
+     */
+    delay(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+}
+//# sourceMappingURL=MockEmailProvider.js.map

package/dist/providers/MockEmailProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockEmailProvider.js","sourceRoot":"","sources":["../../src/providers/MockEmailProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAOH,WAAW,EAGd,MAAM,iCAAiC,CAAC;AASzC,MAAM,OAAO,iBAAiB;IAClB,aAAa,CAAS;IACtB,gBAAgB,CAAU;IAC1B,WAAW,CAAe;IAC1B,UAAU,GAA2B,IAAI,GAAG,EAAE,CAAC;IAC/C,gBAAgB,GAAG,CAAC,CAAC;IAE7B,YAAY,MAAuB;QAC/B,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,aAAa,IAAI,CAAC,CAAC;QAC/C,IAAI,CAAC,gBAAgB,GAAG,MAAM,CAAC,gBAAgB,IAAI,KAAK,CAAC;QACzD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAqB;QAC5B,yBAAyB;QACzB,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzC,CAAC;QAED,wCAAwC;QACxC,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;YAC/C,OAAO;gBACH,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,WAAW,CAAC,MAAM;gBAC1B,SAAS,EAAE,IAAI,IAAI,EAAE;gBACrB,KAAK,EAAE,mBAAmB;aAC7B,CAAC;QACN,CAAC;QAED,sBAAsB;QACtB,MAAM,SAAS,GAAG,QAAQ,IAAI,CAAC,gBAAgB,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;QAElE,mBAAmB;QACnB,MAAM,SAAS,GAAc;YACzB,EAAE,EAAE,SAAS;YACb,OAAO;YACP,MAAM,EAAE,IAAI,IAAI,EAAE;YAClB,MAAM,EAAE,WAAW,CAAC,SAAS;SAChC,CAAC;QAEF,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAE1C,mCAAmC;QACnC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAElC,OAAO;YACH,OAAO,EAAE,IAAI;YACb,SAAS;YACT,MAAM,EAAE,WAAW,CAAC,SAAS;YAC7B,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,gBAAgB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;SACjD,CAAC;IACN,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,SAAiB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAEjD,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;YACjD,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO;YACjC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;QAEnC,OAAO;YACH,SAAS;YACT,MAAM,EAAE,SAAS,CAAC,MAAM;YACxB,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,SAAS;YACT,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;SAC/B,CAAC;IACN,CAAC;IAED,eAAe,CACX,OAAY,EACZ,SAAkB,EAClB,QAAmC;QAEnC,0CAA0C;QAC1C,OAAO;YACH,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,yCAAyC;SACnD,CAAC;IACN,CAAC;IAED;;OAEG;IACH,aAAa;QACT,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,eAAe;QACX,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,gBAAgB,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAiB;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED;;OAEG;IACK,QAAQ,CAAC,SAAiB,EAAE,OAAqB;QACrD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC;QAEzB,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACnC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;QAClC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5B,OAAO,CAAC,GAAG,CAAC,eAAe,SAAS,EAAE,CAAC,CAAC;QACxC,OAAO,CAAC,GAAG,CAAC,SAAS,OAAO,CAAC,IAAI,EAAE,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E,OAAO,CAAC,GAAG,CAAC,OAAO,UAAU,EAAE,CAAC,CAAC;QACjC,IAAI,OAAO,CAAC,EAAE,IAAI,OAAO,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,OAAO,OAAO,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QAE5B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,sDAAsD;YACtD,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrD,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YAEvB,qCAAqC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,IAAI,EAAE,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;QACL,CAAC;aAAM,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACtB,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;YACjC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAE1B,oCAAoC;YACpC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC/C,IAAI,IAAI,EAAE,CAAC;gBACP,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;gBACrC,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;gBAC7C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;YAClC,CAAC;QACL,CAAC;QAED,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxD,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,WAAW,CAAC,MAAM,UAAU,CAAC,CAAC;YACvE,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;gBACnC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC,QAAQ,KAAK,GAAG,CAAC,WAAW,GAAG,CAAC,CAAC;YACpE,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;OAEG;IACK,eAAe,CAAC,IAAY;QAChC,OAAO,IAAI;YACP,4BAA4B;aAC3B,OAAO,CAAC,qDAAqD,EAAE,EAAE,CAAC;aAClE,OAAO,CAAC,kDAAkD,EAAE,EAAE,CAAC;YAChE,uCAAuC;aACtC,OAAO,CAAC,qCAAqC,EAAE,IAAI,CAAC;YACrD,6BAA6B;aAC5B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;YACxB,uBAAuB;aACtB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;aACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;aACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;aACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;aACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;YACxB,sBAAsB;aACrB,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC;aAC3B,IAAI,EAAE,CAAC;IAChB,CAAC;IAED;;;OAGG;IACK,cAAc,CAAC,OAAe;QAClC,8CAA8C;QAC9C,MAAM,QAAQ,GAAG;YACb,aAAa,EAA4B,kBAAkB;YAC3D,iBAAiB,EAAwB,iBAAiB;YAC1D,yBAAyB,EAAgB,8BAA8B;YACvE,yBAAyB,EAAgB,uBAAuB;YAChE,2BAA2B,EAAa,WAAW;YACnD,kCAAkC,EAAM,gCAAgC;YACxE,+BAA+B,CAAS,mCAAmC;SAC9E,CAAC;QAEF,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC7B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrC,IAAI,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;gBACpB,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,EAAU;QACpB,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;CACJ"}

package/dist/providers/RedirectEmailProvider.d.ts

@@ -0,0 +1,28 @@
+import { IEmailProvider, EmailMessage, EmailResult, DeliveryReport, WebhookValidationResult, RedirectEmailConfig, WebhookValidationOptions } from '../interfaces/IEmailProvider.js';
+/**
+ * RedirectEmailProvider wraps another provider and redirects all emails to a specific address.
+ * Useful for development/testing to prevent accidentally sending emails to real users.
+ */
+export declare class RedirectEmailProvider implements IEmailProvider {
+    private redirectTo;
+    private defaultFrom;
+    private addOriginalToSubject;
+    private baseProvider;
+    constructor(config: RedirectEmailConfig);
+    send(message: EmailMessage): Promise<EmailResult>;
+    getDeliveryReport(messageId: string): Promise<DeliveryReport | null>;
+    validateWebhook(payload: any, signature?: string, options?: WebhookValidationOptions): WebhookValidationResult;
+    /**
+     * Extract all original recipients from the message
+     */
+    private getOriginalRecipients;
+    /**
+     * Add a notice to the email body about the redirection
+     */
+    private addRedirectNotice;
+    /**
+     * Simple HTML escape for security
+     */
+    private escapeHtml;
+}
+//# sourceMappingURL=RedirectEmailProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RedirectEmailProvider.d.ts","sourceRoot":"","sources":["../../src/providers/RedirectEmailProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,mBAAmB,EAEnB,wBAAwB,EAC3B,MAAM,iCAAiC,CAAC;AAGzC;;;GAGG;AACH,qBAAa,qBAAsB,YAAW,cAAc;IACxD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAAe;IAClC,OAAO,CAAC,oBAAoB,CAAU;IACtC,OAAO,CAAC,YAAY,CAAiB;gBAEzB,MAAM,EAAE,mBAAmB;IAWjC,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAI1E,eAAe,CACX,OAAO,EAAE,GAAG,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,wBAAwB,GACnC,uBAAuB;IAI1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAoB7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0BzB;;OAEG;IACH,OAAO,CAAC,UAAU;CAUrB"}

package/dist/providers/RedirectEmailProvider.js

@@ -0,0 +1,108 @@
+import { MockEmailProvider } from './MockEmailProvider.js';
+/**
+ * RedirectEmailProvider wraps another provider and redirects all emails to a specific address.
+ * Useful for development/testing to prevent accidentally sending emails to real users.
+ */
+export class RedirectEmailProvider {
+    redirectTo;
+    defaultFrom;
+    addOriginalToSubject;
+    baseProvider;
+    constructor(config) {
+        this.redirectTo = config.redirectTo;
+        this.defaultFrom = config.defaultFrom;
+        this.addOriginalToSubject = config.addOriginalToSubject ?? true;
+        // Use provided base provider or default to MockEmailProvider
+        this.baseProvider = config.baseProvider || new MockEmailProvider({
+            defaultFrom: config.defaultFrom
+        });
+    }
+    async send(message) {
+        // Build list of original recipients for logging
+        const originalRecipients = this.getOriginalRecipients(message);
+        // Create modified message that redirects to the configured address
+        const redirectedMessage = {
+            ...message,
+            to: { address: this.redirectTo },
+            cc: undefined, // Clear CC
+            bcc: undefined, // Clear BCC
+            subject: this.addOriginalToSubject
+                ? `[REDIRECTED] ${message.subject} (Original: ${originalRecipients})`
+                : message.subject
+        };
+        // Add original recipients info to the email body
+        if (message.html) {
+            redirectedMessage.html = this.addRedirectNotice(message.html, originalRecipients, 'html');
+        }
+        if (message.text) {
+            redirectedMessage.text = this.addRedirectNotice(message.text, originalRecipients, 'text');
+        }
+        // Send via base provider
+        return this.baseProvider.send(redirectedMessage);
+    }
+    async getDeliveryReport(messageId) {
+        return this.baseProvider.getDeliveryReport(messageId);
+    }
+    validateWebhook(payload, signature, options) {
+        return this.baseProvider.validateWebhook(payload, signature, options);
+    }
+    /**
+     * Extract all original recipients from the message
+     */
+    getOriginalRecipients(message) {
+        const recipients = [];
+        // Add 'to' recipients
+        const toAddresses = Array.isArray(message.to) ? message.to : [message.to];
+        recipients.push(...toAddresses.map(addr => addr.address));
+        // Add CC recipients
+        if (message.cc && message.cc.length > 0) {
+            recipients.push(...message.cc.map(addr => `CC: ${addr.address}`));
+        }
+        // Add BCC recipients
+        if (message.bcc && message.bcc.length > 0) {
+            recipients.push(...message.bcc.map(addr => `BCC: ${addr.address}`));
+        }
+        return recipients.join(', ');
+    }
+    /**
+     * Add a notice to the email body about the redirection
+     */
+    addRedirectNotice(content, originalRecipients, type) {
+        const notice = type === 'html'
+            ? `
+                <div style="background-color: #fff3cd; border: 1px solid #ffc107; padding: 15px; margin-bottom: 20px; border-radius: 5px;">
+                    <strong>⚠️ EMAIL REDIRECTED (Development Mode)</strong><br>
+                    <p style="margin: 5px 0 0 0;">
+                        This email was redirected from the original recipients:<br>
+                        <strong>${this.escapeHtml(originalRecipients)}</strong>
+                    </p>
+                </div>
+                ${content}
+            `
+            : `
+========================================
+⚠️  EMAIL REDIRECTED (Development Mode)
+========================================
+This email was redirected from the original recipients:
+${originalRecipients}
+========================================
+
+${content}
+            `;
+        return notice;
+    }
+    /**
+     * Simple HTML escape for security
+     */
+    escapeHtml(text) {
+        const map = {
+            '&': '&amp;',
+            '<': '&lt;',
+            '>': '&gt;',
+            '"': '&quot;',
+            "'": '&#039;'
+        };
+        return text.replace(/[&<>"']/g, char => map[char]);
+    }
+}
+//# sourceMappingURL=RedirectEmailProvider.js.map

package/dist/providers/RedirectEmailProvider.js.map

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

package/dist/providers/SweegoEmailProvider.d.ts

@@ -0,0 +1,36 @@
+import { IEmailProvider, EmailMessage, EmailResult, DeliveryReport, WebhookValidationResult, WebhookValidationOptions, SweegoEmailConfig } from '../interfaces/IEmailProvider.js';
+export declare class SweegoEmailProvider implements IEmailProvider {
+    private readonly config;
+    private readonly apiKey?;
+    private readonly accessToken?;
+    private readonly baseUrl;
+    private readonly providerSlug;
+    private readonly defaultFrom;
+    private readonly channel;
+    private readonly clientId?;
+    private readonly webhookSecret?;
+    constructor(config: SweegoEmailConfig);
+    send(message: EmailMessage): Promise<EmailResult>;
+    getDeliveryReport(messageId: string): Promise<DeliveryReport | null>;
+    validateWebhook(payload: any, signature?: string, options?: WebhookValidationOptions): WebhookValidationResult;
+    private applyMetadata;
+    private applyContent;
+    private applyAttachments;
+    private encodeAttachmentContent;
+    private normalizeRecipients;
+    private normalizeAddress;
+    private extractSweegoMetadata;
+    private buildHeaders;
+    private extractSweegoIds;
+    private mapProviderStatus;
+    private mapWebhookPayload;
+    private extractSweegoUid;
+    private parseTimestamp;
+    private normalizeBaseUrl;
+    private safeParseResponse;
+    private extractProviderError;
+    private normalizeHeaders;
+    private stringifyPayload;
+    private parseWebhookSecret;
+}
+//# sourceMappingURL=SweegoEmailProvider.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"SweegoEmailProvider.d.ts","sourceRoot":"","sources":["../../src/providers/SweegoEmailProvider.ts"],"names":[],"mappings":"AACA,OAAO,EACH,cAAc,EACd,YAAY,EACZ,WAAW,EACX,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,iBAAiB,EAIpB,MAAM,iCAAiC,CAAC;AAmBzC,qBAAa,mBAAoB,YAAW,cAAc;IAU1C,OAAO,CAAC,QAAQ,CAAC,MAAM;IATnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAe;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAS;gBAEX,MAAM,EAAE,iBAAiB;IAgBhD,IAAI,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA0EjD,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAgC1E,eAAe,CACX,OAAO,EAAE,GAAG,EACZ,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,wBAAwB,GACnC,uBAAuB;IAsC1B,OAAO,CAAC,aAAa;IAwCrB,OAAO,CAAC,YAAY;IA8BpB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,uBAAuB;IAQ/B,OAAO,CAAC,mBAAmB;IAK3B,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,qBAAqB;IAQ7B,OAAO,CAAC,YAAY;IAsBpB,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,iBAAiB;IA8BzB,OAAO,CAAC,iBAAiB;IAsBzB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,cAAc;IAetB,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,iBAAiB;IAOzB,OAAO,CAAC,oBAAoB;IAQ5B,OAAO,CAAC,gBAAgB;IAiBxB,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,kBAAkB;CAW7B"}