@visulima/email 1.0.0-alpha.1 → 1.0.0-alpha.3

package/dist/providers/brevo/types.d.ts

@@ -12,11 +12,17 @@ export interface BrevoConfig extends BaseConfig {
      * Defaults to: https://api.brevo.com/v3
      */
     endpoint?: string;
+    /**
+     * Enable hard validation for replyTo addresses.
+     * If true, arrays will be rejected. If false, the first address from an array will be used.
+     * Defaults to: false
+     */
+    hardValidation?: boolean;
 }
 /**
  * Brevo-specific email options
  */
-export interface BrevoEmailOptions extends EmailOptions {
+export interface BrevoEmailOptions extends Omit<EmailOptions, "replyTo"> {
     /**
      * Batch ID for batch sending
      */
@@ -26,9 +32,10 @@ export interface BrevoEmailOptions extends EmailOptions {
      */
     headers?: Record<string, string>;
     /**
-     * Reply-to email address (can override base replyTo)
+     * Reply-to email address (can override base replyTo).
+     * Only one address is allowed. If an array is provided and hardValidation is false, the first address will be used.
      */
-    replyTo?: EmailAddress;
+    replyTo?: EmailAddress | EmailAddress[];
     /**
      * Scheduled date/time
      * - If string: ISO 8601 format (e.g., "2025-01-15T10:00:00Z")

package/dist/providers/failover/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/failoverProvider-sam9n1AG.js";export{o as failoverProvider};
+import{default as o}from"../../packem_shared/failoverProvider-CAHQQueo.js";export{o as failoverProvider};

package/dist/providers/http/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/httpProvider-BhN0RrK-.js";export{e as httpProvider};
+import{default as e}from"../../packem_shared/httpProvider-CZD6LZX3.js";export{e as httpProvider};

package/dist/providers/infobip/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/infobipProvider-D8vYTHV4.js";export{e as infobipProvider};
+import{default as e}from"../../packem_shared/infobipProvider-CtLwrUaP.js";export{e as infobipProvider};

package/dist/providers/mailcrab/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/mailCrabProvider-BEwRjB3F.js";export{e as mailCrabProvider};
+import{default as e}from"../../packem_shared/mailCrabProvider-CM_CFDca.js";export{e as mailCrabProvider};

package/dist/providers/mailersend/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/mailerSendProvider-C4uAo-fc.js";export{a as mailerSendProvider};
+import{default as a}from"../../packem_shared/mailerSendProvider-CeeIXFnW.js";export{a as mailerSendProvider};

package/dist/providers/mailgun/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/mailgunProvider-B7upu_OV.js";export{e as mailgunProvider};
+import{default as e}from"../../packem_shared/mailgunProvider-mmjKzouh.js";export{e as mailgunProvider};

package/dist/providers/mailjet/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/mailjetProvider-ReErm08u.js";export{a as mailjetProvider};
+import{default as a}from"../../packem_shared/mailjetProvider-DwN6i0VA.js";export{a as mailjetProvider};

package/dist/providers/mailomat/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/mailomatProvider-OlCT_O2i.js";export{r as mailomatProvider};
+import{default as r}from"../../packem_shared/mailomatProvider-DMQmjKHT.js";export{r as mailomatProvider};

package/dist/providers/mailpace/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/mailPaceProvider-C47Izgaj.js";export{r as mailPaceProvider};
+import{default as r}from"../../packem_shared/mailPaceProvider-B6yKvh6z.js";export{r as mailPaceProvider};

package/dist/providers/mailtrap/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/mailtrapProvider-hVMV3h6r.js";export{e as mailtrapProvider};
+import{default as e}from"../../packem_shared/mailtrapProvider-BN3UBEQw.js";export{e as mailtrapProvider};

package/dist/providers/mandrill/index.js

@@ -1 +1 @@
-import{default as d}from"../../packem_shared/mandrillProvider-DdnbkHZI.js";export{d as mandrillProvider};
+import{default as d}from"../../packem_shared/mandrillProvider-370y7CLu.js";export{d as mandrillProvider};

package/dist/providers/mock/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/mockProvider-BDWZJpea.js";export{e as mockProvider};
+import{default as e}from"../../packem_shared/mockProvider-DN5ZwutD.js";export{e as mockProvider};

package/dist/providers/nodemailer/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/nodemailerProvider-BV21eRGX.js";export{o as nodemailerProvider};
+import{default as o}from"../../packem_shared/nodemailerProvider-_w8QXMU-.js";export{o as nodemailerProvider};

package/dist/providers/opentelemetry/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/opentelemetryProvider-kAz62mKm.js";export{o as opentelemetryProvider};
+import{default as o}from"../../packem_shared/opentelemetryProvider-C_ZXOLSd.js";export{o as opentelemetryProvider};

package/dist/providers/plunk/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/plunkProvider-Bs6K51lT.js";export{o as plunkProvider};
+import{default as o}from"../../packem_shared/plunkProvider-DfJumQ4U.js";export{o as plunkProvider};

package/dist/providers/postal/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/postalProvider-Bcsxp-z6.js";export{a as postalProvider};
+import{default as a}from"../../packem_shared/postalProvider-Bavx2FcH.js";export{a as postalProvider};

package/dist/providers/postmark/index.js

@@ -1 +1 @@
-import{default as a}from"../../packem_shared/postmarkProvider-BUq3wuYD.js";export{a as postmarkProvider};
+import{default as a}from"../../packem_shared/postmarkProvider-DFC0uvjO.js";export{a as postmarkProvider};

package/dist/providers/resend/index.js

@@ -1 +1 @@
-import{default as d}from"../../packem_shared/resendProvider-D-_HQpN_.js";export{d as resendProvider};
+import{default as d}from"../../packem_shared/resendProvider-CfqU7UdE.js";export{d as resendProvider};

package/dist/providers/roundrobin/index.js

@@ -1 +1 @@
-import{default as d}from"../../packem_shared/roundRobinProvider-CejLM1rZ.js";export{d as roundRobinProvider};
+import{default as d}from"../../packem_shared/roundRobinProvider-1WQnuKR8.js";export{d as roundRobinProvider};

package/dist/providers/scaleway/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/scalewayProvider-1n6ePiGl.js";export{r as scalewayProvider};
+import{default as r}from"../../packem_shared/scalewayProvider-be1HPimL.js";export{r as scalewayProvider};

package/dist/providers/sendgrid/index.js

@@ -1 +1 @@
-import{default as e}from"../../packem_shared/sendGridProvider-B1T62dyX.js";export{e as sendGridProvider};
+import{default as e}from"../../packem_shared/sendGridProvider-BVI1sq3n.js";export{e as sendGridProvider};

package/dist/providers/smtp/index.js

@@ -1 +1 @@
-import{default as o}from"../../packem_shared/smtpProvider-CcAoRrkt.js";export{o as smtpProvider};
+import{default as o}from"../../packem_shared/smtpProvider-BV-ufR53.js";export{o as smtpProvider};

package/dist/providers/sweego/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/sweegoProvider-CxFmEUh6.js";export{r as sweegoProvider};
+import{default as r}from"../../packem_shared/sweegoProvider-7419CSAq.js";export{r as sweegoProvider};

package/dist/providers/zeptomail/index.js

@@ -1 +1 @@
-import{default as r}from"../../packem_shared/zeptomailProvider-CWYQPAJk.js";export{r as zeptomailProvider};
+import{default as r}from"../../packem_shared/zeptomailProvider-C2lh0Xmo.js";export{r as zeptomailProvider};

package/dist/types.d.ts

@@ -109,6 +109,19 @@ export type ImmutableHeaders = Omit<Headers, "append" | "delete" | "set">;
  * Email headers can be either a plain object or an ImmutableHeaders instance
  */
 export type EmailHeaders = Record<string, string> | ImmutableHeaders;
+/**
+ * Options for calendar event attachments
+ */
+export interface CalendarEventOptions {
+    /**
+     * Alternative text for the calendar event
+     */
+    alternativeText?: string;
+    /**
+     * Method for the calendar event (e.g., 'REQUEST', 'CANCEL', 'REPLY')
+     */
+    method?: string;
+}
 /**
  * Common email options that all providers support
  */
@@ -119,6 +132,11 @@ export interface EmailOptions {
     from: EmailAddress;
     headers?: EmailHeaders;
     html?: string;
+    icalEvent?: CalendarEventOptions & {
+        content?: string;
+        href?: string;
+        path?: string;
+    };
     priority?: Priority;
     replyTo?: EmailAddress;
     subject: string;

package/dist/utils/cache.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Generic cache interface for caching any type of data.
+ * Implementations can use in-memory cache, LRU cache, Redis, etc.
+ */
+export interface Cache<T = unknown> {
+    /**
+     * Clears all cached entries.
+     */
+    clear: () => Promise<void>;
+    /**
+     * Deletes a cached entry.
+     * @param key The cache key.
+     */
+    delete: (key: string) => Promise<void>;
+    /**
+     * Gets a cached value.
+     * @param key The cache key.
+     * @returns The cached value or undefined if not found or expired.
+     */
+    get: (key: string) => Promise<T | undefined>;
+    /**
+     * Sets a cached value.
+     * @param key The cache key.
+     * @param value The value to cache.
+     * @param ttl Time-to-live in milliseconds.
+     */
+    set: (key: string, value: T, ttl: number) => Promise<void>;
+}
+/**
+ * Options for creating an in-memory cache.
+ */
+export interface InMemoryCacheOptions {
+    /**
+     * Maximum number of entries in the cache.
+     * @default 500
+     */
+    max?: number;
+    /**
+     * Default TTL in milliseconds for entries.
+     * @default 3600000 (1 hour)
+     */
+    ttl?: number;
+}
+/**
+ * Default in-memory cache implementation using LRU cache.
+ */
+export declare class InMemoryCache<T extends object = Record<string, unknown>> implements Cache<T> {
+    private readonly cache;
+    constructor(options?: InMemoryCacheOptions);
+    clear: () => Promise<void>;
+    delete: (key: string) => Promise<void>;
+    get: (key: string) => Promise<T | undefined>;
+    set: (key: string, value: T, ttl: number) => Promise<void>;
+}

package/dist/utils/cache.js

@@ -0,0 +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};

package/dist/utils/create-logger.d.ts

@@ -1,7 +1,7 @@
 /**
  * Logger interface with debug, error, info, and warn methods.
  */
-type Logger = {
+export type Logger = {
     debug: (message: string, ...args: unknown[]) => void;
     error: (message: string, ...args: unknown[]) => void;
     info: (message: string, ...args: unknown[]) => void;
@@ -13,6 +13,4 @@ type Logger = {
  * @param logger Optional Console instance. If provided, logs will be displayed with prefixes. If not provided, returns a no-op logger.
  * @returns A logger instance with debug, error, info, and warn methods.
  */
-declare const createLogger: (providerName: string, logger?: Console) => Logger;
-export type { Logger };
-export default createLogger;
+export declare const createLogger: (providerName: string, logger?: Console) => Logger;

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

@@ -0,0 +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};

package/dist/utils/normalize-email-aliases.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Normalizes email aliases for supported email providers.
+ * For example: example@gmail.com and example+another@gmail.com point to the same email address.
+ * This function normalizes aliases to their canonical form.
+ *
+ * Supported providers:
+ * - Gmail: Removes dots and plus aliases (example+test@gmail.com → example@gmail.com)
+ * - Yahoo, Outlook, Hotmail, Live, MSN, iCloud, ProtonMail, Zoho, FastMail, Mail.com, GMX: Removes plus aliases only
+ * @param email The email address to normalize.
+ * @returns The normalized email address, or the original email if not supported or invalid.
+ * @example
+ * ```ts
+ * import { normalizeEmailAliases } from "@visulima/email/utils/normalize-email-aliases";
+ *
+ * normalizeEmailAliases("example+test@gmail.com"); // "example@gmail.com"
+ * normalizeEmailAliases("ex.ample@gmail.com"); // "example@gmail.com"
+ * normalizeEmailAliases("user+tag@yahoo.com"); // "user@yahoo.com"
+ * normalizeEmailAliases("user@example.com"); // "user@example.com" (unchanged)
+ * ```
+ */
+declare const normalizeEmailAliases: (email: string) => string;
+export default normalizeEmailAliases;

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

@@ -0,0 +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};

package/dist/utils/parse-address.js

@@ -0,0 +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&&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&&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};

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

@@ -0,0 +1,42 @@
+import type { Cache } from "../cache.d.ts";
+export type { Cache, InMemoryCache } from "../cache.d.ts";
+/**
+ * MX record information.
+ */
+export interface MxRecord {
+    exchange: string;
+    priority: number;
+}
+/**
+ * Result of MX record check.
+ */
+export interface MxCheckResult {
+    error?: string;
+    records?: MxRecord[];
+    valid: boolean;
+}
+/**
+ * Options for MX record checking.
+ */
+export interface MxCheckOptions {
+    cache?: Cache<MxCheckResult>;
+    ttl?: number;
+}
+/**
+ * Checks MX records for a domain.
+ * @param domain The domain to check MX records for.
+ * @param options Options for MX record checking, including caching.
+ * @returns Result containing MX records or error.
+ * @example
+ * ```ts
+ * import { checkMxRecords } from "@visulima/email/validation/check-mx-records";
+ * import { InMemoryCache } from "@visulima/email/utils/cache";
+ *
+ * const cache = new InMemoryCache();
+ * const result = await checkMxRecords("example.com", { cache });
+ * if (result.valid) {
+ *     console.log("MX records:", result.records);
+ * }
+ * ```
+ */
+export declare const checkMxRecords: (domain: string, options?: MxCheckOptions) => Promise<MxCheckResult>;

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

@@ -0,0 +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};

package/dist/utils/validation/disposable-email-domains.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Re-exports all functionality from @visulima/disposable-email-domains.
+ * This provides access to disposable email domain checking utilities.
+ * @example
+ * ```ts
+ * import { isDisposableEmail, isDisposableDomain, getDomainList } from "\@visulima/email/validation/disposable-email-domains";
+ *
+ * if (isDisposableEmail("user@mailinator.com")) {
+ *     console.log("Disposable email detected!");
+ * }
+ * ```
+ */
+export * from "@visulima/disposable-email-domains";

package/dist/utils/validation/disposable-email-domains.js

@@ -0,0 +1 @@
+export*from"@visulima/disposable-email-domains";

package/dist/utils/validation/role-accounts.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Common role account prefixes that indicate non-personal email addresses.
+ * Includes RFC 2142 standard role accounts and common business/operational prefixes.
+ */
+declare const ROLE_ACCOUNT_PREFIXES: Set<string>;
+/**
+ * Checks if an email address is a role account (non-personal).
+ * @param email The email address to check.
+ * @param customPrefixes Optional set of additional role account prefixes.
+ * @returns True if the email is a role account, false otherwise.
+ * @example
+ * ```ts
+ * import { isRoleAccount } from "@visulima/email/validation/role-accounts";
+ *
+ * if (isRoleAccount("noreply@example.com")) {
+ *     console.log("This is a role account");
+ * }
+ * ```
+ */
+export declare const isRoleAccount: (email: string, customPrefixes?: Set<string>) => boolean;
+export { ROLE_ACCOUNT_PREFIXES };

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

@@ -0,0 +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};

package/dist/utils/{validate-email-options.d.ts → validation/validate-email-options.d.ts}

@@ -1,4 +1,4 @@
-import type { EmailOptions } from "../types.d.ts";
+import type { EmailOptions } from "../../types.d.ts";
 /**
  * Validates email options and returns any validation errors.
  * @param options The email options to validate.

package/dist/utils/validation/verify-email.d.ts

@@ -0,0 +1,47 @@
+import type { SmtpVerificationOptions } from "./verify-smtp.d.ts";
+/**
+ * Options for comprehensive email verification.
+ */
+export interface EmailVerificationOptions extends SmtpVerificationOptions {
+    checkDisposable?: boolean;
+    checkMx?: boolean;
+    checkRoleAccount?: boolean;
+    checkSmtp?: boolean;
+    customDisposableDomains?: Set<string>;
+    customRolePrefixes?: Set<string>;
+}
+/**
+ * Result of comprehensive email verification.
+ */
+export interface EmailVerificationResult {
+    disposable?: boolean;
+    errors: string[];
+    formatValid: boolean;
+    mxValid?: boolean;
+    roleAccount?: boolean;
+    smtpValid?: boolean;
+    valid: boolean;
+    warnings: string[];
+}
+/**
+ * Comprehensive email verification combining multiple checks.
+ * @param email The email address to verify.
+ * @param options Verification options.
+ * @returns Detailed verification result.
+ * @example
+ * ```ts
+ * import { verifyEmail } from "@visulima/email/validation/verify-email";
+ *
+ * const result = await verifyEmail("user@example.com", {
+ *     checkDisposable: true,
+ *     checkRoleAccount: true,
+ *     checkMx: true,
+ *     checkSmtp: false
+ * });
+ *
+ * if (result.valid) {
+ *     console.log("Email is valid!");
+ * }
+ * ```
+ */
+export declare const verifyEmail: (email: string, options?: EmailVerificationOptions) => Promise<EmailVerificationResult>;

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

@@ -0,0 +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};

package/dist/utils/validation/verify-smtp.d.ts

@@ -0,0 +1,39 @@
+import type { Cache } from "../cache.d.ts";
+import type { MxCheckResult, MxRecord } from "./check-mx-records.d.ts";
+/**
+ * Options for SMTP verification.
+ */
+export interface SmtpVerificationOptions {
+    cache?: Cache<MxCheckResult>;
+    fromEmail?: string;
+    port?: number;
+    smtpCache?: Cache<SmtpVerificationResult>;
+    timeout?: number;
+    ttl?: number;
+}
+/**
+ * Detailed result of SMTP verification attempt.
+ */
+export interface SmtpVerificationResult {
+    error?: string;
+    mxRecords?: MxRecord[];
+    smtpResponse?: string;
+    valid: boolean;
+}
+/**
+ * Verifies an email address by checking MX records and attempting SMTP verification.
+ * Note: Many mail servers block SMTP verification to prevent email harvesting.
+ * @param email The email address to verify.
+ * @param options Verification options.
+ * @returns Result containing verification status.
+ * @example
+ * ```ts
+ * import { verifySmtp } from "@visulima/email/validation/verify-smtp";
+ *
+ * const result = await verifySmtp("user@example.com", {
+ *     timeout: 5000,
+ *     fromEmail: "test@example.com"
+ * });
+ * ```
+ */
+export declare const verifySmtp: (email: string, options?: SmtpVerificationOptions) => Promise<SmtpVerificationResult>;

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

@@ -0,0 +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};

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@visulima/email",
-  "version": "1.0.0-alpha.1",
+  "version": "1.0.0-alpha.3",
   "description": "A comprehensive email library with multi-provider support, crypto utilities, and template engines",
   "keywords": [
     "visulima",
     "email",
     "mail",
+    "better-mail",
     "smtp",
     "resend",
     "aws-ses",
@@ -39,6 +40,8 @@
     "encryption",
     "signing",
     "crypto",
+    "disposable-email",
+    "disposable-email-domains",
     "handlebars",
     "mjml",
     "react-email",
@@ -52,7 +55,7 @@
   "repository": {
     "type": "git",
     "url": "git+https://github.com/visulima/visulima.git",
-    "directory": "packages/email"
+    "directory": "packages/email/email"
   },
   "funding": [
     {
@@ -212,6 +215,46 @@
       "types": "./dist/providers/sweego/index.d.ts",
       "default": "./dist/providers/sweego/index.js"
     },
+    "./utils/parse-address": {
+      "types": "./dist/utils/parse-address.d.ts",
+      "default": "./dist/utils/parse-address.js"
+    },
+    "./utils/format-email-address": {
+      "types": "./dist/utils/format-email-address.d.ts",
+      "default": "./dist/utils/format-email-address.js"
+    },
+    "./utils/cache": {
+      "types": "./dist/utils/cache.d.ts",
+      "default": "./dist/utils/cache.js"
+    },
+    "./validation/disposable-email-domains": {
+      "types": "./dist/utils/validation/disposable-email-domains.d.ts",
+      "default": "./dist/utils/validation/disposable-email-domains.js"
+    },
+    "./validation/validate-email": {
+      "types": "./dist/utils/validation/validate-email.d.ts",
+      "default": "./dist/utils/validation/validate-email.js"
+    },
+    "./validation/check-mx-records": {
+      "types": "./dist/utils/validation/check-mx-records.d.ts",
+      "default": "./dist/utils/validation/check-mx-records.js"
+    },
+    "./validation/role-accounts": {
+      "types": "./dist/utils/validation/role-accounts.d.ts",
+      "default": "./dist/utils/validation/role-accounts.js"
+    },
+    "./validation/verify-smtp": {
+      "types": "./dist/utils/validation/verify-smtp.d.ts",
+      "default": "./dist/utils/validation/verify-smtp.js"
+    },
+    "./validation/verify-email": {
+      "types": "./dist/utils/validation/verify-email.d.ts",
+      "default": "./dist/utils/validation/verify-email.js"
+    },
+    "./utils/normalize-email-aliases": {
+      "types": "./dist/utils/normalize-email-aliases.d.ts",
+      "default": "./dist/utils/normalize-email-aliases.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -220,7 +263,10 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
+    "@visulima/disposable-email-domains": "1.0.0-alpha.2",
     "html-to-text": "^9.0.5",
+    "ical-generator": "^10.0.0",
+    "lru-cache": "^11.2.4",
     "mime": "^4.1.0"
   },
   "peerDependencies": {
@@ -260,7 +306,7 @@
     }
   },
   "engines": {
-    "node": ">=22.12 <=25.*"
+    "node": ">=22.13 <=25.x"
   },
   "publishConfig": {
     "access": "public",

package/dist/packem_shared/MailMessage-Hdgowmvi.js

@@ -1 +0,0 @@
-var x=Object.defineProperty;var h=(o,e)=>x(o,"name",{value:e,configurable:!0});import{createRequire as v}from"node:module";import{readFileAsBuffer as b,detectMimeType as u,generateContentId as A}from"./detectMimeType-S8WRsNtY.js";import w from"../template-engines/html-to-text.js";import T from"./createLogger-DlElSVQP.js";import j from"./headersToRecord-BKUTr40L.js";const E=v(import.meta.url),l=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,M=h(o=>{if(typeof l<"u"&&l.versions&&l.versions.node){const[e,t]=l.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return l.getBuiltinModule(o)}return E(o)},"__cjs_getBuiltinModule"),{basename:y}=M("node:path");var C=Object.defineProperty,d=h((o,e)=>C(o,"name",{value:e,configurable:!0}),"g");const p=d(o=>Array.isArray(o)?o.map(e=>typeof e=="string"?{email:e}:e):typeof o=="string"?[{email:o}]:[o],"normalizeAddresses"),f=d((o,e,t)=>{e.success&&e.data?o&&o.info("Email sent successfully",{messageId:e.data.messageId,provider:e.data.provider}):o&&o.error("Email send failed",{error:e.error,provider:t})},"logSendResult");class I{static{h(this,"MailMessage")}static{d(this,"MailMessage")}fromAddress;toAddresses=[];ccAddresses=[];bccAddresses=[];subjectText="";textContent;autoTextEnabled=!0;htmlContent;headers={};attachments=[];replyToAddress;priorityValue;tagsValue=[];provider;signer;encrypter;logger;from(e){return this.fromAddress=typeof e=="string"?{email:e}:e,this}to(e){return this.toAddresses.push(...p(e)),this}cc(e){return this.ccAddresses.push(...p(e)),this}bcc(e){return this.bccAddresses.push(...p(e)),this}subject(e){return this.subjectText=e,this}text(e){return this.textContent=e,this}html(e){return this.htmlContent=e,this}header(e,t){return this.headers[e]=t,this}setHeaders(e){const t=j(e);return Object.assign(this.headers,t),this}async attachFromPath(e,t){try{const s=await b(e),i=t?.filename||y(e)||"attachment",r=t?.contentType||u(i);this.attachments.push({cid:t?.cid,content:s,contentDisposition:t?.contentDisposition||"attachment",contentType:r,encoding:t?.encoding,filename:i,headers:t?.headers}),this.logger&&this.logger.debug(`Attachment added from path: ${e}`,{contentType:r,filename:i})}catch(s){throw this.logger&&this.logger.error(`Failed to attach file from path: ${e}`,s),s}return this}attachData(e,t){const s=t.contentType||u(t.filename);return this.attachments.push({cid:t.cid,content:e,contentDisposition:t.contentDisposition||"attachment",contentType:s,encoding:t.encoding,filename:t.filename,headers:t.headers}),this.logger&&this.logger.debug("Attachment added from data",{contentType:s,filename:t.filename}),this}async embedFromPath(e,t){try{const s=await b(e),i=t?.filename||y(e)||"inline",r=t?.contentType||u(i),n=A(i);return this.attachments.push({cid:n,content:s,contentDisposition:"inline",contentType:r,filename:i}),this.logger&&this.logger.debug(`Inline attachment embedded from path: ${e}`,{cid:n,contentType:r,filename:i}),n}catch(s){throw this.logger&&this.logger.error(`Failed to embed file from path: ${e}`,s),s}}embedData(e,t,s){const i=s?.contentType||u(t),r=A(t);return this.attachments.push({cid:r,content:e,contentDisposition:"inline",contentType:i,filename:t}),this.logger&&this.logger.debug("Inline attachment embedded from data",{cid:r,contentType:i,filename:t}),r}replyTo(e){return this.replyToAddress=typeof e=="string"?{email:e}:e,this}priority(e){return this.priorityValue=e,this}tags(e){return this.tagsValue=Array.isArray(e)?e:[e],this}mailer(e){return this.provider=e,this}sign(e){return this.signer=e,this.logger&&this.logger.debug("Email signer configured"),this}encrypt(e){return this.encrypter=e,this.logger&&this.logger.debug("Email encrypter configured"),this}setLogger(e){return this.logger=T("MailMessage",e),this}async view(e,t,s,i){try{const r=i?.autoText!==!1;this.autoTextEnabled=r,this.logger&&this.logger.debug("Rendering template",{autoText:r});const n=await e(t,s,i);this.html(n),r&&n&&this.tryAutoGenerateText(n),this.logger&&this.logger.debug("Template rendered successfully")}catch(r){throw this.logger&&this.logger.error("Failed to render template",r),new Error(`Failed to render template: ${r.message}`)}return this}async viewText(e,t,s,i){try{this.logger&&this.logger.debug("Rendering text template");const r=await e(t,s,i);if(typeof r=="string")this.text(r),this.logger&&this.logger.debug("Text template rendered successfully");else throw new TypeError("Text renderer must return a string")}catch(r){throw this.logger&&this.logger.error("Failed to render text template",r),new Error(`Failed to render text template: ${r.message}`)}return this}async build(){if(this.logger&&this.logger.debug("Building email message"),this.fromAddress||this.throwAndLogError("From address is required","Build failed: from address is required"),this.toAddresses.length===0&&this.throwAndLogError("At least one recipient is required","Build failed: at least one recipient is required"),this.subjectText||this.throwAndLogError("Subject is required","Build failed: subject is required"),this.htmlContent&&!this.textContent&&this.autoTextEnabled)try{this.textContent=w(this.htmlContent),this.logger&&this.logger.debug("Auto-generated text content from HTML")}catch{this.logger&&this.logger.debug("Failed to convert HTML to text; proceeding without text content.")}!this.textContent&&!this.htmlContent&&this.throwAndLogError("Either text or html content is required","Build failed: either text or html content is required");let e={from:this.fromAddress,html:this.htmlContent,subject:this.subjectText,text:this.textContent,to:this.toAddresses.length===1?this.toAddresses[0]:this.toAddresses};return this.ccAddresses.length>0&&(e.cc=this.ccAddresses.length===1?this.ccAddresses[0]:this.ccAddresses),this.bccAddresses.length>0&&(e.bcc=this.bccAddresses.length===1?this.bccAddresses[0]:this.bccAddresses),Object.keys(this.headers).length>0&&(e.headers=this.headers),this.attachments.length>0&&(e.attachments=this.attachments,this.logger&&this.logger.debug(`Email includes ${this.attachments.length} attachment(s)`)),this.replyToAddress&&(e.replyTo=this.replyToAddress),this.priorityValue&&(e.priority=this.priorityValue),this.tagsValue.length>0&&(e.tags=this.tagsValue),this.signer&&(this.logger&&this.logger.debug("Signing email message"),e=await this.signer.sign(e),this.logger&&this.logger.debug("Email message signed successfully")),this.encrypter&&(this.logger&&this.logger.debug("Encrypting email message"),e=await this.encrypter.encrypt(e),this.logger&&this.logger.debug("Email message encrypted successfully")),this.logger&&this.logger.debug("Email message built successfully",{bcc:this.bccAddresses.length,cc:this.ccAddresses.length,hasHtml:!!this.htmlContent,hasText:!!this.textContent,to:this.toAddresses.length}),e}async send(){this.provider||this.throwAndLogError("No provider configured. Use mailer() method to set a provider.","Send failed: no provider configured"),this.logger&&this.logger.debug("Sending email",{subject:this.subjectText,to:this.toAddresses.length});const e=await this.build(),t=await this.provider.sendEmail(e);return f(this.logger,t,this.provider.name||"unknown"),t}tryAutoGenerateText(e){try{const t=w(e);t&&!this.textContent&&this.text(t),this.logger&&this.logger.debug("Auto-generated text content from HTML template")}catch(t){this.logger&&this.logger.warn("Failed to auto-generate text from HTML template",t)}}throwAndLogError(e,t){const s=new Error(e);throw this.logger&&this.logger.error(t||e),s}}class m{static{h(this,"Mail")}static{d(this,"Mail")}static extractErrorMessages(e){return e instanceof Error?[e.message]:[String(e||"Unknown error")]}provider;logger;loggerInstance;constructor(e){this.provider=e}setLogger(e){return this.loggerInstance=e,this.logger=T("Mail",e),this}message(){this.logger&&this.logger.debug("Creating new mail message");const e=new I;return e.mailer(this.provider),this.loggerInstance&&e.setLogger(this.loggerInstance),e}async send(e){this.logger&&this.logger.debug("Sending mailable instance");const t=await e.build(),s=await this.provider.sendEmail(t);return f(this.logger,s,this.provider.name||"unknown"),s}async sendEmail(e){this.logger&&this.logger.debug("Sending email with options",{subject:e.subject,to:Array.isArray(e.to)?e.to.length:1});const t=await this.provider.sendEmail(e);return f(this.logger,t,this.provider.name||"unknown"),t}async*sendMany(e,t){const s=this.provider.name;let i=0,r=0,n=0;this.logger&&this.logger.debug("Starting batch email send",{provider:s});for await(const c of e){if(t?.signal?.aborted){this.logger&&this.logger.warn("Batch send operation was aborted",{failed:n,processed:i,successful:r}),yield{errorMessages:["Send operation was aborted"],provider:s,successful:!1};return}i+=1;try{const g="build"in c&&typeof c.build=="function"?await c.build():c;this.logger&&this.logger.debug(`Sending email ${i}`,{subject:g.subject,to:Array.isArray(g.to)?g.to.length:1});const a=await this.provider.sendEmail(g);a.success&&a.data?(r+=1,this.logger&&this.logger.debug(`Email ${i} sent successfully`,{messageId:a.data.messageId}),yield{messageId:a.data.messageId,provider:a.data.provider||s,response:a.data.response,successful:!0,timestamp:a.data.timestamp}):(n+=1,this.logger&&this.logger.error(`Email ${i} send failed`,{error:a.error}),yield{errorMessages:m.extractErrorMessages(a.error),provider:s,successful:!1})}catch(g){n+=1,this.logger&&this.logger.error(`Email ${i} send failed with exception`,g),yield{errorMessages:m.extractErrorMessages(g),provider:s,successful:!1}}}this.logger&&this.logger.info("Batch email send completed",{failed:n,successful:r,total:i})}}const _=d(o=>new m(o),"createMail");export{m as Mail,I as MailMessage,_ as createMail};