@drax/email-back 0.9.0

package/dist/config/EmailConfig.js

@@ -0,0 +1,14 @@
+var EmailConfig;
+(function (EmailConfig) {
+    EmailConfig["type"] = "EMAIL_TYPE";
+    EmailConfig["service"] = "EMAIL_SERVICE";
+    EmailConfig["smtpHost"] = "EMAIL_HOST";
+    EmailConfig["smtpPort"] = "EMAIL_PORT";
+    EmailConfig["authType"] = "EMAIL_AUTH_TYPE";
+    EmailConfig["authUsername"] = "EMAIL_AUTH_USERNAME";
+    EmailConfig["authPassword"] = "EMAIL_AUTH_PASSWORD";
+    EmailConfig["secure"] = "EMAIL_SECURE";
+    EmailConfig["ignoreTLS"] = "EMAIL_IGNORE_TLS";
+})(EmailConfig || (EmailConfig = {}));
+export default EmailConfig;
+export { EmailConfig };

package/dist/factory/EmailServiceFactory.js

@@ -0,0 +1,46 @@
+import { DraxConfig } from "@drax/common-back";
+import { EmailService } from '../services/EmailService.js';
+import EmailConfig from "../config/EmailConfig";
+class EmailServiceFactory {
+    static get instance() {
+        if (!EmailServiceFactory.service) {
+            const type = EmailServiceFactory.getType;
+            const options = EmailServiceFactory.getOptions;
+            EmailServiceFactory.service = new EmailService(type, options);
+        }
+        return EmailServiceFactory.service;
+    }
+    static get getType() {
+        return DraxConfig.getOrLoad(EmailConfig.type);
+    }
+    static get getOptions() {
+        let options;
+        switch (DraxConfig.getOrLoad(EmailConfig.type)) {
+            case 'smtp':
+                options = {
+                    host: DraxConfig.getOrLoad(EmailConfig.smtpHost),
+                    port: DraxConfig.getOrLoad(EmailConfig.smtpPort),
+                    secure: DraxConfig.getOrLoad(EmailConfig.secure),
+                    ignoreTLS: DraxConfig.getOrLoad(EmailConfig.ignoreTLS),
+                    auth: {
+                        user: DraxConfig.getOrLoad(EmailConfig.authUsername),
+                        pass: DraxConfig.getOrLoad(EmailConfig.authPassword),
+                    },
+                };
+                break;
+            case 'gmail':
+                options = {
+                    auth: {
+                        user: DraxConfig.getOrLoad(EmailConfig.authUsername),
+                        pass: DraxConfig.getOrLoad(EmailConfig.authPassword),
+                    }
+                };
+                break;
+            default:
+                throw new Error(`Unsupported email service type: ${DraxConfig.getOrLoad(EmailConfig.type)}`);
+        }
+        return options;
+    }
+}
+export default EmailServiceFactory;
+export { EmailServiceFactory };

package/dist/index.js

@@ -0,0 +1,4 @@
+import EmailConfig from "./config/EmailConfig.js";
+import EmailService from "./services/EmailService.js";
+import EmailLayoutService from "./services/EmailLayoutService.js";
+export { EmailConfig, EmailService, EmailLayoutService, };

package/dist/interfaces/IEmailLayout.js

@@ -0,0 +1 @@
+export {};

package/dist/interfaces/ITransportConfig.js

@@ -0,0 +1 @@
+export {};

package/dist/services/EmailLayoutService.js

@@ -0,0 +1,106 @@
+class EmailLayoutService {
+    constructor(options = {}) {
+        const defaultOptions = {
+            bodyStyle: 'font-family: Arial, sans-serif; margin: 0; padding: 0; background-color: #fcfcfc;',
+            maxWidth: "800px",
+            headerCentered: true,
+            headerBgColor: "#f4f4f4",
+            headerColor: "#111111",
+            headerImage: "",
+            headerImageStyle: "width: auto; height: auto; display: block; margin: 0 auto;",
+            headerTitle: "",
+            headerTitleStyle: "font-size: 28px; color: #333333; margin: 10px; font-weight: 700; display: inline-block;",
+            headerLogo: "",
+            headerLogoStyle: "max-height: 50px; display: block; margin: 10px auto;",
+            footerBgColor: "#f4f4f4",
+            footerCopyright: "Your Company. All rights reserved.",
+            footerContent: "Default footer content",
+            footerUnsubscribe: "",
+        };
+        this.options = { ...defaultOptions, ...options };
+    }
+    get head() {
+        return `<head>
+                <meta charset="UTF-8">
+                <meta name="viewport" content="width=device-width, initial-scale=1.0">
+            </head>`;
+    }
+    get header() {
+        let header = `<tr style="background-color: ${this.options.headerBgColor}">
+        <td style="${this.options.headerCentered ? 'text-align: center;' : ''} vertical-align: middle;">`;
+        if (this.options.headerImage) {
+            header += `<img src="${this.options.headerImage}" 
+                            alt="${this.options.headerTitle}" 
+                            style="${this.options.headerImageStyle}"
+                        />`;
+        }
+        else if (this.options.headerLogo && this.options.headerTitle) {
+            header += `<table style="display: inline-table; text-align: left;">
+                        <tr>
+                          <td style="vertical-align: middle; padding: 10px;">
+                            <img src="${this.options.headerLogo}" 
+                                 alt="${this.options.headerTitle}" 
+                                 style="${this.options.headerLogoStyle}" 
+                            />
+                          </td>
+                          <td style="vertical-align: middle;">
+                            <h1 style="${this.options.headerTitleStyle}">${this.options.headerTitle}</h1>
+                          </td>
+                        </tr>
+                      </table>`;
+        }
+        else if (this.options.headerTitle) {
+            header += `<h1 style="${this.options.headerTitleStyle}"
+                       >
+                            ${this.options.headerTitle}
+                       </h1>`;
+        }
+        else if (this.options.headerLogo) {
+            header += `<img src="${this.options.headerLogo}" alt="${this.options.headerTitle}" 
+                            style="${this.options.headerLogoStyle}" 
+                        />`;
+        }
+        header += `</td></tr>`;
+        return header;
+    }
+    get footer() {
+        let footer = `<tr style=" ${this.options.footerBgColor ? 'background-color:' + this.options.footerBgColor : ''}">
+        <td style="text-align: center; padding: 20px; font-size: 12px; color: #888888;">`;
+        if (this.options.footerCopyright) {
+            footer += ` <p style="margin: 0;">&copy; ${new Date().getFullYear()} ${this.options.footerCopyright}.</p>`;
+        }
+        if (this.options.footerContent) {
+            footer += `${this.options.footerContent}`;
+        }
+        if (this.options.footerUnsubscribe) {
+            footer += `${this.options.footerUnsubscribe}`;
+            //footer += `<p style="margin: 5px 0 0 0;">Si no deseas recibir nuestros correos, <a href="${this.options.unsubscribeLink}" target="_blank" style="color: #555555; text-decoration: none;">haz clic aquí</a> para darte de baja.</p>`
+        }
+        footer += `</td></tr>`;
+        return footer;
+    }
+    html(body) {
+        return `<!DOCTYPE html>
+            <html lang="es">
+            ${this.head}
+          <body style="${this.options.bodyStyle}">
+            <table role="presentation" 
+                   style="border-spacing: 0;  margin: 0 auto; width: 100%; max-width: ${this.options.maxWidth}"
+            >
+            
+                <!-- HEADER -->
+                ${this.header}
+                <!-- BODY -->
+                <tr>
+                    <td style="padding: 20px; background-color: #ffffff;">
+                        ${body}
+                    </td>
+                </tr>
+                <!-- FOOTER -->
+                ${this.footer}
+            </table>
+            </body>`;
+    }
+}
+export default EmailLayoutService;
+export { EmailLayoutService };

package/dist/services/EmailService.js

@@ -0,0 +1,58 @@
+import nodemailer from 'nodemailer';
+class EmailService {
+    constructor(type, config) {
+        this.transporterConfig = config;
+        switch (type) {
+            case 'smtp':
+                this.prepareTransportSmtp(config);
+                break;
+            case 'gmail':
+                this.prepareTransportGmail(config);
+                break;
+            default:
+                throw new Error(`Unsupported email service type: ${type}`);
+        }
+    }
+    prepareTransportGmail(config) {
+        this.transporter = nodemailer.createTransport({
+            service: 'gmail',
+            auth: {
+                user: config.auth.user,
+                pass: config.auth.pass
+            }
+        });
+    }
+    prepareTransportSmtp(config) {
+        this.transporter = nodemailer.createTransport({
+            host: config.host,
+            port: config.port,
+            secure: config.secure,
+            ignoreTLS: config.ignoreTLS,
+            auth: (config.auth.user && config.auth.pass) ? {
+                type: config.auth.type ? config.auth.type : 'login',
+                user: config.auth.user,
+                pass: config.auth.pass
+            } : null
+        });
+    }
+    sendEmail(options) {
+        if (!this.transporter) {
+            throw new Error('Transporter is not initialized');
+        }
+        if (!options.to) {
+            throw new Error('No recipient provided');
+        }
+        if (!options.html && !options.text) {
+            throw new Error('Either HTML or TEXT content is required');
+        }
+        if (!options.subject) {
+            throw new Error('No subject provided');
+        }
+        if (!options.from) {
+            options.from = this.transporterConfig.auth.user;
+        }
+        return this.transporter.sendMail(options);
+    }
+}
+export default EmailService;
+export { EmailService };

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@drax/email-back",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.9.0",
+  "description": "Email utils across modules",
+  "main": "dist/index.js",
+  "types": "types/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "prepublish": "tsc && npm run copygql",
+    "tscrun": "tsc",
+    "clean": "rm -rf dist",
+    "copygql": "copyfiles -u 1 ./**/*.graphql dist/",
+    "tsc": "tsc -b tsconfig.json",
+    "test": "node --import tsx --test test/**/*",
+    "testCache": "node --import tsx --test test/cache/*",
+    "testMongoose": "node --import tsx --test test/mongoose/*"
+  },
+  "author": "Cristian Incarnato & Drax Team",
+  "license": "ISC",
+  "peerDependencies": {
+    "nodemailer": "^6.9.16",
+    "preview-email": "^3.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.12.10",
+    "@types/nodemailer": "^6.4.17",
+    "@types/preview-email": "^3.1.0",
+    "copyfiles": "^2.4.1",
+    "mongoose-paginate-v2": "^1.8.3",
+    "nodemailer": "^6.9.16",
+    "nodemon": "^3.1.0",
+    "preview-email": "^3.1.0",
+    "ts-node": "^10.9.2",
+    "tsc-alias": "^1.8.10",
+    "typescript": "^5.6.2",
+    "vitest": "^2.1.8"
+  },
+  "gitHead": "aae0068b0343cbb23e85c2a9ea454e183739a8a7"
+}

package/src/config/EmailConfig.ts

@@ -0,0 +1,14 @@
+enum EmailConfig {
+    type = "EMAIL_TYPE",
+    service = "EMAIL_SERVICE",
+    smtpHost = "EMAIL_HOST",
+    smtpPort = "EMAIL_PORT",
+    authType = "EMAIL_AUTH_TYPE",
+    authUsername = "EMAIL_AUTH_USERNAME",
+    authPassword = "EMAIL_AUTH_PASSWORD",
+    secure = "EMAIL_SECURE",
+    ignoreTLS = "EMAIL_IGNORE_TLS",
+}
+
+export default EmailConfig;
+export {EmailConfig};

package/src/factory/EmailServiceFactory.ts

@@ -0,0 +1,56 @@
+import {DraxConfig} from "@drax/common-back";
+import {EmailService} from '../services/EmailService.js'
+import EmailConfig from "../config/EmailConfig";
+import {TransportGmailConfig, TransportSmtpConfig} from "../interfaces/ITransportConfig";
+
+class EmailServiceFactory {
+    private static service: EmailService;
+
+    public static get instance(): EmailService {
+        if (!EmailServiceFactory.service) {
+            const type = EmailServiceFactory.getType;
+            const options = EmailServiceFactory.getOptions;
+            EmailServiceFactory.service = new EmailService(type, options);
+        }
+        return EmailServiceFactory.service;
+    }
+
+    public static get getType()  {
+        return DraxConfig.getOrLoad(EmailConfig.type)
+    }
+
+    public static get getOptions()  {
+        let options: TransportSmtpConfig | TransportGmailConfig;
+        switch(DraxConfig.getOrLoad(EmailConfig.type)){
+            case 'smtp':
+                options = {
+                    host: DraxConfig.getOrLoad(EmailConfig.smtpHost),
+                    port: DraxConfig.getOrLoad(EmailConfig.smtpPort),
+                    secure: DraxConfig.getOrLoad(EmailConfig.secure),
+                    ignoreTLS: DraxConfig.getOrLoad(EmailConfig.ignoreTLS),
+                    auth: {
+                        user: DraxConfig.getOrLoad(EmailConfig.authUsername),
+                        pass: DraxConfig.getOrLoad(EmailConfig.authPassword),
+                    },
+                }
+                break;
+            case 'gmail':
+                options = {
+                    auth: {
+                        user: DraxConfig.getOrLoad(EmailConfig.authUsername),
+                        pass: DraxConfig.getOrLoad(EmailConfig.authPassword),
+                    }
+                }
+                break;
+            default:
+                throw new Error(`Unsupported email service type: ${DraxConfig.getOrLoad(EmailConfig.type)}`)
+        }
+        return options;
+    }
+}
+
+export default EmailServiceFactory
+export {
+    EmailServiceFactory
+}
+

package/src/index.ts

@@ -0,0 +1,18 @@
+import EmailConfig from "./config/EmailConfig.js";
+import EmailService from "./services/EmailService.js";
+import EmailLayoutService from "./services/EmailLayoutService.js";
+import type {IEmailLayout} from "./interfaces/IEmailLayout"
+import type {TransportGmailConfig, TransportSmtpConfig} from "./interfaces/ITransportConfig"
+
+export type {
+    IEmailLayout,
+    TransportGmailConfig,
+    TransportSmtpConfig,
+}
+
+
+export {
+    EmailConfig,
+    EmailService,
+    EmailLayoutService,
+}

package/src/interfaces/IEmailLayout.ts

@@ -0,0 +1,25 @@
+interface IEmailLayout{
+
+    bodyStyle?:string
+    maxWidth?: string
+
+    headerCentered?: boolean
+    headerBgColor?: string
+    headerColor?: string
+
+    headerImage?: string
+    headerImageStyle?: string
+
+    headerTitle?: string
+    headerTitleStyle?: string
+
+    headerLogo?: string
+    headerLogoStyle?: string
+
+    footerBgColor?: string
+    footerCopyright?: string
+    footerContent?: string
+    footerUnsubscribe?: string
+}
+
+export type {IEmailLayout}

package/src/interfaces/ITransportConfig.ts

@@ -0,0 +1,21 @@
+interface TransportSmtpConfig {
+    host: string;
+    port: number;
+    secure: boolean;
+    ignoreTLS: boolean;
+    auth: {
+        type: 'login' | 'oauth2';
+        user: string;
+        pass: string;
+    } | null;
+}
+
+interface TransportGmailConfig {
+    auth: {
+        user: string;
+        pass: string;
+    };
+}
+
+
+export type {TransportSmtpConfig, TransportGmailConfig}

package/src/services/EmailLayoutService.ts

@@ -0,0 +1,123 @@
+import {IEmailLayout} from "../interfaces/IEmailLayout";
+
+
+class EmailLayoutService {
+
+    options: IEmailLayout
+
+    constructor(options: IEmailLayout = {}) {
+        const defaultOptions: IEmailLayout = {
+            bodyStyle: 'font-family: Arial, sans-serif; margin: 0; padding: 0; background-color: #fcfcfc;',
+            maxWidth: "800px",
+            headerCentered: true,
+            headerBgColor: "#f4f4f4",
+            headerColor: "#111111",
+            headerImage: "",
+            headerImageStyle: "width: auto; height: auto; display: block; margin: 0 auto;",
+            headerTitle: "",
+            headerTitleStyle: "font-size: 28px; color: #333333; margin: 10px; font-weight: 700; display: inline-block;",
+            headerLogo: "",
+            headerLogoStyle: "max-height: 50px; display: block; margin: 10px auto;",
+            footerBgColor: "#f4f4f4",
+            footerCopyright: "Your Company. All rights reserved.",
+            footerContent: "Default footer content",
+            footerUnsubscribe: "",
+        };
+        this.options = { ...defaultOptions, ...options };
+    }
+
+    get head() {
+        return `<head>
+                <meta charset="UTF-8">
+                <meta name="viewport" content="width=device-width, initial-scale=1.0">
+            </head>`
+    }
+
+    get header() {
+        let header = `<tr style="background-color: ${this.options.headerBgColor}">
+        <td style="${this.options.headerCentered ? 'text-align: center;' : ''} vertical-align: middle;">`
+
+        if (this.options.headerImage) {
+            header += `<img src="${this.options.headerImage}" 
+                            alt="${this.options.headerTitle}" 
+                            style="${this.options.headerImageStyle}"
+                        />`
+        } else if (this.options.headerLogo && this.options.headerTitle) {
+            header += `<table style="display: inline-table; text-align: left;">
+                        <tr>
+                          <td style="vertical-align: middle; padding: 10px;">
+                            <img src="${this.options.headerLogo}" 
+                                 alt="${this.options.headerTitle}" 
+                                 style="${this.options.headerLogoStyle}" 
+                            />
+                          </td>
+                          <td style="vertical-align: middle;">
+                            <h1 style="${this.options.headerTitleStyle}">${this.options.headerTitle}</h1>
+                          </td>
+                        </tr>
+                      </table>`
+        } else if (this.options.headerTitle) {
+            header += `<h1 style="${this.options.headerTitleStyle}"
+                       >
+                            ${this.options.headerTitle}
+                       </h1>`
+        }else if (this.options.headerLogo) {
+            header += `<img src="${this.options.headerLogo}" alt="${this.options.headerTitle}" 
+                            style="${this.options.headerLogoStyle}" 
+                        />`
+        }
+        header += `</td></tr>`
+        return header
+    }
+
+    get footer() {
+        let footer = `<tr style=" ${this.options.footerBgColor ? 'background-color:'+this.options.footerBgColor : ''}">
+        <td style="text-align: center; padding: 20px; font-size: 12px; color: #888888;">`
+
+        if (this.options.footerCopyright) {
+            footer += ` <p style="margin: 0;">&copy; ${new Date().getFullYear()} ${this.options.footerCopyright}.</p>`
+        }
+
+        if (this.options.footerContent) {
+            footer += `${this.options.footerContent}`
+        }
+
+        if (this.options.footerUnsubscribe) {
+            footer += `${this.options.footerUnsubscribe}`
+            //footer += `<p style="margin: 5px 0 0 0;">Si no deseas recibir nuestros correos, <a href="${this.options.unsubscribeLink}" target="_blank" style="color: #555555; text-decoration: none;">haz clic aquí</a> para darte de baja.</p>`
+        }
+
+        footer += `</td></tr>`
+
+        return footer
+    }
+
+    html(body: string) {
+        return `<!DOCTYPE html>
+            <html lang="es">
+            ${this.head}
+          <body style="${this.options.bodyStyle}">
+            <table role="presentation" 
+                   style="border-spacing: 0;  margin: 0 auto; width: 100%; max-width: ${this.options.maxWidth}"
+            >
+            
+                <!-- HEADER -->
+                ${this.header}
+                <!-- BODY -->
+                <tr>
+                    <td style="padding: 20px; background-color: #ffffff;">
+                        ${body}
+                    </td>
+                </tr>
+                <!-- FOOTER -->
+                ${this.footer}
+            </table>
+            </body>`
+    }
+
+
+}
+
+
+export default EmailLayoutService
+export {EmailLayoutService}

package/src/services/EmailService.ts

@@ -0,0 +1,81 @@
+import nodemailer from 'nodemailer';
+
+import type {Transporter, SendMailOptions} from "nodemailer";
+import type {TransportGmailConfig, TransportSmtpConfig} from "../interfaces/ITransportConfig";
+
+
+class EmailService {
+
+    transporter: Transporter;
+    transporterConfig : TransportGmailConfig | TransportSmtpConfig;
+
+    constructor(type: 'smtp' | 'gmail', config: TransportGmailConfig | TransportSmtpConfig) {
+        this.transporterConfig = config;
+        switch (type) {
+            case 'smtp':
+                this.prepareTransportSmtp(config as TransportSmtpConfig);
+                break;
+            case 'gmail':
+                this.prepareTransportGmail(config as TransportGmailConfig);
+                break;
+            default:
+                throw new Error(`Unsupported email service type: ${type}`)
+        }
+    }
+
+
+    prepareTransportGmail(config: TransportGmailConfig): any {
+        this.transporter = nodemailer.createTransport({
+            service: 'gmail',
+            auth: {
+                user: config.auth.user,
+                pass: config.auth.pass
+            }
+        });
+    }
+
+
+    prepareTransportSmtp(config: TransportSmtpConfig): any {
+        this.transporter = nodemailer.createTransport({
+            host: config.host,
+            port: config.port,
+            secure: config.secure,
+            ignoreTLS: config.ignoreTLS,
+            auth: (config.auth.user && config.auth.pass) ? {
+                type: config.auth.type ? config.auth.type : 'login',
+                user: config.auth.user,
+                pass: config.auth.pass
+            } : null
+        });
+    }
+
+
+    sendEmail(options: SendMailOptions): Promise<any> {
+
+        if(!this.transporter){
+            throw new Error('Transporter is not initialized')
+        }
+
+        if(!options.to){
+            throw new Error('No recipient provided')
+        }
+
+        if(!options.html && !options.text){
+            throw new Error('Either HTML or TEXT content is required')
+        }
+
+        if(!options.subject){
+            throw new Error('No subject provided')
+        }
+
+        if(!options.from){
+            options.from = this.transporterConfig.auth.user
+        }
+
+        return this.transporter.sendMail(options);
+    }
+
+}
+
+export default EmailService
+export {EmailService}