@geekmidas/emailkit 10.0.0-alpha.15 → 10.0.0-alpha.151

package/dist/autoSubmitted.cjs

@@ -0,0 +1,48 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let node_async_hooks = require("node:async_hooks");
+//#region src/autoSubmitted.ts
+/**
+* RFC 3834's `Auto-Submitted` header: what stops two automatic responders
+* answering each other forever.
+*
+* Mail an app sends while it is handling mail it received is marked
+* `auto-replied`, and mail that arrives already marked is not handled. Both
+* sides are here, so the sender and the receiver read the header the same way.
+*
+* Which sends are replies is a property of where they happen, not of the call,
+* so it is carried by an `AsyncLocalStorage`: everything a handler awaits,
+* however deep, sends marked mail. The storage lives on `globalThis` so a copy
+* of this module loaded as CJS and another loaded as ESM share it.
+*/
+const AUTO_SUBMITTED_HEADER = "Auto-Submitted";
+const STORE = Symbol.for("@geekmidas/emailkit/autoSubmitted");
+function storage() {
+	const scope = globalThis;
+	scope[STORE] ??= new node_async_hooks.AsyncLocalStorage();
+	return scope[STORE];
+}
+/** Runs `fn` so that every message it sends is marked `auto-replied`. */
+function autoReplying(fn) {
+	return storage().run("auto-replied", fn);
+}
+/** What mail sent from here should be marked, if anything. */
+function currentAutoSubmitted() {
+	return storage().getStore();
+}
+/**
+* Whether a message was sent automatically: its `Auto-Submitted` header is
+* present and anything but `no`. Parameters after `;` are ignored, and so is
+* case, as the RFC says.
+*
+* `headers` is keyed by lower-case name, as `parseEmail` returns them.
+*/
+function isAutoSubmitted(headers) {
+	return (headers["Auto-Submitted".toLowerCase()] ?? []).some((value) => value.split(";")[0].trim().toLowerCase() !== "no");
+}
+//#endregion
+exports.AUTO_SUBMITTED_HEADER = AUTO_SUBMITTED_HEADER;
+exports.autoReplying = autoReplying;
+exports.currentAutoSubmitted = currentAutoSubmitted;
+exports.isAutoSubmitted = isAutoSubmitted;
+
+//# sourceMappingURL=autoSubmitted.cjs.map

package/dist/autoSubmitted.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoSubmitted.cjs","names":["AsyncLocalStorage"],"sources":["../src/autoSubmitted.ts"],"sourcesContent":["/**\n * RFC 3834's `Auto-Submitted` header: what stops two automatic responders\n * answering each other forever.\n *\n * Mail an app sends while it is handling mail it received is marked\n * `auto-replied`, and mail that arrives already marked is not handled. Both\n * sides are here, so the sender and the receiver read the header the same way.\n *\n * Which sends are replies is a property of where they happen, not of the call,\n * so it is carried by an `AsyncLocalStorage`: everything a handler awaits,\n * however deep, sends marked mail. The storage lives on `globalThis` so a copy\n * of this module loaded as CJS and another loaded as ESM share it.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nexport const AUTO_SUBMITTED_HEADER = 'Auto-Submitted';\n\n/** The values RFC 3834 defines; `no` is the only one meaning \"a person sent it\". */\nexport type AutoSubmitted = 'no' | 'auto-generated' | 'auto-replied';\n\nconst STORE = Symbol.for('@geekmidas/emailkit/autoSubmitted');\n\nfunction storage(): AsyncLocalStorage<AutoSubmitted> {\n\tconst scope = globalThis as unknown as Record<\n\t\tsymbol,\n\t\tAsyncLocalStorage<AutoSubmitted> | undefined\n\t>;\n\tscope[STORE] ??= new AsyncLocalStorage<AutoSubmitted>();\n\treturn scope[STORE];\n}\n\n/** Runs `fn` so that every message it sends is marked `auto-replied`. */\nexport function autoReplying<T>(fn: () => T): T {\n\treturn storage().run('auto-replied', fn);\n}\n\n/** What mail sent from here should be marked, if anything. */\nexport function currentAutoSubmitted(): AutoSubmitted | undefined {\n\treturn storage().getStore();\n}\n\n/**\n * Whether a message was sent automatically: its `Auto-Submitted` header is\n * present and anything but `no`. Parameters after `;` are ignored, and so is\n * case, as the RFC says.\n *\n * `headers` is keyed by lower-case name, as `parseEmail` returns them.\n */\nexport function isAutoSubmitted(\n\theaders: Readonly<Record<string, readonly string[] | undefined>>,\n): boolean {\n\treturn (headers[AUTO_SUBMITTED_HEADER.toLowerCase()] ?? []).some(\n\t\t(value) => value.split(';')[0]!.trim().toLowerCase() !== 'no',\n\t);\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAgBA,MAAa,wBAAwB;AAKrC,MAAM,QAAQ,OAAO,IAAI,mCAAmC;AAE5D,SAAS,UAA4C;CACpD,MAAM,QAAQ;CAId,MAAM,WAAW,IAAIA,iBAAAA,kBAAiC;CACtD,OAAO,MAAM;AACd;;AAGA,SAAgB,aAAgB,IAAgB;CAC/C,OAAO,QAAQ,CAAC,CAAC,IAAI,gBAAgB,EAAE;AACxC;;AAGA,SAAgB,uBAAkD;CACjE,OAAO,QAAQ,CAAC,CAAC,SAAS;AAC3B;;;;;;;;AASA,SAAgB,gBACf,SACU;CACV,QAAQ,QAAA,iBAA8B,YAAY,MAAM,CAAC,EAAA,CAAG,MAC1D,UAAU,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,CAAE,KAAK,CAAC,CAAC,YAAY,MAAM,IAC1D;AACD"}

package/dist/autoSubmitted.d.cts

@@ -0,0 +1,31 @@
+//#region src/autoSubmitted.d.ts
+/**
+ * RFC 3834's `Auto-Submitted` header: what stops two automatic responders
+ * answering each other forever.
+ *
+ * Mail an app sends while it is handling mail it received is marked
+ * `auto-replied`, and mail that arrives already marked is not handled. Both
+ * sides are here, so the sender and the receiver read the header the same way.
+ *
+ * Which sends are replies is a property of where they happen, not of the call,
+ * so it is carried by an `AsyncLocalStorage`: everything a handler awaits,
+ * however deep, sends marked mail. The storage lives on `globalThis` so a copy
+ * of this module loaded as CJS and another loaded as ESM share it.
+ */
+export declare const AUTO_SUBMITTED_HEADER = "Auto-Submitted";
+/** The values RFC 3834 defines; `no` is the only one meaning "a person sent it". */
+export type AutoSubmitted = 'no' | 'auto-generated' | 'auto-replied';
+/** Runs `fn` so that every message it sends is marked `auto-replied`. */
+export declare function autoReplying<T>(fn: () => T): T;
+/** What mail sent from here should be marked, if anything. */
+export declare function currentAutoSubmitted(): AutoSubmitted | undefined;
+/**
+ * Whether a message was sent automatically: its `Auto-Submitted` header is
+ * present and anything but `no`. Parameters after `;` are ignored, and so is
+ * case, as the RFC says.
+ *
+ * `headers` is keyed by lower-case name, as `parseEmail` returns them.
+ */
+export declare function isAutoSubmitted(headers: Readonly<Record<string, readonly string[] | undefined>>): boolean;
+//#endregion
+//# sourceMappingURL=autoSubmitted.d.cts.map

package/dist/autoSubmitted.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoSubmitted.d.cts","names":[],"sources":["../src/autoSubmitted.ts"],"mappings":";;;;;;;;;;;;;;qBAgBa;;YAGD;;wBAcI,aAAa,GAAG,UAAU,IAAI;;wBAK9B,wBAAwB;;;;;;;;wBAWxB,gBACf,SAAS,SAAS"}

package/dist/autoSubmitted.d.mts

@@ -0,0 +1,31 @@
+//#region src/autoSubmitted.d.ts
+/**
+ * RFC 3834's `Auto-Submitted` header: what stops two automatic responders
+ * answering each other forever.
+ *
+ * Mail an app sends while it is handling mail it received is marked
+ * `auto-replied`, and mail that arrives already marked is not handled. Both
+ * sides are here, so the sender and the receiver read the header the same way.
+ *
+ * Which sends are replies is a property of where they happen, not of the call,
+ * so it is carried by an `AsyncLocalStorage`: everything a handler awaits,
+ * however deep, sends marked mail. The storage lives on `globalThis` so a copy
+ * of this module loaded as CJS and another loaded as ESM share it.
+ */
+export declare const AUTO_SUBMITTED_HEADER = "Auto-Submitted";
+/** The values RFC 3834 defines; `no` is the only one meaning "a person sent it". */
+export type AutoSubmitted = 'no' | 'auto-generated' | 'auto-replied';
+/** Runs `fn` so that every message it sends is marked `auto-replied`. */
+export declare function autoReplying<T>(fn: () => T): T;
+/** What mail sent from here should be marked, if anything. */
+export declare function currentAutoSubmitted(): AutoSubmitted | undefined;
+/**
+ * Whether a message was sent automatically: its `Auto-Submitted` header is
+ * present and anything but `no`. Parameters after `;` are ignored, and so is
+ * case, as the RFC says.
+ *
+ * `headers` is keyed by lower-case name, as `parseEmail` returns them.
+ */
+export declare function isAutoSubmitted(headers: Readonly<Record<string, readonly string[] | undefined>>): boolean;
+//#endregion
+//# sourceMappingURL=autoSubmitted.d.mts.map

package/dist/autoSubmitted.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoSubmitted.d.mts","names":[],"sources":["../src/autoSubmitted.ts"],"mappings":";;;;;;;;;;;;;;qBAgBa;;YAGD;;wBAcI,aAAa,GAAG,UAAU,IAAI;;wBAK9B,wBAAwB;;;;;;;;wBAWxB,gBACf,SAAS,SAAS"}

package/dist/autoSubmitted.mjs

@@ -0,0 +1,44 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+//#region src/autoSubmitted.ts
+/**
+* RFC 3834's `Auto-Submitted` header: what stops two automatic responders
+* answering each other forever.
+*
+* Mail an app sends while it is handling mail it received is marked
+* `auto-replied`, and mail that arrives already marked is not handled. Both
+* sides are here, so the sender and the receiver read the header the same way.
+*
+* Which sends are replies is a property of where they happen, not of the call,
+* so it is carried by an `AsyncLocalStorage`: everything a handler awaits,
+* however deep, sends marked mail. The storage lives on `globalThis` so a copy
+* of this module loaded as CJS and another loaded as ESM share it.
+*/
+const AUTO_SUBMITTED_HEADER = "Auto-Submitted";
+const STORE = Symbol.for("@geekmidas/emailkit/autoSubmitted");
+function storage() {
+	const scope = globalThis;
+	scope[STORE] ??= new AsyncLocalStorage();
+	return scope[STORE];
+}
+/** Runs `fn` so that every message it sends is marked `auto-replied`. */
+function autoReplying(fn) {
+	return storage().run("auto-replied", fn);
+}
+/** What mail sent from here should be marked, if anything. */
+function currentAutoSubmitted() {
+	return storage().getStore();
+}
+/**
+* Whether a message was sent automatically: its `Auto-Submitted` header is
+* present and anything but `no`. Parameters after `;` are ignored, and so is
+* case, as the RFC says.
+*
+* `headers` is keyed by lower-case name, as `parseEmail` returns them.
+*/
+function isAutoSubmitted(headers) {
+	return (headers["Auto-Submitted".toLowerCase()] ?? []).some((value) => value.split(";")[0].trim().toLowerCase() !== "no");
+}
+//#endregion
+export { AUTO_SUBMITTED_HEADER, autoReplying, currentAutoSubmitted, isAutoSubmitted };
+
+//# sourceMappingURL=autoSubmitted.mjs.map

package/dist/autoSubmitted.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"autoSubmitted.mjs","names":[],"sources":["../src/autoSubmitted.ts"],"sourcesContent":["/**\n * RFC 3834's `Auto-Submitted` header: what stops two automatic responders\n * answering each other forever.\n *\n * Mail an app sends while it is handling mail it received is marked\n * `auto-replied`, and mail that arrives already marked is not handled. Both\n * sides are here, so the sender and the receiver read the header the same way.\n *\n * Which sends are replies is a property of where they happen, not of the call,\n * so it is carried by an `AsyncLocalStorage`: everything a handler awaits,\n * however deep, sends marked mail. The storage lives on `globalThis` so a copy\n * of this module loaded as CJS and another loaded as ESM share it.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\n\nexport const AUTO_SUBMITTED_HEADER = 'Auto-Submitted';\n\n/** The values RFC 3834 defines; `no` is the only one meaning \"a person sent it\". */\nexport type AutoSubmitted = 'no' | 'auto-generated' | 'auto-replied';\n\nconst STORE = Symbol.for('@geekmidas/emailkit/autoSubmitted');\n\nfunction storage(): AsyncLocalStorage<AutoSubmitted> {\n\tconst scope = globalThis as unknown as Record<\n\t\tsymbol,\n\t\tAsyncLocalStorage<AutoSubmitted> | undefined\n\t>;\n\tscope[STORE] ??= new AsyncLocalStorage<AutoSubmitted>();\n\treturn scope[STORE];\n}\n\n/** Runs `fn` so that every message it sends is marked `auto-replied`. */\nexport function autoReplying<T>(fn: () => T): T {\n\treturn storage().run('auto-replied', fn);\n}\n\n/** What mail sent from here should be marked, if anything. */\nexport function currentAutoSubmitted(): AutoSubmitted | undefined {\n\treturn storage().getStore();\n}\n\n/**\n * Whether a message was sent automatically: its `Auto-Submitted` header is\n * present and anything but `no`. Parameters after `;` are ignored, and so is\n * case, as the RFC says.\n *\n * `headers` is keyed by lower-case name, as `parseEmail` returns them.\n */\nexport function isAutoSubmitted(\n\theaders: Readonly<Record<string, readonly string[] | undefined>>,\n): boolean {\n\treturn (headers[AUTO_SUBMITTED_HEADER.toLowerCase()] ?? []).some(\n\t\t(value) => value.split(';')[0]!.trim().toLowerCase() !== 'no',\n\t);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,MAAa,wBAAwB;AAKrC,MAAM,QAAQ,OAAO,IAAI,mCAAmC;AAE5D,SAAS,UAA4C;CACpD,MAAM,QAAQ;CAId,MAAM,WAAW,IAAI,kBAAiC;CACtD,OAAO,MAAM;AACd;;AAGA,SAAgB,aAAgB,IAAgB;CAC/C,OAAO,QAAQ,CAAC,CAAC,IAAI,gBAAgB,EAAE;AACxC;;AAGA,SAAgB,uBAAkD;CACjE,OAAO,QAAQ,CAAC,CAAC,SAAS;AAC3B;;;;;;;;AASA,SAAgB,gBACf,SACU;CACV,QAAQ,QAAA,iBAA8B,YAAY,MAAM,CAAC,EAAA,CAAG,MAC1D,UAAU,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,CAAE,KAAK,CAAC,CAAC,YAAY,MAAM,IAC1D;AACD"}

package/dist/client.cjs

@@ -1,29 +1,10 @@
 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");
+const require_autoSubmitted = require("./autoSubmitted.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,10 +13,20 @@ 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 marked = require_autoSubmitted.currentAutoSubmitted();
 		const mailOptions = {
 			...this.config.defaults,
-			...options
+			...options,
+			...marked ? { headers: { [require_autoSubmitted.AUTO_SUBMITTED_HEADER]: marked } } : {}
 		};
 		if (!mailOptions.from) throw new Error("The \"from\" field is required in email options or defaults");
 		if (!mailOptions.text && !mailOptions.html) throw new Error("Either text or html content must be provided");
@@ -52,10 +43,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 +69,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":["currentAutoSubmitted","AUTO_SUBMITTED_HEADER","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 { AUTO_SUBMITTED_HEADER, currentAutoSubmitted } from './autoSubmitted';\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 marked = currentAutoSubmitted();\n\t\tconst mailOptions = {\n\t\t\t...this.config.defaults,\n\t\t\t...options,\n\t\t\t// A send inside an inbox handler is a reply to mail, whatever it says.\n\t\t\t...(marked ? { headers: { [AUTO_SUBMITTED_HEADER]: marked } } : {}),\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":";;;;;;;;AAmBA,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,SAASA,sBAAAA,qBAAqB;EACpC,MAAM,cAAc;GACnB,GAAG,KAAK,OAAO;GACf,GAAG;GAEH,GAAI,SAAS,EAAE,SAAS,GAAGC,sBAAAA,wBAAwB,OAAO,EAAE,IAAI,CAAC;EAClE;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,GAAMC,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":";;qBAmBa,WAAW,UAAU,2BAA2B,YAAY;UAChE;UACA;EAER,YAAY,QAAQ,kBAAkB;;;;;;EAUhC,KAAK,SAAS,cAAc,QAAQ;UAM5B;EA6BR,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":";;qBAmBa,WAAW,UAAU,2BAA2B,YAAY;UAChE;UACA;EAER,YAAY,QAAQ,kBAAkB;;;;;;EAUhC,KAAK,SAAS,cAAc,QAAQ;UAM5B;EA6BR,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,5 @@
+import { AUTO_SUBMITTED_HEADER, currentAutoSubmitted } from "./autoSubmitted.mjs";
+import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 import { render } from "@react-email/components";
 import nodemailer from "nodemailer";
 //#region src/client.ts
@@ -8,10 +10,20 @@ 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 marked = currentAutoSubmitted();
 		const mailOptions = {
 			...this.config.defaults,
-			...options
+			...options,
+			...marked ? { headers: { [AUTO_SUBMITTED_HEADER]: marked } } : {}
 		};
 		if (!mailOptions.from) throw new Error("The \"from\" field is required in email options or defaults");
 		if (!mailOptions.text && !mailOptions.html) throw new Error("Either text or html content must be provided");
@@ -28,10 +40,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 +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 = 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 { AUTO_SUBMITTED_HEADER, currentAutoSubmitted } from './autoSubmitted';\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 marked = currentAutoSubmitted();\n\t\tconst mailOptions = {\n\t\t\t...this.config.defaults,\n\t\t\t...options,\n\t\t\t// A send inside an inbox handler is a reply to mail, whatever it says.\n\t\t\t...(marked ? { headers: { [AUTO_SUBMITTED_HEADER]: marked } } : {}),\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":";;;;;AAmBA,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,SAAS,qBAAqB;EACpC,MAAM,cAAc;GACnB,GAAG,KAAK,OAAO;GACf,GAAG;GAEH,GAAI,SAAS,EAAE,SAAS,GAAG,wBAAwB,OAAO,EAAE,IAAI,CAAC;EAClE;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/index.cjs

@@ -1,10 +1,15 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_autoSubmitted = require("./autoSubmitted.cjs");
 const require_client = require("./client.cjs");
 const require_errors = require("./errors.cjs");
 const require_url = require("./url.cjs");
+exports.AUTO_SUBMITTED_HEADER = require_autoSubmitted.AUTO_SUBMITTED_HEADER;
 exports.EmailUrlError = require_errors.EmailUrlError;
 exports.MalformedEmailUrl = require_errors.MalformedEmailUrl;
 exports.SMTPClient = require_client.SMTPClient;
 exports.UnsupportedEmailScheme = require_errors.UnsupportedEmailScheme;
+exports.autoReplying = require_autoSubmitted.autoReplying;
 exports.createEmailClient = require_client.createEmailClient;
+exports.currentAutoSubmitted = require_autoSubmitted.currentAutoSubmitted;
+exports.isAutoSubmitted = require_autoSubmitted.isAutoSubmitted;
 exports.parseEmailUrl = require_url.parseEmailUrl;

package/dist/index.d.cts

@@ -1,5 +1,6 @@
+import { AUTO_SUBMITTED_HEADER, AutoSubmitted, autoReplying, currentAutoSubmitted, isAutoSubmitted } from "./autoSubmitted.cjs";
 import { Attachment, EmailClient, EmailClientConfig, EmailOptions, EmailTemplate, PlainEmailOptions, SMTPConfig, SendOptions, SendResult, TemplateNames, TemplatePropsFor, TemplateRecord } from "./types.cjs";
 import { SMTPClient, createEmailClient } from "./client.cjs";
 import { EmailUrlError, MalformedEmailUrl, UnsupportedEmailScheme } from "./errors.cjs";
 import { parseEmailUrl } from "./url.cjs";
-export { type Attachment, type EmailClient, type EmailClientConfig, type EmailOptions, type EmailTemplate, EmailUrlError, MalformedEmailUrl, type PlainEmailOptions, SMTPClient, type SMTPConfig, type SendOptions, type SendResult, type TemplateNames, type TemplatePropsFor, type TemplateRecord, UnsupportedEmailScheme, createEmailClient, parseEmailUrl };
+export { AUTO_SUBMITTED_HEADER, type Attachment, type AutoSubmitted, type EmailClient, type EmailClientConfig, type EmailOptions, type EmailTemplate, EmailUrlError, MalformedEmailUrl, type PlainEmailOptions, SMTPClient, type SMTPConfig, type SendOptions, type SendResult, type TemplateNames, type TemplatePropsFor, type TemplateRecord, UnsupportedEmailScheme, autoReplying, createEmailClient, currentAutoSubmitted, isAutoSubmitted, parseEmailUrl };

package/dist/index.d.mts

@@ -1,5 +1,6 @@
+import { AUTO_SUBMITTED_HEADER, AutoSubmitted, autoReplying, currentAutoSubmitted, isAutoSubmitted } from "./autoSubmitted.mjs";
 import { Attachment, EmailClient, EmailClientConfig, EmailOptions, EmailTemplate, PlainEmailOptions, SMTPConfig, SendOptions, SendResult, TemplateNames, TemplatePropsFor, TemplateRecord } from "./types.mjs";
 import { SMTPClient, createEmailClient } from "./client.mjs";
 import { EmailUrlError, MalformedEmailUrl, UnsupportedEmailScheme } from "./errors.mjs";
 import { parseEmailUrl } from "./url.mjs";
-export { type Attachment, type EmailClient, type EmailClientConfig, type EmailOptions, type EmailTemplate, EmailUrlError, MalformedEmailUrl, type PlainEmailOptions, SMTPClient, type SMTPConfig, type SendOptions, type SendResult, type TemplateNames, type TemplatePropsFor, type TemplateRecord, UnsupportedEmailScheme, createEmailClient, parseEmailUrl };
+export { AUTO_SUBMITTED_HEADER, type Attachment, type AutoSubmitted, type EmailClient, type EmailClientConfig, type EmailOptions, type EmailTemplate, EmailUrlError, MalformedEmailUrl, type PlainEmailOptions, SMTPClient, type SMTPConfig, type SendOptions, type SendResult, type TemplateNames, type TemplatePropsFor, type TemplateRecord, UnsupportedEmailScheme, autoReplying, createEmailClient, currentAutoSubmitted, isAutoSubmitted, parseEmailUrl };

package/dist/index.mjs

@@ -1,4 +1,5 @@
+import { AUTO_SUBMITTED_HEADER, autoReplying, currentAutoSubmitted, isAutoSubmitted } from "./autoSubmitted.mjs";
 import { SMTPClient, createEmailClient } from "./client.mjs";
 import { EmailUrlError, MalformedEmailUrl, UnsupportedEmailScheme } from "./errors.mjs";
 import { parseEmailUrl } from "./url.mjs";
-export { EmailUrlError, MalformedEmailUrl, SMTPClient, UnsupportedEmailScheme, createEmailClient, parseEmailUrl };
+export { AUTO_SUBMITTED_HEADER, EmailUrlError, MalformedEmailUrl, SMTPClient, UnsupportedEmailScheme, autoReplying, createEmailClient, currentAutoSubmitted, isAutoSubmitted, parseEmailUrl };

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.15",
+  "version": "10.0.0-alpha.151",
   "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.3.0",
     "@types/react-dom": "~19.3.0",
-    "typescript": "~6.0.3"
+    "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 ."
   }
 }