tzmail 1.0.0

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

@@ -0,0 +1,48 @@
+/// <reference types="node" />
+/// <reference types="node" />
+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"}

package/dist/services/attachment.service.js

@@ -0,0 +1,93 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttachmentService = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * 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}]
+ * });
+ */
+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
+     */
+    async addFromPath(filePath, options) {
+        const stats = await fs.promises.stat(filePath);
+        if (!stats.isFile()) {
+            throw new Error(`Path is not a file: ${filePath}`);
+        }
+        return {
+            filename: (options === null || options === void 0 ? void 0 : options.filename) || path.basename(filePath),
+            path: filePath,
+            contentType: options === null || options === void 0 ? void 0 : options.contentType,
+            cid: options === null || options === void 0 ? void 0 : options.cid
+        };
+    }
+    async addFromBuffer(buffer, filename, options) {
+        return {
+            filename,
+            content: buffer,
+            contentType: options === null || options === void 0 ? void 0 : options.contentType,
+            cid: options === null || options === void 0 ? void 0 : options.cid
+        };
+    }
+    /**
+     * 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, filename) {
+        throw new Error('Method not implemented yet');
+    }
+}
+exports.AttachmentService = AttachmentService;

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

@@ -0,0 +1,31 @@
+import { Transporter } from 'nodemailer';
+import { IEmailOptions } from '../core/interfaces/email.interface';
+/**
+ * EmailService - Gerencia o envio de emails usando Nodemailer
+ *
+ * Métodos:
+ * - send(options: IEmailOptions): Promise<any>
+ *   Envia um email com as opções especificadas.
+ *
+ * Exemplo de uso:
+ *
+ * const emailService = new EmailService(transporter, 'from@example.com');
+ * const result = await emailService.send({
+ *   to: 'to@example.com',
+ *   subject: 'Assunto do Email',
+ *   template: myTemplate
+ * });
+ */
+export declare class EmailService {
+    private transporter;
+    private defaultFrom?;
+    constructor(transporter: Transporter, defaultFrom?: string | undefined);
+    /**
+     * send - Envia um email com as opções especificadas
+     * @param options - Opções para o email (to, cc, bcc, subject, text, html, template, attachments)
+     * @returns Promise<any> - Resultado do envio do email
+     * @throws Error se o envio falhar
+     */
+    send(options: IEmailOptions): Promise<any>;
+}
+//# sourceMappingURL=email.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email.service.d.ts","sourceRoot":"","sources":["../../src/services/email.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEnE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,WAAW;IACnB,OAAO,CAAC,WAAW,CAAC;gBADZ,WAAW,EAAE,WAAW,EACxB,WAAW,CAAC,oBAAQ;IAG9B;;;;;OAKG;IACG,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC;CA0BjD"}

package/dist/services/email.service.js

@@ -0,0 +1,58 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailService = void 0;
+/**
+ * EmailService - Gerencia o envio de emails usando Nodemailer
+ *
+ * Métodos:
+ * - send(options: IEmailOptions): Promise<any>
+ *   Envia um email com as opções especificadas.
+ *
+ * Exemplo de uso:
+ *
+ * const emailService = new EmailService(transporter, 'from@example.com');
+ * const result = await emailService.send({
+ *   to: 'to@example.com',
+ *   subject: 'Assunto do Email',
+ *   template: myTemplate
+ * });
+ */
+class EmailService {
+    constructor(transporter, defaultFrom) {
+        this.transporter = transporter;
+        this.defaultFrom = defaultFrom;
+    }
+    /**
+     * send - Envia um email com as opções especificadas
+     * @param options - Opções para o email (to, cc, bcc, subject, text, html, template, attachments)
+     * @returns Promise<any> - Resultado do envio do email
+     * @throws Error se o envio falhar
+     */
+    async send(options) {
+        const mailOptions = {
+            from: options.from || this.defaultFrom,
+            to: Array.isArray(options.to) ? options.to.join(',') : options.to,
+            cc: options.cc,
+            bcc: options.bcc,
+            subject: options.subject,
+            text: options.text,
+            html: options.html || (options.template ? await options.template.render(options) : undefined),
+            attachments: options.attachments
+        };
+        try {
+            const info = await this.transporter.sendMail(mailOptions);
+            return {
+                success: true,
+                messageId: info.messageId,
+                response: info.response
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error
+            };
+        }
+    }
+}
+exports.EmailService = EmailService;

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

@@ -0,0 +1,180 @@
+import { ITemplate, ITemplateConfig } from '../core/interfaces/template.interface';
+import { ThemeType } from '../core/enums/theme.enum';
+interface TemplateCache {
+    template: ITemplate;
+    createdAt: Date;
+    expiresAt: Date;
+    hits: number;
+}
+interface TemplateOptions {
+    cache?: boolean;
+    cacheTTL?: number;
+    validateConfig?: boolean;
+    minify?: boolean;
+    preview?: boolean;
+}
+/**
+ * TemplateService - Gerencia a criação, renderização e gerenciamento de templates de email
+ *
+ * Métodos:
+ * - createTemplate(themeType, variant, config, options): ITemplate
+ *   Cria um novo template com as configurações especificadas.
+ *
+ * - cloneTemplate(template, modifications): ITemplate
+ *   Cria um template a partir de um template existente (clone).
+ *
+ * - renderTemplate(template, data, options): Promise<string>
+ *   Renderiza um template com os dados fornecidos.
+ *
+ * - previewTemplate(themeType, variant, config, data): Promise<string>
+ *   Pré-visualiza um template sem enviar email.
+ *
+ * - getThemeInfo(themeType): object
+ *   Obtém informações sobre um tema específico.
+ *
+ * - listThemes(): ThemeType[]
+ *   Lista todos os temas disponíveis.
+ *
+ * - getTemplateStats(): object
+ *   Obtém estatísticas de uso dos templates.
+ *
+ * - clearCache(themeType?): number
+ *   Limpa o cache de templates, opcionalmente por tema.
+ *
+ * - getTemplateHistory(templateId): ITemplate[]
+ *   Obtém histórico de versões de um template.
+ *
+ * - restoreTemplateVersion(templateId, versionIndex): ITemplate | null
+ *   Restaura uma versão anterior do template.
+ *
+ * Exemplo de uso:
+ *
+ * const templateService = new TemplateService();
+ * const myTemplate = templateService.createTemplate(ThemeType.MODERN, 'light', { header: { show: true } });
+ * const html = await templateService.renderTemplate(myTemplate, { username: 'John' });
+ * console.log(html);
+ */
+export declare class TemplateService {
+    private options;
+    private templateCache;
+    private defaultTTL;
+    private templateHistory;
+    constructor(options?: TemplateOptions);
+    /**
+     * Cria um novo template com as configurações especificadas
+     */
+    createTemplate(themeType: ThemeType, variant: 'light' | 'dark', config: ITemplateConfig, options?: TemplateOptions): ITemplate;
+    /**
+     * Cria um template a partir de um template existente (clone)
+     */
+    cloneTemplate(template: ITemplate, modifications?: Partial<ITemplateConfig>): ITemplate;
+    /**
+     * Renderiza um template com os dados fornecidos
+     */
+    renderTemplate(template: ITemplate, data: any, options?: {
+        preview?: boolean;
+    }): Promise<string>;
+    /**
+     * Pré-visualiza um template sem enviar email
+     */
+    previewTemplate(themeType: ThemeType, variant: 'light' | 'dark', config: ITemplateConfig, data: any): Promise<string>;
+    /**
+     * Obtém informações sobre um tema específico
+     */
+    getThemeInfo(themeType: ThemeType): {
+        name: string;
+        description: string;
+        features: string[];
+        availableVariants: ('light' | 'dark')[];
+        defaultConfig: Partial<ITemplateConfig>;
+    };
+    /**
+     * Lista todos os temas disponíveis
+     */
+    listThemes(): ThemeType[];
+    /**
+     * Obtém estatísticas de uso dos templates
+     */
+    getTemplateStats(): {
+        totalTemplates: number;
+        cachedTemplates: number;
+        totalHits: number;
+        templatesByTheme: Record<ThemeType, number>;
+        cacheHitRate: number;
+    };
+    /**
+     * Limpa o cache de templates
+     */
+    clearCache(themeType?: ThemeType): number;
+    /**
+     * Obtém histórico de versões de um template
+     */
+    getTemplateHistory(templateId: string): ITemplate[];
+    /**
+     * Restaura uma versão anterior do template
+     */
+    restoreTemplateVersion(templateId: string, versionIndex: number): ITemplate | null;
+    /**
+     * Valida a configuração do template
+     */
+    private validateTemplateConfig;
+    /**
+     * Gera um ID único para o template baseado na configuração
+     */
+    private generateTemplateId;
+    /**
+     * Adiciona funcionalidades extras ao template
+     */
+    private enhanceTemplate;
+    /**
+     * Adiciona template ao histórico
+     */
+    private addToHistory;
+    /**
+     * Remove templates expirados do cache
+     */
+    private cleanExpiredCache;
+    /**
+     * Minifica o HTML para reduzir tamanho
+     */
+    private minifyHtml;
+    /**
+     * Obtém configuração padrão para um tema
+     */
+    private getDefaultConfigForTheme;
+    /**
+     * Pré-carrega templates no cache
+     */
+    preloadTemplates(templates: Array<{
+        themeType: ThemeType;
+        variant: 'light' | 'dark';
+        config: ITemplateConfig;
+    }>): Promise<void>;
+    /**
+     * Exporta template para formato JSON
+     */
+    exportTemplate(template: ITemplate): string;
+    /**
+     * Importa template de formato JSON
+     */
+    importTemplate(jsonData: string): ITemplate;
+    /**
+     * Gera um template de exemplo para demonstração
+     */
+    generateExampleTemplate(themeType?: ThemeType, variant?: 'light' | 'dark'): ITemplate;
+    /**
+     * Valida se um template é válido
+     */
+    isValidTemplate(template: any): boolean;
+    /**
+     * Obtém estatísticas detalhadas de um template específico
+     */
+    getTemplateDetails(templateId: string): {
+        template: ITemplate | null;
+        history: ITemplate[];
+        cacheInfo: TemplateCache | null;
+        usageCount: number;
+    };
+}
+export {};
+//# sourceMappingURL=template.service.d.ts.map

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

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