@morojs/moro 1.6.8 → 1.7.0

package/dist/core/mail/mail-adapter.d.ts

@@ -0,0 +1,62 @@
+import type { MailAdapter, MailOptions, MailResult } from './types.js';
+/**
+ * Abstract base class for mail adapters
+ * Provides common functionality and interface
+ */
+export declare abstract class BaseMailAdapter implements MailAdapter {
+    protected config: any;
+    protected initialized: boolean;
+    /**
+     * Initialize adapter with configuration
+     */
+    initialize(config: any): Promise<void>;
+    /**
+     * Send an email (must be implemented by subclasses)
+     */
+    abstract send(options: MailOptions): Promise<MailResult>;
+    /**
+     * Get adapter name (must be implemented by subclasses)
+     */
+    abstract getName(): string;
+    /**
+     * Send multiple emails in bulk
+     * Default implementation sends one by one
+     * Override for better performance
+     */
+    sendBulk(options: MailOptions[]): Promise<MailResult[]>;
+    /**
+     * Verify adapter connection (optional)
+     */
+    verify(): Promise<boolean>;
+    /**
+     * Close adapter connections (optional)
+     */
+    close(): Promise<void>;
+    /**
+     * Normalize email address
+     */
+    protected normalizeAddress(address: string | {
+        name?: string;
+        email: string;
+    }): {
+        name?: string;
+        email: string;
+    };
+    /**
+     * Normalize email addresses array
+     */
+    protected normalizeAddresses(addresses: string | string[] | {
+        name?: string;
+        email: string;
+    } | {
+        name?: string;
+        email: string;
+    }[]): {
+        name?: string;
+        email: string;
+    }[];
+    /**
+     * Check if adapter is initialized
+     */
+    protected ensureInitialized(): void;
+}

package/dist/core/mail/mail-adapter.js

@@ -0,0 +1,83 @@
+// Base Mail Adapter Interface
+// ESM-first module
+/**
+ * Abstract base class for mail adapters
+ * Provides common functionality and interface
+ */
+export class BaseMailAdapter {
+    config;
+    initialized = false;
+    /**
+     * Initialize adapter with configuration
+     */
+    async initialize(config) {
+        this.config = config;
+        this.initialized = true;
+    }
+    /**
+     * Send multiple emails in bulk
+     * Default implementation sends one by one
+     * Override for better performance
+     */
+    async sendBulk(options) {
+        if (!this.initialized) {
+            throw new Error(`${this.getName()} adapter not initialized`);
+        }
+        const results = [];
+        for (const mailOptions of options) {
+            try {
+                const result = await this.send(mailOptions);
+                results.push(result);
+            }
+            catch (error) {
+                results.push({
+                    success: false,
+                    error: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Verify adapter connection (optional)
+     */
+    async verify() {
+        return this.initialized;
+    }
+    /**
+     * Close adapter connections (optional)
+     */
+    async close() {
+        this.initialized = false;
+    }
+    /**
+     * Normalize email address
+     */
+    normalizeAddress(address) {
+        if (typeof address === 'string') {
+            return { email: address };
+        }
+        return address;
+    }
+    /**
+     * Normalize email addresses array
+     */
+    normalizeAddresses(addresses) {
+        if (!addresses) {
+            return [];
+        }
+        if (Array.isArray(addresses)) {
+            return addresses.map(addr => this.normalizeAddress(addr));
+        }
+        return [this.normalizeAddress(addresses)];
+    }
+    /**
+     * Check if adapter is initialized
+     */
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error(`${this.getName()} adapter not initialized. Call initialize() first.`);
+        }
+    }
+}
+//# sourceMappingURL=mail-adapter.js.map

package/dist/core/mail/mail-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mail-adapter.js","sourceRoot":"","sources":["../../../src/core/mail/mail-adapter.ts"],"names":[],"mappings":"AAAA,8BAA8B;AAC9B,mBAAmB;AAInB;;;GAGG;AACH,MAAM,OAAgB,eAAe;IACzB,MAAM,CAAM;IACZ,WAAW,GAAG,KAAK,CAAC;IAE9B;;OAEG;IACH,KAAK,CAAC,UAAU,CAAC,MAAW;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC1B,CAAC;IAYD;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAsB;QACnC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,0BAA0B,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,OAAO,GAAiB,EAAE,CAAC;QAEjC,KAAK,MAAM,WAAW,IAAI,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;gBAC5C,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACvB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,IAAI,CAAC;oBACX,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;iBAC9D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,WAAW,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED;;OAEG;IACO,gBAAgB,CAAC,OAAkD;QAI3E,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC5B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED;;OAEG;IACO,kBAAkB,CAC1B,SAIsC;QAEtC,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5D,CAAC;QAED,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACO,iBAAiB;QACzB,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,EAAE,oDAAoD,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;CACF"}

package/dist/core/mail/mail-manager.d.ts

@@ -0,0 +1,63 @@
+import type { MailConfig, MailOptions, MailResult, MailAdapter } from './types.js';
+import { TemplateEngineManager } from './template-engine.js';
+/**
+ * Main mail manager class
+ * Coordinates adapters, templates, and queue integration
+ */
+export declare class MailManager {
+    private config;
+    private adapter?;
+    private templateEngine?;
+    private logger;
+    private defaultFrom?;
+    private queueManager?;
+    constructor(config?: MailConfig);
+    /**
+     * Initialize mail manager
+     */
+    initialize(): Promise<void>;
+    /**
+     * Load email adapter based on configuration
+     */
+    private loadAdapter;
+    /**
+     * Send an email
+     */
+    send(options: MailOptions): Promise<MailResult>;
+    /**
+     * Send email directly (synchronous)
+     */
+    private sendDirect;
+    /**
+     * Send email via queue (asynchronous)
+     */
+    private sendViaQueue;
+    /**
+     * Send multiple emails in bulk
+     */
+    sendBulk(options: MailOptions[]): Promise<MailResult[]>;
+    /**
+     * Send bulk emails via queue
+     */
+    private sendBulkViaQueue;
+    /**
+     * Set queue manager for async email sending
+     */
+    setQueueManager(queueManager: any): void;
+    /**
+     * Verify adapter connection
+     */
+    verify(): Promise<boolean>;
+    /**
+     * Close connections and clean up
+     */
+    close(): Promise<void>;
+    /**
+     * Get template engine
+     */
+    getTemplateEngine(): TemplateEngineManager | undefined;
+    /**
+     * Get adapter
+     */
+    getAdapter(): MailAdapter | undefined;
+}

package/dist/core/mail/mail-manager.js

@@ -0,0 +1,302 @@
+// Mail Manager - Main Email System Controller
+// ESM-first module
+import { TemplateEngineManager } from './template-engine.js';
+import { createFrameworkLogger } from '../logger/index.js';
+/**
+ * Main mail manager class
+ * Coordinates adapters, templates, and queue integration
+ */
+export class MailManager {
+    config;
+    adapter;
+    templateEngine;
+    logger;
+    defaultFrom;
+    queueManager;
+    constructor(config = {}) {
+        this.config = config;
+        this.logger = createFrameworkLogger('Mail');
+        this.defaultFrom = config.from;
+    }
+    /**
+     * Initialize mail manager
+     */
+    async initialize() {
+        this.logger.info('Initializing mail system', 'Mail', {
+            adapter: this.config.adapter || 'console',
+            templates: !!this.config.templates?.path,
+            queue: this.config.queue?.enabled || false,
+        });
+        // Load adapter
+        await this.loadAdapter();
+        // Initialize template engine if configured
+        if (this.config.templates) {
+            this.templateEngine = new TemplateEngineManager(this.config.templates);
+            if (this.config.templates.engine && this.config.templates.engine !== 'moro') {
+                await this.templateEngine.loadExternalEngine(this.config.templates.engine);
+            }
+            if (this.config.templates.partials) {
+                await this.templateEngine.loadPartials();
+            }
+            if (this.config.templates.helpers) {
+                for (const [name, fn] of Object.entries(this.config.templates.helpers)) {
+                    this.templateEngine.registerHelper(name, fn);
+                }
+            }
+        }
+        this.logger.info('Mail system initialized successfully', 'Mail');
+    }
+    /**
+     * Load email adapter based on configuration
+     */
+    async loadAdapter() {
+        const adapterType = (this.config.adapter || 'console');
+        this.logger.debug(`Loading ${adapterType} adapter`, 'Mail');
+        try {
+            if (adapterType === 'console') {
+                const { ConsoleAdapter } = await import('./adapters/console-adapter.js');
+                this.adapter = new ConsoleAdapter();
+            }
+            else if (adapterType === 'nodemailer') {
+                const { NodemailerAdapter } = await import('./adapters/nodemailer-adapter.js');
+                this.adapter = new NodemailerAdapter();
+            }
+            else if (adapterType === 'sendgrid') {
+                const { SendGridAdapter } = await import('./adapters/sendgrid-adapter.js');
+                this.adapter = new SendGridAdapter();
+            }
+            else if (adapterType === 'ses') {
+                const { SESAdapter } = await import('./adapters/ses-adapter.js');
+                this.adapter = new SESAdapter();
+            }
+            else if (adapterType === 'resend') {
+                const { ResendAdapter } = await import('./adapters/resend-adapter.js');
+                this.adapter = new ResendAdapter();
+            }
+            else {
+                throw new Error(`Unknown mail adapter: ${adapterType}`);
+            }
+            await this.adapter.initialize(this.config.connection || {});
+            this.logger.info(`${this.adapter.getName()} adapter loaded successfully`, 'Mail');
+        }
+        catch (error) {
+            this.logger.error(`Failed to load ${adapterType} adapter`, 'Mail', { error });
+            throw error;
+        }
+    }
+    /**
+     * Send an email
+     */
+    async send(options) {
+        if (!this.adapter) {
+            throw new Error('Mail adapter not initialized');
+        }
+        if (!options.from && !this.defaultFrom) {
+            throw new Error('Email "from" address not specified');
+        }
+        const mailOptions = {
+            ...options,
+            from: options.from || this.defaultFrom,
+        };
+        if (!mailOptions.from) {
+            throw new Error('Email "from" address could not be determined');
+        }
+        if (options.template && this.templateEngine) {
+            try {
+                const rendered = await this.templateEngine.renderFile(options.template, options.data || {});
+                if (rendered.html) {
+                    mailOptions.html = rendered.html;
+                }
+                if (rendered.text) {
+                    mailOptions.text = rendered.text;
+                }
+            }
+            catch (error) {
+                this.logger.error('Template rendering failed', 'Mail', {
+                    error,
+                    template: options.template,
+                });
+                throw error;
+            }
+        }
+        if (this.config.queue?.enabled && this.queueManager) {
+            return this.sendViaQueue(mailOptions);
+        }
+        return this.sendDirect(mailOptions);
+    }
+    /**
+     * Send email directly (synchronous)
+     */
+    async sendDirect(options) {
+        if (!this.adapter) {
+            throw new Error('Mail adapter not initialized');
+        }
+        try {
+            this.logger.debug('Sending email', 'Mail', {
+                to: options.to,
+                subject: options.subject,
+            });
+            const result = await this.adapter.send(options);
+            if (result.success) {
+                this.logger.info('Email sent successfully', 'Mail', {
+                    to: options.to,
+                    subject: options.subject,
+                    messageId: result.messageId,
+                });
+            }
+            else {
+                this.logger.warn('Email send failed', 'Mail', {
+                    to: options.to,
+                    subject: options.subject,
+                    error: result.error,
+                });
+            }
+            return result;
+        }
+        catch (error) {
+            this.logger.error('Email send error', 'Mail', {
+                error,
+                to: options.to,
+                subject: options.subject,
+            });
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Send email via queue (asynchronous)
+     */
+    async sendViaQueue(options) {
+        if (!this.queueManager) {
+            throw new Error('Queue manager not set. Call setQueueManager() first.');
+        }
+        const queueName = this.config.queue?.name || 'emails';
+        try {
+            const job = await this.queueManager.addToQueue(queueName, options, {
+                priority: this.config.queue?.priority || 0,
+                delay: this.config.queue?.delay || 0,
+                attempts: this.config.queue?.attempts || 3,
+            });
+            this.logger.info('Email queued for sending', 'Mail', {
+                jobId: job.id,
+                to: options.to,
+                subject: options.subject,
+            });
+            return {
+                success: true,
+                messageId: job.id,
+            };
+        }
+        catch (error) {
+            this.logger.error('Failed to queue email', 'Mail', { error });
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Send multiple emails in bulk
+     */
+    async sendBulk(options) {
+        if (!this.adapter) {
+            throw new Error('Mail adapter not initialized');
+        }
+        const mailOptions = options.map(opts => ({
+            ...opts,
+            from: opts.from || this.defaultFrom,
+        }));
+        if (mailOptions.some(opts => !opts.from)) {
+            throw new Error('Email "from" address not specified for one or more emails');
+        }
+        if (this.config.queue?.enabled && this.queueManager) {
+            return this.sendBulkViaQueue(mailOptions);
+        }
+        if (this.adapter.sendBulk) {
+            return this.adapter.sendBulk(mailOptions);
+        }
+        const results = [];
+        for (const opts of mailOptions) {
+            results.push(await this.send(opts));
+        }
+        return results;
+    }
+    /**
+     * Send bulk emails via queue
+     */
+    async sendBulkViaQueue(options) {
+        if (!this.queueManager) {
+            throw new Error('Queue manager not set');
+        }
+        const queueName = this.config.queue?.name || 'emails';
+        const jobs = options.map(opts => ({
+            data: opts,
+            options: {
+                priority: this.config.queue?.priority || 0,
+                delay: this.config.queue?.delay || 0,
+                attempts: this.config.queue?.attempts || 3,
+            },
+        }));
+        try {
+            const queuedJobs = await this.queueManager.addBulkToQueue(queueName, jobs);
+            return queuedJobs.map((job) => ({
+                success: true,
+                messageId: job.id,
+            }));
+        }
+        catch (error) {
+            this.logger.error('Failed to queue bulk emails', 'Mail', { error });
+            return options.map(() => ({
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+            }));
+        }
+    }
+    /**
+     * Set queue manager for async email sending
+     */
+    setQueueManager(queueManager) {
+        this.queueManager = queueManager;
+    }
+    /**
+     * Verify adapter connection
+     */
+    async verify() {
+        if (!this.adapter || !this.adapter.verify) {
+            return false;
+        }
+        try {
+            return await this.adapter.verify();
+        }
+        catch (error) {
+            this.logger.error('Adapter verification failed', 'Mail', { error });
+            return false;
+        }
+    }
+    /**
+     * Close connections and clean up
+     */
+    async close() {
+        if (this.adapter?.close) {
+            await this.adapter.close();
+        }
+        if (this.templateEngine) {
+            this.templateEngine.clearCache();
+        }
+    }
+    /**
+     * Get template engine
+     */
+    getTemplateEngine() {
+        return this.templateEngine;
+    }
+    /**
+     * Get adapter
+     */
+    getAdapter() {
+        return this.adapter;
+    }
+}
+//# sourceMappingURL=mail-manager.js.map

package/dist/core/mail/mail-manager.js.map

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

package/dist/core/mail/template-engine.d.ts

@@ -0,0 +1,43 @@
+import type { TemplateConfig, TemplateEngine, TemplateResult } from './types.js';
+/**
+ * Main template engine manager
+ */
+export declare class TemplateEngineManager {
+    private config;
+    private engine;
+    private cache;
+    private engineType;
+    constructor(config?: TemplateConfig);
+    /**
+     * Create template engine instance
+     */
+    private createEngine;
+    /**
+     * Render a template file with data
+     */
+    renderFile(templateName: string, data: Record<string, any>): Promise<TemplateResult>;
+    /**
+     * Render a template string with data
+     */
+    renderString(template: string, data: Record<string, any>): Promise<string>;
+    /**
+     * Load external template engine (Handlebars, EJS)
+     */
+    loadExternalEngine(type: TemplateEngine): Promise<void>;
+    /**
+     * Register a helper function
+     */
+    registerHelper(name: string, fn: (...args: any[]) => any): void;
+    /**
+     * Register a partial template
+     */
+    registerPartial(name: string, template: string): void;
+    /**
+     * Clear template cache
+     */
+    clearCache(): void;
+    /**
+     * Load partials from directory
+     */
+    loadPartials(): Promise<void>;
+}