@morojs/moro 1.6.6 → 1.7.0

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

@@ -0,0 +1,167 @@
+// AWS SES Adapter - Amazon Simple Email Service
+// ESM-first module with lazy loading
+import { BaseMailAdapter } from '../mail-adapter.js';
+import { isPackageAvailable, resolveUserPackage } from '../../utilities/package-utils.js';
+import { createFrameworkLogger } from '../../logger/index.js';
+/**
+ * AWS SES adapter for email sending
+ * Supports AWS Simple Email Service
+ */
+export class SESAdapter extends BaseMailAdapter {
+    client;
+    logger;
+    configurationSet;
+    constructor() {
+        super();
+        this.logger = createFrameworkLogger('Mail:SES');
+    }
+    async initialize(config) {
+        if (!config.region) {
+            throw new Error('AWS region is required for SES adapter');
+        }
+        if (!isPackageAvailable('@aws-sdk/client-ses')) {
+            throw new Error('AWS SES SDK is not installed.\n' +
+                'Install it with: npm install @aws-sdk/client-ses\n' +
+                'Or use a different mail adapter.');
+        }
+        const sesPath = resolveUserPackage('@aws-sdk/client-ses');
+        const { SESClient } = await import(sesPath);
+        const clientConfig = {
+            region: config.region,
+        };
+        if (config.credentials) {
+            clientConfig.credentials = config.credentials;
+        }
+        else if (config.accessKeyId && config.secretAccessKey) {
+            clientConfig.credentials = {
+                accessKeyId: config.accessKeyId,
+                secretAccessKey: config.secretAccessKey,
+            };
+        }
+        this.client = new SESClient(clientConfig);
+        this.configurationSet = config.configurationSet;
+        await super.initialize(config);
+        this.logger.info('AWS SES adapter initialized', 'Mail');
+    }
+    async send(options) {
+        this.ensureInitialized();
+        if (!this.client) {
+            throw new Error('SES client not initialized');
+        }
+        try {
+            const sesPath = resolveUserPackage('@aws-sdk/client-ses');
+            const { SendEmailCommand } = await import(sesPath);
+            const destination = {
+                ToAddresses: this.formatAddressesArray(options.to),
+            };
+            if (options.cc) {
+                destination.CcAddresses = this.formatAddressesArray(options.cc);
+            }
+            if (options.bcc) {
+                destination.BccAddresses = this.formatAddressesArray(options.bcc);
+            }
+            const message = {
+                Subject: {
+                    Data: options.subject,
+                    Charset: 'UTF-8',
+                },
+                Body: {},
+            };
+            if (options.text) {
+                message.Body.Text = {
+                    Data: options.text,
+                    Charset: 'UTF-8',
+                };
+            }
+            if (options.html) {
+                message.Body.Html = {
+                    Data: options.html,
+                    Charset: 'UTF-8',
+                };
+            }
+            const commandParams = {
+                Source: this.formatSingleAddress(options.from),
+                Destination: destination,
+                Message: message,
+                ReplyToAddresses: options.replyTo ? [this.formatSingleAddress(options.replyTo)] : undefined,
+                ConfigurationSetName: this.configurationSet,
+            };
+            if (options.returnPath) {
+                commandParams.ReturnPath = options.returnPath;
+            }
+            // Add custom headers via Tags (SES limitation - headers must be added via raw email)
+            if (options.tags && options.tags.length > 0) {
+                commandParams.Tags = options.tags.map((tag, index) => ({
+                    Name: `tag-${index}`,
+                    Value: tag,
+                }));
+            }
+            const command = new SendEmailCommand(commandParams);
+            const response = await this.client.send(command);
+            return {
+                success: true,
+                messageId: response.MessageId,
+                response: JSON.stringify(response),
+            };
+        }
+        catch (error) {
+            this.logger.error('Failed to send email via SES', 'Mail', { error });
+            return {
+                success: false,
+                error: error?.message || String(error),
+            };
+        }
+    }
+    getName() {
+        return 'AWS SES';
+    }
+    async verify() {
+        if (!this.client) {
+            return false;
+        }
+        try {
+            const sesPath = resolveUserPackage('@aws-sdk/client-ses');
+            const { GetAccountSendingEnabledCommand } = await import(sesPath);
+            const command = new GetAccountSendingEnabledCommand({});
+            await this.client.send(command);
+            return true;
+        }
+        catch (error) {
+            this.logger.error('SES verification failed', 'Mail', { error });
+            return false;
+        }
+    }
+    formatSingleAddress(address) {
+        if (!address) {
+            return '';
+        }
+        if (typeof address === 'string') {
+            return address;
+        }
+        if (address.name) {
+            return `"${address.name}" <${address.email}>`;
+        }
+        return address.email;
+    }
+    formatAddressesArray(addresses) {
+        if (!addresses) {
+            return [];
+        }
+        if (typeof addresses === 'string') {
+            return [addresses];
+        }
+        if (Array.isArray(addresses)) {
+            return addresses.map(addr => {
+                if (typeof addr === 'string') {
+                    return addr;
+                }
+                return addr.email;
+            });
+        }
+        if (typeof addresses === 'object') {
+            return [addresses.email];
+        }
+        return [];
+    }
+}
+//# sourceMappingURL=ses-adapter.js.map

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

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

package/dist/core/mail/index.d.ts

@@ -0,0 +1,5 @@
+export type { MailConfig, MailOptions, MailResult, MailAdapter, MailAdapterType, EmailAddress, EmailAttachment, TemplateConfig, TemplateEngine, MailQueueConfig, NodemailerConnection, SendGridConnection, SESConnection, ResendConnection, } from './types.js';
+export { MailManager } from './mail-manager.js';
+export { TemplateEngineManager } from './template-engine.js';
+export { BaseMailAdapter } from './mail-adapter.js';
+export { ConsoleAdapter, NodemailerAdapter, SendGridAdapter, SESAdapter, ResendAdapter, } from './adapters/index.js';

package/dist/core/mail/index.js

@@ -0,0 +1,8 @@
+// Mail System - Public API
+// ESM-first module
+export { MailManager } from './mail-manager.js';
+export { TemplateEngineManager } from './template-engine.js';
+export { BaseMailAdapter } from './mail-adapter.js';
+// Export adapters
+export { ConsoleAdapter, NodemailerAdapter, SendGridAdapter, SESAdapter, ResendAdapter, } from './adapters/index.js';
+//# sourceMappingURL=index.js.map

package/dist/core/mail/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/mail/index.ts"],"names":[],"mappings":"AAAA,2BAA2B;AAC3B,mBAAmB;AAmBnB,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,kBAAkB;AAClB,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,eAAe,EACf,UAAU,EACV,aAAa,GACd,MAAM,qBAAqB,CAAC"}

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;
+}