@rudderjs/mail 0.0.5

package/dist/index.js

@@ -0,0 +1,215 @@
+import { ServiceProvider } from '@rudderjs/core';
+import { resolveOptionalPeer } from '@rudderjs/core';
+export { Mailable } from './mailable.js';
+// ─── Mail Registry ─────────────────────────────────────────
+export class MailRegistry {
+    static adapter = null;
+    static _from = { address: 'noreply@example.com' };
+    static set(adapter) { this.adapter = adapter; }
+    static get() { return this.adapter; }
+    static setFrom(from) { this._from = { ...from }; }
+    static getFrom() { return { ...this._from }; }
+    /** @internal — clears the registered adapter and resets from. Used for testing. */
+    static reset() {
+        this.adapter = null;
+        this._from = { address: 'noreply@example.com' };
+    }
+}
+// ─── Pending Send (fluent builder) ─────────────────────────
+export class MailPendingSend {
+    _to;
+    _cc = [];
+    _bcc = [];
+    _queue;
+    constructor(_to) {
+        this._to = _to;
+    }
+    cc(...addresses) { this._cc = addresses; return this; }
+    bcc(...addresses) { this._bcc = addresses; return this; }
+    /** Specify which queue to use for queued mail. */
+    onQueue(name) { this._queue = name; return this; }
+    async send(mailable) {
+        const adapter = MailRegistry.get();
+        if (!adapter)
+            throw new Error('[RudderJS Mail] No mail adapter registered. Add mail() to providers.');
+        const from = MailRegistry.getFrom();
+        await adapter.send(mailable, { to: this._to, from, cc: this._cc, bcc: this._bcc });
+    }
+    /** Queue the mailable for background sending. Requires `@rudderjs/queue`. */
+    async queue(mailable) {
+        const { dispatchMailJob } = await import('./queued.js');
+        const from = MailRegistry.getFrom();
+        const opts = {};
+        if (this._queue)
+            opts.queue = this._queue;
+        await dispatchMailJob(mailable, { to: this._to, from, cc: this._cc, bcc: this._bcc }, opts);
+    }
+    /** Queue the mailable to be sent after a delay (ms). Requires `@rudderjs/queue`. */
+    async later(delay, mailable) {
+        const { dispatchMailJob } = await import('./queued.js');
+        const from = MailRegistry.getFrom();
+        const opts = { delay };
+        if (this._queue)
+            opts.queue = this._queue;
+        await dispatchMailJob(mailable, { to: this._to, from, cc: this._cc, bcc: this._bcc }, opts);
+    }
+}
+// ─── Mail Facade ───────────────────────────────────────────
+export class Mail {
+    static to(...addresses) {
+        return new MailPendingSend(addresses);
+    }
+    /** Replace the mail adapter with a fake for testing. */
+    static fake() {
+        // Dynamic require to avoid circular top-level import (fake.ts imports from index.ts)
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        const { FakeMailAdapter } = require('./fake.js');
+        return FakeMailAdapter.fake();
+    }
+}
+function isNodemailerConfig(config) {
+    return (config.driver === 'smtp' &&
+        typeof config.host === 'string' &&
+        typeof config.port === 'number');
+}
+// ─── Built-in Log Adapter ──────────────────────────────────
+export class LogAdapter {
+    async send(mailable, options) {
+        const msg = await mailable.compile();
+        const line = '─'.repeat(50);
+        console.log(`\n[RudderJS Mail] ${line}`);
+        console.log(`[RudderJS Mail]  To:      ${options.to.join(', ')}`);
+        console.log(`[RudderJS Mail]  From:    ${options.from.name ? `${options.from.name} <${options.from.address}>` : options.from.address}`);
+        console.log(`[RudderJS Mail]  Subject: ${msg.subject}`);
+        if (msg.html)
+            console.log(`[RudderJS Mail]  HTML:    ${msg.html.replace(/<[^>]+>/g, '').trim().slice(0, 120)}`);
+        if (msg.text)
+            console.log(`[RudderJS Mail]  Text:    ${msg.text.trim().slice(0, 120)}`);
+        console.log(`[RudderJS Mail] ${line}\n`);
+    }
+}
+class NodemailerAdapter {
+    config;
+    from;
+    _transporter = null;
+    constructor(config, from) {
+        this.config = config;
+        this.from = from;
+    }
+    async transporter() {
+        if (!this._transporter) {
+            this._transporter = (async () => {
+                let nodemailer;
+                try {
+                    nodemailer = await resolveOptionalPeer('nodemailer');
+                }
+                catch {
+                    throw new Error('[RudderJS Mail] SMTP driver requires "nodemailer". Install it with: pnpm add nodemailer');
+                }
+                const secure = this.config.encryption === 'ssl';
+                const transportConfig = {
+                    host: this.config.host,
+                    port: this.config.port,
+                    secure,
+                };
+                if (this.config.username) {
+                    transportConfig.auth = { user: this.config.username, pass: this.config.password ?? '' };
+                }
+                return nodemailer.createTransport(transportConfig);
+            })();
+        }
+        return this._transporter;
+    }
+    async send(mailable, options) {
+        const msg = await mailable.compile();
+        const fromStr = this.from.name
+            ? `${this.from.name} <${this.from.address}>`
+            : this.from.address;
+        const transporter = await this.transporter();
+        const message = {
+            from: fromStr,
+            to: options.to.join(', '),
+            subject: msg.subject,
+        };
+        if (options.cc && options.cc.length)
+            message.cc = options.cc.join(', ');
+        if (options.bcc && options.bcc.length)
+            message.bcc = options.bcc.join(', ');
+        if (msg.html !== undefined)
+            message.html = msg.html;
+        if (msg.text !== undefined)
+            message.text = msg.text;
+        await transporter.sendMail(message);
+    }
+}
+export function nodemailer(config, from) {
+    return {
+        create() {
+            return new NodemailerAdapter(config, from);
+        },
+    };
+}
+// ─── Service Provider Factory ──────────────────────────────
+/**
+ * Returns a MailServiceProvider class configured for the given mail config.
+ *
+ * Built-in drivers:  log (prints to console — great for dev), smtp (Nodemailer)
+ *
+ * Usage in bootstrap/providers.ts:
+ *   import { mail } from '@rudderjs/mail'
+ *   import configs from '../config/index.js'
+ *   export default [..., mail(configs.mail), ...]
+ */
+export function mail(config) {
+    class MailServiceProvider extends ServiceProvider {
+        register() { }
+        async boot() {
+            const mailerName = config.default;
+            const mailerConfig = config.mailers[mailerName] ?? { driver: 'log' };
+            const driver = mailerConfig['driver'];
+            MailRegistry.setFrom(config.from);
+            let adapter;
+            if (driver === 'log') {
+                adapter = new LogAdapter();
+            }
+            else if (driver === 'smtp') {
+                if (!isNodemailerConfig(mailerConfig)) {
+                    throw new Error('[RudderJS Mail] Invalid SMTP config. Expected fields: host (string), port (number).');
+                }
+                adapter = nodemailer(mailerConfig, config.from).create();
+            }
+            else if (driver === 'failover') {
+                const mailerNames = mailerConfig['mailers'] ?? [];
+                const retryAfter = mailerConfig['retryAfter'] ?? 60;
+                const adapters = [];
+                for (const name of mailerNames) {
+                    const mc = config.mailers[name];
+                    if (!mc)
+                        continue;
+                    if (mc.driver === 'log') {
+                        adapters.push(new LogAdapter());
+                    }
+                    else if (mc.driver === 'smtp' && isNodemailerConfig(mc)) {
+                        adapters.push(nodemailer(mc, config.from).create());
+                    }
+                }
+                if (adapters.length === 0)
+                    throw new Error('[RudderJS Mail] Failover driver has no valid mailers configured.');
+                const { FailoverAdapter } = await import('./failover.js');
+                adapter = new FailoverAdapter(adapters, retryAfter);
+            }
+            else {
+                throw new Error(`[RudderJS Mail] Unknown driver "${driver}". Available: log, smtp, failover`);
+            }
+            MailRegistry.set(adapter);
+            this.app.instance('mail', adapter);
+        }
+    }
+    return MailServiceProvider;
+}
+// ─── Re-exports ────────────────────────────────────────────
+export { FailoverAdapter } from './failover.js';
+export { MarkdownMailable } from './markdown.js';
+export { mailPreview } from './preview.js';
+export { FakeMailAdapter } from './fake.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/mailable.d.ts

@@ -0,0 +1,21 @@
+export interface MailMessage {
+    subject: string;
+    html?: string;
+    text?: string;
+}
+export declare abstract class Mailable {
+    protected _subject: string;
+    private _html?;
+    private _text?;
+    /** Set the email subject */
+    protected subject(subject: string): this;
+    /** Set the HTML body */
+    protected html(html: string): this;
+    /** Set the plain-text body */
+    protected text(text: string): this;
+    /** Build the mailable — called before sending. Override to set subject/html/text. */
+    abstract build(): this | Promise<this>;
+    /** Called by the adapter — builds then returns the compiled message */
+    compile(): Promise<MailMessage>;
+}
+//# sourceMappingURL=mailable.d.ts.map

package/dist/mailable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailable.d.ts","sourceRoot":"","sources":["../src/mailable.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAI,MAAM,CAAA;IACf,IAAI,CAAC,EAAI,MAAM,CAAA;CAChB;AAID,8BAAsB,QAAQ;IAC5B,SAAS,CAAC,QAAQ,SAAK;IACvB,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,KAAK,CAAC,CAAQ;IAEtB,4BAA4B;IAC5B,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAExC,wBAAwB;IACxB,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAElC,8BAA8B;IAC9B,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAElC,qFAAqF;IACrF,QAAQ,CAAC,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAEtC,uEAAuE;IACjE,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;CAOtC"}

package/dist/mailable.js

@@ -0,0 +1,24 @@
+// ─── Mail Message ──────────────────────────────────────────
+// ─── Mailable ──────────────────────────────────────────────
+export class Mailable {
+    _subject = '';
+    _html;
+    _text;
+    /** Set the email subject */
+    subject(subject) { this._subject = subject; return this; }
+    /** Set the HTML body */
+    html(html) { this._html = html; return this; }
+    /** Set the plain-text body */
+    text(text) { this._text = text; return this; }
+    /** Called by the adapter — builds then returns the compiled message */
+    async compile() {
+        await this.build();
+        const msg = { subject: this._subject };
+        if (this._html !== undefined)
+            msg.html = this._html;
+        if (this._text !== undefined)
+            msg.text = this._text;
+        return msg;
+    }
+}
+//# sourceMappingURL=mailable.js.map

package/dist/mailable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mailable.js","sourceRoot":"","sources":["../src/mailable.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAQ9D,8DAA8D;AAE9D,MAAM,OAAgB,QAAQ;IAClB,QAAQ,GAAG,EAAE,CAAA;IACf,KAAK,CAAS;IACd,KAAK,CAAS;IAEtB,4BAA4B;IAClB,OAAO,CAAC,OAAe,IAAU,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAEjF,wBAAwB;IACd,IAAI,CAAC,IAAY,IAAU,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAErE,8BAA8B;IACpB,IAAI,CAAC,IAAY,IAAU,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,OAAO,IAAI,CAAA,CAAC,CAAC;IAKrE,uEAAuE;IACvE,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,KAAK,EAAE,CAAA;QAClB,MAAM,GAAG,GAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAA;QACnD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAA;QACnD,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;YAAE,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAA;QACnD,OAAO,GAAG,CAAA;IACZ,CAAC;CACF"}

package/dist/markdown.d.ts

@@ -0,0 +1,39 @@
+import { Mailable, type MailMessage } from './mailable.js';
+/**
+ * A mailable that renders markdown content into responsive HTML email.
+ * Supports special components: `@component('name', { attrs })` ... `@endcomponent`
+ *
+ * @example
+ * class WelcomeMail extends MarkdownMailable {
+ *   build() {
+ *     return this.subject('Welcome!')
+ *       .markdown(`
+ * # Welcome, {{ name }}!
+ *
+ * Thanks for signing up.
+ *
+ * @component('button', { url: '{{ url }}' })
+ * Get Started
+ * @endcomponent
+ *
+ * @component('panel')
+ * If you didn't create this account, no action is needed.
+ * @endcomponent
+ * `)
+ *       .with({ name: this.user.name, url: 'https://example.com/dashboard' })
+ *   }
+ * }
+ */
+export declare abstract class MarkdownMailable extends Mailable {
+    private _markdown;
+    private _vars;
+    private _theme?;
+    /** Set the markdown content */
+    protected markdown(content: string): this;
+    /** Set template variables — replaces `{{ key }}` in the markdown */
+    protected with(vars: Record<string, string>): this;
+    /** Set the theme (CSS overrides). Default: built-in responsive layout. */
+    protected theme(css: string): this;
+    compile(): Promise<MailMessage>;
+}
+//# sourceMappingURL=markdown.d.ts.map

package/dist/markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdown.d.ts","sourceRoot":"","sources":["../src/markdown.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAA;AA+D1D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,8BAAsB,gBAAiB,SAAQ,QAAQ;IACrD,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAC,CAAQ;IAEvB,+BAA+B;IAC/B,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKzC,oEAAoE;IACpE,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAKlD,0EAA0E;IAC1E,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAK5B,OAAO,IAAI,OAAO,CAAC,WAAW,CAAC;CAwBtC"}

package/dist/markdown.js

@@ -0,0 +1,194 @@
+import { Mailable } from './mailable.js';
+// ─── Markdown Components ────────────────────────────────────
+const COMPONENTS = {
+    button: (attrs, body) => {
+        const url = attrs['url'] ?? '#';
+        const color = attrs['color'] ?? '#3490dc';
+        return `<table width="100%" cellpadding="0" cellspacing="0" role="presentation">
+      <tr><td align="center" style="padding: 16px 0;">
+        <a href="${_escHtml(url)}" style="display:inline-block;padding:12px 24px;background-color:${_escHtml(color)};color:#ffffff;text-decoration:none;border-radius:6px;font-weight:600;">${_escHtml(body)}</a>
+      </td></tr>
+    </table>`;
+    },
+    panel: (_attrs, body) => {
+        return `<table width="100%" cellpadding="0" cellspacing="0" role="presentation">
+      <tr><td style="padding:16px;background-color:#f8fafc;border-left:4px solid #3490dc;border-radius:4px;">
+        ${_mdToHtml(body)}
+      </td></tr>
+    </table>`;
+    },
+    table: (_attrs, body) => {
+        const rows = body.trim().split('\n').filter(r => r.trim());
+        if (rows.length === 0)
+            return '';
+        const headerCells = rows[0].split('|').map(c => c.trim()).filter(Boolean);
+        const dataRows = rows.slice(2); // skip header + separator
+        let html = '<table width="100%" cellpadding="8" cellspacing="0" style="border-collapse:collapse;margin:16px 0;">';
+        html += '<thead><tr>';
+        for (const cell of headerCells) {
+            html += `<th style="border-bottom:2px solid #dee2e6;text-align:left;padding:8px;">${_escHtml(cell)}</th>`;
+        }
+        html += '</tr></thead><tbody>';
+        for (const row of dataRows) {
+            const cells = row.split('|').map(c => c.trim()).filter(Boolean);
+            html += '<tr>';
+            for (const cell of cells) {
+                html += `<td style="border-bottom:1px solid #dee2e6;padding:8px;">${_escHtml(cell)}</td>`;
+            }
+            html += '</tr>';
+        }
+        html += '</tbody></table>';
+        return html;
+    },
+    header: (_attrs, body) => {
+        return `<div style="padding:24px 0;text-align:center;border-bottom:1px solid #e8e5ef;">
+      <h1 style="margin:0;font-size:20px;color:#333;">${_escHtml(body)}</h1>
+    </div>`;
+    },
+    footer: (_attrs, body) => {
+        return `<div style="padding:16px 0;text-align:center;border-top:1px solid #e8e5ef;color:#999;font-size:12px;">
+      ${_mdToHtml(body)}
+    </div>`;
+    },
+};
+// ─── MarkdownMailable ───────────────────────────────────────
+/**
+ * A mailable that renders markdown content into responsive HTML email.
+ * Supports special components: `@component('name', { attrs })` ... `@endcomponent`
+ *
+ * @example
+ * class WelcomeMail extends MarkdownMailable {
+ *   build() {
+ *     return this.subject('Welcome!')
+ *       .markdown(`
+ * # Welcome, {{ name }}!
+ *
+ * Thanks for signing up.
+ *
+ * @component('button', { url: '{{ url }}' })
+ * Get Started
+ * @endcomponent
+ *
+ * @component('panel')
+ * If you didn't create this account, no action is needed.
+ * @endcomponent
+ * `)
+ *       .with({ name: this.user.name, url: 'https://example.com/dashboard' })
+ *   }
+ * }
+ */
+export class MarkdownMailable extends Mailable {
+    _markdown = '';
+    _vars = {};
+    _theme;
+    /** Set the markdown content */
+    markdown(content) {
+        this._markdown = content;
+        return this;
+    }
+    /** Set template variables — replaces `{{ key }}` in the markdown */
+    with(vars) {
+        Object.assign(this._vars, vars);
+        return this;
+    }
+    /** Set the theme (CSS overrides). Default: built-in responsive layout. */
+    theme(css) {
+        this._theme = css;
+        return this;
+    }
+    async compile() {
+        await this.build();
+        // Interpolate variables
+        let md = this._markdown;
+        for (const [key, value] of Object.entries(this._vars)) {
+            md = md.replace(new RegExp(`\\{\\{\\s*${key}\\s*\\}\\}`, 'g'), value);
+        }
+        // Process components
+        md = _processComponents(md);
+        // Convert remaining markdown to HTML
+        const bodyHtml = _mdToHtml(md);
+        // Wrap in responsive email layout
+        const html = _wrapLayout(bodyHtml, this._theme);
+        return {
+            subject: this._subject,
+            html,
+            text: _stripHtml(bodyHtml),
+        };
+    }
+}
+// ─── Internal helpers ───────────────────────────────────────
+function _escHtml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function _stripHtml(html) {
+    return html.replace(/<[^>]+>/g, '').replace(/\s+/g, ' ').trim();
+}
+function _processComponents(md) {
+    // Match @component('name', { attrs }) ... @endcomponent
+    return md.replace(/@component\('(\w+)'(?:,\s*(\{[^}]*\}))?\)\s*\n([\s\S]*?)@endcomponent/g, (_match, name, attrsStr, body) => {
+        const handler = COMPONENTS[name];
+        if (!handler)
+            return body;
+        let attrs = {};
+        if (attrsStr) {
+            try {
+                // Parse simple { key: 'value' } objects
+                attrs = JSON.parse(attrsStr.replace(/'/g, '"').replace(/(\w+):/g, '"$1":'));
+            }
+            catch { /* use empty attrs */ }
+        }
+        return handler(attrs, body.trim());
+    });
+}
+function _mdToHtml(md) {
+    let html = md;
+    // Headers
+    html = html.replace(/^### (.+)$/gm, '<h3 style="margin:16px 0 8px;color:#333;">$1</h3>');
+    html = html.replace(/^## (.+)$/gm, '<h2 style="margin:20px 0 8px;color:#333;">$1</h2>');
+    html = html.replace(/^# (.+)$/gm, '<h1 style="margin:24px 0 12px;color:#333;">$1</h1>');
+    // Bold and italic
+    html = html.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>');
+    html = html.replace(/\*(.+?)\*/g, '<em>$1</em>');
+    // Links
+    html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2" style="color:#3490dc;">$1</a>');
+    // Inline code
+    html = html.replace(/`([^`]+)`/g, '<code style="background:#f0f0f0;padding:2px 6px;border-radius:3px;font-size:13px;">$1</code>');
+    // Unordered lists
+    html = html.replace(/^- (.+)$/gm, '<li>$1</li>');
+    html = html.replace(/(<li>.*<\/li>\n?)+/g, '<ul style="margin:8px 0;padding-left:24px;">$&</ul>');
+    // Horizontal rules
+    html = html.replace(/^---$/gm, '<hr style="border:none;border-top:1px solid #e8e5ef;margin:24px 0;">');
+    // Paragraphs (double newline)
+    html = html.replace(/\n\n+/g, '</p><p style="margin:12px 0;line-height:1.6;color:#555;">');
+    // Wrap in paragraph if not already wrapped in a block element
+    if (!html.startsWith('<')) {
+        html = `<p style="margin:12px 0;line-height:1.6;color:#555;">${html}</p>`;
+    }
+    return html;
+}
+function _wrapLayout(body, customCss) {
+    const css = customCss ?? `
+    body { margin: 0; padding: 0; background-color: #f4f4f7; font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Helvetica, Arial, sans-serif; }
+    .wrapper { width: 100%; padding: 40px 0; background-color: #f4f4f7; }
+    .content { max-width: 570px; margin: 0 auto; background: #ffffff; border-radius: 8px; overflow: hidden; box-shadow: 0 2px 4px rgba(0,0,0,0.05); }
+    .inner { padding: 32px; }
+  `;
+    return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <style>${css}</style>
+</head>
+<body>
+  <div class="wrapper">
+    <div class="content">
+      <div class="inner">
+        ${body}
+      </div>
+    </div>
+  </div>
+</body>
+</html>`;
+}
+//# sourceMappingURL=markdown.js.map

package/dist/markdown.js.map

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

package/dist/preview.d.ts

@@ -0,0 +1,21 @@
+import type { Mailable } from './mailable.js';
+/**
+ * Renders a mailable as HTML in the browser for development preview.
+ * Returns a route handler that compiles the mailable and serves the HTML.
+ *
+ * @example
+ * import { mailPreview } from '@rudderjs/mail'
+ * import { WelcomeEmail } from '../app/Mail/WelcomeEmail.js'
+ *
+ * // In routes/web.ts (only in development):
+ * if (process.env.NODE_ENV !== 'production') {
+ *   router.get('/mail-preview/welcome', mailPreview(() => new WelcomeEmail(sampleUser)))
+ * }
+ */
+export declare function mailPreview(factory: () => Mailable | Promise<Mailable>): (_req: unknown, res: {
+    status(code: number): {
+        send(body: string): void;
+    };
+    headers?: Record<string, string>;
+}) => Promise<void>;
+//# sourceMappingURL=preview.d.ts.map

package/dist/preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAI7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,GAC1C,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE;IAAE,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAyCjI"}

package/dist/preview.js

@@ -0,0 +1,62 @@
+// ─── Mail Preview ───────────────────────────────────────────
+/**
+ * Renders a mailable as HTML in the browser for development preview.
+ * Returns a route handler that compiles the mailable and serves the HTML.
+ *
+ * @example
+ * import { mailPreview } from '@rudderjs/mail'
+ * import { WelcomeEmail } from '../app/Mail/WelcomeEmail.js'
+ *
+ * // In routes/web.ts (only in development):
+ * if (process.env.NODE_ENV !== 'production') {
+ *   router.get('/mail-preview/welcome', mailPreview(() => new WelcomeEmail(sampleUser)))
+ * }
+ */
+export function mailPreview(factory) {
+    return async (_req, res) => {
+        try {
+            const mailable = await factory();
+            const msg = await mailable.compile();
+            const html = msg.html ?? `<pre>${msg.text ?? '(no content)'}</pre>`;
+            // Wrap in a preview shell with subject header
+            const preview = `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8">
+  <title>Mail Preview: ${_escHtml(msg.subject)}</title>
+  <style>
+    body { margin: 0; font-family: -apple-system, BlinkMacSystemFont, sans-serif; background: #e5e5e5; }
+    .preview-bar { padding: 12px 24px; background: #1a1a2e; color: #fff; font-size: 13px; display: flex; gap: 24px; align-items: center; }
+    .preview-bar strong { color: #a78bfa; }
+    .preview-frame { max-width: 640px; margin: 24px auto; background: #fff; border-radius: 8px; overflow: hidden; box-shadow: 0 4px 12px rgba(0,0,0,0.1); }
+    .preview-content { padding: 0; }
+    .preview-content iframe { width: 100%; height: 80vh; border: none; }
+  </style>
+</head>
+<body>
+  <div class="preview-bar">
+    <span><strong>Subject:</strong> ${_escHtml(msg.subject)}</span>
+    <span><strong>Type:</strong> ${msg.html ? 'HTML' : 'Plain Text'}</span>
+  </div>
+  <div class="preview-frame">
+    <div class="preview-content">
+      <iframe srcdoc="${_escAttr(html)}"></iframe>
+    </div>
+  </div>
+</body>
+</html>`;
+            res.status(200).send(preview);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            res.status(500).send(`<pre>Mail preview error:\n${_escHtml(message)}</pre>`);
+        }
+    };
+}
+function _escHtml(s) {
+    return s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;');
+}
+function _escAttr(s) {
+    return s.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+//# sourceMappingURL=preview.js.map

package/dist/preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAEA,+DAA+D;AAE/D;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CACzB,OAA2C;IAE3C,OAAO,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;QACzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,OAAO,EAAE,CAAA;YAChC,MAAM,GAAG,GAAQ,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAA;YACzC,MAAM,IAAI,GAAO,GAAG,CAAC,IAAI,IAAI,QAAQ,GAAG,CAAC,IAAI,IAAI,cAAc,QAAQ,CAAA;YAEvE,8CAA8C;YAC9C,MAAM,OAAO,GAAG;;;;yBAIG,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;;;;;;;;;;;;sCAYR,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC;mCACxB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY;;;;wBAI3C,QAAQ,CAAC,IAAI,CAAC;;;;QAI9B,CAAA;YAEF,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC/B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;YAChE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,6BAA6B,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;AACrG,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AACrG,CAAC"}

package/dist/queued.d.ts

@@ -0,0 +1,11 @@
+import type { Mailable } from './mailable.js';
+import type { SendOptions } from './index.js';
+/**
+ * @internal — dispatches a mailable through the queue system.
+ * Dynamically requires @rudderjs/queue to avoid hard dependency.
+ */
+export declare function dispatchMailJob(mailable: Mailable, options: SendOptions, queueOptions?: {
+    queue?: string;
+    delay?: number;
+}): Promise<void>;
+//# sourceMappingURL=queued.d.ts.map

package/dist/queued.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queued.d.ts","sourceRoot":"","sources":["../src/queued.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAS7C;;;GAGG;AACH,wBAAsB,eAAe,CACnC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,WAAW,EACpB,YAAY,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,IAAI,CAAC,CAiCf"}