@forinda/kickjs-mailer 2.0.0 → 2.1.0

package/dist/index.d.mts

@@ -0,0 +1,282 @@
+
+import { AdapterContext, AppAdapter } from "@forinda/kickjs";
+
+//#region src/types.d.ts
+interface MailAddress {
+  name?: string;
+  address: string;
+}
+type MailRecipient = string | MailAddress;
+interface MailAttachment {
+  filename: string;
+  content?: string | Buffer;
+  path?: string;
+  contentType?: string;
+  encoding?: string;
+}
+interface MailMessage {
+  /** Sender address */
+  from?: MailRecipient;
+  /** Recipient(s) */
+  to: MailRecipient | MailRecipient[];
+  /** CC recipient(s) */
+  cc?: MailRecipient | MailRecipient[];
+  /** BCC recipient(s) */
+  bcc?: MailRecipient | MailRecipient[];
+  /** Reply-to address */
+  replyTo?: MailRecipient;
+  /** Email subject */
+  subject: string;
+  /** Plain text body */
+  text?: string;
+  /** HTML body */
+  html?: string;
+  /** File attachments */
+  attachments?: MailAttachment[];
+  /** Custom headers */
+  headers?: Record<string, string>;
+  /** Provider-specific options (e.g. Resend tags, SES configuration set) */
+  metadata?: Record<string, any>;
+}
+interface MailResult {
+  /** Provider-assigned message ID */
+  messageId: string;
+  /** Whether the send was accepted (does not guarantee delivery) */
+  accepted: boolean;
+  /** Raw response from the provider */
+  raw?: any;
+}
+/**
+ * Template engine for rendering email bodies.
+ * Implement this to use EJS, Handlebars, Pug, or any template system.
+ *
+ * @example
+ * ```ts
+ * import Handlebars from 'handlebars'
+ *
+ * class HandlebarsEngine implements MailTemplateEngine {
+ *   private templates = new Map<string, HandlebarsTemplateDelegate>()
+ *
+ *   register(name: string, source: string) {
+ *     this.templates.set(name, Handlebars.compile(source))
+ *   }
+ *
+ *   async render(template: string, data: any) {
+ *     const fn = this.templates.get(template)
+ *     if (!fn) throw new Error(`Template "${template}" not found`)
+ *     return fn(data)
+ *   }
+ * }
+ * ```
+ */
+interface MailTemplateEngine {
+  /** Render a named template with data. Returns HTML string. */
+  render(template: string, data: Record<string, any>): Promise<string> | string;
+}
+/**
+ * Abstract mail provider. Implement this to use any email service:
+ * SMTP (nodemailer), Resend, AWS SES, SendGrid, Postmark, Mailgun, etc.
+ *
+ * @example
+ * ```ts
+ * class ResendProvider implements MailProvider {
+ *   name = 'resend'
+ *   private client: Resend
+ *
+ *   constructor(apiKey: string) {
+ *     this.client = new Resend(apiKey)
+ *   }
+ *
+ *   async send(message: MailMessage): Promise<MailResult> {
+ *     const { data, error } = await this.client.emails.send({
+ *       from: formatAddress(message.from),
+ *       to: formatRecipients(message.to),
+ *       subject: message.subject,
+ *       html: message.html,
+ *       text: message.text,
+ *     })
+ *     if (error) throw error
+ *     return { messageId: data.id, accepted: true, raw: data }
+ *   }
+ * }
+ * ```
+ */
+interface MailProvider {
+  /** Provider name for logging */
+  name: string;
+  /** Send an email message */
+  send(message: MailMessage): Promise<MailResult>;
+  /** Optional cleanup (close connections, etc.) */
+  shutdown?(): Promise<void>;
+}
+interface MailerOptions {
+  /** Mail provider to use */
+  provider: MailProvider;
+  /** Default "from" address for all emails */
+  defaultFrom?: MailRecipient;
+  /** Optional template engine for rendering HTML from templates */
+  templateEngine?: MailTemplateEngine;
+  /** Enable/disable sending (useful for testing — logs instead of sending) */
+  enabled?: boolean;
+}
+//#endregion
+//#region src/mailer.service.d.ts
+/** DI token for resolving MailerService from the container */
+declare const MAILER: unique symbol;
+/**
+ * Central mail service — send emails through any provider.
+ *
+ * @example
+ * ```ts
+ * @Service()
+ * class UserService {
+ *   constructor(@Inject(MAILER) private mailer: MailerService) {}
+ *
+ *   async sendWelcome(user: User) {
+ *     await this.mailer.send({
+ *       to: user.email,
+ *       subject: 'Welcome!',
+ *       html: '<h1>Welcome to our app</h1>',
+ *     })
+ *   }
+ *
+ *   // Or with templates:
+ *   async sendInvoice(user: User, invoice: Invoice) {
+ *     await this.mailer.sendTemplate('invoice', {
+ *       to: user.email,
+ *       subject: `Invoice #${invoice.number}`,
+ *     }, { user, invoice })
+ *   }
+ * }
+ * ```
+ */
+declare class MailerService {
+  private provider;
+  private defaultFrom?;
+  private templateEngine?;
+  private enabled;
+  constructor(options: MailerOptions);
+  /**
+   * Send an email message.
+   * Applies defaultFrom if no from address is set.
+   */
+  send(message: MailMessage): Promise<MailResult>;
+  /**
+   * Render a template and send the resulting HTML as an email.
+   * Requires a templateEngine to be configured.
+   *
+   * @param template - Template name (resolved by the engine)
+   * @param message - Mail message (html will be overwritten by the rendered template)
+   * @param data - Template variables
+   */
+  sendTemplate(template: string, message: Omit<MailMessage, 'html'>, data: Record<string, any>): Promise<MailResult>;
+  /** Get the underlying provider (for advanced use) */
+  getProvider(): MailProvider;
+  /** Shutdown the provider */
+  shutdown(): Promise<void>;
+}
+//#endregion
+//#region src/adapter.d.ts
+/**
+ * Mailer adapter — registers MailerService in the DI container.
+ *
+ * @example
+ * ```ts
+ * import { MailerAdapter, SmtpProvider } from '@forinda/kickjs-mailer'
+ *
+ * bootstrap({
+ *   adapters: [
+ *     new MailerAdapter({
+ *       provider: new SmtpProvider({ host: 'smtp.gmail.com', port: 587, auth: { ... } }),
+ *       defaultFrom: { name: 'My App', address: 'noreply@myapp.com' },
+ *     }),
+ *   ],
+ * })
+ * ```
+ */
+declare class MailerAdapter implements AppAdapter {
+  private options;
+  name: string;
+  private mailer;
+  constructor(options: MailerOptions);
+  afterStart({
+    container
+  }: AdapterContext): void;
+  shutdown(): Promise<void>;
+}
+//#endregion
+//#region src/providers/smtp.provider.d.ts
+interface SmtpOptions {
+  /** SMTP host (e.g. 'smtp.gmail.com', 'smtp.resend.com') */
+  host: string;
+  /** SMTP port (default: 587) */
+  port?: number;
+  /** Use TLS (default: true for port 465, false otherwise) */
+  secure?: boolean;
+  /** Authentication credentials */
+  auth?: {
+    user: string;
+    pass: string;
+  };
+  /** Connection timeout in ms (default: 10000) */
+  connectionTimeout?: number;
+}
+/**
+ * SMTP mail provider using nodemailer.
+ *
+ * Requires `nodemailer` as a peer dependency:
+ * ```bash
+ * pnpm add nodemailer @types/nodemailer
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Gmail
+ * new SmtpProvider({
+ *   host: 'smtp.gmail.com',
+ *   port: 587,
+ *   auth: { user: 'you@gmail.com', pass: 'app-password' },
+ * })
+ *
+ * // Resend via SMTP
+ * new SmtpProvider({
+ *   host: 'smtp.resend.com',
+ *   port: 465,
+ *   secure: true,
+ *   auth: { user: 'resend', pass: process.env.RESEND_API_KEY! },
+ * })
+ *
+ * // Mailpit (local dev)
+ * new SmtpProvider({ host: 'localhost', port: 1025 })
+ * ```
+ */
+declare class SmtpProvider implements MailProvider {
+  private options;
+  name: string;
+  private transporter;
+  constructor(options: SmtpOptions);
+  private ensureTransporter;
+  send(message: MailMessage): Promise<MailResult>;
+  shutdown(): Promise<void>;
+}
+//#endregion
+//#region src/providers/console.provider.d.ts
+/**
+ * Console mail provider — logs emails instead of sending them.
+ * Perfect for development and testing.
+ *
+ * @example
+ * ```ts
+ * new MailerAdapter({
+ *   provider: new ConsoleProvider(),
+ *   defaultFrom: 'dev@localhost',
+ * })
+ * ```
+ */
+declare class ConsoleProvider implements MailProvider {
+  name: string;
+  send(message: MailMessage): Promise<MailResult>;
+}
+//#endregion
+export { ConsoleProvider, MAILER, type MailAddress, type MailAttachment, type MailMessage, type MailProvider, type MailRecipient, type MailResult, type MailTemplateEngine, MailerAdapter, type MailerOptions, MailerService, type SmtpOptions, SmtpProvider };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/mailer.service.ts","../src/adapter.ts","../src/providers/smtp.provider.ts","../src/providers/console.provider.ts"],"mappings":";;;;UAEiB,WAAA;EACf,IAAA;EACA,OAAA;AAAA;AAAA,KAGU,aAAA,YAAyB,WAAA;AAAA,UAEpB,cAAA;EACf,QAAA;EACA,OAAA,YAAmB,MAAA;EACnB,IAAA;EACA,WAAA;EACA,QAAA;AAAA;AAAA,UAGe,WAAA;EAV+B;EAY9C,IAAA,GAAO,aAAA;EAVsB;EAY7B,EAAA,EAAI,aAAA,GAAgB,aAAA;EAVK;EAYzB,EAAA,GAAK,aAAA,GAAgB,aAAA;EAZrB;EAcA,GAAA,GAAM,aAAA,GAAgB,aAAA;EAbtB;EAeA,OAAA,GAAU,aAAA;EAbV;EAeA,OAAA;EAfQ;EAiBR,IAAA;EAd0B;EAgB1B,IAAA;EAdO;EAgBP,WAAA,GAAc,cAAA;EAdM;EAgBpB,OAAA,GAAU,MAAA;EAdW;EAgBrB,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,UAAA;EAPD;EASd,SAAA;EALW;EAOX,QAAA;EAPiB;EASjB,GAAA;AAAA;;;;;;;;;;;;;;;;;;;;;;;AANF;UAkCiB,kBAAA;;EAEf,MAAA,CAAO,QAAA,UAAkB,IAAA,EAAM,MAAA,gBAAsB,OAAA;AAAA;;;;;AAFvD;;;;;;;;;;;AAmCA;;;;;;;;;;;;;UAAiB,YAAA;EAKqB;EAHpC,IAAA;EAMa;EAHb,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;EAGhB;EAApB,QAAA,KAAa,OAAA;AAAA;AAAA,UAKE,aAAA;EAEL;EAAV,QAAA,EAAU,YAAA;EAMO;EAHjB,WAAA,GAAc,aAAA;EAGqB;EAAnC,cAAA,GAAiB,kBAAA;EANP;EASV,OAAA;AAAA;;;;cC1HW,MAAA;;ADXb;;;;;AAKA;;;;;AAEA;;;;;;;;;;;;AAQA;;;;cCyBa,aAAA;EAAA,QACH,QAAA;EAAA,QACA,WAAA;EAAA,QACA,cAAA;EAAA,QACA,OAAA;cAEI,OAAA,EAAS,aAAA;EDrBX;;;;ECgCJ,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;EDpBzB;;;;;;;;ECmDX,YAAA,CACJ,QAAA,UACA,OAAA,EAAS,IAAA,CAAK,WAAA,WACd,IAAA,EAAM,MAAA,gBACL,OAAA,CAAQ,UAAA;EDrEX;ECkFA,WAAA,CAAA,GAAe,YAAA;EDlFO;ECuFhB,QAAA,CAAA,GAAY,OAAA;AAAA;;;;;AD9GpB;;;;;AAKA;;;;;AAEA;;;;;cEca,aAAA,YAAyB,UAAA;EAAA,QAIhB,OAAA;EAHpB,IAAA;EAAA,QACQ,MAAA;cAEY,OAAA,EAAS,aAAA;EAI7B,UAAA,CAAA;IAAa;EAAA,GAAa,cAAA;EAOpB,QAAA,CAAA,GAAY,OAAA;AAAA;;;UCpCH,WAAA;;EAEf,IAAA;EHFe;EGIf,IAAA;;EAEA,MAAA;EHJO;EGMP,IAAA;IACE,IAAA;IACA,IAAA;EAAA;EHL4C;EGQ9C,iBAAA;AAAA;;;;;;;;;;;AHEF;;;;;;;;;;;;;;;;;;;cG8Ba,YAAA,YAAwB,YAAA;EAAA,QAIf,OAAA;EAHpB,IAAA;EAAA,QACQ,WAAA;cAEY,OAAA,EAAS,WAAA;EAAA,QAEf,iBAAA;EAiBR,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;EAuBpC,QAAA,CAAA,GAAY,OAAA;AAAA;;;;;;AH3FpB;;;;;AAKA;;;;cIYa,eAAA,YAA2B,YAAA;EACtC,IAAA;EAEM,IAAA,CAAK,OAAA,EAAS,WAAA,GAAc,OAAA,CAAQ,UAAA;AAAA"}

package/dist/index.mjs

@@ -0,0 +1,277 @@
+/**
+ * @forinda/kickjs-mailer v2.1.0
+ *
+ * Copyright (c) Felix Orinda
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ * @license MIT
+ */
+import "reflect-metadata";
+import { Logger } from "@forinda/kickjs";
+//#region src/mailer.service.ts
+const log$2 = Logger.for("Mailer");
+/** DI token for resolving MailerService from the container */
+const MAILER = Symbol("MailerService");
+/**
+* Central mail service — send emails through any provider.
+*
+* @example
+* ```ts
+* @Service()
+* class UserService {
+*   constructor(@Inject(MAILER) private mailer: MailerService) {}
+*
+*   async sendWelcome(user: User) {
+*     await this.mailer.send({
+*       to: user.email,
+*       subject: 'Welcome!',
+*       html: '<h1>Welcome to our app</h1>',
+*     })
+*   }
+*
+*   // Or with templates:
+*   async sendInvoice(user: User, invoice: Invoice) {
+*     await this.mailer.sendTemplate('invoice', {
+*       to: user.email,
+*       subject: `Invoice #${invoice.number}`,
+*     }, { user, invoice })
+*   }
+* }
+* ```
+*/
+var MailerService = class {
+	provider;
+	defaultFrom;
+	templateEngine;
+	enabled;
+	constructor(options) {
+		this.provider = options.provider;
+		this.defaultFrom = options.defaultFrom;
+		this.templateEngine = options.templateEngine;
+		this.enabled = options.enabled ?? true;
+	}
+	/**
+	* Send an email message.
+	* Applies defaultFrom if no from address is set.
+	*/
+	async send(message) {
+		const msg = { ...message };
+		if (!msg.from && this.defaultFrom) msg.from = this.defaultFrom;
+		if (!this.enabled) {
+			log$2.info(`[dry-run] → ${formatRecipient(msg.to)} | ${msg.subject}`);
+			return {
+				messageId: "dry-run",
+				accepted: true
+			};
+		}
+		try {
+			const result = await this.provider.send(msg);
+			log$2.info(`Sent → ${formatRecipient(msg.to)} | ${msg.subject} [${result.messageId}]`);
+			return result;
+		} catch (err) {
+			log$2.error({ err }, `Failed → ${formatRecipient(msg.to)} | ${msg.subject}`);
+			throw err;
+		}
+	}
+	/**
+	* Render a template and send the resulting HTML as an email.
+	* Requires a templateEngine to be configured.
+	*
+	* @param template - Template name (resolved by the engine)
+	* @param message - Mail message (html will be overwritten by the rendered template)
+	* @param data - Template variables
+	*/
+	async sendTemplate(template, message, data) {
+		if (!this.templateEngine) throw new Error("MailerService: templateEngine is required for sendTemplate(). Pass one in MailerOptions or use send() with raw HTML.");
+		const html = await this.templateEngine.render(template, data);
+		return this.send({
+			...message,
+			html
+		});
+	}
+	/** Get the underlying provider (for advanced use) */
+	getProvider() {
+		return this.provider;
+	}
+	/** Shutdown the provider */
+	async shutdown() {
+		if (this.provider.shutdown) await this.provider.shutdown();
+	}
+};
+function formatRecipient(to) {
+	if (Array.isArray(to)) return to.map((r) => typeof r === "string" ? r : r.address).join(", ");
+	return typeof to === "string" ? to : to.address;
+}
+//#endregion
+//#region src/adapter.ts
+const log$1 = Logger.for("MailerAdapter");
+/**
+* Mailer adapter — registers MailerService in the DI container.
+*
+* @example
+* ```ts
+* import { MailerAdapter, SmtpProvider } from '@forinda/kickjs-mailer'
+*
+* bootstrap({
+*   adapters: [
+*     new MailerAdapter({
+*       provider: new SmtpProvider({ host: 'smtp.gmail.com', port: 587, auth: { ... } }),
+*       defaultFrom: { name: 'My App', address: 'noreply@myapp.com' },
+*     }),
+*   ],
+* })
+* ```
+*/
+var MailerAdapter = class {
+	name = "MailerAdapter";
+	mailer;
+	constructor(options) {
+		this.options = options;
+		this.mailer = new MailerService(options);
+	}
+	afterStart({ container }) {
+		container.registerInstance(MAILER, this.mailer);
+		log$1.info(`Mail provider: ${this.options.provider.name}${this.options.enabled === false ? " (disabled)" : ""}`);
+	}
+	async shutdown() {
+		await this.mailer.shutdown();
+		log$1.info("Mailer shut down");
+	}
+};
+//#endregion
+//#region src/providers/smtp.provider.ts
+/**
+* SMTP mail provider using nodemailer.
+*
+* Requires `nodemailer` as a peer dependency:
+* ```bash
+* pnpm add nodemailer @types/nodemailer
+* ```
+*
+* @example
+* ```ts
+* // Gmail
+* new SmtpProvider({
+*   host: 'smtp.gmail.com',
+*   port: 587,
+*   auth: { user: 'you@gmail.com', pass: 'app-password' },
+* })
+*
+* // Resend via SMTP
+* new SmtpProvider({
+*   host: 'smtp.resend.com',
+*   port: 465,
+*   secure: true,
+*   auth: { user: 'resend', pass: process.env.RESEND_API_KEY! },
+* })
+*
+* // Mailpit (local dev)
+* new SmtpProvider({ host: 'localhost', port: 1025 })
+* ```
+*/
+var SmtpProvider = class {
+	name = "smtp";
+	transporter;
+	constructor(options) {
+		this.options = options;
+	}
+	async ensureTransporter() {
+		if (this.transporter) return;
+		try {
+			const nodemailer = await import("nodemailer");
+			this.transporter = (nodemailer.createTransport ?? nodemailer.default?.createTransport)({
+				host: this.options.host,
+				port: this.options.port ?? 587,
+				secure: this.options.secure ?? this.options.port === 465,
+				auth: this.options.auth,
+				connectionTimeout: this.options.connectionTimeout ?? 1e4
+			});
+		} catch {
+			throw new Error("SmtpProvider requires \"nodemailer\" package. Install: pnpm add nodemailer");
+		}
+	}
+	async send(message) {
+		await this.ensureTransporter();
+		const result = await this.transporter.sendMail({
+			from: formatAddress(message.from),
+			to: formatRecipients(message.to),
+			cc: message.cc ? formatRecipients(message.cc) : void 0,
+			bcc: message.bcc ? formatRecipients(message.bcc) : void 0,
+			replyTo: message.replyTo ? formatAddress(message.replyTo) : void 0,
+			subject: message.subject,
+			text: message.text,
+			html: message.html,
+			attachments: message.attachments,
+			headers: message.headers
+		});
+		return {
+			messageId: result.messageId,
+			accepted: (result.accepted?.length ?? 0) > 0,
+			raw: result
+		};
+	}
+	async shutdown() {
+		if (this.transporter) this.transporter.close();
+	}
+};
+function formatAddress(addr) {
+	if (!addr) return void 0;
+	if (typeof addr === "string") return addr;
+	return addr.name ? `"${addr.name}" <${addr.address}>` : addr.address;
+}
+function formatRecipients(recipients) {
+	if (!recipients) return "";
+	if (typeof recipients === "string") return recipients;
+	if (Array.isArray(recipients)) return recipients.map((r) => formatAddress(r)).join(", ");
+	return formatAddress(recipients) ?? "";
+}
+//#endregion
+//#region src/providers/console.provider.ts
+const log = Logger.for("ConsoleMail");
+let counter = 0;
+/**
+* Console mail provider — logs emails instead of sending them.
+* Perfect for development and testing.
+*
+* @example
+* ```ts
+* new MailerAdapter({
+*   provider: new ConsoleProvider(),
+*   defaultFrom: 'dev@localhost',
+* })
+* ```
+*/
+var ConsoleProvider = class {
+	name = "console";
+	async send(message) {
+		const id = `console-${++counter}`;
+		const to = Array.isArray(message.to) ? message.to.map((r) => typeof r === "string" ? r : r.address).join(", ") : typeof message.to === "string" ? message.to : message.to.address;
+		log.info(`────────────────────────────────────────`);
+		log.info(`From:    ${formatAddr(message.from)}`);
+		log.info(`To:      ${to}`);
+		if (message.cc) log.info(`CC:      ${formatAddr(message.cc)}`);
+		if (message.bcc) log.info(`BCC:     ${formatAddr(message.bcc)}`);
+		log.info(`Subject: ${message.subject}`);
+		if (message.text) log.info(`Text:    ${message.text.slice(0, 200)}${message.text.length > 200 ? "..." : ""}`);
+		if (message.html) log.info(`HTML:    ${message.html.slice(0, 200)}${message.html.length > 200 ? "..." : ""}`);
+		if (message.attachments?.length) log.info(`Attach:  ${message.attachments.map((a) => a.filename).join(", ")}`);
+		log.info(`ID:      ${id}`);
+		log.info(`────────────────────────────────────────`);
+		return {
+			messageId: id,
+			accepted: true
+		};
+	}
+};
+function formatAddr(addr) {
+	if (!addr) return "(none)";
+	if (typeof addr === "string") return addr;
+	if (Array.isArray(addr)) return addr.map(formatAddr).join(", ");
+	return addr.name ? `"${addr.name}" <${addr.address}>` : addr.address;
+}
+//#endregion
+export { ConsoleProvider, MAILER, MailerAdapter, MailerService, SmtpProvider };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["log","log"],"sources":["../src/mailer.service.ts","../src/adapter.ts","../src/providers/smtp.provider.ts","../src/providers/console.provider.ts"],"sourcesContent":["import { Logger } from '@forinda/kickjs'\nimport type {\n  MailProvider,\n  MailMessage,\n  MailResult,\n  MailRecipient,\n  MailTemplateEngine,\n  MailerOptions,\n} from './types'\n\nconst log = Logger.for('Mailer')\n\n/** DI token for resolving MailerService from the container */\nexport const MAILER = Symbol('MailerService')\n\n/**\n * Central mail service — send emails through any provider.\n *\n * @example\n * ```ts\n * @Service()\n * class UserService {\n *   constructor(@Inject(MAILER) private mailer: MailerService) {}\n *\n *   async sendWelcome(user: User) {\n *     await this.mailer.send({\n *       to: user.email,\n *       subject: 'Welcome!',\n *       html: '<h1>Welcome to our app</h1>',\n *     })\n *   }\n *\n *   // Or with templates:\n *   async sendInvoice(user: User, invoice: Invoice) {\n *     await this.mailer.sendTemplate('invoice', {\n *       to: user.email,\n *       subject: `Invoice #${invoice.number}`,\n *     }, { user, invoice })\n *   }\n * }\n * ```\n */\nexport class MailerService {\n  private provider: MailProvider\n  private defaultFrom?: MailRecipient\n  private templateEngine?: MailTemplateEngine\n  private enabled: boolean\n\n  constructor(options: MailerOptions) {\n    this.provider = options.provider\n    this.defaultFrom = options.defaultFrom\n    this.templateEngine = options.templateEngine\n    this.enabled = options.enabled ?? true\n  }\n\n  /**\n   * Send an email message.\n   * Applies defaultFrom if no from address is set.\n   */\n  async send(message: MailMessage): Promise<MailResult> {\n    const msg = { ...message }\n\n    // Apply default from\n    if (!msg.from && this.defaultFrom) {\n      msg.from = this.defaultFrom\n    }\n\n    if (!this.enabled) {\n      log.info(`[dry-run] → ${formatRecipient(msg.to)} | ${msg.subject}`)\n      return { messageId: 'dry-run', accepted: true }\n    }\n\n    try {\n      const result = await this.provider.send(msg)\n      log.info(`Sent → ${formatRecipient(msg.to)} | ${msg.subject} [${result.messageId}]`)\n      return result\n    } catch (err: any) {\n      log.error({ err }, `Failed → ${formatRecipient(msg.to)} | ${msg.subject}`)\n      throw err\n    }\n  }\n\n  /**\n   * Render a template and send the resulting HTML as an email.\n   * Requires a templateEngine to be configured.\n   *\n   * @param template - Template name (resolved by the engine)\n   * @param message - Mail message (html will be overwritten by the rendered template)\n   * @param data - Template variables\n   */\n  async sendTemplate(\n    template: string,\n    message: Omit<MailMessage, 'html'>,\n    data: Record<string, any>,\n  ): Promise<MailResult> {\n    if (!this.templateEngine) {\n      throw new Error(\n        'MailerService: templateEngine is required for sendTemplate(). ' +\n          'Pass one in MailerOptions or use send() with raw HTML.',\n      )\n    }\n\n    const html = await this.templateEngine.render(template, data)\n    return this.send({ ...message, html })\n  }\n\n  /** Get the underlying provider (for advanced use) */\n  getProvider(): MailProvider {\n    return this.provider\n  }\n\n  /** Shutdown the provider */\n  async shutdown(): Promise<void> {\n    if (this.provider.shutdown) {\n      await this.provider.shutdown()\n    }\n  }\n}\n\nfunction formatRecipient(to: MailRecipient | MailRecipient[]): string {\n  if (Array.isArray(to)) {\n    return to.map((r) => (typeof r === 'string' ? r : r.address)).join(', ')\n  }\n  return typeof to === 'string' ? to : to.address\n}\n","import { Logger, type AppAdapter, type AdapterContext } from '@forinda/kickjs'\nimport { MailerService, MAILER } from './mailer.service'\nimport type { MailerOptions } from './types'\n\nconst log = Logger.for('MailerAdapter')\n\n/**\n * Mailer adapter — registers MailerService in the DI container.\n *\n * @example\n * ```ts\n * import { MailerAdapter, SmtpProvider } from '@forinda/kickjs-mailer'\n *\n * bootstrap({\n *   adapters: [\n *     new MailerAdapter({\n *       provider: new SmtpProvider({ host: 'smtp.gmail.com', port: 587, auth: { ... } }),\n *       defaultFrom: { name: 'My App', address: 'noreply@myapp.com' },\n *     }),\n *   ],\n * })\n * ```\n */\nexport class MailerAdapter implements AppAdapter {\n  name = 'MailerAdapter'\n  private mailer: MailerService\n\n  constructor(private options: MailerOptions) {\n    this.mailer = new MailerService(options)\n  }\n\n  afterStart({ container }: AdapterContext): void {\n    container.registerInstance(MAILER, this.mailer)\n    log.info(\n      `Mail provider: ${this.options.provider.name}${this.options.enabled === false ? ' (disabled)' : ''}`,\n    )\n  }\n\n  async shutdown(): Promise<void> {\n    await this.mailer.shutdown()\n    log.info('Mailer shut down')\n  }\n}\n","import type { MailProvider, MailMessage, MailResult } from '../types'\n\nexport interface SmtpOptions {\n  /** SMTP host (e.g. 'smtp.gmail.com', 'smtp.resend.com') */\n  host: string\n  /** SMTP port (default: 587) */\n  port?: number\n  /** Use TLS (default: true for port 465, false otherwise) */\n  secure?: boolean\n  /** Authentication credentials */\n  auth?: {\n    user: string\n    pass: string\n  }\n  /** Connection timeout in ms (default: 10000) */\n  connectionTimeout?: number\n}\n\n/**\n * SMTP mail provider using nodemailer.\n *\n * Requires `nodemailer` as a peer dependency:\n * ```bash\n * pnpm add nodemailer @types/nodemailer\n * ```\n *\n * @example\n * ```ts\n * // Gmail\n * new SmtpProvider({\n *   host: 'smtp.gmail.com',\n *   port: 587,\n *   auth: { user: 'you@gmail.com', pass: 'app-password' },\n * })\n *\n * // Resend via SMTP\n * new SmtpProvider({\n *   host: 'smtp.resend.com',\n *   port: 465,\n *   secure: true,\n *   auth: { user: 'resend', pass: process.env.RESEND_API_KEY! },\n * })\n *\n * // Mailpit (local dev)\n * new SmtpProvider({ host: 'localhost', port: 1025 })\n * ```\n */\nexport class SmtpProvider implements MailProvider {\n  name = 'smtp'\n  private transporter: any\n\n  constructor(private options: SmtpOptions) {}\n\n  private async ensureTransporter(): Promise<void> {\n    if (this.transporter) return\n    try {\n      const nodemailer: any = await import('nodemailer')\n      const createTransport = nodemailer.createTransport ?? nodemailer.default?.createTransport\n      this.transporter = createTransport({\n        host: this.options.host,\n        port: this.options.port ?? 587,\n        secure: this.options.secure ?? this.options.port === 465,\n        auth: this.options.auth,\n        connectionTimeout: this.options.connectionTimeout ?? 10000,\n      })\n    } catch {\n      throw new Error('SmtpProvider requires \"nodemailer\" package. Install: pnpm add nodemailer')\n    }\n  }\n\n  async send(message: MailMessage): Promise<MailResult> {\n    await this.ensureTransporter()\n\n    const result = await this.transporter.sendMail({\n      from: formatAddress(message.from),\n      to: formatRecipients(message.to),\n      cc: message.cc ? formatRecipients(message.cc) : undefined,\n      bcc: message.bcc ? formatRecipients(message.bcc) : undefined,\n      replyTo: message.replyTo ? formatAddress(message.replyTo) : undefined,\n      subject: message.subject,\n      text: message.text,\n      html: message.html,\n      attachments: message.attachments,\n      headers: message.headers,\n    })\n\n    return {\n      messageId: result.messageId,\n      accepted: (result.accepted?.length ?? 0) > 0,\n      raw: result,\n    }\n  }\n\n  async shutdown(): Promise<void> {\n    if (this.transporter) {\n      this.transporter.close()\n    }\n  }\n}\n\nfunction formatAddress(addr: any): string | undefined {\n  if (!addr) return undefined\n  if (typeof addr === 'string') return addr\n  return addr.name ? `\"${addr.name}\" <${addr.address}>` : addr.address\n}\n\nfunction formatRecipients(recipients: any): string {\n  if (!recipients) return ''\n  if (typeof recipients === 'string') return recipients\n  if (Array.isArray(recipients)) {\n    return recipients.map((r: any) => formatAddress(r)).join(', ')\n  }\n  return formatAddress(recipients) ?? ''\n}\n","import { Logger } from '@forinda/kickjs'\nimport type { MailProvider, MailMessage, MailResult } from '../types'\n\nconst log = Logger.for('ConsoleMail')\n\nlet counter = 0\n\n/**\n * Console mail provider — logs emails instead of sending them.\n * Perfect for development and testing.\n *\n * @example\n * ```ts\n * new MailerAdapter({\n *   provider: new ConsoleProvider(),\n *   defaultFrom: 'dev@localhost',\n * })\n * ```\n */\nexport class ConsoleProvider implements MailProvider {\n  name = 'console'\n\n  async send(message: MailMessage): Promise<MailResult> {\n    const id = `console-${++counter}`\n    const to = Array.isArray(message.to)\n      ? message.to.map((r) => (typeof r === 'string' ? r : r.address)).join(', ')\n      : typeof message.to === 'string'\n        ? message.to\n        : message.to.address\n\n    log.info(`────────────────────────────────────────`)\n    log.info(`From:    ${formatAddr(message.from)}`)\n    log.info(`To:      ${to}`)\n    if (message.cc) log.info(`CC:      ${formatAddr(message.cc)}`)\n    if (message.bcc) log.info(`BCC:     ${formatAddr(message.bcc)}`)\n    log.info(`Subject: ${message.subject}`)\n    if (message.text)\n      log.info(`Text:    ${message.text.slice(0, 200)}${message.text.length > 200 ? '...' : ''}`)\n    if (message.html)\n      log.info(`HTML:    ${message.html.slice(0, 200)}${message.html.length > 200 ? '...' : ''}`)\n    if (message.attachments?.length) {\n      log.info(`Attach:  ${message.attachments.map((a) => a.filename).join(', ')}`)\n    }\n    log.info(`ID:      ${id}`)\n    log.info(`────────────────────────────────────────`)\n\n    return { messageId: id, accepted: true }\n  }\n}\n\nfunction formatAddr(addr: any): string {\n  if (!addr) return '(none)'\n  if (typeof addr === 'string') return addr\n  if (Array.isArray(addr)) return addr.map(formatAddr).join(', ')\n  return addr.name ? `\"${addr.name}\" <${addr.address}>` : addr.address\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-mailer",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Pluggable email sending for KickJS — nodemailer, Resend, SES, and custom providers",
   "keywords": [
     "kickjs",
@@ -39,20 +39,37 @@
     "vite"
   ],
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "dist/index.mjs",
+  "types": "dist/index.d.mts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.mts"
     }
   },
   "files": [
     "dist"
   ],
+  "wireit": {
+    "build": {
+      "command": "tsdown",
+      "files": [
+        "src/**/*.ts",
+        "tsdown.config.ts",
+        "tsconfig.json",
+        "package.json"
+      ],
+      "output": [
+        "dist/**"
+      ],
+      "dependencies": [
+        "../core:build"
+      ]
+    }
+  },
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs": "2.0.0"
+    "@forinda/kickjs": "2.1.0"
   },
   "peerDependencies": {
     "nodemailer": ">=7.0.11"
@@ -67,7 +84,7 @@
     "@types/nodemailer": "^7.0.11",
     "nodemailer": "^8.0.4",
     "typescript": "^5.9.2",
-    "vitest": "^4.1.1"
+    "vitest": "^4.1.2"
   },
   "publishConfig": {
     "access": "public"
@@ -87,11 +104,10 @@
     "url": "https://github.com/forinda/kick-js/issues"
   },
   "scripts": {
-    "build": "vite build && pnpm build:types",
-    "build:types": "tsc -p tsconfig.build.json",
-    "dev": "vite build --watch",
+    "build": "wireit",
+    "dev": "tsdown --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
-    "clean": "rm -rf dist .turbo"
+    "clean": "rm -rf dist .wireit"
   }
 }

package/dist/adapter.d.ts

@@ -1,28 +0,0 @@
-import { type AppAdapter, type AdapterContext } from '@forinda/kickjs';
-import type { MailerOptions } from './types';
-/**
- * Mailer adapter — registers MailerService in the DI container.
- *
- * @example
- * ```ts
- * import { MailerAdapter, SmtpProvider } from '@forinda/kickjs-mailer'
- *
- * bootstrap({
- *   adapters: [
- *     new MailerAdapter({
- *       provider: new SmtpProvider({ host: 'smtp.gmail.com', port: 587, auth: { ... } }),
- *       defaultFrom: { name: 'My App', address: 'noreply@myapp.com' },
- *     }),
- *   ],
- * })
- * ```
- */
-export declare class MailerAdapter implements AppAdapter {
-    private options;
-    name: string;
-    private mailer;
-    constructor(options: MailerOptions);
-    afterStart({ container }: AdapterContext): void;
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAE9E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAI5C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,aAAc,YAAW,UAAU;IAIlC,OAAO,CAAC,OAAO;IAH3B,IAAI,SAAkB;IACtB,OAAO,CAAC,MAAM,CAAe;gBAET,OAAO,EAAE,aAAa;IAI1C,UAAU,CAAC,EAAE,SAAS,EAAE,EAAE,cAAc,GAAG,IAAI;IAOzC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}

package/dist/index.d.ts

@@ -1,6 +0,0 @@
-import 'reflect-metadata';
-export { type MailProvider, type MailMessage, type MailResult, type MailAddress, type MailRecipient, type MailAttachment, type MailTemplateEngine, type MailerOptions, } from './types';
-export { MailerService, MAILER } from './mailer.service';
-export { MailerAdapter } from './adapter';
-export { SmtpProvider, ConsoleProvider, type SmtpOptions } from './providers';
-//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAA;AAGzB,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,aAAa,GACnB,MAAM,SAAS,CAAA;AAGhB,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAGxD,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAA;AAGzC,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -1,126 +0,0 @@
-import "reflect-metadata";
-import { Logger as f } from "@forinda/kickjs";
-var s = f.for("Mailer"), p = /* @__PURE__ */ Symbol("MailerService"), u = class {
-  provider;
-  defaultFrom;
-  templateEngine;
-  enabled;
-  constructor(t) {
-    this.provider = t.provider, this.defaultFrom = t.defaultFrom, this.templateEngine = t.templateEngine, this.enabled = t.enabled ?? !0;
-  }
-  async send(t) {
-    const r = { ...t };
-    if (!r.from && this.defaultFrom && (r.from = this.defaultFrom), !this.enabled)
-      return s.info(`[dry-run] → ${c(r.to)} | ${r.subject}`), {
-        messageId: "dry-run",
-        accepted: !0
-      };
-    try {
-      const n = await this.provider.send(r);
-      return s.info(`Sent → ${c(r.to)} | ${r.subject} [${n.messageId}]`), n;
-    } catch (n) {
-      throw s.error({ err: n }, `Failed → ${c(r.to)} | ${r.subject}`), n;
-    }
-  }
-  async sendTemplate(t, r, n) {
-    if (!this.templateEngine) throw new Error("MailerService: templateEngine is required for sendTemplate(). Pass one in MailerOptions or use send() with raw HTML.");
-    const o = await this.templateEngine.render(t, n);
-    return this.send({
-      ...r,
-      html: o
-    });
-  }
-  getProvider() {
-    return this.provider;
-  }
-  async shutdown() {
-    this.provider.shutdown && await this.provider.shutdown();
-  }
-};
-function c(t) {
-  return Array.isArray(t) ? t.map((r) => typeof r == "string" ? r : r.address).join(", ") : typeof t == "string" ? t : t.address;
-}
-var h = f.for("MailerAdapter"), v = class {
-  name = "MailerAdapter";
-  mailer;
-  constructor(t) {
-    this.options = t, this.mailer = new u(t);
-  }
-  afterStart({ container: t }) {
-    t.registerInstance(p, this.mailer), h.info(`Mail provider: ${this.options.provider.name}${this.options.enabled === !1 ? " (disabled)" : ""}`);
-  }
-  async shutdown() {
-    await this.mailer.shutdown(), h.info("Mailer shut down");
-  }
-}, $ = class {
-  name = "smtp";
-  transporter;
-  constructor(t) {
-    this.options = t;
-  }
-  async ensureTransporter() {
-    if (!this.transporter)
-      try {
-        const t = await import("nodemailer");
-        this.transporter = (t.createTransport ?? t.default?.createTransport)({
-          host: this.options.host,
-          port: this.options.port ?? 587,
-          secure: this.options.secure ?? this.options.port === 465,
-          auth: this.options.auth,
-          connectionTimeout: this.options.connectionTimeout ?? 1e4
-        });
-      } catch {
-        throw new Error('SmtpProvider requires "nodemailer" package. Install: pnpm add nodemailer');
-      }
-  }
-  async send(t) {
-    await this.ensureTransporter();
-    const r = await this.transporter.sendMail({
-      from: a(t.from),
-      to: l(t.to),
-      cc: t.cc ? l(t.cc) : void 0,
-      bcc: t.bcc ? l(t.bcc) : void 0,
-      replyTo: t.replyTo ? a(t.replyTo) : void 0,
-      subject: t.subject,
-      text: t.text,
-      html: t.html,
-      attachments: t.attachments,
-      headers: t.headers
-    });
-    return {
-      messageId: r.messageId,
-      accepted: (r.accepted?.length ?? 0) > 0,
-      raw: r
-    };
-  }
-  async shutdown() {
-    this.transporter && this.transporter.close();
-  }
-};
-function a(t) {
-  if (t)
-    return typeof t == "string" ? t : t.name ? `"${t.name}" <${t.address}>` : t.address;
-}
-function l(t) {
-  return t ? typeof t == "string" ? t : Array.isArray(t) ? t.map((r) => a(r)).join(", ") : a(t) ?? "" : "";
-}
-var e = f.for("ConsoleMail"), d = 0, w = class {
-  name = "console";
-  async send(t) {
-    const r = `console-${++d}`, n = Array.isArray(t.to) ? t.to.map((o) => typeof o == "string" ? o : o.address).join(", ") : typeof t.to == "string" ? t.to : t.to.address;
-    return e.info("────────────────────────────────────────"), e.info(`From:    ${i(t.from)}`), e.info(`To:      ${n}`), t.cc && e.info(`CC:      ${i(t.cc)}`), t.bcc && e.info(`BCC:     ${i(t.bcc)}`), e.info(`Subject: ${t.subject}`), t.text && e.info(`Text:    ${t.text.slice(0, 200)}${t.text.length > 200 ? "..." : ""}`), t.html && e.info(`HTML:    ${t.html.slice(0, 200)}${t.html.length > 200 ? "..." : ""}`), t.attachments?.length && e.info(`Attach:  ${t.attachments.map((o) => o.filename).join(", ")}`), e.info(`ID:      ${r}`), e.info("────────────────────────────────────────"), {
-      messageId: r,
-      accepted: !0
-    };
-  }
-};
-function i(t) {
-  return t ? typeof t == "string" ? t : Array.isArray(t) ? t.map(i).join(", ") : t.name ? `"${t.name}" <${t.address}>` : t.address : "(none)";
-}
-export {
-  w as ConsoleProvider,
-  p as MAILER,
-  v as MailerAdapter,
-  u as MailerService,
-  $ as SmtpProvider
-};

package/dist/mailer.service.d.ts

@@ -1,56 +0,0 @@
-import type { MailProvider, MailMessage, MailResult, MailerOptions } from './types';
-/** DI token for resolving MailerService from the container */
-export declare const MAILER: unique symbol;
-/**
- * Central mail service — send emails through any provider.
- *
- * @example
- * ```ts
- * @Service()
- * class UserService {
- *   constructor(@Inject(MAILER) private mailer: MailerService) {}
- *
- *   async sendWelcome(user: User) {
- *     await this.mailer.send({
- *       to: user.email,
- *       subject: 'Welcome!',
- *       html: '<h1>Welcome to our app</h1>',
- *     })
- *   }
- *
- *   // Or with templates:
- *   async sendInvoice(user: User, invoice: Invoice) {
- *     await this.mailer.sendTemplate('invoice', {
- *       to: user.email,
- *       subject: `Invoice #${invoice.number}`,
- *     }, { user, invoice })
- *   }
- * }
- * ```
- */
-export declare class MailerService {
-    private provider;
-    private defaultFrom?;
-    private templateEngine?;
-    private enabled;
-    constructor(options: MailerOptions);
-    /**
-     * Send an email message.
-     * Applies defaultFrom if no from address is set.
-     */
-    send(message: MailMessage): Promise<MailResult>;
-    /**
-     * Render a template and send the resulting HTML as an email.
-     * Requires a templateEngine to be configured.
-     *
-     * @param template - Template name (resolved by the engine)
-     * @param message - Mail message (html will be overwritten by the rendered template)
-     * @param data - Template variables
-     */
-    sendTemplate(template: string, message: Omit<MailMessage, 'html'>, data: Record<string, any>): Promise<MailResult>;
-    /** Get the underlying provider (for advanced use) */
-    getProvider(): MailProvider;
-    /** Shutdown the provider */
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=mailer.service.d.ts.map

package/dist/mailer.service.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mailer.service.d.ts","sourceRoot":"","sources":["../src/mailer.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EAGV,aAAa,EACd,MAAM,SAAS,CAAA;AAIhB,8DAA8D;AAC9D,eAAO,MAAM,MAAM,eAA0B,CAAA;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAe;IACnC,OAAO,CAAC,cAAc,CAAC,CAAoB;IAC3C,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,aAAa;IAOlC;;;OAGG;IACG,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAuBrD;;;;;;;OAOG;IACG,YAAY,CAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,EAClC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACxB,OAAO,CAAC,UAAU,CAAC;IAYtB,qDAAqD;IACrD,WAAW,IAAI,YAAY;IAI3B,4BAA4B;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}

package/dist/providers/console.provider.d.ts

@@ -1,18 +0,0 @@
-import type { MailProvider, MailMessage, MailResult } from '../types';
-/**
- * Console mail provider — logs emails instead of sending them.
- * Perfect for development and testing.
- *
- * @example
- * ```ts
- * new MailerAdapter({
- *   provider: new ConsoleProvider(),
- *   defaultFrom: 'dev@localhost',
- * })
- * ```
- */
-export declare class ConsoleProvider implements MailProvider {
-    name: string;
-    send(message: MailMessage): Promise<MailResult>;
-}
-//# sourceMappingURL=console.provider.d.ts.map

package/dist/providers/console.provider.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"console.provider.d.ts","sourceRoot":"","sources":["../../src/providers/console.provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAMrE;;;;;;;;;;;GAWG;AACH,qBAAa,eAAgB,YAAW,YAAY;IAClD,IAAI,SAAY;IAEV,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA0BtD"}

package/dist/providers/index.d.ts

@@ -1,3 +0,0 @@
-export { SmtpProvider, type SmtpOptions } from './smtp.provider';
-export { ConsoleProvider } from './console.provider';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}

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

@@ -1,55 +0,0 @@
-import type { MailProvider, MailMessage, MailResult } from '../types';
-export interface SmtpOptions {
-    /** SMTP host (e.g. 'smtp.gmail.com', 'smtp.resend.com') */
-    host: string;
-    /** SMTP port (default: 587) */
-    port?: number;
-    /** Use TLS (default: true for port 465, false otherwise) */
-    secure?: boolean;
-    /** Authentication credentials */
-    auth?: {
-        user: string;
-        pass: string;
-    };
-    /** Connection timeout in ms (default: 10000) */
-    connectionTimeout?: number;
-}
-/**
- * SMTP mail provider using nodemailer.
- *
- * Requires `nodemailer` as a peer dependency:
- * ```bash
- * pnpm add nodemailer @types/nodemailer
- * ```
- *
- * @example
- * ```ts
- * // Gmail
- * new SmtpProvider({
- *   host: 'smtp.gmail.com',
- *   port: 587,
- *   auth: { user: 'you@gmail.com', pass: 'app-password' },
- * })
- *
- * // Resend via SMTP
- * new SmtpProvider({
- *   host: 'smtp.resend.com',
- *   port: 465,
- *   secure: true,
- *   auth: { user: 'resend', pass: process.env.RESEND_API_KEY! },
- * })
- *
- * // Mailpit (local dev)
- * new SmtpProvider({ host: 'localhost', port: 1025 })
- * ```
- */
-export declare class SmtpProvider implements MailProvider {
-    private options;
-    name: string;
-    private transporter;
-    constructor(options: SmtpOptions);
-    private ensureTransporter;
-    send(message: MailMessage): Promise<MailResult>;
-    shutdown(): Promise<void>;
-}
-//# sourceMappingURL=smtp.provider.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"smtp.provider.d.ts","sourceRoot":"","sources":["../../src/providers/smtp.provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAErE,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAA;IACZ,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,iCAAiC;IACjC,IAAI,CAAC,EAAE;QACL,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,YAAa,YAAW,YAAY;IAInC,OAAO,CAAC,OAAO;IAH3B,IAAI,SAAS;IACb,OAAO,CAAC,WAAW,CAAK;gBAEJ,OAAO,EAAE,WAAW;YAE1B,iBAAiB;IAiBzB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB/C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAKhC"}

package/dist/types.d.ts

@@ -1,118 +0,0 @@
-export interface MailAddress {
-    name?: string;
-    address: string;
-}
-export type MailRecipient = string | MailAddress;
-export interface MailAttachment {
-    filename: string;
-    content?: string | Buffer;
-    path?: string;
-    contentType?: string;
-    encoding?: string;
-}
-export interface MailMessage {
-    /** Sender address */
-    from?: MailRecipient;
-    /** Recipient(s) */
-    to: MailRecipient | MailRecipient[];
-    /** CC recipient(s) */
-    cc?: MailRecipient | MailRecipient[];
-    /** BCC recipient(s) */
-    bcc?: MailRecipient | MailRecipient[];
-    /** Reply-to address */
-    replyTo?: MailRecipient;
-    /** Email subject */
-    subject: string;
-    /** Plain text body */
-    text?: string;
-    /** HTML body */
-    html?: string;
-    /** File attachments */
-    attachments?: MailAttachment[];
-    /** Custom headers */
-    headers?: Record<string, string>;
-    /** Provider-specific options (e.g. Resend tags, SES configuration set) */
-    metadata?: Record<string, any>;
-}
-export interface MailResult {
-    /** Provider-assigned message ID */
-    messageId: string;
-    /** Whether the send was accepted (does not guarantee delivery) */
-    accepted: boolean;
-    /** Raw response from the provider */
-    raw?: any;
-}
-/**
- * Template engine for rendering email bodies.
- * Implement this to use EJS, Handlebars, Pug, or any template system.
- *
- * @example
- * ```ts
- * import Handlebars from 'handlebars'
- *
- * class HandlebarsEngine implements MailTemplateEngine {
- *   private templates = new Map<string, HandlebarsTemplateDelegate>()
- *
- *   register(name: string, source: string) {
- *     this.templates.set(name, Handlebars.compile(source))
- *   }
- *
- *   async render(template: string, data: any) {
- *     const fn = this.templates.get(template)
- *     if (!fn) throw new Error(`Template "${template}" not found`)
- *     return fn(data)
- *   }
- * }
- * ```
- */
-export interface MailTemplateEngine {
-    /** Render a named template with data. Returns HTML string. */
-    render(template: string, data: Record<string, any>): Promise<string> | string;
-}
-/**
- * Abstract mail provider. Implement this to use any email service:
- * SMTP (nodemailer), Resend, AWS SES, SendGrid, Postmark, Mailgun, etc.
- *
- * @example
- * ```ts
- * class ResendProvider implements MailProvider {
- *   name = 'resend'
- *   private client: Resend
- *
- *   constructor(apiKey: string) {
- *     this.client = new Resend(apiKey)
- *   }
- *
- *   async send(message: MailMessage): Promise<MailResult> {
- *     const { data, error } = await this.client.emails.send({
- *       from: formatAddress(message.from),
- *       to: formatRecipients(message.to),
- *       subject: message.subject,
- *       html: message.html,
- *       text: message.text,
- *     })
- *     if (error) throw error
- *     return { messageId: data.id, accepted: true, raw: data }
- *   }
- * }
- * ```
- */
-export interface MailProvider {
-    /** Provider name for logging */
-    name: string;
-    /** Send an email message */
-    send(message: MailMessage): Promise<MailResult>;
-    /** Optional cleanup (close connections, etc.) */
-    shutdown?(): Promise<void>;
-}
-export interface MailerOptions {
-    /** Mail provider to use */
-    provider: MailProvider;
-    /** Default "from" address for all emails */
-    defaultFrom?: MailRecipient;
-    /** Optional template engine for rendering HTML from templates */
-    templateEngine?: MailTemplateEngine;
-    /** Enable/disable sending (useful for testing — logs instead of sending) */
-    enabled?: boolean;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,WAAW,CAAA;AAEhD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACzB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,qBAAqB;IACrB,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,mBAAmB;IACnB,EAAE,EAAE,aAAa,GAAG,aAAa,EAAE,CAAA;IACnC,sBAAsB;IACtB,EAAE,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAA;IACpC,uBAAuB;IACvB,GAAG,CAAC,EAAE,aAAa,GAAG,aAAa,EAAE,CAAA;IACrC,uBAAuB;IACvB,OAAO,CAAC,EAAE,aAAa,CAAA;IACvB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,sBAAsB;IACtB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,gBAAgB;IAChB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,uBAAuB;IACvB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAA;IAC9B,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,kEAAkE;IAClE,QAAQ,EAAE,OAAO,CAAA;IACjB,qCAAqC;IACrC,GAAG,CAAC,EAAE,GAAG,CAAA;CACV;AAID;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,CAAA;CAC9E;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,WAAW,YAAY;IAC3B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAA;IAEZ,4BAA4B;IAC5B,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAE/C,iDAAiD;IACjD,QAAQ,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B;AAID,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,QAAQ,EAAE,YAAY,CAAA;IAEtB,4CAA4C;IAC5C,WAAW,CAAC,EAAE,aAAa,CAAA;IAE3B,iEAAiE;IACjE,cAAc,CAAC,EAAE,kBAAkB,CAAA;IAEnC,4EAA4E;IAC5E,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}