@visulima/email 1.0.0-alpha.34 → 1.0.0-alpha.36

package/dist/template-engines/i18n.d.ts

@@ -0,0 +1,61 @@
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
+/**
+* A map of locale code (e.g. `en`, `en-US`, `de`) to that locale's template.
+*
+* The template value is whatever the underlying {@link TemplateRenderer} accepts (a string for
+* Handlebars/MJML/Liquid, a component for react-email/jsx-email, etc.).
+*/
+type LocaleTemplates = Record<string, unknown>;
+/**
+* Options for {@link renderI18n} and {@link createI18nRenderer}.
+*/
+interface I18nRenderOptions {
+  /**
+  * Locale to fall back to when the requested locale (and its language root) is missing.
+  */
+  defaultLocale?: string;
+  /**
+  * Options forwarded to the underlying renderer.
+  */
+  rendererOptions?: Record<string, unknown>;
+}
+/**
+* Resolves the best-matching available locale key: exact match, then the language subtag
+* (`en-US` → `en`), then the default locale.
+* @param templates The available locale templates.
+* @param locale The requested locale.
+* @param defaultLocale Optional fallback locale.
+* @returns The matching key, or `undefined` when nothing matches.
+*/
+declare const resolveLocale: (templates: LocaleTemplates, locale: string, defaultLocale?: string) => string | undefined;
+/**
+* Renders the template for a given locale using the supplied engine, with locale fallback.
+* @param templates The per-locale templates. See {@link LocaleTemplates}.
+* @param locale The requested locale (e.g. `de-AT`).
+* @param renderer The underlying template engine (Handlebars, MJML, Liquid, react-email, …).
+* @param data Data/variables passed to the renderer.
+* @param options Fallback locale and renderer options. See {@link I18nRenderOptions}.
+* @returns The rendered output for the resolved locale.
+* @throws {EmailError} When no template matches the locale or the fallback.
+*/
+declare const renderI18n: (templates: LocaleTemplates, locale: string, renderer: TemplateRenderer, data?: Record<string, unknown>, options?: I18nRenderOptions) => Promise<string>;
+/**
+* A locale-resolving renderer produced by {@link createI18nRenderer}.
+*/
+type LocalizedRenderer = (templates: LocaleTemplates, locale: string, data?: Record<string, unknown>, rendererOptions?: Record<string, unknown>) => Promise<string>;
+/**
+* Creates a reusable localized renderer bound to an engine and default locale.
+* @param renderer The underlying template engine.
+* @param defaultLocale Optional default/fallback locale applied to every call.
+* @returns A {@link LocalizedRenderer}.
+* @example
+* ```ts
+* import { renderHandlebars } from "@visulima/email/template/handlebars";
+* import { createI18nRenderer } from "@visulima/email/template/i18n";
+*
+* const render = createI18nRenderer(renderHandlebars, "en");
+* await render({ en: "Hello {{name}}", de: "Hallo {{name}}" }, "de", { name: "Ada" });
+* ```
+*/
+declare const createI18nRenderer: (renderer: TemplateRenderer, defaultLocale?: string) => LocalizedRenderer;
+export { I18nRenderOptions, LocaleTemplates, LocalizedRenderer, createI18nRenderer, renderI18n, resolveLocale };

package/dist/template-engines/i18n.js

@@ -0,0 +1 @@
+import l from"../packem_shared/EmailError-B-sEf3bp.js";const c=(t,r,a)=>{const n=new Map(Object.keys(t).map(o=>[o.toLowerCase(),o])),e=o=>{if(o!==void 0)return n.get(o.toLowerCase())};return e(r)??e(r.split("-")[0])??e(a)},d=async(t,r,a,n,e)=>{const o=c(t,r,e?.defaultLocale);if(o===void 0)throw new l("i18n",`No template found for locale "${r}"${e?.defaultLocale?` or default "${e.defaultLocale}"`:""}`);return await a(t[o],n,e?.rendererOptions)},f=(t,r)=>(a,n,e,o)=>d(a,n,t,e,{defaultLocale:r,rendererOptions:o});export{f as createI18nRenderer,d as renderI18n,c as resolveLocale};

package/dist/template-engines/jsx-email.d.ts

@@ -0,0 +1,11 @@
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
+/**
+* Renders a [jsx-email](https://jsx.email/) component to HTML.
+* @param template The jsx-email component element to render.
+* @param _data Data object (unused; jsx-email components receive props directly).
+* @param options Render options (`plainText`, `pretty`).
+* @returns The rendered HTML (or plain text) string.
+* @throws {EmailError} When `jsx-email` is not installed or rendering fails.
+*/
+declare const jsxEmail: TemplateRenderer;
+export { jsxEmail as default };

package/dist/template-engines/jsx-email.js

@@ -0,0 +1 @@
+import t from"../packem_shared/EmailError-B-sEf3bp.js";const l=async(n,s,a)=>{try{const{render:e}=await import("jsx-email");return await e(n,{plainText:a?.plainText,pretty:a?.pretty})}catch(e){throw e instanceof Error&&(e.code==="ERR_MODULE_NOT_FOUND"||e.message.includes("Cannot find module")||e.message.includes("Cannot find package"))?new t("jsx-email","jsx-email is not installed. Please install it: pnpm add jsx-email",{cause:e}):new t("jsx-email",`Failed to render jsx-email component: ${e.message}`,{cause:e})}};export{l as default};

package/dist/template-engines/liquid.d.ts

@@ -0,0 +1,12 @@
+import { T as TemplateRenderer } from "../packem_shared/types.d-nyR1ty1Q.js";
+/**
+* Renders a [LiquidJS](https://liquidjs.com/) template to a string.
+* @param template The Liquid template string.
+* @param data The data/variables exposed to the template.
+* @param options LiquidJS engine options (passed to the `Liquid` constructor).
+* @returns The rendered output.
+* @throws {TypeError} When the template is not a string.
+* @throws {EmailError} When `liquidjs` is not installed or rendering fails.
+*/
+declare const liquid: TemplateRenderer;
+export { liquid as default };

package/dist/template-engines/liquid.js

@@ -0,0 +1 @@
+import t from"../packem_shared/EmailError-B-sEf3bp.js";const r=async(i,a,n)=>{try{if(typeof i!="string")throw new TypeError("Liquid template must be a string");const{Liquid:e}=await import("liquidjs");return await new e(n??{}).parseAndRender(i,a??{})}catch(e){throw e instanceof TypeError?e:e instanceof Error&&(e.code==="ERR_MODULE_NOT_FOUND"||e.message.includes("Cannot find module")||e.message.includes("Cannot find package"))?new t("liquid","liquidjs is not installed. Please install it: pnpm add liquidjs",{cause:e}):new t("liquid",`Failed to render Liquid template: ${e.message}`,{cause:e})}};export{r as default};

package/dist/template-engines/mjml.js

@@ -1 +1 @@
-var i=Object.defineProperty;var a=(t,o)=>i(t,"name",{value:o,configurable:!0});import l from"mjml";import r from"../packem_shared/EmailError-zm2ffVav.js";var f=Object.defineProperty,d=a((t,o)=>f(t,"name",{value:o,configurable:!0}),"o");const v=d((t,o,n)=>{try{if(typeof t!="string")throw new TypeError("MJML template must be a string");const e=l(t,{beautify:n?.beautify??!1,fonts:n?.fonts,keepComments:n?.keepComments??!0,minify:n?.minify??!1,validationLevel:n?.validationLevel??"soft"});if(e.errors&&e.errors.length>0){const s=e.errors.map(m=>m.message).join("; ");throw new r("mjml",`MJML validation errors: ${s}`)}return e.html}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new r("mjml","MJML is not installed. Please install it: pnpm add mjml",{cause:e}):e instanceof r?e:new r("mjml",`Failed to render MJML: ${e.message}`,{cause:e})}},"mjml");export{v as default};
+import r from"mjml";import n from"../packem_shared/EmailError-B-sEf3bp.js";const f=(s,i,t)=>{try{if(typeof s!="string")throw new TypeError("MJML template must be a string");const e=r(s,{beautify:t?.beautify??!1,fonts:t?.fonts,keepComments:t?.keepComments??!0,minify:t?.minify??!1,validationLevel:t?.validationLevel??"soft"});if(e.errors&&e.errors.length>0){const o=e.errors.map(a=>a.message).join("; ");throw new n("mjml",`MJML validation errors: ${o}`)}return e.html}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new n("mjml","MJML is not installed. Please install it: pnpm add mjml",{cause:e}):e instanceof n?e:new n("mjml",`Failed to render MJML: ${e.message}`,{cause:e})}};export{f as default};

package/dist/template-engines/react-email.js

@@ -1 +1 @@
-var l=Object.defineProperty;var n=(e,t)=>l(e,"name",{value:t,configurable:!0});import{render as c}from"@react-email/render";import i from"../packem_shared/EmailError-zm2ffVav.js";var o=Object.defineProperty,m=n((e,t)=>o(e,"name",{value:t,configurable:!0}),"t");const u=m(async(e,t,r)=>{try{return await c(e,{plainText:r?.plainText,pretty:r?.pretty})}catch(a){throw a instanceof Error&&a.message.includes("Cannot find module")?new i("react-email","@react-email/render is not installed. Please install it: pnpm add @react-email/render",{cause:a}):new i("react-email",`Failed to render React Email component: ${a.message}`,{cause:a})}},"reactEmail");export{u as default};
+import{render as n}from"@react-email/render";import a from"../packem_shared/EmailError-B-sEf3bp.js";const s=async(r,i,t)=>{try{return await n(r,{plainText:t?.plainText,pretty:t?.pretty})}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new a("react-email","@react-email/render is not installed. Please install it: pnpm add @react-email/render",{cause:e}):new a("react-email",`Failed to render React Email component: ${e.message}`,{cause:e})}};export{s as default};

package/dist/template-engines/vue-email.js

@@ -1 +1 @@
-var l=Object.defineProperty;var r=(e,a)=>l(e,"name",{value:a,configurable:!0});import{render as o}from"@vue-email/render";import i from"../packem_shared/EmailError-zm2ffVav.js";var m=Object.defineProperty,s=r((e,a)=>m(e,"name",{value:a,configurable:!0}),"a");const c=s(async(e,a,n)=>{try{return await o(e,a??{},{htmlToTextOptions:n?.htmlToTextOptions,plainText:n?.plainText,pretty:n?.pretty})}catch(t){throw t instanceof Error&&t.message.includes("Cannot find module")?new i("vue-email","@vue-email/render is not installed. Please install it: pnpm add @vue-email/render",{cause:t}):new i("vue-email",`Failed to render Vue Email component: ${t.message}`,{cause:t})}},"vueEmail");export{c as default};
+import{render as i}from"@vue-email/render";import a from"../packem_shared/EmailError-B-sEf3bp.js";const s=async(n,r,t)=>{try{return await i(n,r??{},{htmlToTextOptions:t?.htmlToTextOptions,plainText:t?.plainText,pretty:t?.pretty})}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new a("vue-email","@vue-email/render is not installed. Please install it: pnpm add @vue-email/render",{cause:e}):new a("vue-email",`Failed to render Vue Email component: ${e.message}`,{cause:e})}};export{s as default};

package/dist/test/index.d.ts

@@ -0,0 +1,159 @@
+import { a as MockEmailEntry } from "../packem_shared/types.d-DCkecJse.js";
+import { E as EmailOptions } from "../packem_shared/types.d-ejzh-xBP.js";
+import { M as Mail } from "../packem_shared/mail.d-B9SSqyy0.js";
+import 'node:buffer';
+import 'ical-generator';
+import 'node:crypto';
+import "../packem_shared/types.d-BId55FW2.js";
+import "../packem_shared/types.d-nyR1ty1Q.js";
+import "../packem_shared/types.d-Mpu0HZoG.js";
+import "../packem_shared/provider.d-J-y6iogK.js";
+/**
+* A test harness around the in-memory mock provider: a ready-to-use {@link Mail} instance plus
+* helpers to inspect, wait on, and reset the captured outbox.
+*/
+interface TestEmail {
+  /**
+  * The {@link Mail} instance wired to the mock provider. Use it exactly like a real one.
+  */
+  mail: Mail;
+  /**
+  * Removes all captured messages.
+  */
+  reset: () => void;
+  /**
+  * Returns the captured messages, oldest first.
+  */
+  sent: () => ReadonlyArray<MockEmailEntry>;
+  /**
+  * Resolves with the first captured message matching `predicate`, polling until `timeout`.
+  * @param predicate The match condition.
+  * @param options Optional `timeout` (ms, default 1000) and `interval` (ms, default 10).
+  * @param options.interval Poll interval in milliseconds.
+  * @param options.timeout Maximum time to wait in milliseconds.
+  */
+  waitFor: (predicate: (message: MockEmailEntry) => boolean, options?: {
+    interval?: number;
+    timeout?: number;
+  }) => Promise<MockEmailEntry>;
+}
+/**
+* Creates a {@link TestEmail} harness backed by the in-memory mock provider.
+*
+* Nothing is sent over the network; every message is captured for assertion via the
+* {@link https://vitest.dev/ Vitest} matchers exported from `@visulima/email/test`.
+* @returns The test harness. See {@link TestEmail}.
+* @example
+* ```ts
+* const email = createTestEmail();
+* await email.mail.send({ from: { email: "a@x.com" }, to: { email: "b@x.com" }, subject: "Hi", text: "yo" });
+* expect(email).toHaveSentTo("b@x.com");
+* ```
+*/
+declare const createTestEmail: () => TestEmail;
+/**
+* The minimal result shape a Vitest/Jest matcher must return.
+*/
+interface MatcherResult {
+  message: () => string;
+  pass: boolean;
+}
+/**
+* A value the email matchers can assert against: a {@link TestEmail} harness or a raw list of captured
+* entries.
+*/
+type MatcherTarget = ReadonlyArray<MockEmailEntry> | TestEmail;
+/**
+* Asserts that at least one captured message was addressed to `address` (in To, Cc, or Bcc).
+* @param target The {@link TestEmail} harness or captured entries.
+* @param address The recipient address to look for (case-insensitive).
+* @returns The matcher result.
+*/
+declare const toHaveSentTo: (target: MatcherTarget, address: string) => MatcherResult;
+/**
+* Asserts that at least one captured message has a subject equal to (or matching) `expected`.
+* @param target The {@link TestEmail} harness or captured entries.
+* @param expected An exact subject string or a `RegExp`.
+* @returns The matcher result.
+*/
+declare const toHaveSentWithSubject: (target: MatcherTarget, expected: RegExp | string) => MatcherResult;
+/**
+* Asserts that at least one captured message carried an attachment (optionally with a given filename).
+* @param target The {@link TestEmail} harness or captured entries.
+* @param filename When provided, requires an attachment with this exact filename.
+* @returns The matcher result.
+*/
+declare const toHaveSentWithAttachment: (target: MatcherTarget, filename?: string) => MatcherResult;
+/**
+* Asserts that at least one captured message matches a predicate or a partial {@link EmailOptions}.
+* @param target The {@link TestEmail} harness or captured entries.
+* @param matcher A predicate over the sent options, or a partial options object to shallow-match.
+* @returns The matcher result.
+*/
+declare const toHaveSentMatching: (target: MatcherTarget, matcher: Partial<EmailOptions> | ((options: EmailOptions) => boolean)) => MatcherResult;
+/**
+* The matcher map, suitable for passing to Vitest/Jest `expect.extend(...)`.
+*/
+declare const emailMatchers: {
+  toHaveSentMatching: typeof toHaveSentMatching;
+  toHaveSentTo: typeof toHaveSentTo;
+  toHaveSentWithAttachment: typeof toHaveSentWithAttachment;
+  toHaveSentWithSubject: typeof toHaveSentWithSubject;
+};
+/**
+* The shape of the {@link emailMatchers} map.
+*/
+
+/**
+* A Vitest/Jest-compatible `expect` exposing `.extend(...)`.
+*/
+interface ExpectLike {
+  extend: (matchers: Record<string, unknown>) => void;
+}
+/**
+* Registers the email matchers with a Vitest/Jest-compatible `expect`.
+*
+* Kept dependency-free by accepting `expect` as an argument rather than importing `vitest` into the
+* shipped bundle. Add the matching type augmentation to a `vitest.d.ts` in your project for typed
+* `expect(...).toHaveSentTo(...)` calls.
+* @param expectInstance The `expect` object exposing `.extend(...)`.
+* @example
+* ```ts
+* import { expect } from "vitest";
+* import { registerEmailMatchers } from "@visulima/email/test";
+*
+* registerEmailMatchers(expect);
+* ```
+*/
+declare const registerEmailMatchers: (expectInstance: ExpectLike) => void;
+/**
+* A stable, snapshot-friendly view of a sent message — volatile fields (message id, timestamp) are
+* omitted so the snapshot doesn't churn between runs.
+*/
+interface EmailSnapshot {
+  attachments?: {
+    contentType?: string;
+    filename: string;
+  }[];
+  bcc?: string[];
+  cc?: string[];
+  from: string;
+  headers?: Record<string, string>;
+  html?: string;
+  replyTo?: string;
+  subject: string;
+  text?: string;
+  to: string[];
+}
+/**
+* Normalizes a captured message (a `createTestEmail` outbox entry or raw {@link EmailOptions}) into a
+* deterministic {@link EmailSnapshot} for use with Vitest/Jest `toMatchSnapshot()`.
+* @param source A mock-provider outbox entry or an `EmailOptions` object.
+* @returns The snapshot view.
+* @example
+* ```ts
+* expect(toEmailSnapshot(email.sent()[0])).toMatchSnapshot();
+* ```
+*/
+declare const toEmailSnapshot: (source: EmailOptions | MockEmailEntry) => EmailSnapshot;
+export { type EmailSnapshot, type MatcherResult, type MatcherTarget, type TestEmail, createTestEmail, emailMatchers, registerEmailMatchers, toEmailSnapshot, toHaveSentMatching, toHaveSentTo, toHaveSentWithAttachment, toHaveSentWithSubject };

package/dist/test/index.js

@@ -0,0 +1 @@
+import{emailMatchers as a,registerEmailMatchers as o,toHaveSentMatching as r,toHaveSentTo as i,toHaveSentWithAttachment as m,toHaveSentWithSubject as h}from"../packem_shared/emailMatchers-DZDkrZ_3.js";import{toEmailSnapshot as c}from"../packem_shared/toEmailSnapshot-DeRqM5SJ.js";import{createTestEmail as s}from"../packem_shared/createTestEmail-BM3iNznm.js";export{s as createTestEmail,a as emailMatchers,o as registerEmailMatchers,c as toEmailSnapshot,r as toHaveSentMatching,i as toHaveSentTo,m as toHaveSentWithAttachment,h as toHaveSentWithSubject};

package/dist/utils/cache.js

@@ -1 +1 @@
-var h=Object.defineProperty;var r=(c,e)=>h(c,"name",{value:e,configurable:!0});import{LRUCache as n}from"lru-cache";var l=Object.defineProperty,t=r((c,e)=>l(c,"name",{value:e,configurable:!0}),"t");class m{static{r(this,"InMemoryCache")}static{t(this,"InMemoryCache")}cache;constructor(e={}){const{max:a=500,ttl:s=36e5}=e;this.cache=new n({max:a,ttl:s})}clear=t(async()=>{this.cache.clear()},"clear");delete=t(async e=>{this.cache.delete(e)},"delete");get=t(async e=>this.cache.get(e),"get");set=t(async(e,a,s)=>{this.cache.set(e,a,{ttl:s})},"set")}export{m as InMemoryCache};
+import{LRUCache as a}from"lru-cache";class l{cache;constructor(c={}){const{max:e=500,ttl:t=36e5}=c;this.cache=new a({max:e,ttl:t})}clear=async()=>{this.cache.clear()};delete=async c=>{this.cache.delete(c)};get=async c=>this.cache.get(c);set=async(c,e,t)=>{this.cache.set(c,e,{ttl:t})}}export{l as InMemoryCache};

package/dist/utils/format-email-address.d.ts

@@ -1,4 +1,4 @@
-import { b as EmailAddress } from "../packem_shared/types.d-wwpgA3to.js";
+import { c as EmailAddress } from "../packem_shared/types.d-ejzh-xBP.js";
 import 'node:buffer';
 /**
 * Formats an email address as "Name <email@example.com>" or just "email@example.com" if no name is provided.

package/dist/utils/format-email-address.js

@@ -1 +1 @@
-var m=Object.defineProperty;var r=(e,a)=>m(e,"name",{value:a,configurable:!0});import o from"../packem_shared/EmailError-zm2ffVav.js";import{s as l}from"../packem_shared/sanitize-header-wWav-Scu.js";import t from"./validation/validate-email.js";var i=Object.defineProperty,n=r((e,a)=>i(e,"name",{value:a,configurable:!0}),"m");const p=n(e=>{if(!t(e.email))throw new o("email",`Invalid email address: ${e.email}`);return e.name?`${l(e.name)} <${e.email}>`:e.email},"formatEmailAddress");export{p as default};
+import{s as m}from"../packem_shared/format-address-DTl-9O70.js";import r from"../packem_shared/EmailError-B-sEf3bp.js";import i from"./validation/validate-email.js";const n=a=>{if(!i(a.email))throw new r("email",`Invalid email address: ${a.email}`);if(a.name){const e=m(a.name);if(e)return`"${e}" <${a.email}>`}return a.email};export{n as default};

package/dist/utils/normalize-email-aliases.js

@@ -1 +1 @@
-var a=Object.defineProperty;var l=(o,e)=>a(o,"name",{value:e,configurable:!0});var g=Object.defineProperty,u=l((o,e)=>g(o,"name",{value:e,configurable:!0}),"m");const c=new Map([["fastmail.com",{domain:"fastmail.com",ignoreDots:!1,ignorePlus:!0}],["gmail.com",{domain:"gmail.com",ignoreDots:!0,ignorePlus:!0}],["gmx.com",{domain:"gmx.com",ignoreDots:!1,ignorePlus:!0}],["gmx.de",{domain:"gmx.de",ignoreDots:!1,ignorePlus:!0}],["gmx.net",{domain:"gmx.net",ignoreDots:!1,ignorePlus:!0}],["hotmail.com",{domain:"hotmail.com",ignoreDots:!1,ignorePlus:!0}],["icloud.com",{domain:"icloud.com",ignoreDots:!1,ignorePlus:!0}],["live.com",{domain:"live.com",ignoreDots:!1,ignorePlus:!0}],["mail.com",{domain:"mail.com",ignoreDots:!1,ignorePlus:!0}],["msn.com",{domain:"msn.com",ignoreDots:!1,ignorePlus:!0}],["outlook.com",{domain:"outlook.com",ignoreDots:!1,ignorePlus:!0}],["protonmail.com",{domain:"protonmail.com",ignoreDots:!1,ignorePlus:!0}],["yahoo.com",{domain:"yahoo.com",ignoreDots:!1,ignorePlus:!0}],["zoho.com",{domain:"zoho.com",ignoreDots:!1,ignorePlus:!0}]]),d=u(o=>{if(!o||typeof o!="string")return o;const e=o.trim().toLowerCase(),n=e.indexOf("@");if(n===-1||n===0||n===e.length-1)return o;const m=e.slice(0,n),r=e.slice(n+1);if(!m||!r)return o;const t=c.get(r);if(!t)return e;let i=m;if(t.ignorePlus){const s=i.indexOf("+");s!==-1&&(i=i.slice(0,s))}return t.ignoreDots&&(i=i.replaceAll(".","")),`${i}@${r}`},"normalizeEmailAliases");export{d as default};
+const l=new Map([["fastmail.com",{domain:"fastmail.com",ignoreDots:!1,ignorePlus:!0}],["gmail.com",{domain:"gmail.com",ignoreDots:!0,ignorePlus:!0}],["gmx.com",{domain:"gmx.com",ignoreDots:!1,ignorePlus:!0}],["gmx.de",{domain:"gmx.de",ignoreDots:!1,ignorePlus:!0}],["gmx.net",{domain:"gmx.net",ignoreDots:!1,ignorePlus:!0}],["hotmail.com",{domain:"hotmail.com",ignoreDots:!1,ignorePlus:!0}],["icloud.com",{domain:"icloud.com",ignoreDots:!1,ignorePlus:!0}],["live.com",{domain:"live.com",ignoreDots:!1,ignorePlus:!0}],["mail.com",{domain:"mail.com",ignoreDots:!1,ignorePlus:!0}],["msn.com",{domain:"msn.com",ignoreDots:!1,ignorePlus:!0}],["outlook.com",{domain:"outlook.com",ignoreDots:!1,ignorePlus:!0}],["protonmail.com",{domain:"protonmail.com",ignoreDots:!1,ignorePlus:!0}],["yahoo.com",{domain:"yahoo.com",ignoreDots:!1,ignorePlus:!0}],["zoho.com",{domain:"zoho.com",ignoreDots:!1,ignorePlus:!0}]]),a=o=>{if(!o||typeof o!="string")return o;const i=o.trim().toLowerCase(),n=i.indexOf("@");if(n===-1||n===0||n===i.length-1)return o;const s=i.slice(0,n),r=i.slice(n+1);if(!s||!r)return o;const t=l.get(r);if(!t)return i;let e=s;if(t.ignorePlus){const m=e.indexOf("+");m!==-1&&(e=e.slice(0,m))}return t.ignoreDots&&(e=e.replaceAll(".","")),`${e}@${r}`};export{a as default};

package/dist/utils/parse-address.d.ts

@@ -1,4 +1,4 @@
-import { b as EmailAddress } from "../packem_shared/types.d-wwpgA3to.js";
+import { c as EmailAddress } from "../packem_shared/types.d-ejzh-xBP.js";
 import 'node:buffer';
 /**
 * Parses a string representation of an email address into an EmailAddress object.

package/dist/utils/parse-address.js

@@ -1 +1 @@
-var m=Object.defineProperty;var o=(t,e)=>m(t,"name",{value:e,configurable:!0});import d from"./validation/validate-email.js";var h=Object.defineProperty,c=o((t,e)=>h(t,"name",{value:e,configurable:!0}),"l");const g=c(t=>{const e=t.replace(/^"(.+)"$/,"$1");return!(!e||e.length===0||e.includes("..")||e.startsWith(".")||e.endsWith("."))},"isValidLocalPart"),a=c(t=>{const e=t.indexOf("@[");if(e>0&&t.endsWith("]")){const n=t.length-1,l=t.slice(e+2,n);if(l.includes("@["))return!1;const i=t.slice(0,e),s=l;return!s||s.trim().length===0||s.includes("]")?!1:i?g(i):!1}if(t.includes("@[")&&!t.includes("]"))return!1;const r=t.match(/^"((?:[^"\\]|\\.)+)"@(.+)$/);if(r?.[2]){const n=r[2];return n.startsWith("[")?!1:d(`test@${n}`)}return d(t)},"isValidEmailFormat"),$=c(t=>{if(!t||typeof t!="string")return;const e=t.trim();if(!e)return;const r=e.lastIndexOf("<"),n=e.lastIndexOf(">");if(r!==-1&&n>r){const i=e.slice(0,r).trim(),s=e.slice(r+1,n).trim();if(s&&a(s)){if(i){const f=i.replace(/^"(.+)"$/,"$1");return{email:s,name:f}}return{email:s}}}const l=e.match(/^<([^>]+)>$/);if(l?.[1]){const i=l[1].trim();return a(i)?{email:i}:void 0}if(!(e.includes("]")&&!e.includes("@["))&&!(e.includes('"')&&!e.startsWith('"')&&e.indexOf('"')<e.indexOf("@"))){if(e.startsWith('"')){let i=1,s=!1;for(;i<e.length;)if(e[i]==="\\"&&i+1<e.length)i+=2;else if(e[i]==='"'){if(i+1<e.length&&e[i+1]==="@"){s=!0;break}i+=1}else i+=1;if(!s&&e.includes("@")){const f=e.indexOf("@"),u=e.slice(1).indexOf('"');if(u===-1||f<u+1)return}}if(a(e))return{email:e}}},"parseAddress");export{$ as default};
+import u from"./validation/validate-email.js";const d=i=>{const e=i.replace(/^"(.+)"$/,"$1");return!(!e||e.length===0||e.includes("..")||e.startsWith(".")||e.endsWith("."))},c=i=>{const e=i.indexOf("@[");if(e>0&&i.endsWith("]")){const n=i.length-1,l=i.slice(e+2,n);if(l.includes("@["))return!1;const t=i.slice(0,e),s=l;return!s||s.trim().length===0||s.includes("]")?!1:t?d(t):!1}if(i.includes("@[")&&!i.includes("]"))return!1;const r=i.match(/^"((?:[^"\\]|\\.)+)"@(.+)$/);if(r?.[2]){const n=r[2];return n.startsWith("[")?!1:u(`test@${n}`)}return u(i)},h=i=>{if(!i||typeof i!="string")return;const e=i.trim();if(!e)return;const r=e.lastIndexOf("<"),n=e.lastIndexOf(">");if(r!==-1&&n>r){const t=e.slice(0,r).trim(),s=e.slice(r+1,n).trim();if(s&&c(s)){if(t){const f=t.replace(/^"(.+)"$/,"$1");return{email:s,name:f}}return{email:s}}}const l=e.match(/^<([^>]+)>$/);if(l?.[1]){const t=l[1].trim();return c(t)?{email:t}:void 0}if(!(e.includes("]")&&!e.includes("@["))&&!(e.includes('"')&&!e.startsWith('"')&&e.indexOf('"')<e.indexOf("@"))){if(e.startsWith('"')){let t=1,s=!1;for(;t<e.length;)if(e[t]==="\\"&&t+1<e.length)t+=2;else if(e[t]==='"'){if(t+1<e.length&&e[t+1]==="@"){s=!0;break}t+=1}else t+=1;if(!s&&e.includes("@")){const f=e.indexOf("@"),a=e.slice(1).indexOf('"');if(a===-1||f<a+1)return}}if(c(e))return{email:e}}};export{h as default};

package/dist/utils/parse-eml.d.ts

@@ -0,0 +1,22 @@
+import { E as EmailOptions } from "../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* Parses a raw EML / RFC 5322 MIME message back into {@link EmailOptions}.
+*
+* This closes the round-trip story for {@link "../mail".Mail.draft}: serialise a
+* message to EML, persist/transmit it, then `parseEml()` it back into options you
+* can hand to `mail.send()`. It understands the multipart layout produced by this
+* library's own `buildMimeMessage` (text/plain + text/html parts, quoted-printable
+* and base64 transfer encodings, RFC 2047 encoded headers) and common
+* single-part messages.
+*
+* Scope: it extracts `from`, `to`, `cc`, `bcc`, `replyTo`, `subject`, `text`,
+* `html`, `priority`, and remaining custom `headers`. Attachment bodies are not
+* decoded into {@link "../types".Attachment} objects (use a full MIME parser such
+* as `mailparser` for that); attachment parts are skipped.
+* @param eml The raw EML/MIME message string.
+* @returns The parsed email options.
+* @throws {Error} When the message has no `From` or `To`/`Cc`/`Bcc` recipient and therefore cannot satisfy the required {@link EmailOptions} shape.
+*/
+declare const parseEml: (eml: string) => EmailOptions;
+export { parseEml as default };

package/dist/utils/parse-eml.js

@@ -0,0 +1,6 @@
+import y from"./parse-address.js";import{p as $}from"../packem_shared/quoted-printable-nSGDA1tA.js";const T=globalThis.Buffer!==void 0,k=r=>{if(T)return Uint8Array.from(Buffer.from(r,"base64"));const t=atob(r),n=new Uint8Array(t.length);for(let e=0;e<t.length;e+=1)n[e]=t.charCodeAt(e);return n},E=r=>{const t=r.replaceAll("_"," "),n=[];for(let e=0;e<t.length;e+=1){const s=t[e];s==="="&&e+2<t.length?(n.push(Number.parseInt(t.slice(e+1,e+3),16)),e+=2):n.push(s.charCodeAt(0))}return Uint8Array.from(n)},U=/^utf-?8$/i,j=(r,t)=>{if(T&&U.test(t))return Buffer.from(r).toString("utf8");try{return new TextDecoder(t).decode(r)}catch{return new TextDecoder().decode(r)}},D=/=\?([^?]+)\?([bq])\?([^?]*)\?=/gi,M=r=>r.includes("=?")?r.replaceAll(/(\?=)\s+(=\?)/g,"$1$2").replaceAll(D,(t,n,e,s)=>{const o=e.toUpperCase()==="B"?k(s):E(s);return j(o,n)}):r,O=globalThis.Buffer!==void 0,S=/^[ \t]/,q=/boundary=(?:"([^"]+)"|([^";]+))/i,H=/^\r?\n/,L=/[\r\n]+$/,I=/\r?\n$/,N=/\s/g,P=/high|^1|^2/i,_=/low|^4|^5/i,B=r=>{const t=r.replaceAll(`\r
+`,`
+`),n=t.indexOf(`
+
+`),e=n===-1?t:t.slice(0,n),s=n===-1?"":t.slice(n+2),o=[],f=new Map;let i="",c="";const h=()=>{if(i){const a=M(c.trim());o.push([i,a]),f.set(i.toLowerCase(),a)}};for(const a of e.split(`
+`))if(S.test(a)&&i)c+=` ${a.trim()}`;else{h();const d=a.indexOf(":");d===-1?(i="",c=""):(i=a.slice(0,d).trim(),c=a.slice(d+1).trim())}return h(),{body:s,headers:{map:f,raw:o}}},b=r=>{if(!r)return[];const t=[];let n="",e=!1,s=!1;for(const o of r){switch(o){case'"':{e=!e;break}case"<":{s=!0;break}case">":{s=!1;break}}o===","&&!e&&!s?(t.push(n),n=""):n+=o}return n.trim()&&t.push(n),t.map(o=>y(o.trim())).filter(o=>o!==void 0)},F=r=>{if(!r)return;const t=q.exec(r);return t?.[1]??t?.[2]},w=(r,t)=>{const n=(t??"7bit").trim().toLowerCase();if(n==="quoted-printable")return $(r);if(n==="base64"){const e=r.replaceAll(N,"");return O?Buffer.from(e,"base64").toString("utf8"):new TextDecoder().decode(Uint8Array.from(atob(e),s=>s.codePointAt(0)))}return r},V=r=>{const{body:t,headers:n}=B(r),{map:e}=n,s=y(e.get("from")??"");if(!s)throw new Error("Cannot parse EML: missing or invalid `From` header");const o=b(e.get("to")??""),f=b(e.get("cc")??""),i=b(e.get("bcc")??"");if(o.length===0&&f.length===0&&i.length===0)throw new Error("Cannot parse EML: no recipient (`To`/`Cc`/`Bcc`) found");const c={from:s,subject:e.get("subject")??"",to:o.length===1?o[0]:o};f.length>0&&(c.cc=f.length===1?f[0]:f),i.length>0&&(c.bcc=i.length===1?i[0]:i);const h=e.get("reply-to")?y(e.get("reply-to")):void 0;h&&(c.replyTo=h);const a=e.get("content-type"),d=F(a);if(d&&a?.toLowerCase().includes("multipart")){const u=t.split(`--${d}`);for(const l of u){const p=l.replace(H,"");if(!(!p||p.startsWith("--"))){const{body:C,headers:g}=B(p),x=g.map.get("content-type")??"",A=g.map.get("content-transfer-encoding");(g.map.get("content-disposition")??"").toLowerCase().includes("attachment")||(x.toLowerCase().includes("text/plain")?c.text=w(C.replace(L,""),A):x.toLowerCase().includes("text/html")&&(c.html=w(C.replace(L,""),A)))}}}else{const u=e.get("content-transfer-encoding"),l=w(t.replace(I,""),u);a?.toLowerCase().includes("text/html")?c.html=l:l&&(c.text=l)}const v=new Set(["bcc","cc","content-transfer-encoding","content-type","from","mime-version","reply-to","subject","to"]),m={};for(const[u,l]of n.raw){const p=u.toLowerCase();(p==="x-priority"||p==="importance")&&(P.test(l)?c.priority="high":_.test(l)&&(c.priority="low")),v.has(p)||(m[u]=l)}return Object.keys(m).length>0&&(c.headers=m),c};export{V as default};

package/dist/utils/result.d.ts

@@ -0,0 +1,49 @@
+import { R as Result } from "../packem_shared/types.d-ejzh-xBP.js";
+import 'node:buffer';
+/**
+* A successful {@link Result} with its data narrowed to be present.
+*/
+type OkResult<T> = Result<T> & {
+  data: T;
+  success: true;
+};
+/**
+* Returns whether a {@link Result} succeeded, narrowing `data` to be present.
+* @param result The result to test.
+* @returns `true` when the result is successful.
+*/
+declare const isOk: <T>(result: Result<T>) => result is OkResult<T>;
+/**
+* Returns whether a {@link Result} failed.
+* @param result The result to test.
+* @returns `true` when the result is a failure.
+*/
+declare const isErr: <T>(result: Result<T>) => boolean;
+/**
+* Returns the data of a successful {@link Result}, or throws its error.
+* @param result The result to unwrap.
+* @returns The contained data.
+* @throws {EmailError} The result's error (wrapped when it is not already an `Error`).
+*/
+declare const unwrap: <T>(result: Result<T>) => T;
+/**
+* Returns the data of a successful {@link Result}, or a fallback when it failed.
+* @param result The result to unwrap.
+* @param fallback The value to return on failure.
+* @returns The data, or the fallback.
+*/
+declare const unwrapOr: <T>(result: Result<T>, fallback: T) => T;
+/**
+* Maps the data of a successful {@link Result}, passing failures through unchanged.
+* @param result The result to map.
+* @param function_ The mapper applied to the data on success.
+* @returns A new result with the mapped data, or the original failure.
+*/
+declare const mapOk: <T, U>(result: Result<T>, function_: (data: T) => U) => Result<U>;
+/**
+* Runs an async function and captures its outcome as a {@link Result}, never throwing.
+* @param function_ The async function to run.
+* @returns A successful result with the value, or a failed result with the thrown error.
+*/
+declare const tryAsync: <T>(function_: () => Promise<T>) => Promise<Result<T>>;
+export { OkResult, isErr, isOk, mapOk, tryAsync, unwrap, unwrapOr };

package/dist/utils/result.js

@@ -0,0 +1 @@
+import e from"../packem_shared/EmailError-B-sEf3bp.js";const c=s=>s.success,t=s=>!s.success,u=s=>{if(s.success)return s.data;throw s.error instanceof Error?s.error:new e("result","Called unwrap() on a failed result",{cause:s.error})},o=(s,r)=>s.success?s.data:r,n=(s,r)=>s.success?{data:r(s.data),success:!0}:{error:s.error,success:!1},d=async s=>{try{return{data:await s(),success:!0}}catch(r){return{error:r,success:!1}}};export{t as isErr,c as isOk,n as mapOk,d as tryAsync,u as unwrap,o as unwrapOr};

package/dist/utils/validation/check-feature-support.d.ts

@@ -1,4 +1,4 @@
-import { F as FeatureFlags, E as EmailOptions } from "../../packem_shared/types.d-wwpgA3to.js";
+import { F as FeatureFlags, E as EmailOptions } from "../../packem_shared/types.d-ejzh-xBP.js";
 import 'node:buffer';
 /**
 * A single capability that a message uses but the target provider cannot represent.

package/dist/utils/validation/check-feature-support.js

@@ -1 +1 @@
-var i=Object.defineProperty;var l=(e,a)=>i(e,"name",{value:a,configurable:!0});import{i as u}from"../../packem_shared/headers-to-record-Qo124ImV.js";var n=Object.defineProperty,t=l((e,a)=>n(e,"name",{value:a,configurable:!0}),"t");const o=t(e=>Array.isArray(e)&&e.length>0,"hasItems"),c=t((e,a)=>a.find(r=>e[r]!==void 0),"firstSetField"),f=[{detect:t(e=>o(e.attachments)?"attachments":void 0,"detect"),feature:"attachments",label:"attachments"},{detect:t(e=>typeof e.html=="string"&&e.html.length>0?"html":void 0,"detect"),feature:"html",label:"HTML content"},{detect:t(e=>e.replyTo?"replyTo":void 0,"detect"),feature:"replyTo",label:"a reply-to address"},{detect:t(e=>e.headers!==void 0&&Object.keys(u(e.headers)).length>0?"headers":void 0,"detect"),feature:"customHeaders",label:"custom headers"},{detect:t(e=>o(e.tags)?"tags":void 0,"detect"),feature:"tagging",label:"tags"},{detect:t(e=>c(e,["scheduledAt","sendAt"]),"detect"),feature:"scheduling",label:"scheduled delivery"},{detect:t(e=>c(e,["templateId","template"]),"detect"),feature:"templates",label:"provider templates"}];function h(e,a){if(!a)return{supported:!0,violations:[]};const r=[];for(const d of f){if(a[d.feature]!==!1)continue;const s=d.detect(e);s!==void 0&&r.push({feature:d.feature,field:s,message:`Message uses ${d.label} (field "${s}") but the provider does not support the "${d.feature}" capability`})}return{supported:r.length===0,violations:r}}l(h,"f");t(h,"checkFeatureSupport");export{h as default};
+import{s as o}from"../../packem_shared/headers-to-record-De1Eg951.js";const r=e=>Array.isArray(e)&&e.length>0,d=(e,s)=>s.find(t=>e[t]!==void 0),i=[{detect:e=>r(e.attachments)?"attachments":void 0,feature:"attachments",label:"attachments"},{detect:e=>typeof e.html=="string"&&e.html.length>0?"html":void 0,feature:"html",label:"HTML content"},{detect:e=>e.replyTo?"replyTo":void 0,feature:"replyTo",label:"a reply-to address"},{detect:e=>e.headers!==void 0&&Object.keys(o(e.headers)).length>0?"headers":void 0,feature:"customHeaders",label:"custom headers"},{detect:e=>r(e.tags)?"tags":void 0,feature:"tagging",label:"tags"},{detect:e=>d(e,["scheduledAt","sendAt"]),feature:"scheduling",label:"scheduled delivery"},{detect:e=>d(e,["templateId","template"]),feature:"templates",label:"provider templates"}];function u(e,s){if(!s)return{supported:!0,violations:[]};const t=[];for(const a of i){if(s[a.feature]!==!1)continue;const l=a.detect(e);l!==void 0&&t.push({feature:a.feature,field:l,message:`Message uses ${a.label} (field "${l}") but the provider does not support the "${a.feature}" capability`})}return{supported:t.length===0,violations:t}}export{u as default};

package/dist/utils/validation/check-mx-records.d.ts

@@ -1,5 +1,5 @@
 import { Cache } from "../cache.js";
-export { type InMemoryCache } from "../cache.js";
+export type { InMemoryCache } from "../cache.js";
 /**
 * MX record information.
 */

package/dist/utils/validation/check-mx-records.js

@@ -1 +1 @@
-var d=Object.defineProperty;var n=(r,e)=>d(r,"name",{value:e,configurable:!0});import{createRequire as l}from"node:module";const u=l(import.meta.url),c=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,p=n(r=>{if(typeof c<"u"&&c.versions&&c.versions.node){const[e,o]=c.versions.node.split(".").map(Number);if(e>22||e===22&&o>=3||e===20&&o>=16)return c.getBuiltinModule(r)}return u(r)},"__cjs_getBuiltinModule"),{resolveMx:h}=p("node:dns/promises");var f=Object.defineProperty,g=n((r,e)=>f(r,"name",{value:e,configurable:!0}),"h");const v=g(async(r,e={})=>{const o=e.ttl??36e5;if(e.cache){const t=await e.cache.get(r);if(t!==void 0)return t}try{const t=(await h(r)).map(i=>({exchange:i.exchange,priority:i.priority})),s={records:t.toSorted((i,a)=>i.priority-a.priority),valid:t.length>0};return e.cache&&await e.cache.set(r,s,o),s}catch(t){const s={error:t instanceof Error?t.message:String(t),valid:!1};return e.cache&&await e.cache.set(r,s,o),s}},"checkMxRecords");export{v as checkMxRecords};
+import{createRequire as a}from"node:module";const d=a(import.meta.url),c=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,l=o=>{if(typeof c<"u"&&c.versions&&c.versions.node){const[e,s]=c.versions.node.split(".").map(Number);if(e>22||e===22&&s>=3||e===20&&s>=16)return c.getBuiltinModule(o)}return d(o)},{resolveMx:p}=l("node:dns/promises"),h=async(o,e={})=>{const s=e.ttl??36e5;if(e.cache){const r=await e.cache.get(o);if(r!==void 0)return r}try{const r=(await p(o)).map(i=>({exchange:i.exchange,priority:i.priority})),t={records:r.toSorted((i,n)=>i.priority-n.priority),valid:r.length>0};return e.cache&&await e.cache.set(o,t,s),t}catch(r){const t={error:r instanceof Error?r.message:String(r),valid:!1};return e.cache&&await e.cache.set(o,t,s),t}};export{h as checkMxRecords};

package/dist/utils/validation/role-accounts.js

@@ -1 +1 @@
-var l=Object.defineProperty;var u=(e,r)=>l(e,"name",{value:r,configurable:!0});var p=Object.defineProperty,i=u((e,r)=>p(e,"name",{value:r,configurable:!0}),"n");const m=new Set(["abuse","accounts","admin","adminhelp","administrator","adminoffice","adminteam","affiliates","alarms","alert","alternative","analytics","anonymous","archive","audit","automated","autoreply","backoffice","backup","batch","billing","board","bot","bounce","bug","bugreport","build","careers","cert","chapter","chatbot","ci","compliance","contact","continuousintegration","cron","csirt","customer-care","customercare","customerservice","customersupport","cvs","daemon","default","demo","deploy","deployment","dev","development","devops","digest","director","dnsadmin","docs","donotreply","enquiry","errors","events","executive","faculty","failover","feed","feedback","finance","forensics","ftp","git","guardian","guest","help","helpdesk","helpsec","hostmaster","hr","incident","incidents","indexer","info","ingest","inquiry","issues","it","jobs","legal","list","list-request","log","logistics","logs","maildaemon","mailer-daemon","malicious","management","manager","marketing","media","membership","metrics","mod","moderator","mods","monitor","network","news","newsletter","no-reply","noc","noreply","notifications","notify","operations","operator","owner","owners","parent","partners","patches","payments","phish","phishing","pipeline","post","postmaster","pr","press","privacy","procurement","qa","recruitment","redundancy","registrar","releases","reminder","reminders","reply","report","reports","request","resource","root","sales","scheduler","secondary","secops","secretariat","secretary","security","server","service","spam","spamreport","staff","standby","student","subscribe","subscriptions","summaries","supervisor","supplychain","support","supportteam","svn","sync","sysadmin","system","system-alert","system-msg","team","tech","techsupport","temp","tertiary","test","threat","threats","tracker","trial","unknown","unsubscribe","update","updates","usenet","usergroup","uucp","volunteer","vuln","vulnerability","webinars","webmaster","www"]),o=i((e,r)=>m.has(e)||(r?.has(e)??!1),"checkRolePrefix"),d=i((e,r)=>{if(e.length<2)return!1;const t=["-",".","_"];for(const s of t){const n=`${e[0]}${s}${e[1]}`;if(o(n,r))return!0}return!1},"checkCombinedParts"),f=i((e,r)=>{for(const t of e)if(!o(t,r))return!1;return!0},"checkAllPartsAreRoleAccounts"),h=i((e,r)=>{if(!e||typeof e!="string")return!1;const t=e.toLowerCase().trim(),s=t.indexOf("@");if(s===-1||s===0)return!1;const n=t.slice(0,s);if(o(n,r))return!0;const a=n.split(/[+._-]/);if(a.length===1){const c=a[0];return c===void 0?!1:o(c,r)}return d(a,r)?!0:f(a,r)},"isRoleAccount");export{m as ROLE_ACCOUNT_PREFIXES,h as isRoleAccount};
+const c=new Set(["abuse","accounts","admin","adminhelp","administrator","adminoffice","adminteam","affiliates","alarms","alert","alternative","analytics","anonymous","archive","audit","automated","autoreply","backoffice","backup","batch","billing","board","bot","bounce","bug","bugreport","build","careers","cert","chapter","chatbot","ci","compliance","contact","continuousintegration","cron","csirt","customer-care","customercare","customerservice","customersupport","cvs","daemon","default","demo","deploy","deployment","dev","development","devops","digest","director","dnsadmin","docs","donotreply","enquiry","errors","events","executive","faculty","failover","feed","feedback","finance","forensics","ftp","git","guardian","guest","help","helpdesk","helpsec","hostmaster","hr","incident","incidents","indexer","info","ingest","inquiry","issues","it","jobs","legal","list","list-request","log","logistics","logs","maildaemon","mailer-daemon","malicious","management","manager","marketing","media","membership","metrics","mod","moderator","mods","monitor","network","news","newsletter","no-reply","noc","noreply","notifications","notify","operations","operator","owner","owners","parent","partners","patches","payments","phish","phishing","pipeline","post","postmaster","pr","press","privacy","procurement","qa","recruitment","redundancy","registrar","releases","reminder","reminders","reply","report","reports","request","resource","root","sales","scheduler","secondary","secops","secretariat","secretary","security","server","service","spam","spamreport","staff","standby","student","subscribe","subscriptions","summaries","supervisor","supplychain","support","supportteam","svn","sync","sysadmin","system","system-alert","system-msg","team","tech","techsupport","temp","tertiary","test","threat","threats","tracker","trial","unknown","unsubscribe","update","updates","usenet","usergroup","uucp","volunteer","vuln","vulnerability","webinars","webmaster","www"]),o=(e,r)=>c.has(e)||(r?.has(e)??!1),u=(e,r)=>{if(e.length<2)return!1;const t=["-",".","_"];for(const s of t){const n=`${e[0]}${s}${e[1]}`;if(o(n,r))return!0}return!1},p=(e,r)=>{for(const t of e)if(!o(t,r))return!1;return!0},l=(e,r)=>{if(!e||typeof e!="string")return!1;const t=e.toLowerCase().trim(),s=t.indexOf("@");if(s===-1||s===0)return!1;const n=t.slice(0,s);if(o(n,r))return!0;const a=n.split(/[+._-]/);if(a.length===1){const i=a[0];return i===void 0?!1:o(i,r)}return u(a,r)?!0:p(a,r)};export{c as ROLE_ACCOUNT_PREFIXES,l as isRoleAccount};

package/dist/utils/validation/validate-email.js

@@ -1 +1 @@
-var l=Object.defineProperty;var i=(t,e)=>l(t,"name",{value:e,configurable:!0});var f=Object.defineProperty,u=i((t,e)=>f(t,"name",{value:e,configurable:!0}),"i");const c=u(t=>{if(!/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(t))return!1;const e=t.split("@");if(e.length!==2)return!1;const[r,s]=e;if(!r||!s||t.includes("..")||r.startsWith(".")||r.endsWith(".")||!s.includes(".")||s.startsWith("-")||s.endsWith("-"))return!1;const a=s.split(".");for(const n of a)if(n.startsWith("-")||n.endsWith("-")||n.length===0)return!1;return!0},"validateEmail");export{c as default};
+const f=s=>{if(!/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/.test(s))return!1;const r=s.split("@");if(r.length!==2)return!1;const[e,t]=r;if(!e||!t||s.includes("..")||e.startsWith(".")||e.endsWith(".")||!t.includes(".")||t.startsWith("-")||t.endsWith("-"))return!1;const i=t.split(".");for(const n of i)if(n.startsWith("-")||n.endsWith("-")||n.length===0)return!1;return!0};export{f as default};

package/dist/utils/validation/verify-email.js

@@ -1 +1 @@
-var V=Object.defineProperty;var f=(e,r)=>V(e,"name",{value:r,configurable:!0});import{checkMxRecords as y}from"./check-mx-records.js";import{isRoleAccount as k}from"./role-accounts.js";import w from"./validate-email.js";import{verifySmtp as E}from"./verify-smtp.js";import{isDisposableEmail as A}from"@visulima/disposable-email-domains";var D=Object.defineProperty,M=f((e,r)=>D(e,"name",{value:r,configurable:!0}),"f");const N=M(async(e,r={})=>{const{checkDisposable:p=!0,checkMx:d=!0,checkRoleAccount:u=!0,checkSmtp:h=!1,customDisposableDomains:v,customRolePrefixes:b,...g}=r,c=w(e),a=[],i=[];if(!c)return a.push("Invalid email format"),{errors:a,formatValid:!1,valid:!1,warnings:i};let s,l,m,n;if(p)try{s=A(e,v),s&&i.push("Email is from a disposable email service")}catch{}if(u&&(l=k(e,b),l&&i.push("Email appears to be a role account (non-personal)")),d){const o=e.split("@")[1];if(!o)return a.push("Invalid email format: missing domain"),{disposable:s,errors:a,formatValid:!1,mxValid:!1,roleAccount:l,valid:!1,warnings:i};const t=await y(o,{cache:r.cache});m=t.valid,t.valid||a.push(t.error??"No valid MX records found")}if(h){const o=await E(e,{...g,cache:r.cache,smtpCache:r.smtpCache});n=o.valid,!o.valid&&o.error&&a.push(`SMTP verification failed: ${o.error}`)}const x=c&&a.length===0;return{disposable:s,errors:a,formatValid:c,mxValid:m,roleAccount:l,smtpValid:n,valid:x,warnings:i}},"verifyEmail");export{N as verifyEmail};
+import{checkMxRecords as x}from"./check-mx-records.js";import{isRoleAccount as g}from"./role-accounts.js";import k from"./validate-email.js";import{verifySmtp as w}from"./verify-smtp.js";import{isDisposableEmail as y}from"@visulima/disposable-email-domains";const S=async(r,s={})=>{const{checkDisposable:f=!0,checkMx:p=!0,checkRoleAccount:d=!0,checkSmtp:u=!1,customDisposableDomains:h,customRolePrefixes:v,...b}=s,c=k(r),a=[],e=[];if(!c)return a.push("Invalid email format"),{errors:a,formatValid:!1,valid:!1,warnings:e};let o,l,m,n;if(f)try{o=y(r,h),o&&e.push("Email is from a disposable email service")}catch{}if(d&&(l=g(r,v),l&&e.push("Email appears to be a role account (non-personal)")),p){const i=r.split("@")[1];if(!i)return a.push("Invalid email format: missing domain"),{disposable:o,errors:a,formatValid:!1,mxValid:!1,roleAccount:l,valid:!1,warnings:e};const t=await x(i,{cache:s.cache});m=t.valid,t.valid||a.push(t.error??"No valid MX records found")}if(u){const i=await w(r,{...b,cache:s.cache,smtpCache:s.smtpCache});n=i.valid,!i.valid&&i.error&&a.push(`SMTP verification failed: ${i.error}`)}const V=c&&a.length===0;return{disposable:o,errors:a,formatValid:c,mxValid:m,roleAccount:l,smtpValid:n,valid:V,warnings:e}};export{S as verifyEmail};

package/dist/utils/validation/verify-smtp.js

@@ -1,4 +1,4 @@
-var j=Object.defineProperty;var R=(t,e)=>j(t,"name",{value:e,configurable:!0});import{createRequire as S}from"node:module";import{checkMxRecords as C}from"./check-mx-records.js";const $=S(import.meta.url),u=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,O=R(t=>{if(typeof u<"u"&&u.versions&&u.versions.node){const[e,d]=u.versions.node.split(".").map(Number);if(e>22||e===22&&d>=3||e===20&&d>=16)return u.getBuiltinModule(t)}return $(t)},"__cjs_getBuiltinModule"),{Socket:P}=O("node:net");var E=Object.defineProperty,p=R((t,e)=>E(t,"name",{value:e,configurable:!0}),"n");const A=p(async(t,e={})=>{const{fromEmail:d="test@example.com",port:x=25,timeout:M=5e3,ttl:_=36e5}=e;if(!t||typeof t!="string")return{error:"Invalid email address",valid:!1};const l=t.toLowerCase().trim(),h=l.indexOf("@");if(h===-1||h===l.length-1)return{error:"Invalid email format",valid:!1};const{smtpCache:c}=e,g=`smtp:${l}:${d}:${x}`;if(c){const n=await c.get(g);if(n!==void 0)return n}const w=l.slice(h+1),W=e.cache,r=await C(w,{cache:W});if(!r.valid||!r.records||r.records.length===0){const n={error:r.error??"No MX records found",mxRecords:r.records,valid:!1};return c&&await c.set(g,n,_),n}const y=r.records[0];return new Promise(n=>{const o=new P;let v="",s="connected";const m=p(()=>{o.removeAllListeners(),o.destroy()},"cleanup"),f=p(a=>{c&&c.set(g,a,_).catch(()=>{}),n(a)},"cacheAndResolve"),T=p(a=>{m(),f({error:a.message,mxRecords:r.records,valid:!1})},"onError"),b=p(()=>{m(),f({error:"SMTP connection timeout",mxRecords:r.records,valid:!1})},"onTimeout");o.setTimeout(M),o.on("error",T),o.on("timeout",b),o.on("data",a=>{v+=a.toString();const i=v.slice(-3);s==="connected"&&(i.startsWith("220")||i.startsWith("250"))?(s="helo",o.write(`HELO ${w}\r
-`)):s==="helo"&&i.startsWith("250")?(s="mail-from",o.write(`MAIL FROM:<${d}>\r
-`)):s==="mail-from"&&i.startsWith("250")?(s="rcpt-to",o.write(`RCPT TO:<${l}>\r
-`)):s==="rcpt-to"&&i.startsWith("250")?(m(),f({mxRecords:r.records,smtpResponse:v,valid:!0})):s==="rcpt-to"&&(i.startsWith("550")||i.startsWith("551")||i.startsWith("553"))&&(m(),f({error:"Email address does not exist",mxRecords:r.records,smtpResponse:v,valid:!1}))}),y?o.connect(x,y.exchange):(m(),f({error:"No MX record available",mxRecords:r.records,valid:!1}))})},"verifySmtp");export{A as verifySmtp};
+import{createRequire as T}from"node:module";import{checkMxRecords as S}from"./check-mx-records.js";const $=T(import.meta.url),p=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,b=c=>{if(typeof p<"u"&&p.versions&&p.versions.node){const[o,d]=p.versions.node.split(".").map(Number);if(o>22||o===22&&d>=3||o===20&&d>=16)return p.getBuiltinModule(c)}return $(c)},{Socket:j}=b("node:net"),O=async(c,o={})=>{const{fromEmail:d="test@example.com",port:g=25,timeout:w=5e3,ttl:R=36e5}=o;if(!c||typeof c!="string")return{error:"Invalid email address",valid:!1};const l=c.toLowerCase().trim(),h=l.indexOf("@");if(h===-1||h===l.length-1)return{error:"Invalid email format",valid:!1};const{smtpCache:n}=o,v=`smtp:${l}:${d}:${g}`;if(n){const i=await n.get(v);if(i!==void 0)return i}const x=l.slice(h+1),M=o.cache,e=await S(x,{cache:M});if(!e.valid||!e.records||e.records.length===0){const i={error:e.error??"No MX records found",mxRecords:e.records,valid:!1};return n&&await n.set(v,i,R),i}const _=e.records[0];return new Promise(i=>{const r=new j;let u="",t="connected";const m=()=>{r.removeAllListeners(),r.destroy()},f=a=>{n&&n.set(v,a,R).catch(()=>{}),i(a)},W=a=>{m(),f({error:a.message,mxRecords:e.records,valid:!1})},y=()=>{m(),f({error:"SMTP connection timeout",mxRecords:e.records,valid:!1})};r.setTimeout(w),r.on("error",W),r.on("timeout",y),r.on("data",a=>{u+=a.toString();const s=u.slice(-3);t==="connected"&&(s.startsWith("220")||s.startsWith("250"))?(t="helo",r.write(`HELO ${x}\r
+`)):t==="helo"&&s.startsWith("250")?(t="mail-from",r.write(`MAIL FROM:<${d}>\r
+`)):t==="mail-from"&&s.startsWith("250")?(t="rcpt-to",r.write(`RCPT TO:<${l}>\r
+`)):t==="rcpt-to"&&s.startsWith("250")?(m(),f({mxRecords:e.records,smtpResponse:u,valid:!0})):t==="rcpt-to"&&(s.startsWith("550")||s.startsWith("551")||s.startsWith("553"))&&(m(),f({error:"Email address does not exist",mxRecords:e.records,smtpResponse:u,valid:!1}))}),_?r.connect(g,_.exchange):(m(),f({error:"No MX record available",mxRecords:e.records,valid:!1}))})};export{O as verifySmtp};