stratal 0.0.1

package/dist/email/providers/base-email.provider.js

@@ -0,0 +1,43 @@
+/**
+ * Base Email Provider
+ *
+ * Abstract base class for email providers.
+ * Provides shared implementation of sendBatch() to reduce code duplication.
+ */
+export class BaseEmailProvider {
+    /**
+     * Send multiple emails in a batch
+     *
+     * Default implementation sends emails sequentially.
+     * Concrete providers can override for optimized batch sending.
+     */
+    async sendBatch(messages) {
+        const results = [];
+        let successful = 0;
+        let failed = 0;
+        for (const message of messages) {
+            try {
+                const result = await this.send(message);
+                results.push(result);
+                successful++;
+            }
+            catch (error) {
+                results.push({
+                    messageId: '',
+                    accepted: false,
+                    metadata: {
+                        error: error instanceof Error ? error.message : 'Unknown error',
+                    },
+                });
+                failed++;
+            }
+        }
+        return {
+            total: messages.length,
+            successful,
+            failed,
+            results,
+        };
+    }
+}
+//# sourceMappingURL=base-email.provider.js.map

package/dist/email/providers/base-email.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-email.provider.js","sourceRoot":"","sources":["../../../src/email/providers/base-email.provider.ts"],"names":[],"mappings":"AAGA;;;;;GAKG;AACH,MAAM,OAAgB,iBAAiB;IAMrC;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,QAAgC;QAC9C,MAAM,OAAO,GAAsB,EAAE,CAAA;QACrC,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,IAAI,MAAM,GAAG,CAAC,CAAA;QAEd,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;gBACvC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;gBACpB,UAAU,EAAE,CAAA;YACd,CAAC;YACD,OAAO,KAAK,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC;oBACX,SAAS,EAAE,EAAE;oBACb,QAAQ,EAAE,KAAK;oBACf,QAAQ,EAAE;wBACR,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;qBAChE;iBACF,CAAC,CAAA;gBACF,MAAM,EAAE,CAAA;YACV,CAAC;QACH,CAAC;QAED,OAAO;YACL,KAAK,EAAE,QAAQ,CAAC,MAAM;YACtB,UAAU;YACV,MAAM;YACN,OAAO;SACR,CAAA;IACH,CAAC;CACF"}

package/dist/email/providers/email-provider.interface.d.ts

@@ -0,0 +1,66 @@
+import type { ResolvedEmailMessage } from '../contracts';
+/**
+ * Email Send Result
+ *
+ * Standard result returned by email providers after sending
+ */
+export interface EmailSendResult {
+    /**
+     * Unique message ID from the provider
+     */
+    messageId: string;
+    /**
+     * Whether the email was accepted for delivery
+     */
+    accepted: boolean;
+    /**
+     * Optional provider-specific metadata
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Batch Email Send Result
+ *
+ * Result for batch email operations
+ */
+export interface EmailBatchSendResult {
+    /**
+     * Total number of emails sent
+     */
+    total: number;
+    /**
+     * Number of successfully sent emails
+     */
+    successful: number;
+    /**
+     * Number of failed emails
+     */
+    failed: number;
+    /**
+     * Individual results for each email
+     */
+    results: EmailSendResult[];
+}
+/**
+ * Email Provider Interface
+ *
+ * All email provider implementations (Resend, SMTP, etc.) must implement this interface.
+ * This allows the EmailService to work with any provider without knowing the implementation details.
+ */
+export interface IEmailProvider {
+    /**
+     * Send a single email
+     *
+     * @param message - The resolved email message to send (attachments as Buffer)
+     * @returns Promise that resolves with send result
+     */
+    send(message: ResolvedEmailMessage): Promise<EmailSendResult>;
+    /**
+     * Send multiple emails in a batch
+     *
+     * @param messages - Array of resolved email messages to send
+     * @returns Promise that resolves with batch send result
+     */
+    sendBatch(messages: ResolvedEmailMessage[]): Promise<EmailBatchSendResult>;
+}
+//# sourceMappingURL=email-provider.interface.d.ts.map

package/dist/email/providers/email-provider.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-provider.interface.d.ts","sourceRoot":"","sources":["../../../src/email/providers/email-provider.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAExD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IAEjB;;OAEG;IACH,QAAQ,EAAE,OAAO,CAAA;IAEjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACnC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;IAElB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IAEd;;OAEG;IACH,OAAO,EAAE,eAAe,EAAE,CAAA;CAC3B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAE7D;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,oBAAoB,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAC3E"}

package/dist/email/providers/email-provider.interface.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=email-provider.interface.js.map

package/dist/email/providers/email-provider.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-provider.interface.js","sourceRoot":"","sources":["../../../src/email/providers/email-provider.interface.ts"],"names":[],"mappings":""}

package/dist/email/providers/index.d.ts

@@ -0,0 +1,5 @@
+export * from './email-provider.interface';
+export * from './base-email.provider';
+export * from './resend.provider';
+export * from './smtp.provider';
+//# sourceMappingURL=index.d.ts.map

package/dist/email/providers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/email/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA"}

package/dist/email/providers/index.js

@@ -0,0 +1,5 @@
+export * from './email-provider.interface';
+export * from './base-email.provider';
+export * from './resend.provider';
+export * from './smtp.provider';
+//# sourceMappingURL=index.js.map

package/dist/email/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/email/providers/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAA;AAC1C,cAAc,uBAAuB,CAAA;AACrC,cAAc,mBAAmB,CAAA;AACjC,cAAc,iBAAiB,CAAA"}

package/dist/email/providers/resend.provider.d.ts

@@ -0,0 +1,26 @@
+import type { ResolvedEmailMessage } from '../contracts';
+import type { EmailModuleOptions } from '../email.module';
+import { BaseEmailProvider } from './base-email.provider';
+import type { EmailSendResult } from './email-provider.interface';
+/**
+ * Resend Email Provider
+ *
+ * Implementation of IEmailProvider using Resend API
+ * Docs: https://resend.com/docs
+ */
+export declare class ResendProvider extends BaseEmailProvider {
+    private readonly options;
+    private readonly client;
+    private readonly defaultFrom;
+    constructor(options: EmailModuleOptions);
+    send(message: ResolvedEmailMessage): Promise<EmailSendResult>;
+    /**
+     * Convert attachment content to Buffer
+     *
+     * Resend SDK expects Buffer for attachment content.
+     * If content is already a Buffer, return as-is.
+     * If content is a ReadableStream, convert to Buffer.
+     */
+    private toBuffer;
+}
+//# sourceMappingURL=resend.provider.d.ts.map

package/dist/email/providers/resend.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resend.provider.d.ts","sourceRoot":"","sources":["../../../src/email/providers/resend.provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAA2B,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEjE;;;;;GAKG;AACH,qBAAa,cAAe,SAAQ,iBAAiB;IAKjD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAQ;IAC/B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;gBAG1C,OAAO,EAAE,kBAAkB;IAaxC,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAkDnE;;;;;;OAMG;YACW,QAAQ;CASvB"}

package/dist/email/providers/resend.provider.js

@@ -0,0 +1,84 @@
+import { Resend } from 'resend';
+import { EmailResendApiFailedError, ResendApiKeyMissingError } from '../errors';
+import { BaseEmailProvider } from './base-email.provider';
+/**
+ * Resend Email Provider
+ *
+ * Implementation of IEmailProvider using Resend API
+ * Docs: https://resend.com/docs
+ */
+export class ResendProvider extends BaseEmailProvider {
+    options;
+    client;
+    defaultFrom;
+    constructor(options) {
+        super();
+        this.options = options;
+        // Validate Resend API key
+        if (!this.options.apiKey) {
+            throw new ResendApiKeyMissingError();
+        }
+        this.client = new Resend(this.options.apiKey);
+        this.defaultFrom = this.options.from;
+    }
+    async send(message) {
+        try {
+            const from = message.from
+                ? `${message.from.name} <${message.from.email}>`
+                : `${this.defaultFrom.name} <${this.defaultFrom.email}>`;
+            const to = Array.isArray(message.to) ? message.to : [message.to];
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-argument -- Resend SDK types
+            const response = await this.client.emails.send({
+                from,
+                to,
+                subject: message.subject,
+                html: message.html,
+                text: message.text,
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access, @typescript-eslint/no-unsafe-assignment -- Resend template extension
+                ...(message.template && { template: message.template }),
+                ...(message.replyTo && { replyTo: message.replyTo }),
+                ...(message.cc && { cc: message.cc }),
+                ...(message.bcc && { bcc: message.bcc }),
+                ...(message.attachments && {
+                    attachments: await Promise.all(message.attachments.map(async (attachment) => ({
+                        filename: attachment.filename,
+                        content: await this.toBuffer(attachment.content),
+                    }))),
+                }),
+            });
+            if (response.error) {
+                throw new EmailResendApiFailedError();
+            }
+            return {
+                messageId: response.data.id,
+                accepted: true,
+                metadata: {
+                    provider: 'resend',
+                },
+            };
+        }
+        catch (error) {
+            if (error instanceof EmailResendApiFailedError || error instanceof ResendApiKeyMissingError) {
+                throw error;
+            }
+            throw new EmailResendApiFailedError();
+        }
+    }
+    /**
+     * Convert attachment content to Buffer
+     *
+     * Resend SDK expects Buffer for attachment content.
+     * If content is already a Buffer, return as-is.
+     * If content is a ReadableStream, convert to Buffer.
+     */
+    async toBuffer(content) {
+        if (Buffer.isBuffer(content)) {
+            return content;
+        }
+        // Convert ReadableStream to Buffer
+        const response = new Response(content);
+        const arrayBuffer = await response.arrayBuffer();
+        return Buffer.from(arrayBuffer);
+    }
+}
+//# sourceMappingURL=resend.provider.js.map

package/dist/email/providers/resend.provider.js.map

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

package/dist/email/providers/smtp.provider.d.ts

@@ -0,0 +1,25 @@
+import type { ResolvedEmailMessage } from '../contracts';
+import type { EmailModuleOptions } from '../email.module';
+import { BaseEmailProvider } from './base-email.provider';
+import type { EmailSendResult } from './email-provider.interface';
+/**
+ * SMTP Email Provider
+ *
+ * Implementation of IEmailProvider using SMTP/nodemailer
+ * Supports any SMTP server configured via SMTP_URL
+ */
+export declare class SmtpProvider extends BaseEmailProvider {
+    private readonly options;
+    private readonly transporter;
+    private readonly defaultFrom;
+    constructor(options: EmailModuleOptions);
+    send(message: ResolvedEmailMessage): Promise<EmailSendResult>;
+    /**
+     * Convert attachment content to Node.js stream format
+     *
+     * Nodemailer expects Node.js Readable streams, not web ReadableStream.
+     * Buffer is passed through as-is since nodemailer supports it directly.
+     */
+    private toNodeStream;
+}
+//# sourceMappingURL=smtp.provider.d.ts.map

package/dist/email/providers/smtp.provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.provider.d.ts","sourceRoot":"","sources":["../../../src/email/providers/smtp.provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAA2B,oBAAoB,EAAE,MAAM,cAAc,CAAA;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACzD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEjE;;;;;GAKG;AACH,qBAAa,YAAa,SAAQ,iBAAiB;IAK/C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJ1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA4C;IACxE,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAiC;gBAG1C,OAAO,EAAE,kBAAkB;IA6BxC,IAAI,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IAsCnE;;;;;OAKG;IACH,OAAO,CAAC,YAAY;CAOrB"}

package/dist/email/providers/smtp.provider.js

@@ -0,0 +1,86 @@
+import * as nodemailer from 'nodemailer';
+import { Readable } from 'stream';
+import { EmailSmtpConnectionFailedError, SmtpConfigurationMissingError, SmtpHostMissingError } from '../errors';
+import { BaseEmailProvider } from './base-email.provider';
+/**
+ * SMTP Email Provider
+ *
+ * Implementation of IEmailProvider using SMTP/nodemailer
+ * Supports any SMTP server configured via SMTP_URL
+ */
+export class SmtpProvider extends BaseEmailProvider {
+    options;
+    transporter;
+    defaultFrom;
+    constructor(options) {
+        super();
+        this.options = options;
+        // Validate SMTP configuration
+        if (!this.options.smtp) {
+            throw new SmtpConfigurationMissingError();
+        }
+        if (!this.options.smtp.host) {
+            throw new SmtpHostMissingError();
+        }
+        // Create nodemailer transporter
+        this.transporter = nodemailer.createTransport({
+            host: this.options.smtp.host,
+            port: this.options.smtp.port,
+            secure: this.options.smtp.secure,
+            auth: this.options.smtp.username && this.options.smtp.password
+                ? {
+                    user: this.options.smtp.username,
+                    pass: this.options.smtp.password,
+                }
+                : undefined,
+        });
+        this.defaultFrom = this.options.from;
+    }
+    async send(message) {
+        try {
+            const from = message.from
+                ? `${message.from.name} <${message.from.email}>`
+                : `${this.defaultFrom.name} <${this.defaultFrom.email}>`;
+            const info = await this.transporter.sendMail({
+                from,
+                to: Array.isArray(message.to) ? message.to.join(', ') : message.to,
+                subject: message.subject,
+                html: message.html,
+                text: message.text,
+                replyTo: message.replyTo,
+                cc: message.cc?.join(', '),
+                bcc: message.bcc?.join(', '),
+                attachments: message.attachments?.map(attachment => ({
+                    filename: attachment.filename,
+                    content: this.toNodeStream(attachment.content),
+                    contentType: attachment.contentType,
+                })),
+            });
+            return {
+                messageId: info.messageId,
+                accepted: true,
+                metadata: {
+                    provider: 'smtp',
+                    response: info.response,
+                },
+            };
+        }
+        catch {
+            throw new EmailSmtpConnectionFailedError(this.options.smtp?.host ?? '', this.options.smtp?.port ?? 587);
+        }
+    }
+    /**
+     * Convert attachment content to Node.js stream format
+     *
+     * Nodemailer expects Node.js Readable streams, not web ReadableStream.
+     * Buffer is passed through as-is since nodemailer supports it directly.
+     */
+    toNodeStream(content) {
+        if (Buffer.isBuffer(content)) {
+            return content;
+        }
+        // Convert web ReadableStream to Node.js Readable
+        return Readable.fromWeb(content);
+    }
+}
+//# sourceMappingURL=smtp.provider.js.map

package/dist/email/providers/smtp.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"smtp.provider.js","sourceRoot":"","sources":["../../../src/email/providers/smtp.provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,YAAY,CAAA;AAExC,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAGjC,OAAO,EAAE,8BAA8B,EAAE,6BAA6B,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAC/G,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAGzD;;;;;GAKG;AACH,MAAM,OAAO,YAAa,SAAQ,iBAAiB;IAK9B;IAJF,WAAW,CAA4C;IACvD,WAAW,CAAiC;IAE7D,YACmB,OAA2B;QAE5C,KAAK,EAAE,CAAA;QAFU,YAAO,GAAP,OAAO,CAAoB;QAI5C,8BAA8B;QAC9B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,6BAA6B,EAAE,CAAA;QAC3C,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,MAAM,IAAI,oBAAoB,EAAE,CAAA;QAClC,CAAC;QAED,gCAAgC;QAChC,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,eAAe,CAAC;YAC5C,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI;YAC5B,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI;YAC5B,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM;YAChC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ;gBAC5D,CAAC,CAAC;oBACA,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ;oBAChC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ;iBACjC;gBACD,CAAC,CAAC,SAAS;SACd,CAAC,CAAA;QAEF,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAA;IACtC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAA6B;QACtC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI;gBACvB,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,KAAK,GAAG;gBAChD,CAAC,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,KAAK,IAAI,CAAC,WAAW,CAAC,KAAK,GAAG,CAAA;YAE1D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC;gBAC3C,IAAI;gBACJ,EAAE,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE;gBAClE,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC;gBAC1B,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC;gBAC5B,WAAW,EAAE,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;oBACnD,QAAQ,EAAE,UAAU,CAAC,QAAQ;oBAC7B,OAAO,EAAE,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC;oBAC9C,WAAW,EAAE,UAAU,CAAC,WAAW;iBACpC,CAAC,CAAC;aACJ,CAAC,CAAA;YAEF,OAAO;gBACL,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,QAAQ,EAAE,IAAI;gBACd,QAAQ,EAAE;oBACR,QAAQ,EAAE,MAAM;oBAChB,QAAQ,EAAE,IAAI,CAAC,QAAQ;iBACxB;aACF,CAAA;QACH,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,8BAA8B,CACtC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,EAAE,EAC7B,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,IAAI,GAAG,CAC/B,CAAA;QACH,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACK,YAAY,CAAC,OAA2C;QAC9D,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,iDAAiD;QACjD,OAAO,QAAQ,CAAC,OAAO,CAAC,OAAiD,CAAC,CAAA;IAC5E,CAAC;CACF"}

package/dist/email/services/email-provider-factory.d.ts

@@ -0,0 +1,24 @@
+import type { EmailModuleOptions } from '../email.module';
+import type { IEmailProvider } from '../providers/email-provider.interface';
+/**
+ * Email Provider Factory
+ *
+ * Creates email provider instances based on configuration.
+ * Supports automatic provider selection from module options.
+ *
+ * Providers are loaded lazily via dynamic imports to avoid pulling in
+ * heavy Node.js-only dependencies (e.g. nodemailer) at module parse time,
+ * which would break Cloudflare Workers and vitest-pool-workers environments.
+ */
+export declare class EmailProviderFactory {
+    private readonly options;
+    constructor(options: EmailModuleOptions);
+    /**
+     * Create email provider instance based on configuration
+     *
+     * @returns Email provider implementation
+     * @throws EmailProviderNotSupportedError if provider is not supported
+     */
+    create(): Promise<IEmailProvider>;
+}
+//# sourceMappingURL=email-provider-factory.d.ts.map

package/dist/email/services/email-provider-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-provider-factory.d.ts","sourceRoot":"","sources":["../../../src/email/services/email-provider-factory.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAA;AAE3E;;;;;;;;;GASG;AACH,qBACa,oBAAoB;IAG7B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,kBAAkB;IAG9C;;;;;OAKG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,CAAC;CAgBxC"}

package/dist/email/services/email-provider-factory.js

@@ -0,0 +1,59 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { inject } from 'tsyringe';
+import { Transient } from '../../di/decorators';
+import { EMAIL_TOKENS } from '../email.tokens';
+import { EmailProviderNotSupportedError } from '../errors';
+/**
+ * Email Provider Factory
+ *
+ * Creates email provider instances based on configuration.
+ * Supports automatic provider selection from module options.
+ *
+ * Providers are loaded lazily via dynamic imports to avoid pulling in
+ * heavy Node.js-only dependencies (e.g. nodemailer) at module parse time,
+ * which would break Cloudflare Workers and vitest-pool-workers environments.
+ */
+let EmailProviderFactory = class EmailProviderFactory {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    /**
+     * Create email provider instance based on configuration
+     *
+     * @returns Email provider implementation
+     * @throws EmailProviderNotSupportedError if provider is not supported
+     */
+    async create() {
+        switch (this.options.provider) {
+            case 'resend': {
+                const { ResendProvider } = await import('../providers/resend.provider');
+                return new ResendProvider(this.options);
+            }
+            case 'smtp': {
+                const { SmtpProvider } = await import('../providers/smtp.provider');
+                return new SmtpProvider(this.options);
+            }
+            default:
+                throw new EmailProviderNotSupportedError(this.options.provider);
+        }
+    }
+};
+EmailProviderFactory = __decorate([
+    Transient(EMAIL_TOKENS.EmailProviderFactory),
+    __param(0, inject(EMAIL_TOKENS.Options)),
+    __metadata("design:paramtypes", [Object])
+], EmailProviderFactory);
+export { EmailProviderFactory };
+//# sourceMappingURL=email-provider-factory.js.map

package/dist/email/services/email-provider-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-provider-factory.js","sourceRoot":"","sources":["../../../src/email/services/email-provider-factory.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAE/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAA;AAG1D;;;;;;;;;GASG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAGZ;IAFnB,YAEmB,OAA2B;QAA3B,YAAO,GAAP,OAAO,CAAoB;IAC1C,CAAC;IAEL;;;;;OAKG;IACH,KAAK,CAAC,MAAM;QACV,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAC9B,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,8BAA8B,CAAC,CAAA;gBACvE,OAAO,IAAI,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACzC,CAAC;YAED,KAAK,MAAM,CAAC,CAAC,CAAC;gBACZ,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,4BAA4B,CAAC,CAAA;gBACnE,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACvC,CAAC;YAED;gBACE,MAAM,IAAI,8BAA8B,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACnE,CAAC;IACH,CAAC;CACF,CAAA;AA5BY,oBAAoB;IADhC,SAAS,CAAC,YAAY,CAAC,oBAAoB,CAAC;IAGxC,WAAA,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,CAAA;;GAFpB,oBAAoB,CA4BhC"}

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

@@ -0,0 +1,51 @@
+import type { ReactElement } from 'react';
+import type { IQueueSender } from '../../queue';
+import type { SendBatchEmailInput, SendEmailInput } from '../contracts';
+export type SendEmailInputWithTemplate = Omit<SendEmailInput, 'html' | 'text'> & {
+    template?: ReactElement;
+};
+export type SendBatchEmailInputWithTemplate = Omit<SendBatchEmailInput, 'messages'> & {
+    messages: SendEmailInputWithTemplate[];
+};
+/**
+ * Email Service
+ *
+ * Main facade for sending emails. Routes emails to queues for async processing.
+ * The queue is injected via EMAIL_TOKENS.EmailQueue, configured by the application
+ * via EmailModule.withRoot({ queue: 'queue-name' }).
+ *
+ * @example Basic usage
+ * ```typescript
+ * @inject(EMAIL_TOKENS.EmailService)
+ * private readonly emailService: EmailService
+ *
+ * await this.emailService.send({
+ *   to: 'user@example.com',
+ *   subject: 'Welcome',
+ *   template: <WelcomeEmail name="John" />
+ * })
+ * ```
+ */
+export declare class EmailService {
+    protected readonly queue: IQueueSender;
+    constructor(queue: IQueueSender);
+    /**
+     * Send a single email
+     *
+     * Dispatches the email to the queue for async processing.
+     * Supports optional React template rendering.
+     *
+     * @param input - Email message details
+     */
+    send({ template, ...input }: SendEmailInputWithTemplate): Promise<void>;
+    /**
+     * Send multiple emails in a batch
+     *
+     * Dispatches all emails to the queue for async processing.
+     * Supports React template rendering for each message.
+     *
+     * @param input - Batch email details
+     */
+    sendBatch(input: SendBatchEmailInputWithTemplate): Promise<void>;
+}
+//# sourceMappingURL=email.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"email.service.d.ts","sourceRoot":"","sources":["../../../src/email/services/email.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAGzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAGvE,MAAM,MAAM,0BAA0B,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG;IAC/E,QAAQ,CAAC,EAAE,YAAY,CAAA;CACxB,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG,IAAI,CAAC,mBAAmB,EAAE,UAAU,CAAC,GAAG;IACpF,QAAQ,EAAE,0BAA0B,EAAE,CAAA;CACvC,CAAA;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBACa,YAAY;IAGrB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,YAAY;gBAAnB,KAAK,EAAE,YAAY;IAGxC;;;;;;;OAOG;IACG,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAAE,EAAE,0BAA0B,GAAG,OAAO,CAAC,IAAI,CAAC;IAO7E;;;;;;;OAOG;IACG,SAAS,CAAC,KAAK,EAAE,+BAA+B,GAAG,OAAO,CAAC,IAAI,CAAC;CAKvE"}

package/dist/email/services/email.service.js

@@ -0,0 +1,75 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { render } from '@react-email/render';
+import { inject } from 'tsyringe';
+import { Transient } from '../../di/decorators';
+import { EMAIL_TOKENS } from '../email.tokens';
+/**
+ * Email Service
+ *
+ * Main facade for sending emails. Routes emails to queues for async processing.
+ * The queue is injected via EMAIL_TOKENS.EmailQueue, configured by the application
+ * via EmailModule.withRoot({ queue: 'queue-name' }).
+ *
+ * @example Basic usage
+ * ```typescript
+ * @inject(EMAIL_TOKENS.EmailService)
+ * private readonly emailService: EmailService
+ *
+ * await this.emailService.send({
+ *   to: 'user@example.com',
+ *   subject: 'Welcome',
+ *   template: <WelcomeEmail name="John" />
+ * })
+ * ```
+ */
+let EmailService = class EmailService {
+    queue;
+    constructor(queue) {
+        this.queue = queue;
+    }
+    /**
+     * Send a single email
+     *
+     * Dispatches the email to the queue for async processing.
+     * Supports optional React template rendering.
+     *
+     * @param input - Email message details
+     */
+    async send({ template, ...input }) {
+        await this.queue.dispatch({
+            type: 'email.send',
+            payload: { ...input, html: template ? await render(template) : undefined },
+        });
+    }
+    /**
+     * Send multiple emails in a batch
+     *
+     * Dispatches all emails to the queue for async processing.
+     * Supports React template rendering for each message.
+     *
+     * @param input - Batch email details
+     */
+    async sendBatch(input) {
+        for (const message of input.messages) {
+            await this.send(message);
+        }
+    }
+};
+EmailService = __decorate([
+    Transient(EMAIL_TOKENS.EmailService),
+    __param(0, inject(EMAIL_TOKENS.EmailQueue)),
+    __metadata("design:paramtypes", [Object])
+], EmailService);
+export { EmailService };
+//# sourceMappingURL=email.service.js.map

package/dist/email/services/email.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.service.js","sourceRoot":"","sources":["../../../src/email/services/email.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAE5C,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAA;AAG/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAU9C;;;;;;;;;;;;;;;;;;GAkBG;AAEI,IAAM,YAAY,GAAlB,MAAM,YAAY;IAGF;IAFrB,YAEqB,KAAmB;QAAnB,UAAK,GAAL,KAAK,CAAc;IACpC,CAAC;IAEL;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,KAAK,EAA8B;QAC3D,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE;SAC3E,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,SAAS,CAAC,KAAsC;QACpD,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC1B,CAAC;IACH,CAAC;CACF,CAAA;AAlCY,YAAY;IADxB,SAAS,CAAC,YAAY,CAAC,YAAY,CAAC;IAGhC,WAAA,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,CAAA;;GAFvB,YAAY,CAkCxB"}

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

@@ -0,0 +1,3 @@
+export * from './email.service';
+export * from './email-provider-factory';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/email/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,0BAA0B,CAAA"}

package/dist/email/services/index.js

@@ -0,0 +1,3 @@
+export * from './email.service';
+export * from './email-provider-factory';
+//# sourceMappingURL=index.js.map

package/dist/email/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/email/services/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,0BAA0B,CAAA"}