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

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-uP2Wpi5x.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-DAZnfgDh.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-pP3a1I1z.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-Ccm6HIsr.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-BPJ4RzsE.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-CwvMTsc_.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-CUJMsFSY.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-B_l5QnwN.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-BdpdKp7S.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-CmICY2yv.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-Dj4vhxjz.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-UiTviqTp.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-BqG5vYka.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-1uJuHIQ5.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-DMdTroUj.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-DG2rY0mt.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-DaR-sY5P.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-998actWK.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-DroogcP0.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-BWUCBzur.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-D82muNhj.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-DzSgmGjo.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-dOP4zYOR.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-BWyoNPZH.js";export{r as zeptomailProvider};

package/dist/template-engines/handlebars.js

@@ -1 +1 @@
-var i=Object.defineProperty;var d=(a,r)=>i(a,"name",{value:r,configurable:!0});import t from"handlebars";import s from"../packem_shared/EmailError-zm2ffVav.js";var o=Object.defineProperty,l=d((a,r)=>o(a,"name",{value:r,configurable:!0}),"s");const p=l((a,r,e)=>{try{if(typeof a!="string")throw new TypeError("Handlebars template must be a string");return t.compile(a,e)(r||{})}catch(n){throw n instanceof Error&&n.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:n}):new s("handlebars",`Failed to render Handlebars template: ${n.message}`,{cause:n})}},"renderHandlebars"),u=l((a,r)=>{try{t.registerHelper(a,r)}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:e}):e}},"registerHandlebarsHelper"),h=l((a,r)=>{try{t.registerPartial(a,r)}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:e}):e}},"registerHandlebarsPartial");export{u as registerHandlebarsHelper,h as registerHandlebarsPartial,p as renderHandlebars};
+var i=Object.defineProperty;var d=(a,r)=>i(a,"name",{value:r,configurable:!0});import t from"handlebars";import s from"../packem_shared/EmailError-C4nx6TgJ.js";var o=Object.defineProperty,l=d((a,r)=>o(a,"name",{value:r,configurable:!0}),"s");const p=l((a,r,e)=>{try{if(typeof a!="string")throw new TypeError("Handlebars template must be a string");return t.compile(a,e)(r||{})}catch(n){throw n instanceof Error&&n.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:n}):new s("handlebars",`Failed to render Handlebars template: ${n.message}`,{cause:n})}},"renderHandlebars"),u=l((a,r)=>{try{t.registerHelper(a,r)}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:e}):e}},"registerHandlebarsHelper"),h=l((a,r)=>{try{t.registerPartial(a,r)}catch(e){throw e instanceof Error&&e.message.includes("Cannot find module")?new s("handlebars","Handlebars is not installed. Please install it: pnpm add handlebars",{cause:e}):e}},"registerHandlebarsPartial");export{u as registerHandlebarsHelper,h as registerHandlebarsPartial,p as renderHandlebars};

package/dist/template-engines/html-to-text.js

@@ -1 +1 @@
-var n=Object.defineProperty;var o=(t,e)=>n(t,"name",{value:e,configurable:!0});import{convert as a}from"html-to-text";import l from"../packem_shared/EmailError-zm2ffVav.js";var s=Object.defineProperty,i=o((t,e)=>s(t,"name",{value:e,configurable:!0}),"o");const p=i((t,e)=>{try{return a(t,{longWordSplit:e?.longWordSplit,preserveNewlines:e?.preserveNewlines??!1,selectors:e?.selectors,wordwrap:e?.wordwrap??80})}catch(r){throw r instanceof Error&&r.message.includes("Cannot find module")?new l("html-to-text","html-to-text is not installed. Please install it: pnpm add html-to-text",{cause:r}):new l("html-to-text",`Failed to convert HTML to text: ${r.message}`,{cause:r})}},"htmlToText");export{p as default};
+var n=Object.defineProperty;var o=(t,e)=>n(t,"name",{value:e,configurable:!0});import{convert as a}from"html-to-text";import l from"../packem_shared/EmailError-C4nx6TgJ.js";var s=Object.defineProperty,i=o((t,e)=>s(t,"name",{value:e,configurable:!0}),"o");const p=i((t,e)=>{try{return a(t,{longWordSplit:e?.longWordSplit,preserveNewlines:e?.preserveNewlines??!1,selectors:e?.selectors,wordwrap:e?.wordwrap??80})}catch(r){throw r instanceof Error&&r.message.includes("Cannot find module")?new l("html-to-text","html-to-text is not installed. Please install it: pnpm add html-to-text",{cause:r}):new l("html-to-text",`Failed to convert HTML to text: ${r.message}`,{cause:r})}},"htmlToText");export{p 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};
+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-C4nx6TgJ.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};

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};
+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-C4nx6TgJ.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};

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};
+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-C4nx6TgJ.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};

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-C4nx6TgJ.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};