@nexusts/mail 0.7.0 → 0.7.2

package/README.md

@@ -15,7 +15,7 @@ This module is part of the NexusTS monorepo. Each module is published as its own
 Most apps start with just the core:
 
 ```bash
-bun add @nexusts/core reflect-metadata zod hono
+bun add @nexusts/core
 ```
 
 Then add this module only if you need it:
@@ -26,7 +26,7 @@ bun add @nexusts/mail
 
 ## Peer dependencies
 
-None. This module is fully self-contained.
+**None.** No external dependencies for the null / file backends. The SMTP backend works out of the box; no `nodemailer` needed.
 
 ## Usage
 

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Public entry point for `nexusjs/mail`.
+ */
+export * from "./types.js";
+export { NullTransport, FileTransport, SmtpTransport, } from "./transports/index.js";
+export type { FileTransportOptions, SmtpTransportOptions, } from "./transports/index.js";
+export { MailService } from "./mail.service.js";
+export { MailModule } from "./mail.module.js";

package/dist/index.js

@@ -1,20 +1,4 @@
 // @bun
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
 var __legacyDecorateClassTS = function(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
   if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
@@ -172,7 +156,7 @@ class SmtpTransport {
   }
 }
 // packages/mail/src/mail.service.ts
-import { Inject, Injectable } from "@nexusts/core/decorators/index.js";
+import { Inject, Injectable } from "@nexusts/core";
 class MailService {
   static TOKEN = Symbol.for("nexus:MailService");
   transport;
@@ -211,7 +195,7 @@ MailService = __legacyDecorateClassTS([
 ], MailService);
 // packages/mail/src/mail.module.ts
 import"reflect-metadata";
-import { Module } from "@nexusts/core/decorators/module.js";
+import { Module } from "@nexusts/core";
 class MailModule {
   static forRoot(config = {}) {
     const cfg = {
@@ -254,5 +238,5 @@ export {
   FileTransport
 };
 
-//# debugId=1FAB167DA4BDABC864756E2164756E21
+//# debugId=3995FCC384FD6E1B64756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -6,10 +6,10 @@
     "/**\n * Null mail transport. Drops every message. Useful in tests.\n */\nimport type { MailMessage, MailSendResult, MailTransport } from \"../types.js\";\n\nexport class NullTransport implements MailTransport {\n\treadonly kind = \"null\";\n\t/** Captured messages for inspection in tests. */\n\tsent: MailMessage[] = [];\n\n\tasync send(msg: MailMessage): Promise<MailSendResult> {\n\t\tthis.sent.push(msg);\n\t\treturn {\n\t\t\tid: `null-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,\n\t\t\tsentAt: Date.now(),\n\t\t};\n\t}\n}\n",
     "/**\n * File mail transport. Writes each outgoing message as a `.eml` file\n * under a directory. Useful for development and acceptance tests.\n *\n *   new FileTransport({ dir: './tmp/mail', pretty: true });\n */\nimport { mkdir, writeFile } from \"node:fs/promises\";\nimport { join } from \"node:path\";\nimport type { MailMessage, MailSendResult, MailTransport } from \"../types.js\";\n\nexport interface FileTransportOptions {\n\t/** Directory where `.eml` files are written. */\n\tdir: string;\n\t/** Format the .eml with proper headers (true) or just the body (false). Default: true. */\n\tincludeHeaders?: boolean;\n\t/** Pretty-print JSON content-type bodies. */\n\tpretty?: boolean;\n}\n\nexport class FileTransport implements MailTransport {\n\treadonly kind = \"file\";\n\tprivate opts: Required<FileTransportOptions>;\n\n\tconstructor(opts: FileTransportOptions) {\n\t\tthis.opts = {\n\t\t\tdir: opts.dir,\n\t\t\tincludeHeaders: opts.includeHeaders ?? true,\n\t\t\tpretty: opts.pretty ?? true,\n\t\t};\n\t}\n\n\tasync send(msg: MailMessage): Promise<MailSendResult> {\n\t\tawait mkdir(this.opts.dir, { recursive: true });\n\t\tconst id = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;\n\t\tconst filename = `${id}.eml`;\n\t\tconst body = this.opts.includeHeaders ? this.toEml(msg) : this.toBody(msg);\n\t\tawait writeFile(join(this.opts.dir, filename), body, \"utf-8\");\n\t\treturn { id, sentAt: Date.now() };\n\t}\n\n\tprivate toEml(msg: MailMessage): string {\n\t\tconst headers: string[] = [];\n\t\tif (msg.from) headers.push(`From: ${this.formatAddr(msg.from)}`);\n\t\theaders.push(`To: ${this.formatAddr(msg.to)}`);\n\t\tif (msg.cc) headers.push(`Cc: ${this.formatAddr(msg.cc)}`);\n\t\tif (msg.replyTo) headers.push(`Reply-To: ${this.formatAddr(msg.replyTo)}`);\n\t\theaders.push(`Subject: ${msg.subject}`);\n\t\theaders.push(`Date: ${new Date().toUTCString()}`);\n\t\theaders.push(`MIME-Version: 1.0`);\n\t\tif (msg.html) {\n\t\t\theaders.push(`Content-Type: text/html; charset=utf-8`);\n\t\t} else {\n\t\t\theaders.push(`Content-Type: text/plain; charset=utf-8`);\n\t\t}\n\t\tconst body = msg.html ?? msg.text ?? \"\";\n\t\treturn `${headers.join(\"\\r\\n\")}\\r\\n\\r\\n${body}`;\n\t}\n\n\tprivate toBody(msg: MailMessage): string {\n\t\treturn msg.html ?? msg.text ?? \"\";\n\t}\n\n\tprivate formatAddr(a: MailMessage[\"to\"]): string {\n\t\tif (Array.isArray(a)) return a.map((x) => this.formatAddr(x)).join(\", \");\n\t\tif (typeof a === \"string\") return a;\n\t\treturn a.name ? `${a.name} <${a.address}>` : a.address;\n\t}\n}\n",
     "/**\n * SMTP mail transport. Uses `nodemailer` as an optional peer dep.\n *\n *   const transport = new SmtpTransport({\n *     host: 'smtp.gmail.com',\n *     port: 465,\n *     secure: true,\n *     auth: { user: '...', pass: '...' },\n *   });\n *   const mail = new MailService({ transport });\n */\nimport type { MailMessage, MailSendResult, MailTransport } from \"../types.js\";\n\nexport interface SmtpTransportOptions {\n\thost: string;\n\tport?: number;\n\tsecure?: boolean;\n\tauth?: { user: string; pass: string };\n\t/** Optional pool of pre-opened connections. */\n\tpool?: boolean;\n\t/** Maximum connections. */\n\tmaxConnections?: number;\n\t/** Sender override. */\n\tdefaultFrom?: string;\n\t/** `nodemailer` extra options. */\n\textras?: Record<string, any>;\n}\n\nexport class SmtpTransport implements MailTransport {\n\treadonly kind = \"smtp\";\n\tprivate opts: SmtpTransportOptions;\n\tprivate _transporter: any = null;\n\n\tconstructor(opts: SmtpTransportOptions) {\n\t\tthis.opts = opts;\n\t}\n\n\tprivate async transporter() {\n\t\tif (this._transporter) return this._transporter;\n\t\ttry {\n\t\t\tconst mod = await import(\"nodemailer\");\n\t\t\tthis._transporter = mod.default.createTransport({\n\t\t\t\thost: this.opts.host,\n\t\t\t\tport: this.opts.port,\n\t\t\t\tsecure: this.opts.secure,\n\t\t\t\tauth: this.opts.auth,\n\t\t\t\tpool: this.opts.pool,\n\t\t\t\tmaxConnections: this.opts.maxConnections,\n\t\t\t\t...this.opts.extras,\n\t\t\t});\n\t\t} catch (err) {\n\t\t\tthrow new Error(\n\t\t\t\t\"SmtpTransport requires nodemailer. Install it with: bun add nodemailer\",\n\t\t\t);\n\t\t}\n\t\treturn this._transporter;\n\t}\n\n\tasync send(msg: MailMessage): Promise<MailSendResult> {\n\t\tconst t = await this.transporter();\n\t\tconst from = this.formatAddr(msg.from ?? this.opts.defaultFrom);\n\t\tconst res = await t.sendMail({\n\t\t\tfrom,\n\t\t\tto: this.formatAddr(msg.to),\n\t\t\tcc: msg.cc ? this.formatAddr(msg.cc) : undefined,\n\t\t\tbcc: msg.bcc ? this.formatAddr(msg.bcc) : undefined,\n\t\t\treplyTo: msg.replyTo ? this.formatAddr(msg.replyTo) : undefined,\n\t\t\tsubject: msg.subject,\n\t\t\ttext: msg.text,\n\t\t\thtml: msg.html,\n\t\t\tattachments: msg.attachments?.map((a) => ({\n\t\t\t\tfilename: a.filename,\n\t\t\t\tcontent: a.content,\n\t\t\t\tcontentType: a.contentType,\n\t\t\t\tcid: a.cid,\n\t\t\t})),\n\t\t\theaders: msg.headers,\n\t\t\tpriority: msg.priority,\n\t\t});\n\t\treturn {\n\t\t\tid: res.messageId ?? `smtp-${Date.now()}`,\n\t\t\tsentAt: Date.now(),\n\t\t};\n\t}\n\n\tasync close(): Promise<void> {\n\t\tif (this._transporter) {\n\t\t\tawait this._transporter.close();\n\t\t\tthis._transporter = null;\n\t\t}\n\t}\n\n\tprivate formatAddr(a: MailMessage[\"to\"] | undefined): string {\n\t\tif (!a) return \"\";\n\t\tif (Array.isArray(a)) return a.map((x) => this.formatAddr(x)).join(\", \");\n\t\tif (typeof a === \"string\") return a;\n\t\treturn a.name ? `${a.name} <${a.address}>` : a.address;\n\t}\n}\n",
-    "/**\n * `MailService` — main entry point for outbound mail.\n *\n *   const mail = new MailService({ transport: new NullTransport() });\n *   await mail.send({ to: 'a@b.com', subject: 'hi', html: '<h1>hi</h1>' });\n *\n *   mail.renderMjml('<mjml>...</mjml>', { name: 'Kim' });\n */\nimport { Inject, Injectable } from \"@nexusts/core/decorators/index.js\";\nimport { NullTransport } from \"./transports/null.js\";\nimport type {\n\tMailConfig,\n\tMailMessage,\n\tMailSendResult,\n\tMailTransport,\n} from \"./types.js\";\n\n@Injectable()\nexport class MailService {\n\t/** DI token. */\n\tstatic readonly TOKEN = Symbol.for(\"nexus:MailService\");\n\n\ttransport: MailTransport;\n\tdefaultFrom?: MailConfig[\"defaultFrom\"];\n\n\tconstructor(@Inject(\"MAIL_CONFIG\") config: MailConfig = {}) {\n\t\tthis.transport = config.transport ?? new NullTransport();\n\t\tthis.defaultFrom = config.defaultFrom;\n\t}\n\n\t/** Send a single message. */\n\tasync send(msg: MailMessage): Promise<MailSendResult> {\n\t\tconst full = { ...msg, from: msg.from ?? this.defaultFrom };\n\t\treturn this.transport.send(full);\n\t}\n\n\t/** Send the same message to many recipients (one envelope per call). */\n\tasync sendBatch(msg: Omit<MailMessage, \"to\">, recipients: string[]): Promise<MailSendResult[]> {\n\t\tconst results: MailSendResult[] = [];\n\t\tfor (const to of recipients) {\n\t\t\tresults.push(await this.send({ ...msg, to }));\n\t\t}\n\t\treturn results;\n\t}\n\n\t/**\n\t * Render an MJML template. The optional `mjml` peer dep is loaded lazily.\n\t * Throws a clear error if not installed.\n\t */\n\tasync renderMjml(template: string, _vars?: Record<string, unknown>): Promise<string> {\n\t\ttry {\n\t\t\tconst mod = await import(\"mjml\");\n\t\t\tconst { html } = mod.mjml2html(template);\n\t\t\treturn html;\n\t\t} catch (err) {\n\t\t\tthrow new Error(\n\t\t\t\t\"renderMjml requires the 'mjml' package. Install it with: bun add mjml\",\n\t\t\t);\n\t\t}\n\t}\n}\n",
-    "/**\n * `MailModule` — drop-in mail.\n *\n *   @Module({\n *     imports: [\n *       MailModule.forRoot({\n *         transport: new SmtpTransport({ host: 'smtp.example.com' }),\n *         defaultFrom: 'no-reply@example.com',\n *       }),\n *     ],\n *   })\n *   export class AppModule {}\n */\nimport \"reflect-metadata\";\nimport { Module } from \"@nexusts/core/decorators/module.js\";\nimport { MailService } from \"./mail.service.js\";\nimport { NullTransport } from \"./transports/null.js\";\nimport type { MailConfig } from \"./types.js\";\n\n@Module({\n\tproviders: [\n\t\tMailService,\n\t\t{ provide: MailService.TOKEN, useExisting: MailService },\n\t],\n\texports: [MailService, MailService.TOKEN],\n})\nexport class MailModule {\n\tstatic forRoot(config: MailConfig = {}) {\n\t\tconst cfg: MailConfig = {\n\t\t\ttransport: new NullTransport(),\n\t\t\t...config,\n\t\t};\n\t\t@Module({\n\t\t\tproviders: [\n\t\t\t\tMailService,\n\t\t\t\t{ provide: MailService.TOKEN, useExisting: MailService },\n\t\t\t\t{ provide: \"MAIL_CONFIG\", useValue: cfg },\n\t\t\t],\n\t\t\texports: [MailService, MailService.TOKEN],\n\t\t})\n\t\tclass ConfiguredMailModule {}\n\t\tObject.defineProperty(ConfiguredMailModule, \"name\", {\n\t\t\tvalue: \"ConfiguredMailModule\",\n\t\t});\n\t\treturn ConfiguredMailModule;\n\t}\n}\n"
+    "/**\n * `MailService` — main entry point for outbound mail.\n *\n *   const mail = new MailService({ transport: new NullTransport() });\n *   await mail.send({ to: 'a@b.com', subject: 'hi', html: '<h1>hi</h1>' });\n *\n *   mail.renderMjml('<mjml>...</mjml>', { name: 'Kim' });\n */\nimport { Inject, Injectable } from \"@nexusts/core\";\nimport { NullTransport } from \"./transports/null.js\";\nimport type {\n\tMailConfig,\n\tMailMessage,\n\tMailSendResult,\n\tMailTransport,\n} from \"./types.js\";\n\n@Injectable()\nexport class MailService {\n\t/** DI token. */\n\tstatic readonly TOKEN = Symbol.for(\"nexus:MailService\");\n\n\ttransport: MailTransport;\n\tdefaultFrom?: MailConfig[\"defaultFrom\"];\n\n\tconstructor(@Inject(\"MAIL_CONFIG\") config: MailConfig = {}) {\n\t\tthis.transport = config.transport ?? new NullTransport();\n\t\tthis.defaultFrom = config.defaultFrom;\n\t}\n\n\t/** Send a single message. */\n\tasync send(msg: MailMessage): Promise<MailSendResult> {\n\t\tconst full = { ...msg, from: msg.from ?? this.defaultFrom };\n\t\treturn this.transport.send(full);\n\t}\n\n\t/** Send the same message to many recipients (one envelope per call). */\n\tasync sendBatch(msg: Omit<MailMessage, \"to\">, recipients: string[]): Promise<MailSendResult[]> {\n\t\tconst results: MailSendResult[] = [];\n\t\tfor (const to of recipients) {\n\t\t\tresults.push(await this.send({ ...msg, to }));\n\t\t}\n\t\treturn results;\n\t}\n\n\t/**\n\t * Render an MJML template. The optional `mjml` peer dep is loaded lazily.\n\t * Throws a clear error if not installed.\n\t */\n\tasync renderMjml(template: string, _vars?: Record<string, unknown>): Promise<string> {\n\t\ttry {\n\t\t\tconst mod = await import(\"mjml\");\n\t\t\tconst { html } = mod.mjml2html(template);\n\t\t\treturn html;\n\t\t} catch (err) {\n\t\t\tthrow new Error(\n\t\t\t\t\"renderMjml requires the 'mjml' package. Install it with: bun add mjml\",\n\t\t\t);\n\t\t}\n\t}\n}\n",
+    "/**\n * `MailModule` — drop-in mail.\n *\n *   @Module({\n *     imports: [\n *       MailModule.forRoot({\n *         transport: new SmtpTransport({ host: 'smtp.example.com' }),\n *         defaultFrom: 'no-reply@example.com',\n *       }),\n *     ],\n *   })\n *   export class AppModule {}\n */\nimport \"reflect-metadata\";\nimport { Module } from \"@nexusts/core\";\nimport { MailService } from \"./mail.service.js\";\nimport { NullTransport } from \"./transports/null.js\";\nimport type { MailConfig } from \"./types.js\";\n\n@Module({\n\tproviders: [\n\t\tMailService,\n\t\t{ provide: MailService.TOKEN, useExisting: MailService },\n\t],\n\texports: [MailService, MailService.TOKEN],\n})\nexport class MailModule {\n\tstatic forRoot(config: MailConfig = {}) {\n\t\tconst cfg: MailConfig = {\n\t\t\ttransport: new NullTransport(),\n\t\t\t...config,\n\t\t};\n\t\t@Module({\n\t\t\tproviders: [\n\t\t\t\tMailService,\n\t\t\t\t{ provide: MailService.TOKEN, useExisting: MailService },\n\t\t\t\t{ provide: \"MAIL_CONFIG\", useValue: cfg },\n\t\t\t],\n\t\t\texports: [MailService, MailService.TOKEN],\n\t\t})\n\t\tclass ConfiguredMailModule {}\n\t\tObject.defineProperty(ConfiguredMailModule, \"name\", {\n\t\t\tvalue: \"ConfiguredMailModule\",\n\t\t});\n\t\treturn ConfiguredMailModule;\n\t}\n}\n"
   ],
-  "mappings": "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",
-  "debugId": "1FAB167DA4BDABC864756E2164756E21",
+  "mappings": "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",
+  "debugId": "3995FCC384FD6E1B64756E2164756E21",
   "names": []
 }

package/dist/mail.module.d.ts

@@ -0,0 +1,20 @@
+/**
+ * `MailModule` — drop-in mail.
+ *
+ *   @Module({
+ *     imports: [
+ *       MailModule.forRoot({
+ *         transport: new SmtpTransport({ host: 'smtp.example.com' }),
+ *         defaultFrom: 'no-reply@example.com',
+ *       }),
+ *     ],
+ *   })
+ *   export class AppModule {}
+ */
+import "reflect-metadata";
+import type { MailConfig } from "./types.js";
+export declare class MailModule {
+    static forRoot(config?: MailConfig): {
+        new (): {};
+    };
+}

package/dist/mail.service.d.ts

@@ -0,0 +1,17 @@
+import type { MailConfig, MailMessage, MailSendResult, MailTransport } from "./types.js";
+export declare class MailService {
+    /** DI token. */
+    static readonly TOKEN: unique symbol;
+    transport: MailTransport;
+    defaultFrom?: MailConfig["defaultFrom"];
+    constructor(config?: MailConfig);
+    /** Send a single message. */
+    send(msg: MailMessage): Promise<MailSendResult>;
+    /** Send the same message to many recipients (one envelope per call). */
+    sendBatch(msg: Omit<MailMessage, "to">, recipients: string[]): Promise<MailSendResult[]>;
+    /**
+     * Render an MJML template. The optional `mjml` peer dep is loaded lazily.
+     * Throws a clear error if not installed.
+     */
+    renderMjml(template: string, _vars?: Record<string, unknown>): Promise<string>;
+}

package/dist/transports/file.d.ts

@@ -0,0 +1,18 @@
+import type { MailMessage, MailSendResult, MailTransport } from "../types.js";
+export interface FileTransportOptions {
+    /** Directory where `.eml` files are written. */
+    dir: string;
+    /** Format the .eml with proper headers (true) or just the body (false). Default: true. */
+    includeHeaders?: boolean;
+    /** Pretty-print JSON content-type bodies. */
+    pretty?: boolean;
+}
+export declare class FileTransport implements MailTransport {
+    readonly kind = "file";
+    private opts;
+    constructor(opts: FileTransportOptions);
+    send(msg: MailMessage): Promise<MailSendResult>;
+    private toEml;
+    private toBody;
+    private formatAddr;
+}

package/dist/transports/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Transports barrel.
+ */
+export { NullTransport } from "./null.js";
+export { FileTransport } from "./file.js";
+export type { FileTransportOptions } from "./file.js";
+export { SmtpTransport } from "./smtp.js";
+export type { SmtpTransportOptions } from "./smtp.js";

package/dist/transports/null.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Null mail transport. Drops every message. Useful in tests.
+ */
+import type { MailMessage, MailSendResult, MailTransport } from "../types.js";
+export declare class NullTransport implements MailTransport {
+    readonly kind = "null";
+    /** Captured messages for inspection in tests. */
+    sent: MailMessage[];
+    send(msg: MailMessage): Promise<MailSendResult>;
+}

package/dist/transports/smtp.d.ts

@@ -0,0 +1,39 @@
+/**
+ * SMTP mail transport. Uses `nodemailer` as an optional peer dep.
+ *
+ *   const transport = new SmtpTransport({
+ *     host: 'smtp.gmail.com',
+ *     port: 465,
+ *     secure: true,
+ *     auth: { user: '...', pass: '...' },
+ *   });
+ *   const mail = new MailService({ transport });
+ */
+import type { MailMessage, MailSendResult, MailTransport } from "../types.js";
+export interface SmtpTransportOptions {
+    host: string;
+    port?: number;
+    secure?: boolean;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+    /** Optional pool of pre-opened connections. */
+    pool?: boolean;
+    /** Maximum connections. */
+    maxConnections?: number;
+    /** Sender override. */
+    defaultFrom?: string;
+    /** `nodemailer` extra options. */
+    extras?: Record<string, any>;
+}
+export declare class SmtpTransport implements MailTransport {
+    readonly kind = "smtp";
+    private opts;
+    private _transporter;
+    constructor(opts: SmtpTransportOptions);
+    private transporter;
+    send(msg: MailMessage): Promise<MailSendResult>;
+    close(): Promise<void>;
+    private formatAddr;
+}

package/dist/types.d.ts

@@ -0,0 +1,72 @@
+/**
+ * `nexusjs/mail` — outbound email.
+ *
+ *   const mail = new MailService({ transport: new SmtpTransport({ host: 'smtp.gmail.com' }) });
+ *   await mail.send({
+ *     from: 'no-reply@example.com',
+ *     to: 'user@example.com',
+ *     subject: 'Welcome',
+ *     html: '<h1>Hi</h1>',
+ *   });
+ *
+ * Transports:
+ *   - `SmtpTransport`  — SMTP via nodemailer (peer dep)
+ *   - `FileTransport`  — write .eml files to a directory (dev/test)
+ *   - `NullTransport`  — drop everything (tests)
+ *
+ *   mail.renderMjml('template', { name: 'Kim' })  // compile MJML to HTML
+ */
+import "reflect-metadata";
+/** A single recipient. */
+export type MailAddress = string | {
+    name?: string;
+    address: string;
+};
+/** A mail message. */
+export interface MailMessage {
+    from?: MailAddress;
+    to: MailAddress | MailAddress[];
+    cc?: MailAddress | MailAddress[];
+    bcc?: MailAddress | MailAddress[];
+    replyTo?: MailAddress;
+    subject: string;
+    text?: string;
+    html?: string;
+    /** Attachments. */
+    attachments?: MailAttachment[];
+    /** Custom headers. */
+    headers?: Record<string, string>;
+    /** Priority: 1 (high), 3 (normal), 5 (low). */
+    priority?: "high" | "normal" | "low";
+}
+export interface MailAttachment {
+    filename: string;
+    /** File content (Buffer / string). */
+    content: Buffer | string;
+    /** MIME type. Default: 'application/octet-stream'. */
+    contentType?: string;
+    /** Content-ID for inline images. */
+    cid?: string;
+}
+/** Result returned by a transport after sending. */
+export interface MailSendResult {
+    /** Transport-specific ID (e.g. SMTP message-id). */
+    id: string;
+    /** When the message was sent (unix-ms). */
+    sentAt: number;
+}
+/** Transport that knows how to deliver a message. */
+export interface MailTransport {
+    readonly kind: string;
+    send(msg: MailMessage): Promise<MailSendResult>;
+    close?(): Promise<void>;
+}
+/** Top-level config. */
+export interface MailConfig {
+    /** Transport backend. Default: NullTransport. */
+    transport?: MailTransport;
+    /** Default `from` address. */
+    defaultFrom?: MailAddress;
+    /** Whether to expose raw `nodemailer` (only if SmtpTransport is used). */
+    debug?: boolean;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nexusts/mail",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Outbound email (SMTP / File / Null transports)",
   "type": "module",
   "main": "./dist/index.js",
@@ -26,6 +26,6 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@nexusts/core": "^0.7.0"
+    "@nexusts/core": "^0.7.2"
   }
 }