@forinda/kickjs-mailer 1.3.2 → 1.4.0

package/dist/adapter.d.ts

@@ -0,0 +1,28 @@
+import { type AppAdapter, type Container } from '@forinda/kickjs-core';
+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(_server: any, container: Container): void;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,UAAU,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,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,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAO9C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAIhC"}

package/dist/index.d.ts

@@ -1,273 +1,6 @@
-import { AppAdapter, Container } from '@forinda/kickjs-core';
-
-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;
-}
-
-/** 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>;
-}
-
-/**
- * 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(_server: any, container: Container): void;
-    shutdown(): Promise<void>;
-}
-
-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>;
-}
-
-/**
- * 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>;
-}
-
-export { ConsoleProvider, MAILER, type MailAddress, type MailAttachment, type MailMessage, type MailProvider, type MailRecipient, type MailResult, type MailTemplateEngine, MailerAdapter, type MailerOptions, MailerService, type SmtpOptions, SmtpProvider };
+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

@@ -0,0 +1 @@
+{"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 +1,126 @@
-var w=Object.defineProperty;var o=(r,t)=>w(r,"name",{value:t,configurable:!0});import"reflect-metadata";import{Logger as b}from"@forinda/kickjs-core";var u=b.for("Mailer"),d=Symbol("MailerService"),a=class{static{o(this,"MailerService")}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){let e={...t};if(!e.from&&this.defaultFrom&&(e.from=this.defaultFrom),!this.enabled)return u.info(`[dry-run] \u2192 ${h(e.to)} | ${e.subject}`),{messageId:"dry-run",accepted:!0};try{let i=await this.provider.send(e);return u.info(`Sent \u2192 ${h(e.to)} | ${e.subject} [${i.messageId}]`),i}catch(i){throw u.error({err:i},`Failed \u2192 ${h(e.to)} | ${e.subject}`),i}}async sendTemplate(t,e,i){if(!this.templateEngine)throw new Error("MailerService: templateEngine is required for sendTemplate(). Pass one in MailerOptions or use send() with raw HTML.");let s=await this.templateEngine.render(t,i);return this.send({...e,html:s})}getProvider(){return this.provider}async shutdown(){this.provider.shutdown&&await this.provider.shutdown()}};function h(r){return Array.isArray(r)?r.map(t=>typeof t=="string"?t:t.address).join(", "):typeof r=="string"?r:r.address}o(h,"formatRecipient");import{Logger as v}from"@forinda/kickjs-core";var $=v.for("MailerAdapter"),m=class{static{o(this,"MailerAdapter")}options;name="MailerAdapter";mailer;constructor(t){this.options=t,this.mailer=new a(t)}afterStart(t,e){e.registerInstance(d,this.mailer),$.info(`Mail provider: ${this.options.provider.name}${this.options.enabled===!1?" (disabled)":""}`)}async shutdown(){await this.mailer.shutdown(),$.info("Mailer shut down")}};var c=class{static{o(this,"SmtpProvider")}options;name="smtp";transporter;constructor(t){this.options=t}async ensureTransporter(){if(!this.transporter)try{let t=await import("nodemailer"),e=t.createTransport??t.default?.createTransport;this.transporter=e({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();let e=await this.transporter.sendMail({from:f(t.from),to:y(t.to),cc:t.cc?y(t.cc):void 0,bcc:t.bcc?y(t.bcc):void 0,replyTo:t.replyTo?f(t.replyTo):void 0,subject:t.subject,text:t.text,html:t.html,attachments:t.attachments,headers:t.headers});return{messageId:e.messageId,accepted:(e.accepted?.length??0)>0,raw:e}}async shutdown(){this.transporter&&this.transporter.close()}};function f(r){if(r)return typeof r=="string"?r:r.name?`"${r.name}" <${r.address}>`:r.address}o(f,"formatAddress");function y(r){return r?typeof r=="string"?r:Array.isArray(r)?r.map(t=>f(t)).join(", "):f(r)??"":""}o(y,"formatRecipients");import{Logger as x}from"@forinda/kickjs-core";var n=x.for("ConsoleMail"),A=0,l=class{static{o(this,"ConsoleProvider")}name="console";async send(t){let e=`console-${++A}`,i=Array.isArray(t.to)?t.to.map(s=>typeof s=="string"?s:s.address).join(", "):typeof t.to=="string"?t.to:t.to.address;return n.info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"),n.info(`From:    ${p(t.from)}`),n.info(`To:      ${i}`),t.cc&&n.info(`CC:      ${p(t.cc)}`),t.bcc&&n.info(`BCC:     ${p(t.bcc)}`),n.info(`Subject: ${t.subject}`),t.text&&n.info(`Text:    ${t.text.slice(0,200)}${t.text.length>200?"...":""}`),t.html&&n.info(`HTML:    ${t.html.slice(0,200)}${t.html.length>200?"...":""}`),t.attachments?.length&&n.info(`Attach:  ${t.attachments.map(s=>s.filename).join(", ")}`),n.info(`ID:      ${e}`),n.info("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"),{messageId:e,accepted:!0}}};function p(r){return r?typeof r=="string"?r:Array.isArray(r)?r.map(p).join(", "):r.name?`"${r.name}" <${r.address}>`:r.address:"(none)"}o(p,"formatAddr");export{l as ConsoleProvider,d as MAILER,m as MailerAdapter,a as MailerService,c as SmtpProvider};
+import "reflect-metadata";
+import { Logger as f } from "@forinda/kickjs-core";
+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(t, r) {
+    r.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

@@ -0,0 +1,56 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,18 @@
+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

@@ -0,0 +1 @@
+{"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

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

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,55 @@
+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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,118 @@
+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

@@ -0,0 +1 @@
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-mailer",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "Pluggable email sending for KickJS — nodemailer, Resend, SES, and custom providers",
   "keywords": [
     "kickjs",
@@ -35,7 +35,8 @@
     "@forinda/kickjs-queue",
     "@forinda/kickjs-multi-tenant",
     "@forinda/kickjs-devtools",
-    "@forinda/kickjs-notifications"
+    "@forinda/kickjs-notifications",
+    "vite"
   ],
   "type": "module",
   "main": "dist/index.js",
@@ -51,7 +52,7 @@
   ],
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs-core": "1.3.2"
+    "@forinda/kickjs-core": "1.4.0"
   },
   "peerDependencies": {
     "nodemailer": ">=7.0.11"
@@ -64,8 +65,7 @@
   "devDependencies": {
     "@types/node": "^24.5.2",
     "@types/nodemailer": "^7.0.11",
-    "nodemailer": "^8.0.3",
-    "tsup": "^8.5.0",
+    "nodemailer": "^8.0.4",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
   },
@@ -87,8 +87,9 @@
     "url": "https://github.com/forinda/kick-js/issues"
   },
   "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "vite build && pnpm build:types",
+    "build:types": "tsc -p tsconfig.build.json",
+    "dev": "vite build --watch",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist .turbo"