@zyther/tzmail 0.1.4 → 0.5.0

package/dist/factories/template-factory.js

@@ -7,12 +7,125 @@ const monokai_theme_1 = require("../templates/themes/monokai.theme");
 const modern_theme_1 = require("../templates/themes/modern.theme");
 const corporate_theme_1 = require("../templates/themes/corporate.theme");
 const minimal_theme_1 = require("../templates/themes/minimal.theme");
+const aurora_theme_1 = require("../templates/themes/aurora.theme");
+const ocean_theme_1 = require("../templates/themes/ocean.theme");
+const sunset_theme_1 = require("../templates/themes/sunset.theme");
+const lavender_theme_1 = require("../templates/themes/lavender.theme");
+const forest_theme_1 = require("../templates/themes/forest.theme");
+const editorial_theme_1 = require("../templates/themes/editorial.theme");
+const pastel_theme_1 = require("../templates/themes/pastel.theme");
+const neobrutal_theme_1 = require("../templates/themes/neobrutal.theme");
+const glass_theme_1 = require("../templates/themes/glass.theme");
+const midnight_theme_1 = require("../templates/themes/midnight.theme");
 const template_builder_1 = require("../templates/base/template-builder");
+const color_accessibility_1 = require("../templates/base/color-accessibility");
+const SAFE_COLOR = /^(#[\da-f]{3,8}|[a-z]{1,24}|(?:rgb|rgba|hsl|hsla)\([\d.%\s,+/-]+\))$/i;
+const SAFE_LANGUAGE_TAG = /^[A-Za-z]{2,8}(?:-[A-Za-z0-9]{1,8})*$/;
+const SAFE_NAMED_COLORS = new Set(('transparent inherit currentcolor aliceblue antiquewhite aqua aquamarine azure beige bisque black blanchedalmond blue blueviolet brown burlywood cadetblue chartreuse chocolate coral cornflowerblue cornsilk crimson cyan darkblue darkcyan darkgoldenrod darkgray darkgrey darkgreen darkkhaki darkmagenta darkolivegreen darkorange darkorchid darkred darksalmon darkseagreen darkslateblue darkslategray darkslategrey darkturquoise darkviolet deeppink deepskyblue dimgray dimgrey dodgerblue firebrick floralwhite forestgreen fuchsia gainsboro ghostwhite gold goldenrod gray grey green greenyellow honeydew hotpink indianred indigo ivory khaki lavender lavenderblush lawngreen lemonchiffon lightblue lightcoral lightcyan lightgoldenrodyellow lightgray lightgrey lightgreen lightpink lightsalmon lightseagreen lightskyblue lightslategray lightslategrey lightsteelblue lightyellow lime limegreen linen magenta maroon mediumaquamarine mediumblue mediumorchid mediumpurple mediumseagreen mediumslateblue mediumspringgreen mediumturquoise mediumvioletred midnightblue mintcream mistyrose moccasin navajowhite navy oldlace olive olivedrab orange orangered orchid palegoldenrod palegreen paleturquoise palevioletred papayawhip peachpuff peru pink plum powderblue purple rebeccapurple red rosybrown royalblue saddlebrown salmon sandybrown seagreen seashell sienna silver skyblue slateblue slategray slategrey snow springgreen steelblue tan teal thistle tomato turquoise violet wheat white whitesmoke yellow yellowgreen').split(' '));
+function cssColor(value, fallback) {
+    if (value === undefined)
+        return fallback;
+    const trimmed = value.trim();
+    if (!SAFE_COLOR.test(trimmed) || (!trimmed.startsWith('#') && !/^(rgb|rgba|hsl|hsla)\(/i.test(trimmed) && !SAFE_NAMED_COLORS.has(trimmed.toLowerCase()))) {
+        throw new Error('Invalid template color value');
+    }
+    return trimmed;
+}
+function escapeHtml(value) {
+    return String(value ?? '').replace(/[&<>"']/g, character => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[character]));
+}
+function interpolate(value, variables, escapeValues = false) {
+    if (value === undefined)
+        return undefined;
+    return value.replace(/\{\{\s*([A-Za-z0-9_.-]+)\s*\}\}/g, (_placeholder, path) => {
+        let resolved = variables;
+        for (const segment of path.split('.')) {
+            if (resolved === null || typeof resolved !== 'object')
+                throw new Error(`Missing template variable: ${path}`);
+            resolved = resolved[segment];
+        }
+        if (resolved === undefined)
+            throw new Error(`Missing template variable: ${path}`);
+        if (resolved !== null && !['string', 'number', 'boolean'].includes(typeof resolved)) {
+            throw new Error(`Template variable ${path} must be a string, number, boolean, or null`);
+        }
+        const text = resolved === null ? '' : String(resolved);
+        return escapeValues ? escapeHtml(text) : text;
+    });
+}
+function resolveTemplateConfig(config, variables) {
+    return {
+        ...config,
+        preheader: interpolate(config.preheader, variables),
+        header: config.header ? {
+            ...config.header,
+            logo: config.header.logo ? {
+                ...config.header.logo,
+                text: interpolate(config.header.logo.text, variables),
+                imageUrl: interpolate(config.header.logo.imageUrl, variables),
+                alt: interpolate(config.header.logo.alt, variables)
+            } : undefined
+        } : undefined,
+        body: config.body ? {
+            ...config.body,
+            title: interpolate(config.body.title, variables),
+            message: interpolate(config.body.message, variables),
+            // Substitutions inside trusted HTML are escaped before insertion.
+            content: interpolate(config.body.content, variables, true),
+            buttonText: interpolate(config.body.buttonText, variables),
+            buttonUrl: interpolate(config.body.buttonUrl, variables)
+        } : undefined,
+        footer: config.footer ? {
+            ...config.footer,
+            links: config.footer.links?.map(link => ({
+                text: interpolate(link.text, variables),
+                url: interpolate(link.url, variables)
+            })),
+            socialLinks: config.footer.socialLinks?.map(link => ({
+                ...link,
+                url: interpolate(link.url, variables)
+            })),
+            copyrightText: interpolate(config.footer.copyrightText, variables),
+            unsubscribeText: interpolate(config.footer.unsubscribeText, variables),
+            unsubscribeUrl: interpolate(config.footer.unsubscribeUrl, variables)
+        } : undefined
+    };
+}
 class TemplateFactory {
+    static themes = new Map([
+        [theme_enum_1.ThemeType.SYSTEM, new system_theme_1.SystemTheme()],
+        [theme_enum_1.ThemeType.MONOKAI, new monokai_theme_1.MonokaiTheme()],
+        [theme_enum_1.ThemeType.MODERN, new modern_theme_1.ModernTheme()],
+        [theme_enum_1.ThemeType.CORPORATE, new corporate_theme_1.CorporateTheme()],
+        [theme_enum_1.ThemeType.MINIMAL, new minimal_theme_1.MinimalTheme()],
+        [theme_enum_1.ThemeType.AURORA, new aurora_theme_1.AuroraTheme()],
+        [theme_enum_1.ThemeType.OCEAN, new ocean_theme_1.OceanTheme()],
+        [theme_enum_1.ThemeType.SUNSET, new sunset_theme_1.SunsetTheme()],
+        [theme_enum_1.ThemeType.LAVENDER, new lavender_theme_1.LavenderTheme()],
+        [theme_enum_1.ThemeType.FOREST, new forest_theme_1.ForestTheme()],
+        [theme_enum_1.ThemeType.EDITORIAL, new editorial_theme_1.EditorialTheme()],
+        [theme_enum_1.ThemeType.PASTEL, new pastel_theme_1.PastelTheme()],
+        [theme_enum_1.ThemeType.NEOBRUTAL, new neobrutal_theme_1.NeoBrutalTheme()],
+        [theme_enum_1.ThemeType.GLASS, new glass_theme_1.GlassTheme()],
+        [theme_enum_1.ThemeType.MIDNIGHT, new midnight_theme_1.MidnightTheme()]
+    ]);
     static createTemplate(themeType, variant, config) {
         const theme = this.themes.get(themeType);
-        if (!theme) {
+        if (!theme)
             throw new Error(`Theme ${themeType} not found`);
+        if (variant !== 'light' && variant !== 'dark')
+            throw new Error(`Invalid template variant: ${variant}`);
+        if (!config || typeof config !== 'object')
+            throw new Error('Template config must be an object');
+        if (config.language !== undefined && (typeof config.language !== 'string' || config.language.length > 63 || !SAFE_LANGUAGE_TAG.test(config.language))) {
+            throw new Error('Invalid template language tag');
+        }
+        if (config.direction !== undefined && !['ltr', 'rtl', 'auto'].includes(config.direction))
+            throw new Error('Invalid template text direction');
+        if (config.linkDecoration !== undefined && !['none', 'underline'].includes(config.linkDecoration))
+            throw new Error('Invalid template linkDecoration');
+        if (config.preheader !== undefined && (typeof config.preheader !== 'string' || config.preheader.length > 500 || /[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F]/.test(config.preheader))) {
+            throw new Error('preheader must be a string of at most 500 printable characters');
         }
         return {
             name: `${themeType}_${variant}`,
@@ -20,77 +133,74 @@ class TemplateFactory {
             variant,
             config,
             render: async (data) => {
-                const builder = new template_builder_1.TemplateBuilder(theme, config, variant);
-                const body = data.template.config.body || {};
-                let bodyContent = body.content || `
+                const templateData = data?.templateData && typeof data.templateData === 'object' && !Array.isArray(data.templateData)
+                    ? data.templateData
+                    : {};
+                const renderConfig = resolveTemplateConfig(config, templateData);
+                const builder = new template_builder_1.TemplateBuilder(theme, renderConfig, variant);
+                // Renderer usa sempre a configuração capturada. `data` é somente conteúdo variável,
+                // nunca uma fonte alternativa de configuração/template.
+                const body = renderConfig.body || {};
+                const alignment = body.alignment || 'left';
+                if (!['left', 'center', 'right'].includes(alignment))
+                    throw new Error('Invalid body alignment');
+                const fontSize = body.fontSize ?? 14;
+                if (!Number.isFinite(fontSize) || fontSize < 8 || fontSize > 72)
+                    throw new Error('Invalid body font size');
+                const background = cssColor(body.backgroundColor, theme[variant].background);
+                const requestedTextColor = cssColor(body.textColor, theme[variant].text);
+                const textColor = (0, color_accessibility_1.readableTextColor)(requestedTextColor, background, theme[variant].text);
+                cssColor(renderConfig.header?.backgroundColor, 'transparent');
+                cssColor(renderConfig.header?.textColor, 'inherit');
+                cssColor(renderConfig.footer?.backgroundColor, 'transparent');
+                cssColor(renderConfig.footer?.textColor, 'inherit');
+                const titleFontSize = fontSize + 7;
+                const bodyCellStyle = `padding: 0; text-align: ${alignment}; background-color: ${background}; color: ${textColor}; font-size: ${fontSize}px; font-family: ${theme.typography.fontFamily};`;
+                const titleStyle = `margin: 0 0 16px 0; color: ${textColor}; font-family: ${theme.typography.fontFamily}; font-size: ${titleFontSize}px; font-weight: ${theme.typography.fontWeights.bold}; line-height: 1.3; text-align: ${alignment};`;
+                const messageStyle = `margin: 0; color: ${textColor}; font-family: ${theme.typography.fontFamily}; font-size: ${fontSize}px; line-height: 1.6; text-align: ${alignment};`;
+                // body.content é o único campo da configuração intencionalmente tratado como HTML confiável.
+                // Título, mensagem e valores de estilo são sempre escapados/validados e não viram HTML.
+                const bodyContent = body.content ?? `
           <table width="100%" cellpadding="0" cellspacing="0" role="presentation">
             <tr>
-              <td style="padding: 20px; text-align: ${body.alignment || 'left'}; background-color: ${body.backgroundColor || 'transparent'}; color: ${body.textColor || 'inherit'}; font-size: ${body.fontSize || 14}px;">
-                
-                <h2 style="margin: 0 0 16px 0; font-size: ${(body.fontSize + 7) || 21}px; line-height: 1.3;">
-                  ${body.title || 'Hello!'}
-                </h2>
-
-                <p style="margin: 0; line-height: 1.6;">
-                  ${body.message || 'This is an email generated with tzMail.'}
-                </p>
-
+              <td align="${alignment}" style="${escapeHtml(bodyCellStyle)}">
+                <h2 style="${escapeHtml(titleStyle)}">${escapeHtml(body.title ?? 'Hello!')}</h2>
+                <p style="${escapeHtml(messageStyle)}">${escapeHtml(body.message ?? 'This is an email generated with tzMail.')}</p>
               </td>
             </tr>
-          </table>
-        `;
-                builder.buildHeader(data.headerContent).buildBody(bodyContent);
+          </table>`;
+                builder.buildPreheader().buildHeader(typeof data?.headerContent === 'string' ? data.headerContent : '').buildBody(bodyContent);
                 if (body.buttonText && body.buttonUrl) {
-                    builder.buildButton(body.buttonText, body.buttonUrl, body.buttonVariant);
+                    builder.buildButton(body.buttonText, body.buttonUrl, body.buttonVariant || 'primary');
                 }
-                return builder
-                    .buildFooter()
-                    .build();
+                return builder.buildFooter().build();
             }
         };
     }
-    static getTheme(themeType) {
-        return this.themes.get(themeType);
-    }
-    static listThemes() {
-        return Array.from(this.themes.keys());
-    }
+    static getTheme(themeType) { return this.themes.get(themeType); }
+    static listThemes() { return Array.from(this.themes.keys()); }
     static getThemeInfo(themeType) {
         const themeInfo = {
-            [theme_enum_1.ThemeType.SYSTEM]: {
-                name: 'System',
-                description: 'Tema limpo e profissional com cores adaptativas',
-                features: ['Design minimalista', 'Alta acessibilidade', 'Compatibilidade total']
-            },
-            [theme_enum_1.ThemeType.MONOKAI]: {
-                name: 'Monokai',
-                description: 'Inspirado no famoso tema de código, ideal para conteúdo técnico',
-                features: ['Cores vibrantes', 'Destaque de sintaxe', 'Efeitos glow']
-            },
-            [theme_enum_1.ThemeType.MODERN]: {
-                name: 'Modern',
-                description: 'Design contemporâneo com gradientes e efeitos modernos',
-                features: ['Gradientes elegantes', 'Glassmorphism', 'Animações suaves']
-            },
-            [theme_enum_1.ThemeType.CORPORATE]: {
-                name: 'Corporate',
-                description: 'Design profissional e elegante para empresas',
-                features: ['Tipografia serifada', 'Detalhes em dourado', 'Layout estruturado']
-            },
-            [theme_enum_1.ThemeType.MINIMAL]: {
-                name: 'Minimal',
-                description: 'Design clean e focado no conteúdo',
-                features: ['Sem distrações', 'Espaçamento generoso', 'Tipografia limpa']
-            }
+            [theme_enum_1.ThemeType.SYSTEM]: { name: 'System', description: 'Clean, professional palette with adaptive light and dark variants', features: ['Minimal design', 'Accessible contrast', 'Email-client friendly'] },
+            [theme_enum_1.ThemeType.MONOKAI]: { name: 'Monokai', description: 'Vibrant, code-inspired colors for technical content', features: ['Vivid accents', 'Developer aesthetic', 'Dark-mode variant'] },
+            [theme_enum_1.ThemeType.MODERN]: { name: 'Modern', description: 'Contemporary layout with refined colors and typography', features: ['Modern palette', 'Clean hierarchy', 'Responsive structure'] },
+            [theme_enum_1.ThemeType.CORPORATE]: { name: 'Corporate', description: 'Professional, structured styling for business communication', features: ['Serif typography', 'Gold details', 'Formal hierarchy'] },
+            [theme_enum_1.ThemeType.MINIMAL]: { name: 'Minimal', description: 'Content-first design with generous whitespace', features: ['Low visual noise', 'Generous spacing', 'Clean typography'] },
+            [theme_enum_1.ThemeType.AURORA]: { name: 'Aurora', description: 'Cool northern-lights colors with teal and violet accents', features: ['Teal and violet palette', 'Balanced light and dark modes', 'System-font typography'] },
+            [theme_enum_1.ThemeType.OCEAN]: { name: 'Ocean', description: 'Calm marine blues and cyan for clear, trustworthy messages', features: ['Navy and cyan palette', 'Readable contrast', 'Email-safe fonts'] },
+            [theme_enum_1.ThemeType.SUNSET]: { name: 'Sunset', description: 'Warm coral, terracotta, and amber for an energetic impression', features: ['Warm accents', 'Polished surfaces', 'Light and dark modes'] },
+            [theme_enum_1.ThemeType.LAVENDER]: { name: 'Lavender', description: 'Elegant violet and rose accents on soft, readable surfaces', features: ['Lavender palette', 'Soft visual tone', 'Accessible contrast'] },
+            [theme_enum_1.ThemeType.FOREST]: { name: 'Forest', description: 'Natural evergreen, moss, sage, and warm cream colors', features: ['Nature-inspired palette', 'Calm serif typography', 'Light and dark modes'] },
+            [theme_enum_1.ThemeType.EDITORIAL]: { name: 'Editorial', description: 'Magazine-inspired typography with warm paper and ink tones', features: ['Serif hierarchy', 'Brick-red accent', 'Content-led layout'] },
+            [theme_enum_1.ThemeType.PASTEL]: { name: 'Pastel', description: 'Soft peach, mint, and lavender accents with readable contrast', features: ['Gentle pastel palette', 'Bright, friendly tone', 'Accessible text colors'] },
+            [theme_enum_1.ThemeType.NEOBRUTAL]: { name: 'Neo Brutal', description: 'Bold black-and-white styling with electric color accents', features: ['High contrast', 'Strong typography', 'Distinctive cobalt and yellow'] },
+            [theme_enum_1.ThemeType.GLASS]: { name: 'Glass', description: 'Cool, glass-inspired colors implemented with solid email-safe surfaces', features: ['Cool blue-gray palette', 'Solid client-compatible colors', 'Clean typography'] },
+            [theme_enum_1.ThemeType.MIDNIGHT]: { name: 'Midnight', description: 'Premium midnight navy and champagne-gold accents', features: ['Luxe dark palette', 'Warm paper light mode', 'Serif typography'] }
         };
-        return themeInfo[themeType];
+        const info = themeInfo[themeType];
+        if (!info)
+            throw new Error(`Theme ${themeType} not found`);
+        return info;
     }
 }
 exports.TemplateFactory = TemplateFactory;
-TemplateFactory.themes = new Map([
-    [theme_enum_1.ThemeType.SYSTEM, new system_theme_1.SystemTheme()],
-    [theme_enum_1.ThemeType.MONOKAI, new monokai_theme_1.MonokaiTheme()],
-    [theme_enum_1.ThemeType.MODERN, new modern_theme_1.ModernTheme()],
-    [theme_enum_1.ThemeType.CORPORATE, new corporate_theme_1.CorporateTheme()],
-    [theme_enum_1.ThemeType.MINIMAL, new minimal_theme_1.MinimalTheme()]
-]);

package/dist/index.d.ts

@@ -2,14 +2,27 @@ export { EmailFactory } from './factories/email-factory';
 export { TemplateFactory } from './factories/template-factory';
 export { ITemplate, ITemplateConfig } from './core/interfaces/template.interface';
 export { ThemeType } from './core/enums/theme.enum';
-export { ITheme } from './templates/themes/theme.interface';
-export { TemplateService } from './services/template.service';
+export { ITheme, IThemeColorToken, IThemeEmailStyles, IThemeTextTransform } from './templates/themes/theme.interface';
+export { TemplateService, ITemplateServiceOptions } from './services/template.service';
 export { EmailService } from './services/email.service';
-export { AttachmentService } from './services/attachment.service';
+export { AttachmentService, IAttachmentServiceOptions } from './services/attachment.service';
+export { IAmazonSesConfig, IAttachment, IEmailAuth, IEmailConfig, IEmailOptions, IEmailSendResult, IMailgunConfig, ISendGridConfig } from './core/interfaces/email.interface';
+export { IEmailTransport, ITransportMessage, ITransportSendInfo } from './providers/provider.interface';
+export { BullMQEmailQueue, IBullMQBackoffOptions, IBullMQEmailQueueConfig, IBullMQJobLike, IBullMQQueueEventPayload, IBullMQQueueEventsLike, IBullMQQueueMetrics, IBullMQRateLimiterOptions, IBullMQRuntime, IBullMQWorkerMetricsOptions, IEmailQueueJobData, IEmailQueueJobOptions, IEmailQueueSender, ISerializedEmailAttachment, IQueuedEmailJob } from './queues/bullmq-email-queue';
 export { TemplateBuilder } from './templates/base/template-builder';
 export { CorporateTheme } from './templates/themes/corporate.theme';
 export { MinimalTheme } from './templates/themes/minimal.theme';
 export { ModernTheme } from './templates/themes/modern.theme';
 export { MonokaiTheme } from './templates/themes/monokai.theme';
 export { SystemTheme } from './templates/themes/system.theme';
+export { AuroraTheme } from './templates/themes/aurora.theme';
+export { OceanTheme } from './templates/themes/ocean.theme';
+export { SunsetTheme } from './templates/themes/sunset.theme';
+export { LavenderTheme } from './templates/themes/lavender.theme';
+export { ForestTheme } from './templates/themes/forest.theme';
+export { EditorialTheme } from './templates/themes/editorial.theme';
+export { PastelTheme } from './templates/themes/pastel.theme';
+export { NeoBrutalTheme } from './templates/themes/neobrutal.theme';
+export { GlassTheme } from './templates/themes/glass.theme';
+export { MidnightTheme } from './templates/themes/midnight.theme';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACtH,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAC7F,OAAO,EACL,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,eAAe,EAChB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AACxG,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,cAAc,EACd,2BAA2B,EAC3B,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SystemTheme = exports.MonokaiTheme = exports.ModernTheme = exports.MinimalTheme = exports.CorporateTheme = exports.TemplateBuilder = exports.AttachmentService = exports.EmailService = exports.TemplateService = exports.ThemeType = exports.TemplateFactory = exports.EmailFactory = void 0;
+exports.MidnightTheme = exports.GlassTheme = exports.NeoBrutalTheme = exports.PastelTheme = exports.EditorialTheme = exports.ForestTheme = exports.LavenderTheme = exports.SunsetTheme = exports.OceanTheme = exports.AuroraTheme = exports.SystemTheme = exports.MonokaiTheme = exports.ModernTheme = exports.MinimalTheme = exports.CorporateTheme = exports.TemplateBuilder = exports.BullMQEmailQueue = exports.AttachmentService = exports.EmailService = exports.TemplateService = exports.ThemeType = exports.TemplateFactory = exports.EmailFactory = void 0;
 var email_factory_1 = require("./factories/email-factory");
 Object.defineProperty(exports, "EmailFactory", { enumerable: true, get: function () { return email_factory_1.EmailFactory; } });
 var template_factory_1 = require("./factories/template-factory");
@@ -13,6 +13,8 @@ var email_service_1 = require("./services/email.service");
 Object.defineProperty(exports, "EmailService", { enumerable: true, get: function () { return email_service_1.EmailService; } });
 var attachment_service_1 = require("./services/attachment.service");
 Object.defineProperty(exports, "AttachmentService", { enumerable: true, get: function () { return attachment_service_1.AttachmentService; } });
+var bullmq_email_queue_1 = require("./queues/bullmq-email-queue");
+Object.defineProperty(exports, "BullMQEmailQueue", { enumerable: true, get: function () { return bullmq_email_queue_1.BullMQEmailQueue; } });
 var template_builder_1 = require("./templates/base/template-builder");
 Object.defineProperty(exports, "TemplateBuilder", { enumerable: true, get: function () { return template_builder_1.TemplateBuilder; } });
 var corporate_theme_1 = require("./templates/themes/corporate.theme");
@@ -25,3 +27,23 @@ var monokai_theme_1 = require("./templates/themes/monokai.theme");
 Object.defineProperty(exports, "MonokaiTheme", { enumerable: true, get: function () { return monokai_theme_1.MonokaiTheme; } });
 var system_theme_1 = require("./templates/themes/system.theme");
 Object.defineProperty(exports, "SystemTheme", { enumerable: true, get: function () { return system_theme_1.SystemTheme; } });
+var aurora_theme_1 = require("./templates/themes/aurora.theme");
+Object.defineProperty(exports, "AuroraTheme", { enumerable: true, get: function () { return aurora_theme_1.AuroraTheme; } });
+var ocean_theme_1 = require("./templates/themes/ocean.theme");
+Object.defineProperty(exports, "OceanTheme", { enumerable: true, get: function () { return ocean_theme_1.OceanTheme; } });
+var sunset_theme_1 = require("./templates/themes/sunset.theme");
+Object.defineProperty(exports, "SunsetTheme", { enumerable: true, get: function () { return sunset_theme_1.SunsetTheme; } });
+var lavender_theme_1 = require("./templates/themes/lavender.theme");
+Object.defineProperty(exports, "LavenderTheme", { enumerable: true, get: function () { return lavender_theme_1.LavenderTheme; } });
+var forest_theme_1 = require("./templates/themes/forest.theme");
+Object.defineProperty(exports, "ForestTheme", { enumerable: true, get: function () { return forest_theme_1.ForestTheme; } });
+var editorial_theme_1 = require("./templates/themes/editorial.theme");
+Object.defineProperty(exports, "EditorialTheme", { enumerable: true, get: function () { return editorial_theme_1.EditorialTheme; } });
+var pastel_theme_1 = require("./templates/themes/pastel.theme");
+Object.defineProperty(exports, "PastelTheme", { enumerable: true, get: function () { return pastel_theme_1.PastelTheme; } });
+var neobrutal_theme_1 = require("./templates/themes/neobrutal.theme");
+Object.defineProperty(exports, "NeoBrutalTheme", { enumerable: true, get: function () { return neobrutal_theme_1.NeoBrutalTheme; } });
+var glass_theme_1 = require("./templates/themes/glass.theme");
+Object.defineProperty(exports, "GlassTheme", { enumerable: true, get: function () { return glass_theme_1.GlassTheme; } });
+var midnight_theme_1 = require("./templates/themes/midnight.theme");
+Object.defineProperty(exports, "MidnightTheme", { enumerable: true, get: function () { return midnight_theme_1.MidnightTheme; } });

package/dist/providers/mailgun.transport.d.ts

@@ -0,0 +1,10 @@
+import { IMailgunConfig } from '../core/interfaces/email.interface';
+import { ITransportMessage, ITransportSendInfo, IEmailTransport } from './provider.interface';
+export declare class MailgunTransport implements IEmailTransport {
+    private readonly config;
+    private readonly apiUrl;
+    private readonly fetchImpl;
+    constructor(config: IMailgunConfig, fetchImpl?: typeof fetch);
+    sendMail(message: ITransportMessage): Promise<ITransportSendInfo>;
+}
+//# sourceMappingURL=mailgun.transport.d.ts.map

package/dist/providers/mailgun.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailgun.transport.d.ts","sourceRoot":"","sources":["../../src/providers/mailgun.transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG9F,qBAAa,gBAAiB,YAAW,eAAe;IAI1C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAEZ,MAAM,EAAE,cAAc,EAAE,SAAS,GAAE,OAAO,KAAa;IAc9E,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;CAyDxE"}

package/dist/providers/mailgun.transport.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MailgunTransport = void 0;
+const provider_utils_1 = require("./provider-utils");
+class MailgunTransport {
+    config;
+    apiUrl;
+    fetchImpl;
+    constructor(config, fetchImpl = fetch) {
+        this.config = config;
+        (0, provider_utils_1.validateApiConfig)(config);
+        if (!config.domain.trim() || /[\u0000-\u001f\u007f]/.test(config.domain)) {
+            throw new Error('Mailgun domain is required and must not contain control characters');
+        }
+        const defaultApiUrl = config.region === 'eu' ? 'https://api.eu.mailgun.net' : 'https://api.mailgun.net';
+        this.apiUrl = (config.apiUrl ?? defaultApiUrl).replace(/\/+$/, '');
+        const parsedUrl = new URL(this.apiUrl);
+        if (parsedUrl.protocol !== 'https:' && parsedUrl.hostname !== 'localhost' && parsedUrl.hostname !== '127.0.0.1') {
+            throw new Error('Mailgun apiUrl must use HTTPS');
+        }
+        this.fetchImpl = fetchImpl;
+    }
+    async sendMail(message) {
+        const recipients = (0, provider_utils_1.splitAddresses)(message.to);
+        if (recipients.length === 0)
+            throw new Error('Mailgun requires at least one recipient');
+        const from = message.from ?? this.config.defaultFrom;
+        const body = new FormData();
+        body.set('from', from);
+        for (const recipient of recipients)
+            body.append('to', recipient);
+        for (const recipient of (0, provider_utils_1.splitAddresses)(message.cc))
+            body.append('cc', recipient);
+        for (const recipient of (0, provider_utils_1.splitAddresses)(message.bcc))
+            body.append('bcc', recipient);
+        body.set('subject', message.subject);
+        if (message.text !== undefined)
+            body.set('text', message.text);
+        if (message.text === undefined && message.html === undefined) {
+            throw new Error('Mailgun requires a text or HTML body');
+        }
+        let html = message.html;
+        for (const attachment of message.attachments ?? []) {
+            const data = await (0, provider_utils_1.attachmentToBuffer)(attachment, this.config.maxAttachmentBytes);
+            const file = new Blob([new Uint8Array(data)], { type: attachment.contentType ?? 'application/octet-stream' });
+            body.append(attachment.cid ? 'inline' : 'attachment', file, attachment.filename);
+            if (attachment.cid && html !== undefined) {
+                html = html.split(`cid:${attachment.cid}`).join(`cid:${attachment.filename}`);
+            }
+        }
+        if (html !== undefined)
+            body.set('html', html);
+        const url = `${this.apiUrl}/v3/${encodeURIComponent(this.config.domain)}/messages`;
+        const response = await this.fetchImpl(url, {
+            method: 'POST',
+            headers: {
+                authorization: `Basic ${Buffer.from(`api:${this.config.apiKey}`).toString('base64')}`
+            },
+            body,
+            redirect: 'error',
+            signal: AbortSignal.timeout(this.config.requestTimeoutMs ?? 30_000)
+        });
+        const responseBody = await response.text();
+        if (response.status !== 200) {
+            const error = new Error(`Mailgun API returned HTTP ${response.status}${responseBody ? `: ${responseBody}` : ''}`);
+            Object.assign(error, { statusCode: response.status, responseBody });
+            throw error;
+        }
+        let result;
+        try {
+            result = responseBody ? JSON.parse(responseBody) : {};
+        }
+        catch {
+            throw new Error('Mailgun API returned an invalid JSON response');
+        }
+        const accepted = [...recipients, ...(0, provider_utils_1.splitAddresses)(message.cc), ...(0, provider_utils_1.splitAddresses)(message.bcc)];
+        return {
+            ...(result.id ? { messageId: result.id } : {}),
+            response: result.message ?? '200 Accepted',
+            accepted,
+            rejected: []
+        };
+    }
+}
+exports.MailgunTransport = MailgunTransport;

package/dist/providers/nodemailer.transport.d.ts

@@ -0,0 +1,11 @@
+import { Transporter } from 'nodemailer';
+import { IEmailTransport, ITransportMessage, ITransportSendInfo } from './provider.interface';
+export declare class NodemailerTransport implements IEmailTransport {
+    private readonly transporter;
+    private readonly closeExtra?;
+    constructor(transporter: Transporter, closeExtra?: (() => void) | undefined);
+    sendMail(message: ITransportMessage): Promise<ITransportSendInfo>;
+    verify(): Promise<true>;
+    close(): void;
+}
+//# sourceMappingURL=nodemailer.transport.d.ts.map

package/dist/providers/nodemailer.transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nodemailer.transport.d.ts","sourceRoot":"","sources":["../../src/providers/nodemailer.transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE9F,qBAAa,mBAAoB,YAAW,eAAe;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW;IAAe,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;gBAAtD,WAAW,EAAE,WAAW,EAAmB,UAAU,CAAC,GAAE,MAAM,IAAI,aAAA;IAEzF,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAKvE,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,KAAK,IAAI,IAAI;CAId"}

package/dist/providers/nodemailer.transport.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NodemailerTransport = void 0;
+class NodemailerTransport {
+    transporter;
+    closeExtra;
+    constructor(transporter, closeExtra) {
+        this.transporter = transporter;
+        this.closeExtra = closeExtra;
+    }
+    async sendMail(message) {
+        const info = await this.transporter.sendMail(message);
+        return info;
+    }
+    verify() {
+        return this.transporter.verify();
+    }
+    close() {
+        this.transporter.close();
+        this.closeExtra?.();
+    }
+}
+exports.NodemailerTransport = NodemailerTransport;

package/dist/providers/provider-utils.d.ts

@@ -0,0 +1,17 @@
+import { IAttachment } from '../core/interfaces/email.interface';
+export interface IProviderMailbox {
+    email: string;
+    name?: string;
+}
+/** Splits a header address list without splitting commas inside quotes or angle brackets. */
+export declare function splitAddresses(value: string | string[] | undefined): string[];
+export declare function parseMailbox(value: string): IProviderMailbox;
+export declare function parseMailboxes(value: string | string[] | undefined): IProviderMailbox[];
+export declare function attachmentToBuffer(attachment: IAttachment, maxAttachmentBytes?: number): Promise<Buffer>;
+export declare function validateApiConfig(options: {
+    apiKey: string;
+    defaultFrom: string;
+    requestTimeoutMs?: number;
+    maxAttachmentBytes?: number;
+}): void;
+//# sourceMappingURL=provider-utils.d.ts.map

package/dist/providers/provider-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-utils.d.ts","sourceRoot":"","sources":["../../src/providers/provider-utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,MAAM,EAAE,CAyB7E;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAO5D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,GAAG,gBAAgB,EAAE,CAEvF;AAED,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,WAAW,EAAE,kBAAkB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAyB9G;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B,GAAG,IAAI,CASP"}

package/dist/providers/provider-utils.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitAddresses = splitAddresses;
+exports.parseMailbox = parseMailbox;
+exports.parseMailboxes = parseMailboxes;
+exports.attachmentToBuffer = attachmentToBuffer;
+exports.validateApiConfig = validateApiConfig;
+const promises_1 = require("fs/promises");
+/** Splits a header address list without splitting commas inside quotes or angle brackets. */
+function splitAddresses(value) {
+    if (value === undefined)
+        return [];
+    const entries = Array.isArray(value) ? value : [value];
+    const result = [];
+    for (const entry of entries) {
+        let start = 0;
+        let quoted = false;
+        let angleDepth = 0;
+        for (let index = 0; index < entry.length; index += 1) {
+            const char = entry[index];
+            if (char === '"' && entry[index - 1] !== '\\')
+                quoted = !quoted;
+            if (!quoted && char === '<')
+                angleDepth += 1;
+            if (!quoted && char === '>' && angleDepth > 0)
+                angleDepth -= 1;
+            if (!quoted && angleDepth === 0 && char === ',') {
+                const address = entry.slice(start, index).trim();
+                if (address)
+                    result.push(address);
+                start = index + 1;
+            }
+        }
+        const address = entry.slice(start).trim();
+        if (address)
+            result.push(address);
+    }
+    return result;
+}
+function parseMailbox(value) {
+    const normalized = value.trim();
+    const match = /^(.*?)\s*<([^<>]+)>$/.exec(normalized);
+    if (!match)
+        return { email: normalized };
+    const name = match[1].trim().replace(/^"|"$/g, '');
+    return name ? { email: match[2].trim(), name } : { email: match[2].trim() };
+}
+function parseMailboxes(value) {
+    return splitAddresses(value).map(parseMailbox);
+}
+async function attachmentToBuffer(attachment, maxAttachmentBytes) {
+    let content;
+    if (attachment.content !== undefined) {
+        content = Buffer.isBuffer(attachment.content)
+            ? attachment.content
+            : Buffer.from(attachment.content);
+    }
+    else if (attachment.path) {
+        if (maxAttachmentBytes !== undefined) {
+            const fileInfo = await (0, promises_1.stat)(attachment.path);
+            if (fileInfo.size > maxAttachmentBytes) {
+                throw new Error(`Attachment exceeds configured maxAttachmentBytes (${maxAttachmentBytes})`);
+            }
+        }
+        content = await (0, promises_1.readFile)(attachment.path);
+    }
+    else {
+        throw new Error(`Attachment "${attachment.filename}" requires content or path`);
+    }
+    if (maxAttachmentBytes !== undefined && content.length > maxAttachmentBytes) {
+        throw new Error(`Attachment exceeds configured maxAttachmentBytes (${maxAttachmentBytes})`);
+    }
+    if (!attachment.filename || /[\u0000-\u001f\u007f]/.test(attachment.filename)) {
+        throw new Error('Attachment filename must be non-empty and contain no control characters');
+    }
+    return content;
+}
+function validateApiConfig(options) {
+    if (!options.apiKey.trim())
+        throw new Error('Provider apiKey is required');
+    if (!options.defaultFrom.trim())
+        throw new Error('Provider defaultFrom is required');
+    if (options.requestTimeoutMs !== undefined && (!Number.isSafeInteger(options.requestTimeoutMs) || options.requestTimeoutMs <= 0)) {
+        throw new Error('requestTimeoutMs must be a positive safe integer');
+    }
+    if (options.maxAttachmentBytes !== undefined && (!Number.isSafeInteger(options.maxAttachmentBytes) || options.maxAttachmentBytes <= 0)) {
+        throw new Error('maxAttachmentBytes must be a positive safe integer');
+    }
+}