@zyther/tzmail 0.1.0

package/README.md

@@ -0,0 +1,133 @@
+# tzMail
+
+A powerful and flexible TypeScript/Node.js email package built on top of Nodemailer, featuring a robust templating system with built-in themes, caching, and easy attachment management.
+
+## Features
+
+- 🚀 **Singleton Factory**: Easy initialization and global access.
+
+- 🎨 **Themed Templates**: 5 built-in professional themes (Modern, Corporate, Minimal, Monokai, System).
+
+- 🌓 **Dark Mode Support**: All templates support light and dark variants.
+
+- ⚡ **Performance**: In-memory template caching with TTL and version history.
+
+- 📎 **Attachment Service**: Simple helpers for local files and buffers.
+
+- ✅ **Validation**: Built-in configuration validation for templates.
+
+## Installation
+
+```bash
+npm install tzmail
+# or
+yarn add tzmail
+```
+
+## Quick Start
+
+### 1. Initialize the Factory
+
+```typescript
+import { EmailFactory } from 'tzmail';
+
+const smtpConfig = {
+  host: 'smtp.example.com',
+  port: 587,
+  auth: {
+    user: 'user@example.com',
+    pass: 'password'
+  },
+  defaultFrom: 'My App <noreply@myapp.com>'
+};
+
+const emailFactory = EmailFactory.initialize(smtpConfig);
+```
+
+### 2. Create and Send an Email
+
+```typescript
+const templateService = emailFactory.getTemplateService();
+
+// Create a template
+const welcomeTemplate = templateService.createTemplate(
+  'modern', // ThemeType
+  'light',  // Variant
+  {
+    body: {
+      title: 'Welcome!',
+      message: 'Thanks for joining us.',
+      buttonText: 'Get Started',
+      buttonUrl: 'https://myapp.com'
+    }
+  }
+ );
+
+// Send the email
+const result = await emailFactory.sendEmail({
+  to: 'user@example.com',
+  subject: 'Welcome aboard!',
+  template: welcomeTemplate
+});
+
+console.log(result.success ? 'Sent!' : 'Failed');
+```
+
+## Core Components
+
+### Themes
+
+| Theme | Best For | Features |
+| --- | --- | --- |
+| `MODERN` | Modern UI apps | Gradients, glassmorphism, rounded corners. |
+| `CORPORATE` | Business/Enterprise | Serif typography, gold accents, structured layout. |
+| `MINIMAL` | Clean newsletters | High whitespace, focused content, neutral colors. |
+| `MONOKAI` | Technical content | Syntax highlighting for code blocks, vibrant colors. |
+| `SYSTEM` | General purpose | Clean, accessible, system-native look. |
+
+### Attachment Service
+
+Easily add attachments from paths or buffers:
+
+```typescript
+const attachmentService = emailFactory.getAttachmentService();
+const file = await attachmentService.addFromPath('path/to/report.pdf');
+
+await emailFactory.sendEmail({
+  to: 'user@example.com',
+  subject: 'Monthly Report',
+  attachments: [file],
+  html: '<p>Please find the report attached.</p>'
+});
+```
+
+## Configuration Reference
+
+### `ITemplateConfig`
+
+Customize your email structure:
+
+- **header**: `{ show: boolean, logo: { type: 'text' | 'image', ... } }`
+
+- **body**: `{ title, message, buttonText, buttonUrl, alignment, ... }`
+
+- **footer**: `{ show: boolean, links: [], socialLinks: [], copyrightText }`
+
+- **layout**: `'full'` | `'minimal'`
+
+- **spacing**: `'compact'` | `'normal'` | `'relaxed'`
+
+## Error Handling
+
+The `sendEmail` method returns a result object:
+
+```typescript
+{
+  success: boolean;
+  messageId?: string;
+  response?: string;
+  error?: any;
+}
+```
+
+---

package/dist/core/enums/template-part.enum.d.ts

@@ -0,0 +1,7 @@
+export declare enum TemplatePart {
+    HEADER = "header",
+    BODY = "body",
+    FOOTER = "footer",
+    BUTTON = "button"
+}
+//# sourceMappingURL=template-part.enum.d.ts.map

package/dist/core/enums/template-part.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-part.enum.d.ts","sourceRoot":"","sources":["../../../src/core/enums/template-part.enum.ts"],"names":[],"mappings":"AACA,oBAAY,YAAY;IACtB,MAAM,WAAW;IACjB,IAAI,SAAS;IACb,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB"}

package/dist/core/enums/template-part.enum.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplatePart = void 0;
+var TemplatePart;
+(function (TemplatePart) {
+    TemplatePart["HEADER"] = "header";
+    TemplatePart["BODY"] = "body";
+    TemplatePart["FOOTER"] = "footer";
+    TemplatePart["BUTTON"] = "button";
+})(TemplatePart || (exports.TemplatePart = TemplatePart = {}));

package/dist/core/enums/theme.enum.d.ts

@@ -0,0 +1,8 @@
+export declare enum ThemeType {
+    SYSTEM = "system",
+    MONOKAI = "monokai",
+    MODERN = "modern",
+    CORPORATE = "corporate",
+    MINIMAL = "minimal"
+}
+//# sourceMappingURL=theme.enum.d.ts.map

package/dist/core/enums/theme.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.enum.d.ts","sourceRoot":"","sources":["../../../src/core/enums/theme.enum.ts"],"names":[],"mappings":"AACA,oBAAY,SAAS;IACnB,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,MAAM,WAAW;IACjB,SAAS,cAAc;IACvB,OAAO,YAAY;CACpB"}

package/dist/core/enums/theme.enum.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ThemeType = void 0;
+var ThemeType;
+(function (ThemeType) {
+    ThemeType["SYSTEM"] = "system";
+    ThemeType["MONOKAI"] = "monokai";
+    ThemeType["MODERN"] = "modern";
+    ThemeType["CORPORATE"] = "corporate";
+    ThemeType["MINIMAL"] = "minimal";
+})(ThemeType || (exports.ThemeType = ThemeType = {}));

package/dist/core/interfaces/email.interface.d.ts

@@ -0,0 +1,30 @@
+import { ITemplate } from "./template.interface";
+export interface IEmailOptions {
+    to: string | string[];
+    subject: string;
+    from?: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    attachments?: IAttachment[];
+    template?: ITemplate;
+    text?: string;
+    html?: string;
+}
+export interface IAttachment {
+    filename: string;
+    content?: string | Buffer;
+    path?: string;
+    contentType?: string;
+    cid?: string;
+}
+export interface IEmailConfig {
+    host: string;
+    port: number;
+    secure: boolean;
+    auth: {
+        user: string;
+        pass: string;
+    };
+    defaultFrom?: string;
+}
+//# sourceMappingURL=email.interface.d.ts.map

package/dist/core/interfaces/email.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.interface.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/email.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,WAAW,CAAC,EAAE,WAAW,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE;QACJ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/dist/core/interfaces/email.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/core/interfaces/template.interface.d.ts

@@ -0,0 +1,56 @@
+import { ThemeType } from "../enums/theme.enum";
+export interface ITemplate {
+    name: string;
+    theme: ThemeType;
+    variant: 'light' | 'dark';
+    config: ITemplateConfig;
+    render(data: any): Promise<string>;
+}
+export interface ITemplateConfig {
+    header?: IHeaderConfig;
+    body?: IBodyConfig;
+    footer?: IFooterConfig;
+    layout?: 'full' | 'minimal';
+    spacing?: 'compact' | 'normal' | 'relaxed';
+    borderRadius?: 'none' | 'small' | 'medium' | 'large';
+}
+export interface IBodyConfig {
+    title?: string;
+    message?: string;
+    content?: string;
+    buttonText?: string;
+    buttonUrl?: string;
+    buttonVariant?: 'primary' | 'secondary' | 'success' | 'danger';
+    alignment?: 'left' | 'center' | 'right';
+    backgroundColor?: string;
+    textColor?: string;
+    fontSize?: number;
+}
+export interface IHeaderConfig {
+    show: boolean;
+    logo?: {
+        type: 'text' | 'image';
+        text?: string;
+        imageUrl?: string;
+        alt?: string;
+        size?: 'small' | 'medium' | 'large';
+    };
+    backgroundColor?: string;
+    textColor?: string;
+}
+export interface IFooterConfig {
+    show: boolean;
+    links?: Array<{
+        text: string;
+        url: string;
+    }>;
+    socialLinks?: Array<{
+        platform: 'facebook' | 'twitter' | 'linkedin' | 'github' | 'instagram' | 'youtube' | 'tiktok' | 'pinterest' | 'reddit' | 'pinterest' | 'tiktok' | 'gitlab' | 'stackoverflow' | 'medium' | 'dribbble' | 'behance' | 'telegram';
+        url: string;
+    }>;
+    copyrightText?: string;
+    unsubscribeText?: string;
+    backgroundColor?: string;
+    textColor?: string;
+}
+//# sourceMappingURL=template.interface.d.ts.map

package/dist/core/interfaces/template.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.interface.d.ts","sourceRoot":"","sources":["../../../src/core/interfaces/template.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;IACjB,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;IAC1B,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;CACtD;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;IAC/D,SAAS,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;IACxC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,CAAC;KACrC,CAAC;IACF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,QAAQ,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;QAC9N,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/core/interfaces/template.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/factories/email-factory.d.ts

@@ -0,0 +1,34 @@
+import { IEmailConfig, IEmailOptions } from '../core/interfaces/email.interface';
+import { TemplateService } from '../services/template.service';
+import { AttachmentService } from '../services/attachment.service';
+import { ThemeType } from '../core/enums/theme.enum';
+import { ITemplateConfig } from '../core/interfaces/template.interface';
+export declare class EmailFactory {
+    private static instance;
+    private emailService;
+    private templateService;
+    private attachmentService;
+    private constructor();
+    static initialize(config: IEmailConfig, templateOptions?: any): EmailFactory;
+    static getInstance(): EmailFactory;
+    sendEmail(options: IEmailOptions): Promise<any>;
+    getTemplateService(): TemplateService;
+    getAttachmentService(): AttachmentService;
+    previewTemplate(themeType: ThemeType, variant: 'light' | 'dark', config: ITemplateConfig, data: any): Promise<string>;
+    getThemeInfo(themeType: ThemeType): {
+        name: string;
+        description: string;
+        features: string[];
+        availableVariants: ("light" | "dark")[];
+        defaultConfig: Partial<ITemplateConfig>;
+    };
+    listThemes(): ThemeType[];
+    getTemplateStats(): {
+        totalTemplates: number;
+        cachedTemplates: number;
+        totalHits: number;
+        templatesByTheme: Record<ThemeType, number>;
+        cacheHitRate: number;
+    };
+}
+//# sourceMappingURL=email-factory.d.ts.map

package/dist/factories/email-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-factory.d.ts","sourceRoot":"","sources":["../../src/factories/email-factory.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEjF,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AAExE,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAe;IACtC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,iBAAiB,CAAoB;IAE7C,OAAO;IAOP,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE,GAAG,GAAG,YAAY;IAO5E,MAAM,CAAC,WAAW,IAAI,YAAY;IAO5B,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC;IAIrD,kBAAkB,IAAI,eAAe;IAIrC,oBAAoB,IAAI,iBAAiB;IAInC,eAAe,CACnB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,MAAM,EAAE,eAAe,EACvB,IAAI,EAAE,GAAG,GACR,OAAO,CAAC,MAAM,CAAC;IAIlB,YAAY,CAAC,SAAS,EAAE,SAAS;;;;;;;IAIjC,UAAU;IAIV,gBAAgB;;;;;;;CAGjB"}

package/dist/factories/email-factory.js

@@ -0,0 +1,52 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailFactory = void 0;
+const nodemailer_1 = __importDefault(require("nodemailer"));
+const email_service_1 = require("../services/email.service");
+const template_service_1 = require("../services/template.service");
+const attachment_service_1 = require("../services/attachment.service");
+class EmailFactory {
+    constructor(config, templateOptions) {
+        const transporter = nodemailer_1.default.createTransport(config);
+        this.emailService = new email_service_1.EmailService(transporter, config.defaultFrom);
+        this.templateService = new template_service_1.TemplateService(templateOptions);
+        this.attachmentService = new attachment_service_1.AttachmentService();
+    }
+    static initialize(config, templateOptions) {
+        if (!this.instance) {
+            this.instance = new EmailFactory(config, templateOptions);
+        }
+        return this.instance;
+    }
+    static getInstance() {
+        if (!this.instance) {
+            throw new Error('EmailFactory not initialized. Call initialize() first.');
+        }
+        return this.instance;
+    }
+    async sendEmail(options) {
+        return this.emailService.send(options);
+    }
+    getTemplateService() {
+        return this.templateService;
+    }
+    getAttachmentService() {
+        return this.attachmentService;
+    }
+    async previewTemplate(themeType, variant, config, data) {
+        return this.templateService.previewTemplate(themeType, variant, config, data);
+    }
+    getThemeInfo(themeType) {
+        return this.templateService.getThemeInfo(themeType);
+    }
+    listThemes() {
+        return this.templateService.listThemes();
+    }
+    getTemplateStats() {
+        return this.templateService.getTemplateStats();
+    }
+}
+exports.EmailFactory = EmailFactory;

package/dist/factories/template-factory.d.ts

@@ -0,0 +1,15 @@
+import { ThemeType } from '../core/enums/theme.enum';
+import { ITemplate, ITemplateConfig } from '../core/interfaces/template.interface';
+import { ITheme } from '../templates/themes/theme.interface';
+export declare class TemplateFactory {
+    private static themes;
+    static createTemplate(themeType: ThemeType, variant: 'light' | 'dark', config: ITemplateConfig): ITemplate;
+    static getTheme(themeType: ThemeType): ITheme | undefined;
+    static listThemes(): ThemeType[];
+    static getThemeInfo(themeType: ThemeType): {
+        name: string;
+        description: string;
+        features: string[];
+    };
+}
+//# sourceMappingURL=template-factory.d.ts.map

package/dist/factories/template-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-factory.d.ts","sourceRoot":"","sources":["../../src/factories/template-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAQ7D,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,CAMlB;IAEH,MAAM,CAAC,cAAc,CACnB,SAAS,EAAE,SAAS,EACpB,OAAO,EAAE,OAAO,GAAG,MAAM,EACzB,MAAM,EAAE,eAAe,GACtB,SAAS;IA+CZ,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS;IAIzD,MAAM,CAAC,UAAU,IAAI,SAAS,EAAE;IAIhC,MAAM,CAAC,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG;QACzC,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;KACpB;CA+BF"}

package/dist/factories/template-factory.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TemplateFactory = void 0;
+const theme_enum_1 = require("../core/enums/theme.enum");
+const system_theme_1 = require("../templates/themes/system.theme");
+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 template_builder_1 = require("../templates/base/template-builder");
+class TemplateFactory {
+    static createTemplate(themeType, variant, config) {
+        const theme = this.themes.get(themeType);
+        if (!theme) {
+            throw new Error(`Theme ${themeType} not found`);
+        }
+        return {
+            name: `${themeType}_${variant}`,
+            theme: themeType,
+            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 || `
+          <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>
+            </tr>
+          </table>
+        `;
+                builder.buildHeader(data.headerContent).buildBody(bodyContent);
+                if (body.buttonText && body.buttonUrl) {
+                    builder.buildButton(body.buttonText, body.buttonUrl, body.buttonVariant);
+                }
+                return builder
+                    .buildFooter()
+                    .build();
+            }
+        };
+    }
+    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']
+            }
+        };
+        return themeInfo[themeType];
+    }
+}
+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

@@ -0,0 +1,15 @@
+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 { EmailService } from './services/email.service';
+export { AttachmentService } from './services/attachment.service';
+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';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,27 @@
+"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;
+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");
+Object.defineProperty(exports, "TemplateFactory", { enumerable: true, get: function () { return template_factory_1.TemplateFactory; } });
+var theme_enum_1 = require("./core/enums/theme.enum");
+Object.defineProperty(exports, "ThemeType", { enumerable: true, get: function () { return theme_enum_1.ThemeType; } });
+var template_service_1 = require("./services/template.service");
+Object.defineProperty(exports, "TemplateService", { enumerable: true, get: function () { return template_service_1.TemplateService; } });
+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 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");
+Object.defineProperty(exports, "CorporateTheme", { enumerable: true, get: function () { return corporate_theme_1.CorporateTheme; } });
+var minimal_theme_1 = require("./templates/themes/minimal.theme");
+Object.defineProperty(exports, "MinimalTheme", { enumerable: true, get: function () { return minimal_theme_1.MinimalTheme; } });
+var modern_theme_1 = require("./templates/themes/modern.theme");
+Object.defineProperty(exports, "ModernTheme", { enumerable: true, get: function () { return modern_theme_1.ModernTheme; } });
+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; } });

package/dist/services/attachment.service.d.ts

@@ -0,0 +1,46 @@
+import { IAttachment } from '../core/interfaces/email.interface';
+/**
+ * AttachmentService - Gerencia anexos para emails
+ *
+ * Métodos:
+ * - addFromPath(filePath: string, options?: Partial<IAttachment>): Promise<IAttachment>
+ *   Adiciona um anexo a partir de um caminho de arquivo.
+ *
+ * - addFromBuffer(buffer: Buffer, filename: string, options?: Partial<IAttachment>): Promise<IAttachment>
+ *   Adiciona um anexo a partir de um buffer em memória.
+ *
+ * - addFromUrl(url: string, filename: string): Promise<IAttachment>
+ *   Adiciona um anexo a partir de uma URL (ainda não implementado).
+ *
+ * Exemplo de uso:
+ *
+ * const attachmentService = new AttachmentService();
+ * const attachment = await attachmentService.addFromPath('path/to/file.pdf');
+ *
+ * emailFactory.sendEmail({
+ *   to: 'user@example.com',
+ *   subject: 'Assunto do Email',
+ *   template: myTemplate,
+ *   attachments: [{...attachment}]
+ * });
+ */
+export declare class AttachmentService {
+    /**
+     * addFromPath - Adiciona um anexo a partir de um caminho de arquivo
+     * @param filePath - Caminho do arquivo a ser anexado
+     * @param options - Opções adicionais para o anexo (filename, contentType, cid)
+     * @returns Promise<IAttachment> - Objeto de anexo formatado para Nodemailer
+     * @throws Error se o caminho não for um arquivo válido
+     */
+    addFromPath(filePath: string, options?: Partial<IAttachment>): Promise<IAttachment>;
+    addFromBuffer(buffer: Buffer, filename: string, options?: Partial<IAttachment>): Promise<IAttachment>;
+    /**
+     * addFromUrl - Adiciona um anexo a partir de uma URL (a ser implementado)
+     * @param url - URL do recurso a ser anexado
+     * @param filename - Nome do arquivo para o anexo
+     * @returns Promise<IAttachment> - Objeto de anexo formatado para Nodemailer
+     * @throws Error se o método não for implementado
+     */
+    addFromUrl(url: string, filename: string): Promise<IAttachment>;
+}
+//# sourceMappingURL=attachment.service.d.ts.map

package/dist/services/attachment.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachment.service.d.ts","sourceRoot":"","sources":["../../src/services/attachment.service.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,qBAAa,iBAAiB;IAC5B;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC;IAcnF,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,GAC7B,OAAO,CAAC,WAAW,CAAC;IASvB;;;;;;OAMG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAGhE"}