@geekmidas/emailkit 10.0.0-alpha.99 → 10.0.0

package/src/types.ts

@@ -0,0 +1,99 @@
+import type { Address } from 'nodemailer/lib/mailer';
+import type { ReactElement } from 'react';
+
+export interface EmailOptions {
+	from: string | Address;
+	to: string | string[] | Address[];
+	cc?: string | string[] | Address[];
+	bcc?: string | string[] | Address[];
+	subject: string;
+	replyTo?: string | Address;
+	attachments?: Attachment[];
+}
+
+export interface Attachment {
+	filename: string;
+	content?: string | Buffer;
+	path?: string;
+	contentType?: string;
+	cid?: string;
+}
+
+export interface PlainEmailOptions extends EmailOptions {
+	text?: string;
+	html?: string;
+}
+
+export type SendOptions = Omit<PlainEmailOptions, 'from'> & {
+	from?: string | Address;
+};
+
+export interface SMTPConfig {
+	host: string;
+	port: number;
+	secure?: boolean;
+	auth?: {
+		user: string;
+		pass: string;
+	};
+	tls?: {
+		rejectUnauthorized?: boolean;
+		servername?: string;
+	};
+	pool?: boolean;
+	maxConnections?: number;
+	maxMessages?: number;
+	rateLimit?: number;
+	logger?: boolean;
+	debug?: boolean;
+}
+
+export interface SendResult {
+	messageId: string;
+	accepted: string[];
+	rejected: string[];
+	response: string;
+}
+
+export type EmailTemplate<T = any> = (props: T) => ReactElement;
+
+// Extract props type from a template function
+export type TemplateProps<T> = T extends EmailTemplate<infer P> ? P : never;
+
+// Template record type for type safety
+export type TemplateRecord = Record<string, EmailTemplate<any>>;
+
+// Extract template names from template record
+export type TemplateNames<T extends TemplateRecord> = keyof T;
+
+// Extract props for a specific template
+export type TemplatePropsFor<
+	T extends TemplateRecord,
+	K extends TemplateNames<T>,
+> = TemplateProps<T[K]>;
+
+export interface EmailClientConfig<T extends TemplateRecord = TemplateRecord> {
+	smtp: SMTPConfig;
+	templates: T;
+	dkim?: {
+		domainName: string;
+		keySelector: string;
+		privateKey: string;
+	};
+	defaults: {
+		from?: string | Address;
+		replyTo?: string | Address;
+	};
+}
+
+export interface EmailClient<T extends TemplateRecord = TemplateRecord> {
+	send(options: SendOptions): Promise<SendResult>;
+	sendTemplate<K extends TemplateNames<T>>(
+		template: K,
+		options: SendOptions & {
+			props: TemplatePropsFor<T, K>;
+		},
+	): Promise<SendResult>;
+	verify(): Promise<boolean>;
+	close(): Promise<void>;
+}

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "composite": true,
+    "jsx": "react-jsx"
+  },
+  "include": ["src/**/*"]
+}

package/dist/client.cjs.map

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

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

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

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

@@ -1,53 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region src/errors.ts
-/**
-* Email URL errors.
-*
-* Every provider is reached over SMTP, so there are only two problems a URL can
-* have: it is not a URL, or it names a scheme this transport cannot speak. Both
-* carry the offending value as a field.
-*
-* Messages state the rule, which is constant, and never interpolate the value.
-* An interpolated message cannot be matched on, reads differently every time it
-* is thrown, and carries user input into every log line that touches it — and a
-* mail URL's userinfo is a credential, which makes that leak a real one here.
-*/
-/** Base for anything wrong with an email URL, so callers may catch broadly. */
-var EmailUrlError = class extends Error {
-	/** The URL that could not be used. Carries credentials — do not log it. */
-	url;
-	constructor(url, message) {
-		super(message);
-		this.url = url;
-		this.name = new.target.name;
-	}
-};
-/** The string is not a URL at all. */
-var MalformedEmailUrl = class extends EmailUrlError {
-	constructor(url) {
-		super(url, "Not a valid URL");
-	}
-};
-/**
-* A URL, but naming a scheme that is not SMTP.
-*
-* Almost always `ses://` or `resend://` — a provider written where a protocol
-* belongs. Mail is delivered over SMTP whoever is delivering it, so the provider
-* shows up as the URL's host and credentials, never as its scheme.
-*/
-var UnsupportedEmailScheme = class extends EmailUrlError {
-	/** The scheme the URL carried, e.g. `'ses:'`. */
-	actual;
-	/** The schemes this transport speaks. */
-	expected = ["smtp:", "smtps:"];
-	constructor(url, actual) {
-		super(url, "Email URL scheme must be smtp: or smtps:");
-		this.actual = actual;
-	}
-};
-//#endregion
-exports.EmailUrlError = EmailUrlError;
-exports.MalformedEmailUrl = MalformedEmailUrl;
-exports.UnsupportedEmailScheme = UnsupportedEmailScheme;
-
-//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.cjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Email URL errors.\n *\n * Every provider is reached over SMTP, so there are only two problems a URL can\n * have: it is not a URL, or it names a scheme this transport cannot speak. Both\n * carry the offending value as a field.\n *\n * Messages state the rule, which is constant, and never interpolate the value.\n * An interpolated message cannot be matched on, reads differently every time it\n * is thrown, and carries user input into every log line that touches it — and a\n * mail URL's userinfo is a credential, which makes that leak a real one here.\n */\n\n/** Base for anything wrong with an email URL, so callers may catch broadly. */\nexport abstract class EmailUrlError extends Error {\n\t/** The URL that could not be used. Carries credentials — do not log it. */\n\treadonly url: string;\n\n\tconstructor(url: string, message: string) {\n\t\tsuper(message);\n\t\tthis.url = url;\n\t\tthis.name = new.target.name;\n\t}\n}\n\n/** The string is not a URL at all. */\nexport class MalformedEmailUrl extends EmailUrlError {\n\tconstructor(url: string) {\n\t\tsuper(url, 'Not a valid URL');\n\t}\n}\n\n/**\n * A URL, but naming a scheme that is not SMTP.\n *\n * Almost always `ses://` or `resend://` — a provider written where a protocol\n * belongs. Mail is delivered over SMTP whoever is delivering it, so the provider\n * shows up as the URL's host and credentials, never as its scheme.\n */\nexport class UnsupportedEmailScheme extends EmailUrlError {\n\t/** The scheme the URL carried, e.g. `'ses:'`. */\n\treadonly actual: string;\n\t/** The schemes this transport speaks. */\n\treadonly expected: readonly string[] = ['smtp:', 'smtps:'];\n\n\tconstructor(url: string, actual: string) {\n\t\tsuper(url, 'Email URL scheme must be smtp: or smtps:');\n\t\tthis.actual = actual;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;AAcA,IAAsB,gBAAtB,cAA4C,MAAM;;CAEjD;CAEA,YAAY,KAAa,SAAiB;EACzC,MAAM,OAAO;EACb,KAAK,MAAM;EACX,KAAK,OAAO,WAAW;CACxB;AACD;;AAGA,IAAa,oBAAb,cAAuC,cAAc;CACpD,YAAY,KAAa;EACxB,MAAM,KAAK,iBAAiB;CAC7B;AACD;;;;;;;;AASA,IAAa,yBAAb,cAA4C,cAAc;;CAEzD;;CAEA,WAAuC,CAAC,SAAS,QAAQ;CAEzD,YAAY,KAAa,QAAgB;EACxC,MAAM,KAAK,0CAA0C;EACrD,KAAK,SAAS;CACf;AACD"}

package/dist/errors.d.cts

@@ -1,39 +0,0 @@
-//#region src/errors.d.ts
-/**
- * Email URL errors.
- *
- * Every provider is reached over SMTP, so there are only two problems a URL can
- * have: it is not a URL, or it names a scheme this transport cannot speak. Both
- * carry the offending value as a field.
- *
- * Messages state the rule, which is constant, and never interpolate the value.
- * An interpolated message cannot be matched on, reads differently every time it
- * is thrown, and carries user input into every log line that touches it — and a
- * mail URL's userinfo is a credential, which makes that leak a real one here.
- */
-/** Base for anything wrong with an email URL, so callers may catch broadly. */
-export declare abstract class EmailUrlError extends Error {
-  /** The URL that could not be used. Carries credentials — do not log it. */
-  readonly url: string;
-  constructor(url: string, message: string);
-}
-/** The string is not a URL at all. */
-export declare class MalformedEmailUrl extends EmailUrlError {
-  constructor(url: string);
-}
-/**
- * A URL, but naming a scheme that is not SMTP.
- *
- * Almost always `ses://` or `resend://` — a provider written where a protocol
- * belongs. Mail is delivered over SMTP whoever is delivering it, so the provider
- * shows up as the URL's host and credentials, never as its scheme.
- */
-export declare class UnsupportedEmailScheme extends EmailUrlError {
-  /** The scheme the URL carried, e.g. `'ses:'`. */
-  readonly actual: string;
-  /** The schemes this transport speaks. */
-  readonly expected: readonly string[];
-  constructor(url: string, actual: string);
-}
-//#endregion
-//# sourceMappingURL=errors.d.cts.map

package/dist/errors.d.cts.map

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

@@ -1,39 +0,0 @@
-//#region src/errors.d.ts
-/**
- * Email URL errors.
- *
- * Every provider is reached over SMTP, so there are only two problems a URL can
- * have: it is not a URL, or it names a scheme this transport cannot speak. Both
- * carry the offending value as a field.
- *
- * Messages state the rule, which is constant, and never interpolate the value.
- * An interpolated message cannot be matched on, reads differently every time it
- * is thrown, and carries user input into every log line that touches it — and a
- * mail URL's userinfo is a credential, which makes that leak a real one here.
- */
-/** Base for anything wrong with an email URL, so callers may catch broadly. */
-export declare abstract class EmailUrlError extends Error {
-  /** The URL that could not be used. Carries credentials — do not log it. */
-  readonly url: string;
-  constructor(url: string, message: string);
-}
-/** The string is not a URL at all. */
-export declare class MalformedEmailUrl extends EmailUrlError {
-  constructor(url: string);
-}
-/**
- * A URL, but naming a scheme that is not SMTP.
- *
- * Almost always `ses://` or `resend://` — a provider written where a protocol
- * belongs. Mail is delivered over SMTP whoever is delivering it, so the provider
- * shows up as the URL's host and credentials, never as its scheme.
- */
-export declare class UnsupportedEmailScheme extends EmailUrlError {
-  /** The scheme the URL carried, e.g. `'ses:'`. */
-  readonly actual: string;
-  /** The schemes this transport speaks. */
-  readonly expected: readonly string[];
-  constructor(url: string, actual: string);
-}
-//#endregion
-//# sourceMappingURL=errors.d.mts.map

package/dist/errors.d.mts.map

@@ -1 +0,0 @@
-{"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/errors.mjs

@@ -1,50 +0,0 @@
-//#region src/errors.ts
-/**
-* Email URL errors.
-*
-* Every provider is reached over SMTP, so there are only two problems a URL can
-* have: it is not a URL, or it names a scheme this transport cannot speak. Both
-* carry the offending value as a field.
-*
-* Messages state the rule, which is constant, and never interpolate the value.
-* An interpolated message cannot be matched on, reads differently every time it
-* is thrown, and carries user input into every log line that touches it — and a
-* mail URL's userinfo is a credential, which makes that leak a real one here.
-*/
-/** Base for anything wrong with an email URL, so callers may catch broadly. */
-var EmailUrlError = class extends Error {
-	/** The URL that could not be used. Carries credentials — do not log it. */
-	url;
-	constructor(url, message) {
-		super(message);
-		this.url = url;
-		this.name = new.target.name;
-	}
-};
-/** The string is not a URL at all. */
-var MalformedEmailUrl = class extends EmailUrlError {
-	constructor(url) {
-		super(url, "Not a valid URL");
-	}
-};
-/**
-* A URL, but naming a scheme that is not SMTP.
-*
-* Almost always `ses://` or `resend://` — a provider written where a protocol
-* belongs. Mail is delivered over SMTP whoever is delivering it, so the provider
-* shows up as the URL's host and credentials, never as its scheme.
-*/
-var UnsupportedEmailScheme = class extends EmailUrlError {
-	/** The scheme the URL carried, e.g. `'ses:'`. */
-	actual;
-	/** The schemes this transport speaks. */
-	expected = ["smtp:", "smtps:"];
-	constructor(url, actual) {
-		super(url, "Email URL scheme must be smtp: or smtps:");
-		this.actual = actual;
-	}
-};
-//#endregion
-export { EmailUrlError, MalformedEmailUrl, UnsupportedEmailScheme };
-
-//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"errors.mjs","names":[],"sources":["../src/errors.ts"],"sourcesContent":["/**\n * Email URL errors.\n *\n * Every provider is reached over SMTP, so there are only two problems a URL can\n * have: it is not a URL, or it names a scheme this transport cannot speak. Both\n * carry the offending value as a field.\n *\n * Messages state the rule, which is constant, and never interpolate the value.\n * An interpolated message cannot be matched on, reads differently every time it\n * is thrown, and carries user input into every log line that touches it — and a\n * mail URL's userinfo is a credential, which makes that leak a real one here.\n */\n\n/** Base for anything wrong with an email URL, so callers may catch broadly. */\nexport abstract class EmailUrlError extends Error {\n\t/** The URL that could not be used. Carries credentials — do not log it. */\n\treadonly url: string;\n\n\tconstructor(url: string, message: string) {\n\t\tsuper(message);\n\t\tthis.url = url;\n\t\tthis.name = new.target.name;\n\t}\n}\n\n/** The string is not a URL at all. */\nexport class MalformedEmailUrl extends EmailUrlError {\n\tconstructor(url: string) {\n\t\tsuper(url, 'Not a valid URL');\n\t}\n}\n\n/**\n * A URL, but naming a scheme that is not SMTP.\n *\n * Almost always `ses://` or `resend://` — a provider written where a protocol\n * belongs. Mail is delivered over SMTP whoever is delivering it, so the provider\n * shows up as the URL's host and credentials, never as its scheme.\n */\nexport class UnsupportedEmailScheme extends EmailUrlError {\n\t/** The scheme the URL carried, e.g. `'ses:'`. */\n\treadonly actual: string;\n\t/** The schemes this transport speaks. */\n\treadonly expected: readonly string[] = ['smtp:', 'smtps:'];\n\n\tconstructor(url: string, actual: string) {\n\t\tsuper(url, 'Email URL scheme must be smtp: or smtps:');\n\t\tthis.actual = actual;\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,IAAsB,gBAAtB,cAA4C,MAAM;;CAEjD;CAEA,YAAY,KAAa,SAAiB;EACzC,MAAM,OAAO;EACb,KAAK,MAAM;EACX,KAAK,OAAO,WAAW;CACxB;AACD;;AAGA,IAAa,oBAAb,cAAuC,cAAc;CACpD,YAAY,KAAa;EACxB,MAAM,KAAK,iBAAiB;CAC7B;AACD;;;;;;;;AASA,IAAa,yBAAb,cAA4C,cAAc;;CAEzD;;CAEA,WAAuC,CAAC,SAAS,QAAQ;CAEzD,YAAY,KAAa,QAAgB;EACxC,MAAM,KAAK,0CAA0C;EACrD,KAAK,SAAS;CACf;AACD"}

package/dist/types.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.cts","names":[],"sources":["../src/types.ts"],"mappings":";;;KAMK,UAAU,KAAK;iBAEH;EAChB,eAAe;EACf,wBAAwB;EACxB,yBAAyB;EACzB,0BAA0B;EAC1B;EACA,mBAAmB;EACnB,cAAc;;iBAGE;EAChB;EACA,mBAAmB;EACnB;EACA;EACA;;iBAGgB,0BAA0B;EAC1C;EACA;;YAGW,cAAc,KAAK;EAC9B,gBAAgB;;iBAGA;EAChB;EACA;EACA;EACA;IACC;IACA;;EAED;IACC;IACA;;EAED;EACA;EACA;EACA;EACA;EACA;;iBAGgB;EAChB;EACA;EACA;;;;;;;;;EASA;;YAGW,cAAc,YAAY,OAAO,MAAM;YAGvC,cAAc,KAAK,UAAU,oBAAoB,KAAK;YAGtD,iBAAiB,eAAe;YAGhC,cAAc,UAAU,wBAAwB;YAGhD,iBACX,UAAU,gBACV,UAAU,cAAc,MACrB,cAAc,EAAE;iBAEH,kBAAkB,UAAU,iBAAiB;EAC7D,MAAM;EACN,WAAW;EACX;IACC;IACA;IACA;;EAED;IACC,gBAAgB;IAChB,mBAAmB;;;iBAIJ,YAAY,UAAU,iBAAiB;EACvD,KAAK,SAAS,cAAc,QAAQ;EACpC,aAAa,UAAU,cAAc,IACpC,UAAU,GACV,SAAS;IACR,OAAO,iBAAiB,GAAG;MAE1B,QAAQ;EACX,UAAU;EACV,SAAS"}

package/dist/types.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../src/types.ts"],"mappings":";;;KAMK,UAAU,KAAK;iBAEH;EAChB,eAAe;EACf,wBAAwB;EACxB,yBAAyB;EACzB,0BAA0B;EAC1B;EACA,mBAAmB;EACnB,cAAc;;iBAGE;EAChB;EACA,mBAAmB;EACnB;EACA;EACA;;iBAGgB,0BAA0B;EAC1C;EACA;;YAGW,cAAc,KAAK;EAC9B,gBAAgB;;iBAGA;EAChB;EACA;EACA;EACA;IACC;IACA;;EAED;IACC;IACA;;EAED;EACA;EACA;EACA;EACA;EACA;;iBAGgB;EAChB;EACA;EACA;;;;;;;;;EASA;;YAGW,cAAc,YAAY,OAAO,MAAM;YAGvC,cAAc,KAAK,UAAU,oBAAoB,KAAK;YAGtD,iBAAiB,eAAe;YAGhC,cAAc,UAAU,wBAAwB;YAGhD,iBACX,UAAU,gBACV,UAAU,cAAc,MACrB,cAAc,EAAE;iBAEH,kBAAkB,UAAU,iBAAiB;EAC7D,MAAM;EACN,WAAW;EACX;IACC;IACA;IACA;;EAED;IACC,gBAAgB;IAChB,mBAAmB;;;iBAIJ,YAAY,UAAU,iBAAiB;EACvD,KAAK,SAAS,cAAc,QAAQ;EACpC,aAAa,UAAU,cAAc,IACpC,UAAU,GACV,SAAS;IACR,OAAO,iBAAiB,GAAG;MAE1B,QAAQ;EACX,UAAU;EACV,SAAS"}

package/dist/url.cjs

@@ -1,61 +0,0 @@
-Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_errors = require("./errors.cjs");
-//#region src/url.ts
-/**
-* `smtp://` — the one URL shape an email construct ever provides.
-*
-* Every provider is reached the same way: Mailpit locally, SES through its SMTP
-* interface, Resend and Postmark through theirs. So there is no scheme-keyed
-* driver registry here as there is in `@geekmidas/storage` — one transport, one
-* parser, and the client never branches on who is delivering the mail.
-*
-* What varies between providers is confined to the URL: host, port, and
-* credentials. That is what lets the same handler source run against Mailpit and
-* against SES without a conditional.
-*/
-/**
-* The port to use when the URL names none.
-*
-* 587 is submission-with-STARTTLS, which is what SES, Resend, and Postmark all
-* document; 465 is implicit TLS, which is what `smtps://` means.
-*/
-const DEFAULT_PORT = {
-	"smtp:": 587,
-	"smtps:": 465
-};
-/**
-* Build an SMTP transport config from a `<NAME>_URL`.
-*
-* `smtps://` sets `secure`, which is nodemailer's flag for implicit TLS on
-* connect rather than STARTTLS after `EHLO` — the distinction 465 and 587 carry,
-* and the reason the scheme is worth having rather than inferring from the port.
-*
-* @example parseEmailUrl('smtp://mailpit:1025')
-* @example parseEmailUrl('smtps://AKIA…:…@email-smtp.eu-west-1.amazonaws.com:465')
-* @example parseEmailUrl('smtp://resend:re_123@smtp.resend.com:587')
-*/
-function parseEmailUrl(url) {
-	let parsed;
-	try {
-		parsed = new URL(url);
-	} catch {
-		throw new require_errors.MalformedEmailUrl(url);
-	}
-	if (parsed.protocol !== "smtp:" && parsed.protocol !== "smtps:") throw new require_errors.UnsupportedEmailScheme(url, parsed.protocol);
-	const secure = parsed.protocol === "smtps:";
-	const config = {
-		host: parsed.hostname,
-		port: parsed.port ? Number(parsed.port) : DEFAULT_PORT[parsed.protocol],
-		secure
-	};
-	if (parsed.username) config.auth = {
-		user: decodeURIComponent(parsed.username),
-		pass: decodeURIComponent(parsed.password)
-	};
-	if (parsed.searchParams.get("insecure") === "true") config.tls = { rejectUnauthorized: false };
-	return config;
-}
-//#endregion
-exports.parseEmailUrl = parseEmailUrl;
-
-//# sourceMappingURL=url.cjs.map

package/dist/url.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"url.cjs","names":["MalformedEmailUrl","UnsupportedEmailScheme"],"sources":["../src/url.ts"],"sourcesContent":["/**\n * `smtp://` — the one URL shape an email construct ever provides.\n *\n * Every provider is reached the same way: Mailpit locally, SES through its SMTP\n * interface, Resend and Postmark through theirs. So there is no scheme-keyed\n * driver registry here as there is in `@geekmidas/storage` — one transport, one\n * parser, and the client never branches on who is delivering the mail.\n *\n * What varies between providers is confined to the URL: host, port, and\n * credentials. That is what lets the same handler source run against Mailpit and\n * against SES without a conditional.\n */\n\nimport { MalformedEmailUrl, UnsupportedEmailScheme } from './errors';\nimport type { SMTPConfig } from './types';\n\n/**\n * The port to use when the URL names none.\n *\n * 587 is submission-with-STARTTLS, which is what SES, Resend, and Postmark all\n * document; 465 is implicit TLS, which is what `smtps://` means.\n */\nconst DEFAULT_PORT = { 'smtp:': 587, 'smtps:': 465 } as const;\n\n/**\n * Build an SMTP transport config from a `<NAME>_URL`.\n *\n * `smtps://` sets `secure`, which is nodemailer's flag for implicit TLS on\n * connect rather than STARTTLS after `EHLO` — the distinction 465 and 587 carry,\n * and the reason the scheme is worth having rather than inferring from the port.\n *\n * @example parseEmailUrl('smtp://mailpit:1025')\n * @example parseEmailUrl('smtps://AKIA…:…@email-smtp.eu-west-1.amazonaws.com:465')\n * @example parseEmailUrl('smtp://resend:re_123@smtp.resend.com:587')\n */\nexport function parseEmailUrl(url: string): SMTPConfig {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(url);\n\t} catch {\n\t\tthrow new MalformedEmailUrl(url);\n\t}\n\n\tif (parsed.protocol !== 'smtp:' && parsed.protocol !== 'smtps:') {\n\t\tthrow new UnsupportedEmailScheme(url, parsed.protocol);\n\t}\n\n\tconst secure = parsed.protocol === 'smtps:';\n\tconst config: SMTPConfig = {\n\t\thost: parsed.hostname,\n\t\tport: parsed.port ? Number(parsed.port) : DEFAULT_PORT[parsed.protocol],\n\t\tsecure,\n\t};\n\n\t// Mailpit accepts mail unauthenticated, so credentials are optional rather\n\t// than required — omitting `auth` entirely is what nodemailer expects, where\n\t// empty strings would be sent as a real (failing) AUTH exchange.\n\tif (parsed.username) {\n\t\tconfig.auth = {\n\t\t\tuser: decodeURIComponent(parsed.username),\n\t\t\tpass: decodeURIComponent(parsed.password),\n\t\t};\n\t}\n\n\t// Local containers present a self-signed certificate. Rather than have every\n\t// project set this, read it off the URL — the adapter that knows it is\n\t// pointing at a container is the one that can say so.\n\tif (parsed.searchParams.get('insecure') === 'true') {\n\t\tconfig.tls = { rejectUnauthorized: false };\n\t}\n\n\treturn config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAsBA,MAAM,eAAe;CAAE,SAAS;CAAK,UAAU;AAAI;;;;;;;;;;;;AAanD,SAAgB,cAAc,KAAyB;CACtD,IAAI;CACJ,IAAI;EACH,SAAS,IAAI,IAAI,GAAG;CACrB,QAAQ;EACP,MAAM,IAAIA,eAAAA,kBAAkB,GAAG;CAChC;CAEA,IAAI,OAAO,aAAa,WAAW,OAAO,aAAa,UACtD,MAAM,IAAIC,eAAAA,uBAAuB,KAAK,OAAO,QAAQ;CAGtD,MAAM,SAAS,OAAO,aAAa;CACnC,MAAM,SAAqB;EAC1B,MAAM,OAAO;EACb,MAAM,OAAO,OAAO,OAAO,OAAO,IAAI,IAAI,aAAa,OAAO;EAC9D;CACD;CAKA,IAAI,OAAO,UACV,OAAO,OAAO;EACb,MAAM,mBAAmB,OAAO,QAAQ;EACxC,MAAM,mBAAmB,OAAO,QAAQ;CACzC;CAMD,IAAI,OAAO,aAAa,IAAI,UAAU,MAAM,QAC3C,OAAO,MAAM,EAAE,oBAAoB,MAAM;CAG1C,OAAO;AACR"}

package/dist/url.d.cts

@@ -1,16 +0,0 @@
-import { SMTPConfig } from "./types.cjs";
-//#region src/url.d.ts
-/**
- * Build an SMTP transport config from a `<NAME>_URL`.
- *
- * `smtps://` sets `secure`, which is nodemailer's flag for implicit TLS on
- * connect rather than STARTTLS after `EHLO` — the distinction 465 and 587 carry,
- * and the reason the scheme is worth having rather than inferring from the port.
- *
- * @example parseEmailUrl('smtp://mailpit:1025')
- * @example parseEmailUrl('smtps://AKIA…:…@email-smtp.eu-west-1.amazonaws.com:465')
- * @example parseEmailUrl('smtp://resend:re_123@smtp.resend.com:587')
- */
-export declare function parseEmailUrl(url: string): SMTPConfig;
-//#endregion
-//# sourceMappingURL=url.d.cts.map

package/dist/url.d.cts.map

@@ -1 +0,0 @@
-{"version":3,"file":"url.d.cts","names":[],"sources":["../src/url.ts"],"mappings":";;;;;;;;;;;;;wBAmCgB,cAAc,cAAc"}

package/dist/url.d.mts

@@ -1,16 +0,0 @@
-import { SMTPConfig } from "./types.mjs";
-//#region src/url.d.ts
-/**
- * Build an SMTP transport config from a `<NAME>_URL`.
- *
- * `smtps://` sets `secure`, which is nodemailer's flag for implicit TLS on
- * connect rather than STARTTLS after `EHLO` — the distinction 465 and 587 carry,
- * and the reason the scheme is worth having rather than inferring from the port.
- *
- * @example parseEmailUrl('smtp://mailpit:1025')
- * @example parseEmailUrl('smtps://AKIA…:…@email-smtp.eu-west-1.amazonaws.com:465')
- * @example parseEmailUrl('smtp://resend:re_123@smtp.resend.com:587')
- */
-export declare function parseEmailUrl(url: string): SMTPConfig;
-//#endregion
-//# sourceMappingURL=url.d.mts.map

package/dist/url.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"url.d.mts","names":[],"sources":["../src/url.ts"],"mappings":";;;;;;;;;;;;;wBAmCgB,cAAc,cAAc"}

package/dist/url.mjs

@@ -1,60 +0,0 @@
-import { MalformedEmailUrl, UnsupportedEmailScheme } from "./errors.mjs";
-//#region src/url.ts
-/**
-* `smtp://` — the one URL shape an email construct ever provides.
-*
-* Every provider is reached the same way: Mailpit locally, SES through its SMTP
-* interface, Resend and Postmark through theirs. So there is no scheme-keyed
-* driver registry here as there is in `@geekmidas/storage` — one transport, one
-* parser, and the client never branches on who is delivering the mail.
-*
-* What varies between providers is confined to the URL: host, port, and
-* credentials. That is what lets the same handler source run against Mailpit and
-* against SES without a conditional.
-*/
-/**
-* The port to use when the URL names none.
-*
-* 587 is submission-with-STARTTLS, which is what SES, Resend, and Postmark all
-* document; 465 is implicit TLS, which is what `smtps://` means.
-*/
-const DEFAULT_PORT = {
-	"smtp:": 587,
-	"smtps:": 465
-};
-/**
-* Build an SMTP transport config from a `<NAME>_URL`.
-*
-* `smtps://` sets `secure`, which is nodemailer's flag for implicit TLS on
-* connect rather than STARTTLS after `EHLO` — the distinction 465 and 587 carry,
-* and the reason the scheme is worth having rather than inferring from the port.
-*
-* @example parseEmailUrl('smtp://mailpit:1025')
-* @example parseEmailUrl('smtps://AKIA…:…@email-smtp.eu-west-1.amazonaws.com:465')
-* @example parseEmailUrl('smtp://resend:re_123@smtp.resend.com:587')
-*/
-function parseEmailUrl(url) {
-	let parsed;
-	try {
-		parsed = new URL(url);
-	} catch {
-		throw new MalformedEmailUrl(url);
-	}
-	if (parsed.protocol !== "smtp:" && parsed.protocol !== "smtps:") throw new UnsupportedEmailScheme(url, parsed.protocol);
-	const secure = parsed.protocol === "smtps:";
-	const config = {
-		host: parsed.hostname,
-		port: parsed.port ? Number(parsed.port) : DEFAULT_PORT[parsed.protocol],
-		secure
-	};
-	if (parsed.username) config.auth = {
-		user: decodeURIComponent(parsed.username),
-		pass: decodeURIComponent(parsed.password)
-	};
-	if (parsed.searchParams.get("insecure") === "true") config.tls = { rejectUnauthorized: false };
-	return config;
-}
-//#endregion
-export { parseEmailUrl };
-
-//# sourceMappingURL=url.mjs.map

package/dist/url.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"url.mjs","names":[],"sources":["../src/url.ts"],"sourcesContent":["/**\n * `smtp://` — the one URL shape an email construct ever provides.\n *\n * Every provider is reached the same way: Mailpit locally, SES through its SMTP\n * interface, Resend and Postmark through theirs. So there is no scheme-keyed\n * driver registry here as there is in `@geekmidas/storage` — one transport, one\n * parser, and the client never branches on who is delivering the mail.\n *\n * What varies between providers is confined to the URL: host, port, and\n * credentials. That is what lets the same handler source run against Mailpit and\n * against SES without a conditional.\n */\n\nimport { MalformedEmailUrl, UnsupportedEmailScheme } from './errors';\nimport type { SMTPConfig } from './types';\n\n/**\n * The port to use when the URL names none.\n *\n * 587 is submission-with-STARTTLS, which is what SES, Resend, and Postmark all\n * document; 465 is implicit TLS, which is what `smtps://` means.\n */\nconst DEFAULT_PORT = { 'smtp:': 587, 'smtps:': 465 } as const;\n\n/**\n * Build an SMTP transport config from a `<NAME>_URL`.\n *\n * `smtps://` sets `secure`, which is nodemailer's flag for implicit TLS on\n * connect rather than STARTTLS after `EHLO` — the distinction 465 and 587 carry,\n * and the reason the scheme is worth having rather than inferring from the port.\n *\n * @example parseEmailUrl('smtp://mailpit:1025')\n * @example parseEmailUrl('smtps://AKIA…:…@email-smtp.eu-west-1.amazonaws.com:465')\n * @example parseEmailUrl('smtp://resend:re_123@smtp.resend.com:587')\n */\nexport function parseEmailUrl(url: string): SMTPConfig {\n\tlet parsed: URL;\n\ttry {\n\t\tparsed = new URL(url);\n\t} catch {\n\t\tthrow new MalformedEmailUrl(url);\n\t}\n\n\tif (parsed.protocol !== 'smtp:' && parsed.protocol !== 'smtps:') {\n\t\tthrow new UnsupportedEmailScheme(url, parsed.protocol);\n\t}\n\n\tconst secure = parsed.protocol === 'smtps:';\n\tconst config: SMTPConfig = {\n\t\thost: parsed.hostname,\n\t\tport: parsed.port ? Number(parsed.port) : DEFAULT_PORT[parsed.protocol],\n\t\tsecure,\n\t};\n\n\t// Mailpit accepts mail unauthenticated, so credentials are optional rather\n\t// than required — omitting `auth` entirely is what nodemailer expects, where\n\t// empty strings would be sent as a real (failing) AUTH exchange.\n\tif (parsed.username) {\n\t\tconfig.auth = {\n\t\t\tuser: decodeURIComponent(parsed.username),\n\t\t\tpass: decodeURIComponent(parsed.password),\n\t\t};\n\t}\n\n\t// Local containers present a self-signed certificate. Rather than have every\n\t// project set this, read it off the URL — the adapter that knows it is\n\t// pointing at a container is the one that can say so.\n\tif (parsed.searchParams.get('insecure') === 'true') {\n\t\tconfig.tls = { rejectUnauthorized: false };\n\t}\n\n\treturn config;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAsBA,MAAM,eAAe;CAAE,SAAS;CAAK,UAAU;AAAI;;;;;;;;;;;;AAanD,SAAgB,cAAc,KAAyB;CACtD,IAAI;CACJ,IAAI;EACH,SAAS,IAAI,IAAI,GAAG;CACrB,QAAQ;EACP,MAAM,IAAI,kBAAkB,GAAG;CAChC;CAEA,IAAI,OAAO,aAAa,WAAW,OAAO,aAAa,UACtD,MAAM,IAAI,uBAAuB,KAAK,OAAO,QAAQ;CAGtD,MAAM,SAAS,OAAO,aAAa;CACnC,MAAM,SAAqB;EAC1B,MAAM,OAAO;EACb,MAAM,OAAO,OAAO,OAAO,OAAO,IAAI,IAAI,aAAa,OAAO;EAC9D;CACD;CAKA,IAAI,OAAO,UACV,OAAO,OAAO;EACb,MAAM,mBAAmB,OAAO,QAAQ;EACxC,MAAM,mBAAmB,OAAO,QAAQ;CACzC;CAMD,IAAI,OAAO,aAAa,IAAI,UAAU,MAAM,QAC3C,OAAO,MAAM,EAAE,oBAAoB,MAAM;CAG1C,OAAO;AACR"}