@geekmidas/emailkit 10.0.0-alpha.14 → 10.0.0-alpha.141

package/dist/client.cjs

@@ -1,29 +1,9 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-//#endregion
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+let _opentelemetry_api = require("@opentelemetry/api");
 let _react_email_components = require("@react-email/components");
 let nodemailer = require("nodemailer");
-nodemailer = __toESM(nodemailer, 1);
+nodemailer = require_rolldown_runtime.__toESM(nodemailer, 1);
 //#region src/client.ts
 var SMTPClient = class {
 	transporter;
@@ -32,7 +12,15 @@ var SMTPClient = class {
 		this.config = config;
 		this.transporter = nodemailer.default.createTransport(config.smtp);
 	}
+	/**
+	* Send one message. An `email.send` span covers it, through the global
+	* OpenTelemetry tracer: the transport and how many were accepted or
+	* rejected, never an address, subject or body.
+	*/
 	async send(options) {
+		return traceSend({ "email.recipients": recipients(options) }, () => this.deliver(options));
+	}
+	async deliver(options) {
 		const mailOptions = {
 			...this.config.defaults,
 			...options
@@ -52,10 +40,13 @@ var SMTPClient = class {
 		if (!Component) throw new Error(`Template "${String(template)}" not found`);
 		const element = Component(options.props);
 		const html = await (0, _react_email_components.render)(element);
-		return this.send({
+		return traceSend({
+			"email.template": String(template),
+			"email.recipients": recipients(options)
+		}, () => this.deliver({
 			...options,
 			html
-		});
+		}));
 	}
 	async verify() {
 		try {
@@ -75,6 +66,37 @@ var SMTPClient = class {
 function createEmailClient(config) {
 	return new SMTPClient(config);
 }
+/** How many addresses a message is for: to, cc and bcc. */
+function recipients(options) {
+	return count(options.to) + count(options.cc) + count(options.bcc);
+}
+function count(value) {
+	if (!value) return 0;
+	return Array.isArray(value) ? value.length : 1;
+}
+async function traceSend(attributes, send) {
+	const span = _opentelemetry_api.trace.getTracer("@geekmidas/emailkit").startSpan("email.send", {
+		kind: _opentelemetry_api.SpanKind.CLIENT,
+		attributes: {
+			"email.transport": "smtp",
+			...attributes
+		}
+	});
+	try {
+		const result = await send();
+		if (result.accepted.length || result.rejected.length) span.setAttributes({
+			"email.accepted": count(result.accepted),
+			"email.rejected": count(result.rejected)
+		});
+		return result;
+	} catch (error) {
+		if (error instanceof Error) span.recordException(error);
+		span.setStatus({ code: _opentelemetry_api.SpanStatusCode.ERROR });
+		throw error;
+	} finally {
+		span.end();
+	}
+}
 //#endregion
 exports.SMTPClient = SMTPClient;
 exports.createEmailClient = createEmailClient;

package/dist/client.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.cjs","names":["render"],"sources":["../src/client.ts"],"sourcesContent":["import { render } from '@react-email/components';\nimport nodemailer, { type Transporter } from 'nodemailer';\nimport type {\n\tEmailClient,\n\tEmailClientConfig,\n\tSendOptions,\n\tSendResult,\n\tTemplateNames,\n\tTemplatePropsFor,\n\tTemplateRecord,\n} from './types';\n\nexport class SMTPClient<T extends TemplateRecord> implements EmailClient<T> {\n\tprivate transporter: Transporter;\n\tprivate config: EmailClientConfig<T>;\n\n\tconstructor(config: EmailClientConfig<T>) {\n\t\tthis.config = config;\n\t\tthis.transporter = nodemailer.createTransport(config.smtp as any);\n\t}\n\n\tasync send(options: SendOptions): Promise<SendResult> {\n\t\tconst mailOptions = {\n\t\t\t...this.config.defaults,\n\t\t\t...options,\n\t\t};\n\n\t\tif (!mailOptions.from) {\n\t\t\tthrow new Error(\n\t\t\t\t'The \"from\" field is required in email options or defaults',\n\t\t\t);\n\t\t}\n\n\t\tif (!mailOptions.text && !mailOptions.html) {\n\t\t\tthrow new Error('Either text or html content must be provided');\n\t\t}\n\n\t\tconst info = await this.transporter.sendMail(mailOptions);\n\n\t\treturn {\n\t\t\tmessageId: info.messageId,\n\t\t\taccepted: info.accepted || [],\n\t\t\trejected: info.rejected || [],\n\t\t\tresponse: info.response,\n\t\t};\n\t}\n\n\tasync sendTemplate<K extends TemplateNames<T>>(\n\t\ttemplate: K,\n\t\toptions: Omit<SendOptions, 'template'> & {\n\t\t\tprops: TemplatePropsFor<T, K>;\n\t\t},\n\t): Promise<SendResult> {\n\t\tconst Component = this.config.templates[template];\n\t\tif (!Component) {\n\t\t\tthrow new Error(`Template \"${String(template)}\" not found`);\n\t\t}\n\n\t\tconst element = Component(options.props);\n\t\tconst html = await render(element);\n\n\t\treturn this.send({\n\t\t\t...options,\n\t\t\thtml,\n\t\t});\n\t}\n\n\tasync verify(): Promise<boolean> {\n\t\ttry {\n\t\t\tawait this.transporter.verify();\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.transporter.close();\n\t}\n\n\tgetTemplateNames(): TemplateNames<T>[] {\n\t\treturn Object.keys(this.config.templates) as TemplateNames<T>[];\n\t}\n}\n\nexport function createEmailClient<T extends TemplateRecord>(\n\tconfig: EmailClientConfig<T>,\n): SMTPClient<T> {\n\treturn new SMTPClient(config);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,IAAa,aAAb,MAA4E;CAC3E;CACA;CAEA,YAAY,QAA8B;EACzC,KAAK,SAAS;EACd,KAAK,cAAc,WAAA,QAAW,gBAAgB,OAAO,IAAW;CACjE;CAEA,MAAM,KAAK,SAA2C;EACrD,MAAM,cAAc;GACnB,GAAG,KAAK,OAAO;GACf,GAAG;EACJ;EAEA,IAAI,CAAC,YAAY,MAChB,MAAM,IAAI,MACT,6DACD;EAGD,IAAI,CAAC,YAAY,QAAQ,CAAC,YAAY,MACrC,MAAM,IAAI,MAAM,8CAA8C;EAG/D,MAAM,OAAO,MAAM,KAAK,YAAY,SAAS,WAAW;EAExD,OAAO;GACN,WAAW,KAAK;GAChB,UAAU,KAAK,YAAY,CAAC;GAC5B,UAAU,KAAK,YAAY,CAAC;GAC5B,UAAU,KAAK;EAChB;CACD;CAEA,MAAM,aACL,UACA,SAGsB;EACtB,MAAM,YAAY,KAAK,OAAO,UAAU;EACxC,IAAI,CAAC,WACJ,MAAM,IAAI,MAAM,aAAa,OAAO,QAAQ,EAAE,YAAY;EAG3D,MAAM,UAAU,UAAU,QAAQ,KAAK;EACvC,MAAM,OAAO,OAAA,GAAMA,wBAAAA,OAAAA,CAAO,OAAO;EAEjC,OAAO,KAAK,KAAK;GAChB,GAAG;GACH;EACD,CAAC;CACF;CAEA,MAAM,SAA2B;EAChC,IAAI;GACH,MAAM,KAAK,YAAY,OAAO;GAC9B,OAAO;EACR,QAAQ;GACP,OAAO;EACR;CACD;CAEA,MAAM,QAAuB;EAC5B,KAAK,YAAY,MAAM;CACxB;CAEA,mBAAuC;EACtC,OAAO,OAAO,KAAK,KAAK,OAAO,SAAS;CACzC;AACD;AAEA,SAAgB,kBACf,QACgB;CAChB,OAAO,IAAI,WAAW,MAAM;AAC7B"}
+{"version":3,"file":"client.cjs","names":["render","trace","SpanKind","SpanStatusCode"],"sources":["../src/client.ts"],"sourcesContent":["import {\n\ttype Attributes,\n\tSpanKind,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\nimport { render } from '@react-email/components';\nimport nodemailer, { type Transporter } from 'nodemailer';\nimport type {\n\tEmailClient,\n\tEmailClientConfig,\n\tSendOptions,\n\tSendResult,\n\tTemplateNames,\n\tTemplatePropsFor,\n\tTemplateRecord,\n} from './types';\n\nexport class SMTPClient<T extends TemplateRecord> implements EmailClient<T> {\n\tprivate transporter: Transporter;\n\tprivate config: EmailClientConfig<T>;\n\n\tconstructor(config: EmailClientConfig<T>) {\n\t\tthis.config = config;\n\t\tthis.transporter = nodemailer.createTransport(config.smtp as any);\n\t}\n\n\t/**\n\t * Send one message. An `email.send` span covers it, through the global\n\t * OpenTelemetry tracer: the transport and how many were accepted or\n\t * rejected, never an address, subject or body.\n\t */\n\tasync send(options: SendOptions): Promise<SendResult> {\n\t\treturn traceSend({ 'email.recipients': recipients(options) }, () =>\n\t\t\tthis.deliver(options),\n\t\t);\n\t}\n\n\tprivate async deliver(options: SendOptions): Promise<SendResult> {\n\t\tconst mailOptions = {\n\t\t\t...this.config.defaults,\n\t\t\t...options,\n\t\t};\n\n\t\tif (!mailOptions.from) {\n\t\t\tthrow new Error(\n\t\t\t\t'The \"from\" field is required in email options or defaults',\n\t\t\t);\n\t\t}\n\n\t\tif (!mailOptions.text && !mailOptions.html) {\n\t\t\tthrow new Error('Either text or html content must be provided');\n\t\t}\n\n\t\tconst info = await this.transporter.sendMail(mailOptions);\n\n\t\treturn {\n\t\t\tmessageId: info.messageId,\n\t\t\taccepted: info.accepted || [],\n\t\t\trejected: info.rejected || [],\n\t\t\tresponse: info.response,\n\t\t};\n\t}\n\n\tasync sendTemplate<K extends TemplateNames<T>>(\n\t\ttemplate: K,\n\t\toptions: Omit<SendOptions, 'template'> & {\n\t\t\tprops: TemplatePropsFor<T, K>;\n\t\t},\n\t): Promise<SendResult> {\n\t\tconst Component = this.config.templates[template];\n\t\tif (!Component) {\n\t\t\tthrow new Error(`Template \"${String(template)}\" not found`);\n\t\t}\n\n\t\tconst element = Component(options.props);\n\t\tconst html = await render(element);\n\n\t\treturn traceSend(\n\t\t\t{\n\t\t\t\t'email.template': String(template),\n\t\t\t\t'email.recipients': recipients(options),\n\t\t\t},\n\t\t\t() => this.deliver({ ...options, html }),\n\t\t);\n\t}\n\n\tasync verify(): Promise<boolean> {\n\t\ttry {\n\t\t\tawait this.transporter.verify();\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.transporter.close();\n\t}\n\n\tgetTemplateNames(): TemplateNames<T>[] {\n\t\treturn Object.keys(this.config.templates) as TemplateNames<T>[];\n\t}\n}\n\nexport function createEmailClient<T extends TemplateRecord>(\n\tconfig: EmailClientConfig<T>,\n): SMTPClient<T> {\n\treturn new SMTPClient(config);\n}\n\n/** How many addresses a message is for: to, cc and bcc. */\nfunction recipients(options: {\n\tto?: unknown;\n\tcc?: unknown;\n\tbcc?: unknown;\n}): number {\n\treturn count(options.to) + count(options.cc) + count(options.bcc);\n}\n\nfunction count(value: unknown): number {\n\tif (!value) return 0;\n\treturn Array.isArray(value) ? value.length : 1;\n}\n\nasync function traceSend(\n\tattributes: Attributes,\n\tsend: () => Promise<SendResult>,\n): Promise<SendResult> {\n\tconst span = trace.getTracer('@geekmidas/emailkit').startSpan('email.send', {\n\t\tkind: SpanKind.CLIENT,\n\t\tattributes: { 'email.transport': 'smtp', ...attributes },\n\t});\n\ttry {\n\t\tconst result = await send();\n\t\t// What the server said, when the transport reports it.\n\t\tif (result.accepted.length || result.rejected.length) {\n\t\t\tspan.setAttributes({\n\t\t\t\t'email.accepted': count(result.accepted),\n\t\t\t\t'email.rejected': count(result.rejected),\n\t\t\t});\n\t\t}\n\t\treturn result;\n\t} catch (error) {\n\t\tif (error instanceof Error) span.recordException(error);\n\t\tspan.setStatus({ code: SpanStatusCode.ERROR });\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n"],"mappings":";;;;;;;AAkBA,IAAa,aAAb,MAA4E;CAC3E;CACA;CAEA,YAAY,QAA8B;EACzC,KAAK,SAAS;EACd,KAAK,cAAc,WAAA,QAAW,gBAAgB,OAAO,IAAW;CACjE;;;;;;CAOA,MAAM,KAAK,SAA2C;EACrD,OAAO,UAAU,EAAE,oBAAoB,WAAW,OAAO,EAAE,SAC1D,KAAK,QAAQ,OAAO,CACrB;CACD;CAEA,MAAc,QAAQ,SAA2C;EAChE,MAAM,cAAc;GACnB,GAAG,KAAK,OAAO;GACf,GAAG;EACJ;EAEA,IAAI,CAAC,YAAY,MAChB,MAAM,IAAI,MACT,6DACD;EAGD,IAAI,CAAC,YAAY,QAAQ,CAAC,YAAY,MACrC,MAAM,IAAI,MAAM,8CAA8C;EAG/D,MAAM,OAAO,MAAM,KAAK,YAAY,SAAS,WAAW;EAExD,OAAO;GACN,WAAW,KAAK;GAChB,UAAU,KAAK,YAAY,CAAC;GAC5B,UAAU,KAAK,YAAY,CAAC;GAC5B,UAAU,KAAK;EAChB;CACD;CAEA,MAAM,aACL,UACA,SAGsB;EACtB,MAAM,YAAY,KAAK,OAAO,UAAU;EACxC,IAAI,CAAC,WACJ,MAAM,IAAI,MAAM,aAAa,OAAO,QAAQ,EAAE,YAAY;EAG3D,MAAM,UAAU,UAAU,QAAQ,KAAK;EACvC,MAAM,OAAO,OAAA,GAAMA,wBAAAA,OAAAA,CAAO,OAAO;EAEjC,OAAO,UACN;GACC,kBAAkB,OAAO,QAAQ;GACjC,oBAAoB,WAAW,OAAO;EACvC,SACM,KAAK,QAAQ;GAAE,GAAG;GAAS;EAAK,CAAC,CACxC;CACD;CAEA,MAAM,SAA2B;EAChC,IAAI;GACH,MAAM,KAAK,YAAY,OAAO;GAC9B,OAAO;EACR,QAAQ;GACP,OAAO;EACR;CACD;CAEA,MAAM,QAAuB;EAC5B,KAAK,YAAY,MAAM;CACxB;CAEA,mBAAuC;EACtC,OAAO,OAAO,KAAK,KAAK,OAAO,SAAS;CACzC;AACD;AAEA,SAAgB,kBACf,QACgB;CAChB,OAAO,IAAI,WAAW,MAAM;AAC7B;;AAGA,SAAS,WAAW,SAIT;CACV,OAAO,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,GAAG;AACjE;AAEA,SAAS,MAAM,OAAwB;CACtC,IAAI,CAAC,OAAO,OAAO;CACnB,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,SAAS;AAC9C;AAEA,eAAe,UACd,YACA,MACsB;CACtB,MAAM,OAAOC,mBAAAA,MAAM,UAAU,qBAAqB,CAAC,CAAC,UAAU,cAAc;EAC3E,MAAMC,mBAAAA,SAAS;EACf,YAAY;GAAE,mBAAmB;GAAQ,GAAG;EAAW;CACxD,CAAC;CACD,IAAI;EACH,MAAM,SAAS,MAAM,KAAK;EAE1B,IAAI,OAAO,SAAS,UAAU,OAAO,SAAS,QAC7C,KAAK,cAAc;GAClB,kBAAkB,MAAM,OAAO,QAAQ;GACvC,kBAAkB,MAAM,OAAO,QAAQ;EACxC,CAAC;EAEF,OAAO;CACR,SAAS,OAAO;EACf,IAAI,iBAAiB,OAAO,KAAK,gBAAgB,KAAK;EACtD,KAAK,UAAU,EAAE,MAAMC,mBAAAA,eAAe,MAAM,CAAC;EAC7C,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD"}

package/dist/client.d.cts

@@ -4,7 +4,13 @@ export declare class SMTPClient<T extends TemplateRecord> implements EmailClient
   private transporter;
   private config;
   constructor(config: EmailClientConfig<T>);
+  /**
+   * Send one message. An `email.send` span covers it, through the global
+   * OpenTelemetry tracer: the transport and how many were accepted or
+   * rejected, never an address, subject or body.
+   */
   send(options: SendOptions): Promise<SendResult>;
+  private deliver;
   sendTemplate<K extends TemplateNames<T>>(template: K, options: Omit<SendOptions, 'template'> & {
     props: TemplatePropsFor<T, K>;
   }): Promise<SendResult>;

package/dist/client.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.cts","names":[],"sources":["../src/client.ts"],"mappings":";;qBAYa,WAAW,UAAU,2BAA2B,YAAY;UAChE;UACA;EAEI,YAAA,QAAQ,kBAAkB;EAKhC,KAAK,SAAS,cAAc,QAAQ;EA0BpC,aAAa,UAAU,cAAc,IAC1C,UAAU,GACV,SAAS,KAAK;IACb,OAAO,iBAAiB,GAAG;MAE1B,QAAQ;EAeL,UAAU;EASV,SAAS;EAIf,oBAAoB,cAAc;;wBAKnB,kBAAkB,UAAU,gBAC3C,QAAQ,kBAAkB,KACxB,WAAW"}
+{"version":3,"file":"client.d.cts","names":[],"sources":["../src/client.ts"],"mappings":";;qBAkBa,WAAW,UAAU,2BAA2B,YAAY;UAChE;UACA;EAER,YAAY,QAAQ,kBAAkB;;;;;;EAUhC,KAAK,SAAS,cAAc,QAAQ;UAM5B;EA0BR,aAAa,UAAU,cAAc,IAC1C,UAAU,GACV,SAAS,KAAK;IACb,OAAO,iBAAiB,GAAG;MAE1B,QAAQ;EAkBL,UAAU;EASV,SAAS;EAIf,oBAAoB,cAAc;;wBAKnB,kBAAkB,UAAU,gBAC3C,QAAQ,kBAAkB,KACxB,WAAW"}

package/dist/client.d.mts

@@ -4,7 +4,13 @@ export declare class SMTPClient<T extends TemplateRecord> implements EmailClient
   private transporter;
   private config;
   constructor(config: EmailClientConfig<T>);
+  /**
+   * Send one message. An `email.send` span covers it, through the global
+   * OpenTelemetry tracer: the transport and how many were accepted or
+   * rejected, never an address, subject or body.
+   */
   send(options: SendOptions): Promise<SendResult>;
+  private deliver;
   sendTemplate<K extends TemplateNames<T>>(template: K, options: Omit<SendOptions, 'template'> & {
     props: TemplatePropsFor<T, K>;
   }): Promise<SendResult>;

package/dist/client.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;qBAYa,WAAW,UAAU,2BAA2B,YAAY;UAChE;UACA;EAEI,YAAA,QAAQ,kBAAkB;EAKhC,KAAK,SAAS,cAAc,QAAQ;EA0BpC,aAAa,UAAU,cAAc,IAC1C,UAAU,GACV,SAAS,KAAK;IACb,OAAO,iBAAiB,GAAG;MAE1B,QAAQ;EAeL,UAAU;EASV,SAAS;EAIf,oBAAoB,cAAc;;wBAKnB,kBAAkB,UAAU,gBAC3C,QAAQ,kBAAkB,KACxB,WAAW"}
+{"version":3,"file":"client.d.mts","names":[],"sources":["../src/client.ts"],"mappings":";;qBAkBa,WAAW,UAAU,2BAA2B,YAAY;UAChE;UACA;EAER,YAAY,QAAQ,kBAAkB;;;;;;EAUhC,KAAK,SAAS,cAAc,QAAQ;UAM5B;EA0BR,aAAa,UAAU,cAAc,IAC1C,UAAU,GACV,SAAS,KAAK;IACb,OAAO,iBAAiB,GAAG;MAE1B,QAAQ;EAkBL,UAAU;EASV,SAAS;EAIf,oBAAoB,cAAc;;wBAKnB,kBAAkB,UAAU,gBAC3C,QAAQ,kBAAkB,KACxB,WAAW"}

package/dist/client.mjs

@@ -1,3 +1,4 @@
+import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 import { render } from "@react-email/components";
 import nodemailer from "nodemailer";
 //#region src/client.ts
@@ -8,7 +9,15 @@ var SMTPClient = class {
 		this.config = config;
 		this.transporter = nodemailer.createTransport(config.smtp);
 	}
+	/**
+	* Send one message. An `email.send` span covers it, through the global
+	* OpenTelemetry tracer: the transport and how many were accepted or
+	* rejected, never an address, subject or body.
+	*/
 	async send(options) {
+		return traceSend({ "email.recipients": recipients(options) }, () => this.deliver(options));
+	}
+	async deliver(options) {
 		const mailOptions = {
 			...this.config.defaults,
 			...options
@@ -28,10 +37,13 @@ var SMTPClient = class {
 		if (!Component) throw new Error(`Template "${String(template)}" not found`);
 		const element = Component(options.props);
 		const html = await render(element);
-		return this.send({
+		return traceSend({
+			"email.template": String(template),
+			"email.recipients": recipients(options)
+		}, () => this.deliver({
 			...options,
 			html
-		});
+		}));
 	}
 	async verify() {
 		try {
@@ -51,6 +63,37 @@ var SMTPClient = class {
 function createEmailClient(config) {
 	return new SMTPClient(config);
 }
+/** How many addresses a message is for: to, cc and bcc. */
+function recipients(options) {
+	return count(options.to) + count(options.cc) + count(options.bcc);
+}
+function count(value) {
+	if (!value) return 0;
+	return Array.isArray(value) ? value.length : 1;
+}
+async function traceSend(attributes, send) {
+	const span = trace.getTracer("@geekmidas/emailkit").startSpan("email.send", {
+		kind: SpanKind.CLIENT,
+		attributes: {
+			"email.transport": "smtp",
+			...attributes
+		}
+	});
+	try {
+		const result = await send();
+		if (result.accepted.length || result.rejected.length) span.setAttributes({
+			"email.accepted": count(result.accepted),
+			"email.rejected": count(result.rejected)
+		});
+		return result;
+	} catch (error) {
+		if (error instanceof Error) span.recordException(error);
+		span.setStatus({ code: SpanStatusCode.ERROR });
+		throw error;
+	} finally {
+		span.end();
+	}
+}
 //#endregion
 export { SMTPClient, createEmailClient };
 

package/dist/client.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import { render } from '@react-email/components';\nimport nodemailer, { type Transporter } from 'nodemailer';\nimport type {\n\tEmailClient,\n\tEmailClientConfig,\n\tSendOptions,\n\tSendResult,\n\tTemplateNames,\n\tTemplatePropsFor,\n\tTemplateRecord,\n} from './types';\n\nexport class SMTPClient<T extends TemplateRecord> implements EmailClient<T> {\n\tprivate transporter: Transporter;\n\tprivate config: EmailClientConfig<T>;\n\n\tconstructor(config: EmailClientConfig<T>) {\n\t\tthis.config = config;\n\t\tthis.transporter = nodemailer.createTransport(config.smtp as any);\n\t}\n\n\tasync send(options: SendOptions): Promise<SendResult> {\n\t\tconst mailOptions = {\n\t\t\t...this.config.defaults,\n\t\t\t...options,\n\t\t};\n\n\t\tif (!mailOptions.from) {\n\t\t\tthrow new Error(\n\t\t\t\t'The \"from\" field is required in email options or defaults',\n\t\t\t);\n\t\t}\n\n\t\tif (!mailOptions.text && !mailOptions.html) {\n\t\t\tthrow new Error('Either text or html content must be provided');\n\t\t}\n\n\t\tconst info = await this.transporter.sendMail(mailOptions);\n\n\t\treturn {\n\t\t\tmessageId: info.messageId,\n\t\t\taccepted: info.accepted || [],\n\t\t\trejected: info.rejected || [],\n\t\t\tresponse: info.response,\n\t\t};\n\t}\n\n\tasync sendTemplate<K extends TemplateNames<T>>(\n\t\ttemplate: K,\n\t\toptions: Omit<SendOptions, 'template'> & {\n\t\t\tprops: TemplatePropsFor<T, K>;\n\t\t},\n\t): Promise<SendResult> {\n\t\tconst Component = this.config.templates[template];\n\t\tif (!Component) {\n\t\t\tthrow new Error(`Template \"${String(template)}\" not found`);\n\t\t}\n\n\t\tconst element = Component(options.props);\n\t\tconst html = await render(element);\n\n\t\treturn this.send({\n\t\t\t...options,\n\t\t\thtml,\n\t\t});\n\t}\n\n\tasync verify(): Promise<boolean> {\n\t\ttry {\n\t\t\tawait this.transporter.verify();\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.transporter.close();\n\t}\n\n\tgetTemplateNames(): TemplateNames<T>[] {\n\t\treturn Object.keys(this.config.templates) as TemplateNames<T>[];\n\t}\n}\n\nexport function createEmailClient<T extends TemplateRecord>(\n\tconfig: EmailClientConfig<T>,\n): SMTPClient<T> {\n\treturn new SMTPClient(config);\n}\n"],"mappings":";;;AAYA,IAAa,aAAb,MAA4E;CAC3E;CACA;CAEA,YAAY,QAA8B;EACzC,KAAK,SAAS;EACd,KAAK,cAAc,WAAW,gBAAgB,OAAO,IAAW;CACjE;CAEA,MAAM,KAAK,SAA2C;EACrD,MAAM,cAAc;GACnB,GAAG,KAAK,OAAO;GACf,GAAG;EACJ;EAEA,IAAI,CAAC,YAAY,MAChB,MAAM,IAAI,MACT,6DACD;EAGD,IAAI,CAAC,YAAY,QAAQ,CAAC,YAAY,MACrC,MAAM,IAAI,MAAM,8CAA8C;EAG/D,MAAM,OAAO,MAAM,KAAK,YAAY,SAAS,WAAW;EAExD,OAAO;GACN,WAAW,KAAK;GAChB,UAAU,KAAK,YAAY,CAAC;GAC5B,UAAU,KAAK,YAAY,CAAC;GAC5B,UAAU,KAAK;EAChB;CACD;CAEA,MAAM,aACL,UACA,SAGsB;EACtB,MAAM,YAAY,KAAK,OAAO,UAAU;EACxC,IAAI,CAAC,WACJ,MAAM,IAAI,MAAM,aAAa,OAAO,QAAQ,EAAE,YAAY;EAG3D,MAAM,UAAU,UAAU,QAAQ,KAAK;EACvC,MAAM,OAAO,MAAM,OAAO,OAAO;EAEjC,OAAO,KAAK,KAAK;GAChB,GAAG;GACH;EACD,CAAC;CACF;CAEA,MAAM,SAA2B;EAChC,IAAI;GACH,MAAM,KAAK,YAAY,OAAO;GAC9B,OAAO;EACR,QAAQ;GACP,OAAO;EACR;CACD;CAEA,MAAM,QAAuB;EAC5B,KAAK,YAAY,MAAM;CACxB;CAEA,mBAAuC;EACtC,OAAO,OAAO,KAAK,KAAK,OAAO,SAAS;CACzC;AACD;AAEA,SAAgB,kBACf,QACgB;CAChB,OAAO,IAAI,WAAW,MAAM;AAC7B"}
+{"version":3,"file":"client.mjs","names":[],"sources":["../src/client.ts"],"sourcesContent":["import {\n\ttype Attributes,\n\tSpanKind,\n\tSpanStatusCode,\n\ttrace,\n} from '@opentelemetry/api';\nimport { render } from '@react-email/components';\nimport nodemailer, { type Transporter } from 'nodemailer';\nimport type {\n\tEmailClient,\n\tEmailClientConfig,\n\tSendOptions,\n\tSendResult,\n\tTemplateNames,\n\tTemplatePropsFor,\n\tTemplateRecord,\n} from './types';\n\nexport class SMTPClient<T extends TemplateRecord> implements EmailClient<T> {\n\tprivate transporter: Transporter;\n\tprivate config: EmailClientConfig<T>;\n\n\tconstructor(config: EmailClientConfig<T>) {\n\t\tthis.config = config;\n\t\tthis.transporter = nodemailer.createTransport(config.smtp as any);\n\t}\n\n\t/**\n\t * Send one message. An `email.send` span covers it, through the global\n\t * OpenTelemetry tracer: the transport and how many were accepted or\n\t * rejected, never an address, subject or body.\n\t */\n\tasync send(options: SendOptions): Promise<SendResult> {\n\t\treturn traceSend({ 'email.recipients': recipients(options) }, () =>\n\t\t\tthis.deliver(options),\n\t\t);\n\t}\n\n\tprivate async deliver(options: SendOptions): Promise<SendResult> {\n\t\tconst mailOptions = {\n\t\t\t...this.config.defaults,\n\t\t\t...options,\n\t\t};\n\n\t\tif (!mailOptions.from) {\n\t\t\tthrow new Error(\n\t\t\t\t'The \"from\" field is required in email options or defaults',\n\t\t\t);\n\t\t}\n\n\t\tif (!mailOptions.text && !mailOptions.html) {\n\t\t\tthrow new Error('Either text or html content must be provided');\n\t\t}\n\n\t\tconst info = await this.transporter.sendMail(mailOptions);\n\n\t\treturn {\n\t\t\tmessageId: info.messageId,\n\t\t\taccepted: info.accepted || [],\n\t\t\trejected: info.rejected || [],\n\t\t\tresponse: info.response,\n\t\t};\n\t}\n\n\tasync sendTemplate<K extends TemplateNames<T>>(\n\t\ttemplate: K,\n\t\toptions: Omit<SendOptions, 'template'> & {\n\t\t\tprops: TemplatePropsFor<T, K>;\n\t\t},\n\t): Promise<SendResult> {\n\t\tconst Component = this.config.templates[template];\n\t\tif (!Component) {\n\t\t\tthrow new Error(`Template \"${String(template)}\" not found`);\n\t\t}\n\n\t\tconst element = Component(options.props);\n\t\tconst html = await render(element);\n\n\t\treturn traceSend(\n\t\t\t{\n\t\t\t\t'email.template': String(template),\n\t\t\t\t'email.recipients': recipients(options),\n\t\t\t},\n\t\t\t() => this.deliver({ ...options, html }),\n\t\t);\n\t}\n\n\tasync verify(): Promise<boolean> {\n\t\ttry {\n\t\t\tawait this.transporter.verify();\n\t\t\treturn true;\n\t\t} catch {\n\t\t\treturn false;\n\t\t}\n\t}\n\n\tasync close(): Promise<void> {\n\t\tthis.transporter.close();\n\t}\n\n\tgetTemplateNames(): TemplateNames<T>[] {\n\t\treturn Object.keys(this.config.templates) as TemplateNames<T>[];\n\t}\n}\n\nexport function createEmailClient<T extends TemplateRecord>(\n\tconfig: EmailClientConfig<T>,\n): SMTPClient<T> {\n\treturn new SMTPClient(config);\n}\n\n/** How many addresses a message is for: to, cc and bcc. */\nfunction recipients(options: {\n\tto?: unknown;\n\tcc?: unknown;\n\tbcc?: unknown;\n}): number {\n\treturn count(options.to) + count(options.cc) + count(options.bcc);\n}\n\nfunction count(value: unknown): number {\n\tif (!value) return 0;\n\treturn Array.isArray(value) ? value.length : 1;\n}\n\nasync function traceSend(\n\tattributes: Attributes,\n\tsend: () => Promise<SendResult>,\n): Promise<SendResult> {\n\tconst span = trace.getTracer('@geekmidas/emailkit').startSpan('email.send', {\n\t\tkind: SpanKind.CLIENT,\n\t\tattributes: { 'email.transport': 'smtp', ...attributes },\n\t});\n\ttry {\n\t\tconst result = await send();\n\t\t// What the server said, when the transport reports it.\n\t\tif (result.accepted.length || result.rejected.length) {\n\t\t\tspan.setAttributes({\n\t\t\t\t'email.accepted': count(result.accepted),\n\t\t\t\t'email.rejected': count(result.rejected),\n\t\t\t});\n\t\t}\n\t\treturn result;\n\t} catch (error) {\n\t\tif (error instanceof Error) span.recordException(error);\n\t\tspan.setStatus({ code: SpanStatusCode.ERROR });\n\t\tthrow error;\n\t} finally {\n\t\tspan.end();\n\t}\n}\n"],"mappings":";;;;AAkBA,IAAa,aAAb,MAA4E;CAC3E;CACA;CAEA,YAAY,QAA8B;EACzC,KAAK,SAAS;EACd,KAAK,cAAc,WAAW,gBAAgB,OAAO,IAAW;CACjE;;;;;;CAOA,MAAM,KAAK,SAA2C;EACrD,OAAO,UAAU,EAAE,oBAAoB,WAAW,OAAO,EAAE,SAC1D,KAAK,QAAQ,OAAO,CACrB;CACD;CAEA,MAAc,QAAQ,SAA2C;EAChE,MAAM,cAAc;GACnB,GAAG,KAAK,OAAO;GACf,GAAG;EACJ;EAEA,IAAI,CAAC,YAAY,MAChB,MAAM,IAAI,MACT,6DACD;EAGD,IAAI,CAAC,YAAY,QAAQ,CAAC,YAAY,MACrC,MAAM,IAAI,MAAM,8CAA8C;EAG/D,MAAM,OAAO,MAAM,KAAK,YAAY,SAAS,WAAW;EAExD,OAAO;GACN,WAAW,KAAK;GAChB,UAAU,KAAK,YAAY,CAAC;GAC5B,UAAU,KAAK,YAAY,CAAC;GAC5B,UAAU,KAAK;EAChB;CACD;CAEA,MAAM,aACL,UACA,SAGsB;EACtB,MAAM,YAAY,KAAK,OAAO,UAAU;EACxC,IAAI,CAAC,WACJ,MAAM,IAAI,MAAM,aAAa,OAAO,QAAQ,EAAE,YAAY;EAG3D,MAAM,UAAU,UAAU,QAAQ,KAAK;EACvC,MAAM,OAAO,MAAM,OAAO,OAAO;EAEjC,OAAO,UACN;GACC,kBAAkB,OAAO,QAAQ;GACjC,oBAAoB,WAAW,OAAO;EACvC,SACM,KAAK,QAAQ;GAAE,GAAG;GAAS;EAAK,CAAC,CACxC;CACD;CAEA,MAAM,SAA2B;EAChC,IAAI;GACH,MAAM,KAAK,YAAY,OAAO;GAC9B,OAAO;EACR,QAAQ;GACP,OAAO;EACR;CACD;CAEA,MAAM,QAAuB;EAC5B,KAAK,YAAY,MAAM;CACxB;CAEA,mBAAuC;EACtC,OAAO,OAAO,KAAK,KAAK,OAAO,SAAS;CACzC;AACD;AAEA,SAAgB,kBACf,QACgB;CAChB,OAAO,IAAI,WAAW,MAAM;AAC7B;;AAGA,SAAS,WAAW,SAIT;CACV,OAAO,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,EAAE,IAAI,MAAM,QAAQ,GAAG;AACjE;AAEA,SAAS,MAAM,OAAwB;CACtC,IAAI,CAAC,OAAO,OAAO;CACnB,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,SAAS;AAC9C;AAEA,eAAe,UACd,YACA,MACsB;CACtB,MAAM,OAAO,MAAM,UAAU,qBAAqB,CAAC,CAAC,UAAU,cAAc;EAC3E,MAAM,SAAS;EACf,YAAY;GAAE,mBAAmB;GAAQ,GAAG;EAAW;CACxD,CAAC;CACD,IAAI;EACH,MAAM,SAAS,MAAM,KAAK;EAE1B,IAAI,OAAO,SAAS,UAAU,OAAO,SAAS,QAC7C,KAAK,cAAc;GAClB,kBAAkB,MAAM,OAAO,QAAQ;GACvC,kBAAkB,MAAM,OAAO,QAAQ;EACxC,CAAC;EAEF,OAAO;CACR,SAAS,OAAO;EACf,IAAI,iBAAiB,OAAO,KAAK,gBAAgB,KAAK;EACtD,KAAK,UAAU,EAAE,MAAM,eAAe,MAAM,CAAC;EAC7C,MAAM;CACP,UAAU;EACT,KAAK,IAAI;CACV;AACD"}

package/dist/errors.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.cts","names":[],"sources":["../src/errors.ts"],"mappings":";;;;;;;;;;;;;;8BAcsB,sBAAsB;;WAElC;EAEG,YAAA,aAAa;;;qBAQb,0BAA0B;EAC1B,YAAA;;;;;;;;;qBAYA,+BAA+B;;WAElC;;WAEA;EAEG,YAAA,aAAa"}
+{"version":3,"file":"errors.d.cts","names":[],"sources":["../src/errors.ts"],"mappings":";;;;;;;;;;;;;;8BAcsB,sBAAsB;;WAElC;EAET,YAAY,aAAa;;;qBAQb,0BAA0B;EACtC,YAAY;;;;;;;;;qBAYA,+BAA+B;;WAElC;;WAEA;EAET,YAAY,aAAa"}

package/dist/errors.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.mts","names":[],"sources":["../src/errors.ts"],"mappings":";;;;;;;;;;;;;;8BAcsB,sBAAsB;;WAElC;EAEG,YAAA,aAAa;;;qBAQb,0BAA0B;EAC1B,YAAA;;;;;;;;;qBAYA,+BAA+B;;WAElC;;WAEA;EAEG,YAAA,aAAa"}
+{"version":3,"file":"errors.d.mts","names":[],"sources":["../src/errors.ts"],"mappings":";;;;;;;;;;;;;;8BAcsB,sBAAsB;;WAElC;EAET,YAAY,aAAa;;;qBAQb,0BAA0B;EACtC,YAAY;;;;;;;;;qBAYA,+BAA+B;;WAElC;;WAEA;EAET,YAAY,aAAa"}

package/dist/inbound.cjs

@@ -0,0 +1,130 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rolldown_runtime = require("./rolldown-runtime-VH7oDXx4.cjs");
+let nodemailer = require("nodemailer");
+let nodemailer_lib_mail_composer_index_js = require("nodemailer/lib/mail-composer/index.js");
+nodemailer_lib_mail_composer_index_js = require_rolldown_runtime.__toESM(nodemailer_lib_mail_composer_index_js, 1);
+let postal_mime = require("postal-mime");
+postal_mime = require_rolldown_runtime.__toESM(postal_mime, 1);
+//#region src/inbound.ts
+/**
+* Received mail: the one MIME parser everything that reads a message uses, and
+* the composer that builds one.
+*
+* An `Inbox`'s handler, the test mailbox's `receive` and the mailbox that
+* reads what an app sent all go through {@link parseEmail}, so an attachment
+* that survives one survives all of them. {@link composeEmail} builds a real
+* MIME message from fields — what a test hands an inbox when it does not
+* bring a `.eml` of its own.
+*/
+/** Parse a raw RFC 5322 message. */
+async function parseEmail(raw) {
+	const parsed = await postal_mime.default.parse(raw, { attachmentEncoding: "arraybuffer" });
+	const headers = {};
+	for (const { key, value } of parsed.headers) {
+		const name = key.toLowerCase();
+		headers[name] = [...headers[name] ?? [], value];
+	}
+	const from = parsed.from ? addresses([parsed.from])[0] : void 0;
+	return {
+		...from ? { from } : {},
+		to: addresses(parsed.to),
+		cc: addresses(parsed.cc),
+		replyTo: addresses(parsed.replyTo),
+		...parsed.subject !== void 0 ? { subject: parsed.subject } : {},
+		...parsed.date !== void 0 ? { date: parsed.date } : {},
+		...parsed.messageId ? { messageId: parsed.messageId } : {},
+		...parsed.inReplyTo ? { inReplyTo: parsed.inReplyTo } : {},
+		references: (parsed.references ?? "").split(/\s+/).filter(Boolean),
+		headers,
+		...parsed.text !== void 0 ? { text: parsed.text } : {},
+		...parsed.html !== void 0 ? { html: parsed.html } : {},
+		attachments: parsed.attachments.map(attachment)
+	};
+}
+/** Groups flattened into their members: a header's mailboxes, in order. */
+function addresses(list) {
+	const flat = [];
+	for (const entry of list ?? []) {
+		const members = entry.group ?? [entry];
+		for (const { name, address } of members) {
+			if (!address) continue;
+			flat.push({
+				...name ? { name } : {},
+				address
+			});
+		}
+	}
+	return flat;
+}
+function attachment(file) {
+	const bytes = typeof file.content === "string" ? new TextEncoder().encode(file.content) : file.content instanceof Uint8Array ? file.content : new Uint8Array(file.content);
+	return {
+		...file.filename ? { filename: file.filename } : {},
+		contentType: file.mimeType,
+		size: bytes.byteLength,
+		...file.disposition ? { disposition: file.disposition } : {},
+		...file.contentId ? { contentId: file.contentId } : {},
+		content: async () => bytes.slice()
+	};
+}
+/** A real MIME message from fields, as `parseEmail` reads one. */
+async function composeEmail(options) {
+	const list = (value) => value === void 0 ? void 0 : typeof value === "string" ? value : [...value];
+	const built = await new nodemailer_lib_mail_composer_index_js.default({
+		from: options.from,
+		...options.to !== void 0 ? { to: list(options.to) } : {},
+		...options.cc !== void 0 ? { cc: list(options.cc) } : {},
+		...options.replyTo ? { replyTo: options.replyTo } : {},
+		...options.subject !== void 0 ? { subject: options.subject } : {},
+		...options.text !== void 0 ? { text: options.text } : {},
+		...options.html !== void 0 ? { html: options.html } : {},
+		...options.messageId ? { messageId: options.messageId } : {},
+		...options.date ? { date: options.date } : {},
+		...options.headers ? { headers: { ...options.headers } } : {},
+		attachments: (options.attachments ?? []).map((file) => ({
+			filename: file.filename,
+			content: typeof file.content === "string" ? file.content : Buffer.from(file.content),
+			...file.contentType ? { contentType: file.contentType } : {}
+		}))
+	}).compile().build();
+	return new Uint8Array(built);
+}
+/** The receiving server's reply named no id for the message it accepted. */
+var DeliveryNotQueued = class extends Error {
+	response;
+	constructor(response) {
+		super("The mail server accepted the message but named no id for it ('queued as …'), so it cannot be read back. Mailpit names one; deliver to Mailpit.");
+		this.response = response;
+		this.name = "DeliveryNotQueued";
+	}
+};
+/**
+* Deliver a raw message over SMTP with an envelope of its own — what a
+* sender's server does, `RCPT TO` and all — and return the id the receiving
+* server queued it under: Mailpit's message id, which its API serves the raw
+* message by.
+*/
+async function deliverRaw(smtpUrl, envelope, raw) {
+	const transport = (0, nodemailer.createTransport)(smtpUrl);
+	try {
+		const info = await transport.sendMail({
+			envelope: {
+				from: envelope.from,
+				to: [...envelope.to]
+			},
+			raw: typeof raw === "string" ? raw : Buffer.from(raw)
+		});
+		const id = /queued as (\S+)/i.exec(String(info.response))?.[1];
+		if (!id) throw new DeliveryNotQueued(String(info.response));
+		return id;
+	} finally {
+		transport.close();
+	}
+}
+//#endregion
+exports.DeliveryNotQueued = DeliveryNotQueued;
+exports.composeEmail = composeEmail;
+exports.deliverRaw = deliverRaw;
+exports.parseEmail = parseEmail;
+
+//# sourceMappingURL=inbound.cjs.map

package/dist/inbound.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.cjs","names":["PostalMime","MailComposer","createTransport"],"sources":["../src/inbound.ts"],"sourcesContent":["/**\n * Received mail: the one MIME parser everything that reads a message uses, and\n * the composer that builds one.\n *\n * An `Inbox`'s handler, the test mailbox's `receive` and the mailbox that\n * reads what an app sent all go through {@link parseEmail}, so an attachment\n * that survives one survives all of them. {@link composeEmail} builds a real\n * MIME message from fields — what a test hands an inbox when it does not\n * bring a `.eml` of its own.\n */\n\nimport { createTransport } from 'nodemailer';\nimport MailComposer from 'nodemailer/lib/mail-composer/index.js';\nimport PostalMime, {\n\ttype Address,\n\ttype Attachment as PostalAttachment,\n} from 'postal-mime';\n\n/** A mailbox in a header: `\"Ada\" <ada@example.com>`. */\nexport interface EmailAddress {\n\t/** The display name, where the header gave one. */\n\tname?: string;\n\taddress: string;\n}\n\n/** A file in a message. */\nexport interface ReceivedAttachment {\n\t/**\n\t * As the sender named it — never a key or a path: it is theirs to choose,\n\t * `../../etc/passwd` included.\n\t */\n\tfilename?: string;\n\tcontentType: string;\n\t/** Bytes. */\n\tsize: number;\n\t/** `attachment`, or `inline` for one the HTML refers to by `contentId`. */\n\tdisposition?: string;\n\tcontentId?: string;\n\t/** Its bytes. */\n\tcontent(): Promise<Uint8Array>;\n}\n\n/** A message, parsed: its headers as the sender wrote them, its body, its files. */\nexport interface ParsedEmail {\n\tfrom?: EmailAddress;\n\tto: EmailAddress[];\n\tcc: EmailAddress[];\n\treplyTo: EmailAddress[];\n\tsubject?: string;\n\t/** `Date:`, as written. */\n\tdate?: string;\n\tmessageId?: string;\n\tinReplyTo?: string;\n\t/** `References:`, one message id each. */\n\treferences: string[];\n\t/** Every header, by lowercase name, each occurrence in order. */\n\theaders: Readonly<Record<string, readonly string[]>>;\n\ttext?: string;\n\thtml?: string;\n\tattachments: ReceivedAttachment[];\n}\n\n/** Parse a raw RFC 5322 message. */\nexport async function parseEmail(\n\traw: string | Uint8Array | ArrayBuffer,\n): Promise<ParsedEmail> {\n\tconst parsed = await PostalMime.parse(raw, {\n\t\tattachmentEncoding: 'arraybuffer',\n\t});\n\n\tconst headers: Record<string, string[]> = {};\n\tfor (const { key, value } of parsed.headers) {\n\t\tconst name = key.toLowerCase();\n\t\theaders[name] = [...(headers[name] ?? []), value];\n\t}\n\n\tconst from = parsed.from ? addresses([parsed.from])[0] : undefined;\n\treturn {\n\t\t...(from ? { from } : {}),\n\t\tto: addresses(parsed.to),\n\t\tcc: addresses(parsed.cc),\n\t\treplyTo: addresses(parsed.replyTo),\n\t\t...(parsed.subject !== undefined ? { subject: parsed.subject } : {}),\n\t\t...(parsed.date !== undefined ? { date: parsed.date } : {}),\n\t\t...(parsed.messageId ? { messageId: parsed.messageId } : {}),\n\t\t...(parsed.inReplyTo ? { inReplyTo: parsed.inReplyTo } : {}),\n\t\treferences: (parsed.references ?? '').split(/\\s+/).filter(Boolean),\n\t\theaders,\n\t\t...(parsed.text !== undefined ? { text: parsed.text } : {}),\n\t\t...(parsed.html !== undefined ? { html: parsed.html } : {}),\n\t\tattachments: parsed.attachments.map(attachment),\n\t};\n}\n\n/** Groups flattened into their members: a header's mailboxes, in order. */\nfunction addresses(list: readonly Address[] | undefined): EmailAddress[] {\n\tconst flat: EmailAddress[] = [];\n\tfor (const entry of list ?? []) {\n\t\tconst members = entry.group ?? [entry];\n\t\tfor (const { name, address } of members) {\n\t\t\tif (!address) continue;\n\t\t\tflat.push({ ...(name ? { name } : {}), address });\n\t\t}\n\t}\n\treturn flat;\n}\n\nfunction attachment(file: PostalAttachment): ReceivedAttachment {\n\tconst bytes =\n\t\ttypeof file.content === 'string'\n\t\t\t? new TextEncoder().encode(file.content)\n\t\t\t: file.content instanceof Uint8Array\n\t\t\t\t? file.content\n\t\t\t\t: new Uint8Array(file.content);\n\treturn {\n\t\t...(file.filename ? { filename: file.filename } : {}),\n\t\tcontentType: file.mimeType,\n\t\tsize: bytes.byteLength,\n\t\t...(file.disposition ? { disposition: file.disposition } : {}),\n\t\t...(file.contentId ? { contentId: file.contentId } : {}),\n\t\t// A copy each time: a handler that mutates what it was given must not\n\t\t// change what the next read sees.\n\t\tcontent: async () => bytes.slice(),\n\t};\n}\n\n/** A file to put in a composed message. */\nexport interface ComposedAttachment {\n\tfilename: string;\n\tcontent: string | Uint8Array;\n\tcontentType?: string;\n}\n\n/** The fields {@link composeEmail} builds a message from. */\nexport interface ComposeEmailOptions {\n\tfrom: string;\n\t/** `To:` as written — not where the message is delivered, which is the envelope's. */\n\tto?: string | readonly string[];\n\tcc?: string | readonly string[];\n\treplyTo?: string;\n\tsubject?: string;\n\ttext?: string;\n\thtml?: string;\n\tattachments?: readonly ComposedAttachment[];\n\t/** Any other header, as written: `Auto-Submitted`, `In-Reply-To`, `References`. */\n\theaders?: Readonly<Record<string, string>>;\n\tmessageId?: string;\n\tdate?: Date;\n}\n\n/** A real MIME message from fields, as `parseEmail` reads one. */\nexport async function composeEmail(\n\toptions: ComposeEmailOptions,\n): Promise<Uint8Array> {\n\tconst list = (value: string | readonly string[] | undefined) =>\n\t\tvalue === undefined\n\t\t\t? undefined\n\t\t\t: typeof value === 'string'\n\t\t\t\t? value\n\t\t\t\t: [...value];\n\tconst composer = new MailComposer({\n\t\tfrom: options.from,\n\t\t...(options.to !== undefined ? { to: list(options.to) } : {}),\n\t\t...(options.cc !== undefined ? { cc: list(options.cc) } : {}),\n\t\t...(options.replyTo ? { replyTo: options.replyTo } : {}),\n\t\t...(options.subject !== undefined ? { subject: options.subject } : {}),\n\t\t...(options.text !== undefined ? { text: options.text } : {}),\n\t\t...(options.html !== undefined ? { html: options.html } : {}),\n\t\t...(options.messageId ? { messageId: options.messageId } : {}),\n\t\t...(options.date ? { date: options.date } : {}),\n\t\t...(options.headers ? { headers: { ...options.headers } } : {}),\n\t\tattachments: (options.attachments ?? []).map((file) => ({\n\t\t\tfilename: file.filename,\n\t\t\tcontent:\n\t\t\t\ttypeof file.content === 'string'\n\t\t\t\t\t? file.content\n\t\t\t\t\t: Buffer.from(file.content),\n\t\t\t...(file.contentType ? { contentType: file.contentType } : {}),\n\t\t})),\n\t});\n\tconst built = await composer.compile().build();\n\treturn new Uint8Array(built);\n}\n\n/** The receiving server's reply named no id for the message it accepted. */\nexport class DeliveryNotQueued extends Error {\n\tconstructor(readonly response: string) {\n\t\tsuper(\n\t\t\t`The mail server accepted the message but named no id for it ` +\n\t\t\t\t`('queued as …'), so it cannot be read back. Mailpit names one; ` +\n\t\t\t\t`deliver to Mailpit.`,\n\t\t);\n\t\tthis.name = 'DeliveryNotQueued';\n\t}\n}\n\n/**\n * Deliver a raw message over SMTP with an envelope of its own — what a\n * sender's server does, `RCPT TO` and all — and return the id the receiving\n * server queued it under: Mailpit's message id, which its API serves the raw\n * message by.\n */\nexport async function deliverRaw(\n\tsmtpUrl: string,\n\tenvelope: { from: string; to: readonly string[] },\n\traw: Uint8Array | string,\n): Promise<string> {\n\tconst transport = createTransport(smtpUrl);\n\ttry {\n\t\tconst info = await transport.sendMail({\n\t\t\tenvelope: { from: envelope.from, to: [...envelope.to] },\n\t\t\traw: typeof raw === 'string' ? raw : Buffer.from(raw),\n\t\t});\n\t\tconst id = /queued as (\\S+)/i.exec(String(info.response))?.[1];\n\t\tif (!id) throw new DeliveryNotQueued(String(info.response));\n\t\treturn id;\n\t} finally {\n\t\ttransport.close();\n\t}\n}\n"],"mappings":"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"}

package/dist/inbound.d.cts

@@ -0,0 +1,95 @@
+//#region src/inbound.d.ts
+/**
+ * Received mail: the one MIME parser everything that reads a message uses, and
+ * the composer that builds one.
+ *
+ * An `Inbox`'s handler, the test mailbox's `receive` and the mailbox that
+ * reads what an app sent all go through {@link parseEmail}, so an attachment
+ * that survives one survives all of them. {@link composeEmail} builds a real
+ * MIME message from fields — what a test hands an inbox when it does not
+ * bring a `.eml` of its own.
+ */
+/** A mailbox in a header: `"Ada" <ada@example.com>`. */
+export interface EmailAddress {
+  /** The display name, where the header gave one. */
+  name?: string;
+  address: string;
+}
+/** A file in a message. */
+export interface ReceivedAttachment {
+  /**
+   * As the sender named it — never a key or a path: it is theirs to choose,
+   * `../../etc/passwd` included.
+   */
+  filename?: string;
+  contentType: string;
+  /** Bytes. */
+  size: number;
+  /** `attachment`, or `inline` for one the HTML refers to by `contentId`. */
+  disposition?: string;
+  contentId?: string;
+  /** Its bytes. */
+  content(): Promise<Uint8Array>;
+}
+/** A message, parsed: its headers as the sender wrote them, its body, its files. */
+export interface ParsedEmail {
+  from?: EmailAddress;
+  to: EmailAddress[];
+  cc: EmailAddress[];
+  replyTo: EmailAddress[];
+  subject?: string;
+  /** `Date:`, as written. */
+  date?: string;
+  messageId?: string;
+  inReplyTo?: string;
+  /** `References:`, one message id each. */
+  references: string[];
+  /** Every header, by lowercase name, each occurrence in order. */
+  headers: Readonly<Record<string, readonly string[]>>;
+  text?: string;
+  html?: string;
+  attachments: ReceivedAttachment[];
+}
+/** Parse a raw RFC 5322 message. */
+export declare function parseEmail(raw: string | Uint8Array | ArrayBuffer): Promise<ParsedEmail>;
+/** A file to put in a composed message. */
+export interface ComposedAttachment {
+  filename: string;
+  content: string | Uint8Array;
+  contentType?: string;
+}
+/** The fields {@link composeEmail} builds a message from. */
+export interface ComposeEmailOptions {
+  from: string;
+  /** `To:` as written — not where the message is delivered, which is the envelope's. */
+  to?: string | readonly string[];
+  cc?: string | readonly string[];
+  replyTo?: string;
+  subject?: string;
+  text?: string;
+  html?: string;
+  attachments?: readonly ComposedAttachment[];
+  /** Any other header, as written: `Auto-Submitted`, `In-Reply-To`, `References`. */
+  headers?: Readonly<Record<string, string>>;
+  messageId?: string;
+  date?: Date;
+}
+/** A real MIME message from fields, as `parseEmail` reads one. */
+export declare function composeEmail(options: ComposeEmailOptions): Promise<Uint8Array>;
+/** The receiving server's reply named no id for the message it accepted. */
+export declare class DeliveryNotQueued extends Error {
+  readonly response: string;
+  constructor(response: string);
+}
+/**
+ * Deliver a raw message over SMTP with an envelope of its own — what a
+ * sender's server does, `RCPT TO` and all — and return the id the receiving
+ * server queued it under: Mailpit's message id, which its API serves the raw
+ * message by.
+ */
+export declare function deliverRaw(smtpUrl: string, envelope: {
+  from: string;
+  to: readonly string[];
+}, raw: Uint8Array | string): Promise<string>;
+//#endregion
+//# sourceMappingURL=inbound.d.cts.map

package/dist/inbound.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.cts","names":[],"sources":["../src/inbound.ts"],"mappings":";;;;;;;;;;;;iBAmBiB;;EAEhB;EACA;;;iBAIgB;;;;;EAKhB;EACA;;EAEA;;EAEA;EACA;;EAEA,WAAW,QAAQ;;;iBAIH;EAChB,OAAO;EACP,IAAI;EACJ,IAAI;EACJ,SAAS;EACT;;EAEA;EACA;EACA;;EAEA;;EAEA,SAAS,SAAS;EAClB;EACA;EACA,aAAa;;;wBAIQ,WACrB,cAAc,aAAa,cACzB,QAAQ;;iBA8DM;EAChB;EACA,kBAAkB;EAClB;;;iBAIgB;EAChB;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA,uBAAuB;;EAEvB,UAAU,SAAS;EACnB;EACA,OAAO;;;wBAIc,aACrB,SAAS,sBACP,QAAQ;;qBAgCE,0BAA0B;WACjB;EAArB,YAAqB;;;;;;;;wBAgBA,WACrB,iBACA;EAAY;EAAc;GAC1B,KAAK,sBACH"}

package/dist/inbound.d.mts

@@ -0,0 +1,95 @@
+//#region src/inbound.d.ts
+/**
+ * Received mail: the one MIME parser everything that reads a message uses, and
+ * the composer that builds one.
+ *
+ * An `Inbox`'s handler, the test mailbox's `receive` and the mailbox that
+ * reads what an app sent all go through {@link parseEmail}, so an attachment
+ * that survives one survives all of them. {@link composeEmail} builds a real
+ * MIME message from fields — what a test hands an inbox when it does not
+ * bring a `.eml` of its own.
+ */
+/** A mailbox in a header: `"Ada" <ada@example.com>`. */
+export interface EmailAddress {
+  /** The display name, where the header gave one. */
+  name?: string;
+  address: string;
+}
+/** A file in a message. */
+export interface ReceivedAttachment {
+  /**
+   * As the sender named it — never a key or a path: it is theirs to choose,
+   * `../../etc/passwd` included.
+   */
+  filename?: string;
+  contentType: string;
+  /** Bytes. */
+  size: number;
+  /** `attachment`, or `inline` for one the HTML refers to by `contentId`. */
+  disposition?: string;
+  contentId?: string;
+  /** Its bytes. */
+  content(): Promise<Uint8Array>;
+}
+/** A message, parsed: its headers as the sender wrote them, its body, its files. */
+export interface ParsedEmail {
+  from?: EmailAddress;
+  to: EmailAddress[];
+  cc: EmailAddress[];
+  replyTo: EmailAddress[];
+  subject?: string;
+  /** `Date:`, as written. */
+  date?: string;
+  messageId?: string;
+  inReplyTo?: string;
+  /** `References:`, one message id each. */
+  references: string[];
+  /** Every header, by lowercase name, each occurrence in order. */
+  headers: Readonly<Record<string, readonly string[]>>;
+  text?: string;
+  html?: string;
+  attachments: ReceivedAttachment[];
+}
+/** Parse a raw RFC 5322 message. */
+export declare function parseEmail(raw: string | Uint8Array | ArrayBuffer): Promise<ParsedEmail>;
+/** A file to put in a composed message. */
+export interface ComposedAttachment {
+  filename: string;
+  content: string | Uint8Array;
+  contentType?: string;
+}
+/** The fields {@link composeEmail} builds a message from. */
+export interface ComposeEmailOptions {
+  from: string;
+  /** `To:` as written — not where the message is delivered, which is the envelope's. */
+  to?: string | readonly string[];
+  cc?: string | readonly string[];
+  replyTo?: string;
+  subject?: string;
+  text?: string;
+  html?: string;
+  attachments?: readonly ComposedAttachment[];
+  /** Any other header, as written: `Auto-Submitted`, `In-Reply-To`, `References`. */
+  headers?: Readonly<Record<string, string>>;
+  messageId?: string;
+  date?: Date;
+}
+/** A real MIME message from fields, as `parseEmail` reads one. */
+export declare function composeEmail(options: ComposeEmailOptions): Promise<Uint8Array>;
+/** The receiving server's reply named no id for the message it accepted. */
+export declare class DeliveryNotQueued extends Error {
+  readonly response: string;
+  constructor(response: string);
+}
+/**
+ * Deliver a raw message over SMTP with an envelope of its own — what a
+ * sender's server does, `RCPT TO` and all — and return the id the receiving
+ * server queued it under: Mailpit's message id, which its API serves the raw
+ * message by.
+ */
+export declare function deliverRaw(smtpUrl: string, envelope: {
+  from: string;
+  to: readonly string[];
+}, raw: Uint8Array | string): Promise<string>;
+//#endregion
+//# sourceMappingURL=inbound.d.mts.map

package/dist/inbound.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.d.mts","names":[],"sources":["../src/inbound.ts"],"mappings":";;;;;;;;;;;;iBAmBiB;;EAEhB;EACA;;;iBAIgB;;;;;EAKhB;EACA;;EAEA;;EAEA;EACA;;EAEA,WAAW,QAAQ;;;iBAIH;EAChB,OAAO;EACP,IAAI;EACJ,IAAI;EACJ,SAAS;EACT;;EAEA;EACA;EACA;;EAEA;;EAEA,SAAS,SAAS;EAClB;EACA;EACA,aAAa;;;wBAIQ,WACrB,cAAc,aAAa,cACzB,QAAQ;;iBA8DM;EAChB;EACA,kBAAkB;EAClB;;;iBAIgB;EAChB;;EAEA;EACA;EACA;EACA;EACA;EACA;EACA,uBAAuB;;EAEvB,UAAU,SAAS;EACnB;EACA,OAAO;;;wBAIc,aACrB,SAAS,sBACP,QAAQ;;qBAgCE,0BAA0B;WACjB;EAArB,YAAqB;;;;;;;;wBAgBA,WACrB,iBACA;EAAY;EAAc;GAC1B,KAAK,sBACH"}

package/dist/inbound.mjs

@@ -0,0 +1,123 @@
+import { createTransport } from "nodemailer";
+import MailComposer from "nodemailer/lib/mail-composer/index.js";
+import PostalMime from "postal-mime";
+//#region src/inbound.ts
+/**
+* Received mail: the one MIME parser everything that reads a message uses, and
+* the composer that builds one.
+*
+* An `Inbox`'s handler, the test mailbox's `receive` and the mailbox that
+* reads what an app sent all go through {@link parseEmail}, so an attachment
+* that survives one survives all of them. {@link composeEmail} builds a real
+* MIME message from fields — what a test hands an inbox when it does not
+* bring a `.eml` of its own.
+*/
+/** Parse a raw RFC 5322 message. */
+async function parseEmail(raw) {
+	const parsed = await PostalMime.parse(raw, { attachmentEncoding: "arraybuffer" });
+	const headers = {};
+	for (const { key, value } of parsed.headers) {
+		const name = key.toLowerCase();
+		headers[name] = [...headers[name] ?? [], value];
+	}
+	const from = parsed.from ? addresses([parsed.from])[0] : void 0;
+	return {
+		...from ? { from } : {},
+		to: addresses(parsed.to),
+		cc: addresses(parsed.cc),
+		replyTo: addresses(parsed.replyTo),
+		...parsed.subject !== void 0 ? { subject: parsed.subject } : {},
+		...parsed.date !== void 0 ? { date: parsed.date } : {},
+		...parsed.messageId ? { messageId: parsed.messageId } : {},
+		...parsed.inReplyTo ? { inReplyTo: parsed.inReplyTo } : {},
+		references: (parsed.references ?? "").split(/\s+/).filter(Boolean),
+		headers,
+		...parsed.text !== void 0 ? { text: parsed.text } : {},
+		...parsed.html !== void 0 ? { html: parsed.html } : {},
+		attachments: parsed.attachments.map(attachment)
+	};
+}
+/** Groups flattened into their members: a header's mailboxes, in order. */
+function addresses(list) {
+	const flat = [];
+	for (const entry of list ?? []) {
+		const members = entry.group ?? [entry];
+		for (const { name, address } of members) {
+			if (!address) continue;
+			flat.push({
+				...name ? { name } : {},
+				address
+			});
+		}
+	}
+	return flat;
+}
+function attachment(file) {
+	const bytes = typeof file.content === "string" ? new TextEncoder().encode(file.content) : file.content instanceof Uint8Array ? file.content : new Uint8Array(file.content);
+	return {
+		...file.filename ? { filename: file.filename } : {},
+		contentType: file.mimeType,
+		size: bytes.byteLength,
+		...file.disposition ? { disposition: file.disposition } : {},
+		...file.contentId ? { contentId: file.contentId } : {},
+		content: async () => bytes.slice()
+	};
+}
+/** A real MIME message from fields, as `parseEmail` reads one. */
+async function composeEmail(options) {
+	const list = (value) => value === void 0 ? void 0 : typeof value === "string" ? value : [...value];
+	const built = await new MailComposer({
+		from: options.from,
+		...options.to !== void 0 ? { to: list(options.to) } : {},
+		...options.cc !== void 0 ? { cc: list(options.cc) } : {},
+		...options.replyTo ? { replyTo: options.replyTo } : {},
+		...options.subject !== void 0 ? { subject: options.subject } : {},
+		...options.text !== void 0 ? { text: options.text } : {},
+		...options.html !== void 0 ? { html: options.html } : {},
+		...options.messageId ? { messageId: options.messageId } : {},
+		...options.date ? { date: options.date } : {},
+		...options.headers ? { headers: { ...options.headers } } : {},
+		attachments: (options.attachments ?? []).map((file) => ({
+			filename: file.filename,
+			content: typeof file.content === "string" ? file.content : Buffer.from(file.content),
+			...file.contentType ? { contentType: file.contentType } : {}
+		}))
+	}).compile().build();
+	return new Uint8Array(built);
+}
+/** The receiving server's reply named no id for the message it accepted. */
+var DeliveryNotQueued = class extends Error {
+	response;
+	constructor(response) {
+		super("The mail server accepted the message but named no id for it ('queued as …'), so it cannot be read back. Mailpit names one; deliver to Mailpit.");
+		this.response = response;
+		this.name = "DeliveryNotQueued";
+	}
+};
+/**
+* Deliver a raw message over SMTP with an envelope of its own — what a
+* sender's server does, `RCPT TO` and all — and return the id the receiving
+* server queued it under: Mailpit's message id, which its API serves the raw
+* message by.
+*/
+async function deliverRaw(smtpUrl, envelope, raw) {
+	const transport = createTransport(smtpUrl);
+	try {
+		const info = await transport.sendMail({
+			envelope: {
+				from: envelope.from,
+				to: [...envelope.to]
+			},
+			raw: typeof raw === "string" ? raw : Buffer.from(raw)
+		});
+		const id = /queued as (\S+)/i.exec(String(info.response))?.[1];
+		if (!id) throw new DeliveryNotQueued(String(info.response));
+		return id;
+	} finally {
+		transport.close();
+	}
+}
+//#endregion
+export { DeliveryNotQueued, composeEmail, deliverRaw, parseEmail };
+
+//# sourceMappingURL=inbound.mjs.map

package/dist/inbound.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"inbound.mjs","names":[],"sources":["../src/inbound.ts"],"sourcesContent":["/**\n * Received mail: the one MIME parser everything that reads a message uses, and\n * the composer that builds one.\n *\n * An `Inbox`'s handler, the test mailbox's `receive` and the mailbox that\n * reads what an app sent all go through {@link parseEmail}, so an attachment\n * that survives one survives all of them. {@link composeEmail} builds a real\n * MIME message from fields — what a test hands an inbox when it does not\n * bring a `.eml` of its own.\n */\n\nimport { createTransport } from 'nodemailer';\nimport MailComposer from 'nodemailer/lib/mail-composer/index.js';\nimport PostalMime, {\n\ttype Address,\n\ttype Attachment as PostalAttachment,\n} from 'postal-mime';\n\n/** A mailbox in a header: `\"Ada\" <ada@example.com>`. */\nexport interface EmailAddress {\n\t/** The display name, where the header gave one. */\n\tname?: string;\n\taddress: string;\n}\n\n/** A file in a message. */\nexport interface ReceivedAttachment {\n\t/**\n\t * As the sender named it — never a key or a path: it is theirs to choose,\n\t * `../../etc/passwd` included.\n\t */\n\tfilename?: string;\n\tcontentType: string;\n\t/** Bytes. */\n\tsize: number;\n\t/** `attachment`, or `inline` for one the HTML refers to by `contentId`. */\n\tdisposition?: string;\n\tcontentId?: string;\n\t/** Its bytes. */\n\tcontent(): Promise<Uint8Array>;\n}\n\n/** A message, parsed: its headers as the sender wrote them, its body, its files. */\nexport interface ParsedEmail {\n\tfrom?: EmailAddress;\n\tto: EmailAddress[];\n\tcc: EmailAddress[];\n\treplyTo: EmailAddress[];\n\tsubject?: string;\n\t/** `Date:`, as written. */\n\tdate?: string;\n\tmessageId?: string;\n\tinReplyTo?: string;\n\t/** `References:`, one message id each. */\n\treferences: string[];\n\t/** Every header, by lowercase name, each occurrence in order. */\n\theaders: Readonly<Record<string, readonly string[]>>;\n\ttext?: string;\n\thtml?: string;\n\tattachments: ReceivedAttachment[];\n}\n\n/** Parse a raw RFC 5322 message. */\nexport async function parseEmail(\n\traw: string | Uint8Array | ArrayBuffer,\n): Promise<ParsedEmail> {\n\tconst parsed = await PostalMime.parse(raw, {\n\t\tattachmentEncoding: 'arraybuffer',\n\t});\n\n\tconst headers: Record<string, string[]> = {};\n\tfor (const { key, value } of parsed.headers) {\n\t\tconst name = key.toLowerCase();\n\t\theaders[name] = [...(headers[name] ?? []), value];\n\t}\n\n\tconst from = parsed.from ? addresses([parsed.from])[0] : undefined;\n\treturn {\n\t\t...(from ? { from } : {}),\n\t\tto: addresses(parsed.to),\n\t\tcc: addresses(parsed.cc),\n\t\treplyTo: addresses(parsed.replyTo),\n\t\t...(parsed.subject !== undefined ? { subject: parsed.subject } : {}),\n\t\t...(parsed.date !== undefined ? { date: parsed.date } : {}),\n\t\t...(parsed.messageId ? { messageId: parsed.messageId } : {}),\n\t\t...(parsed.inReplyTo ? { inReplyTo: parsed.inReplyTo } : {}),\n\t\treferences: (parsed.references ?? '').split(/\\s+/).filter(Boolean),\n\t\theaders,\n\t\t...(parsed.text !== undefined ? { text: parsed.text } : {}),\n\t\t...(parsed.html !== undefined ? { html: parsed.html } : {}),\n\t\tattachments: parsed.attachments.map(attachment),\n\t};\n}\n\n/** Groups flattened into their members: a header's mailboxes, in order. */\nfunction addresses(list: readonly Address[] | undefined): EmailAddress[] {\n\tconst flat: EmailAddress[] = [];\n\tfor (const entry of list ?? []) {\n\t\tconst members = entry.group ?? [entry];\n\t\tfor (const { name, address } of members) {\n\t\t\tif (!address) continue;\n\t\t\tflat.push({ ...(name ? { name } : {}), address });\n\t\t}\n\t}\n\treturn flat;\n}\n\nfunction attachment(file: PostalAttachment): ReceivedAttachment {\n\tconst bytes =\n\t\ttypeof file.content === 'string'\n\t\t\t? new TextEncoder().encode(file.content)\n\t\t\t: file.content instanceof Uint8Array\n\t\t\t\t? file.content\n\t\t\t\t: new Uint8Array(file.content);\n\treturn {\n\t\t...(file.filename ? { filename: file.filename } : {}),\n\t\tcontentType: file.mimeType,\n\t\tsize: bytes.byteLength,\n\t\t...(file.disposition ? { disposition: file.disposition } : {}),\n\t\t...(file.contentId ? { contentId: file.contentId } : {}),\n\t\t// A copy each time: a handler that mutates what it was given must not\n\t\t// change what the next read sees.\n\t\tcontent: async () => bytes.slice(),\n\t};\n}\n\n/** A file to put in a composed message. */\nexport interface ComposedAttachment {\n\tfilename: string;\n\tcontent: string | Uint8Array;\n\tcontentType?: string;\n}\n\n/** The fields {@link composeEmail} builds a message from. */\nexport interface ComposeEmailOptions {\n\tfrom: string;\n\t/** `To:` as written — not where the message is delivered, which is the envelope's. */\n\tto?: string | readonly string[];\n\tcc?: string | readonly string[];\n\treplyTo?: string;\n\tsubject?: string;\n\ttext?: string;\n\thtml?: string;\n\tattachments?: readonly ComposedAttachment[];\n\t/** Any other header, as written: `Auto-Submitted`, `In-Reply-To`, `References`. */\n\theaders?: Readonly<Record<string, string>>;\n\tmessageId?: string;\n\tdate?: Date;\n}\n\n/** A real MIME message from fields, as `parseEmail` reads one. */\nexport async function composeEmail(\n\toptions: ComposeEmailOptions,\n): Promise<Uint8Array> {\n\tconst list = (value: string | readonly string[] | undefined) =>\n\t\tvalue === undefined\n\t\t\t? undefined\n\t\t\t: typeof value === 'string'\n\t\t\t\t? value\n\t\t\t\t: [...value];\n\tconst composer = new MailComposer({\n\t\tfrom: options.from,\n\t\t...(options.to !== undefined ? { to: list(options.to) } : {}),\n\t\t...(options.cc !== undefined ? { cc: list(options.cc) } : {}),\n\t\t...(options.replyTo ? { replyTo: options.replyTo } : {}),\n\t\t...(options.subject !== undefined ? { subject: options.subject } : {}),\n\t\t...(options.text !== undefined ? { text: options.text } : {}),\n\t\t...(options.html !== undefined ? { html: options.html } : {}),\n\t\t...(options.messageId ? { messageId: options.messageId } : {}),\n\t\t...(options.date ? { date: options.date } : {}),\n\t\t...(options.headers ? { headers: { ...options.headers } } : {}),\n\t\tattachments: (options.attachments ?? []).map((file) => ({\n\t\t\tfilename: file.filename,\n\t\t\tcontent:\n\t\t\t\ttypeof file.content === 'string'\n\t\t\t\t\t? file.content\n\t\t\t\t\t: Buffer.from(file.content),\n\t\t\t...(file.contentType ? { contentType: file.contentType } : {}),\n\t\t})),\n\t});\n\tconst built = await composer.compile().build();\n\treturn new Uint8Array(built);\n}\n\n/** The receiving server's reply named no id for the message it accepted. */\nexport class DeliveryNotQueued extends Error {\n\tconstructor(readonly response: string) {\n\t\tsuper(\n\t\t\t`The mail server accepted the message but named no id for it ` +\n\t\t\t\t`('queued as …'), so it cannot be read back. Mailpit names one; ` +\n\t\t\t\t`deliver to Mailpit.`,\n\t\t);\n\t\tthis.name = 'DeliveryNotQueued';\n\t}\n}\n\n/**\n * Deliver a raw message over SMTP with an envelope of its own — what a\n * sender's server does, `RCPT TO` and all — and return the id the receiving\n * server queued it under: Mailpit's message id, which its API serves the raw\n * message by.\n */\nexport async function deliverRaw(\n\tsmtpUrl: string,\n\tenvelope: { from: string; to: readonly string[] },\n\traw: Uint8Array | string,\n): Promise<string> {\n\tconst transport = createTransport(smtpUrl);\n\ttry {\n\t\tconst info = await transport.sendMail({\n\t\t\tenvelope: { from: envelope.from, to: [...envelope.to] },\n\t\t\traw: typeof raw === 'string' ? raw : Buffer.from(raw),\n\t\t});\n\t\tconst id = /queued as (\\S+)/i.exec(String(info.response))?.[1];\n\t\tif (!id) throw new DeliveryNotQueued(String(info.response));\n\t\treturn id;\n\t} finally {\n\t\ttransport.close();\n\t}\n}\n"],"mappings":"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"}

package/dist/rolldown-runtime-VH7oDXx4.cjs

@@ -0,0 +1,28 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+Object.defineProperty(exports, "__toESM", {
+	enumerable: true,
+	get: function() {
+		return __toESM;
+	}
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@geekmidas/emailkit",
-  "version": "10.0.0-alpha.14",
+  "version": "10.0.0-alpha.141",
   "description": "Type-safe email client with SMTP support and React templates",
   "private": false,
   "type": "module",
@@ -38,20 +38,26 @@
     "access": "public"
   },
   "dependencies": {
-    "nodemailer": "~10.0.10"
+    "@opentelemetry/api": "~1.9.1",
+    "nodemailer": "~10.0.10",
+    "postal-mime": "~4.1.4"
   },
   "devDependencies": {
+    "@opentelemetry/sdk-trace-node": "~2.11.0",
     "@types/nodemailer": "~8.0.2",
-    "@types/react": "~19.1.8",
-    "@types/react-dom": "~19.1.6",
-    "typescript": "~6.0.3"
+    "@types/react": "~19.3.0",
+    "@types/react-dom": "~19.3.0",
+    "typescript": "~7.0.2"
   },
   "peerDependencies": {
+    "@react-email/components": ">=1.0.12",
     "react": ">=18.0.0",
-    "react-dom": ">=18.0.0",
-    "@react-email/components": ">=1.0.12"
+    "react-dom": ">=18.0.0"
   },
   "engines": {
     "node": ">=22.0.0"
+  },
+  "scripts": {
+    "build": "tsdown --config ../../tsdown.config.ts --filter ."
   }
 }