@visulima/email-verifier 1.0.1 → 1.0.3

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+## @visulima/email-verifier [1.0.3](https://github.com/visulima/visulima/compare/%40visulima%2Femail-verifier%401.0.2...%40visulima%2Femail-verifier%401.0.3) (2026-08-17)
+
+## @visulima/email-verifier [1.0.2](https://github.com/visulima/visulima/compare/%40visulima%2Femail-verifier%401.0.1...%40visulima%2Femail-verifier%401.0.2) (2026-08-02)
+
+
+### Dependencies
+
+* **@visulima/disposable-email-domains:** upgraded to 1.1.0
+* **@visulima/email-provider-mx:** upgraded to 1.0.1
+* **@visulima/free-email-domains:** upgraded to 1.0.1
+
 ## @visulima/email-verifier [1.0.1](https://github.com/visulima/visulima/compare/%40visulima%2Femail-verifier%401.0.0...%40visulima%2Femail-verifier%401.0.1) (2026-07-15)
 
 

package/dist/checks/character.d.ts

@@ -1,6 +1,6 @@
 /**
-* The result of local-part character analysis.
-*/
+ * The result of local-part character analysis.
+ */
 interface CharacterResult {
   /** Ratio of digits to total characters in the local part (0–1). */
   digitRatio: number;
@@ -12,20 +12,20 @@ interface CharacterResult {
   reasons: string[];
 }
 /**
-* Analyzes the local part of an email for irregular characteristics that
-* correlate with low-quality, spam-trap, or machine-generated addresses.
-*
-* Heuristic and intentionally conservative — it flags *patterns* (excessive
-* length, digit-heavy locals, long unpronounceable consonant runs, long repeats)
-* rather than asserting invalidity.
-* @param email The email address to analyze.
-* @returns The character analysis result.
-* @example
-* ```ts
-* import { analyzeCharacters } from "@visulima/email-verifier/checks/character";
-*
-* analyzeCharacters("aaaaaaa@example.com").irregular; // long repeat ⇒ true
-* ```
-*/
+ * Analyzes the local part of an email for irregular characteristics that
+ * correlate with low-quality, spam-trap, or machine-generated addresses.
+ *
+ * Heuristic and intentionally conservative — it flags *patterns* (excessive
+ * length, digit-heavy locals, long unpronounceable consonant runs, long repeats)
+ * rather than asserting invalidity.
+ * @param email The email address to analyze.
+ * @returns The character analysis result.
+ * @example
+ * ```ts
+ * import { analyzeCharacters } from "@visulima/email-verifier/checks/character";
+ *
+ * analyzeCharacters("aaaaaaa@example.com").irregular; // long repeat ⇒ true
+ * ```
+ */
 declare const analyzeCharacters: (email: string) => CharacterResult;
 export { type CharacterResult, analyzeCharacters, analyzeCharacters as default };

package/dist/checks/character.js

@@ -1 +1 @@
-import{splitAddress as h}from"../packem_shared/extractDomain-CYJf1_0N.js";const g=30,l=.6,i=7,o=/\d/g,c=/[bcdfghj-np-tvwxz]{7,}/,u=/(.)\1{4,}/,p=a=>{const r=h(a);if(!r)return{digitRatio:0,irregular:!0,length:0,reasons:["invalid-format"]};const{localPart:t}=r,e=[],s=(t.match(o)??[]).length,n=t.length===0?0:s/t.length;return t.length>g&&e.push("excessive-length"),n>=l&&t.length>4&&e.push("digit-heavy"),c.test(t)&&e.push(`consonant-run-${String(i)}+`),u.test(t)&&e.push("repeated-character"),{digitRatio:n,irregular:e.length>0,length:t.length,reasons:e}};export{p as analyzeCharacters,p as default};
+import{splitAddress as a}from"../packem_shared/extractDomain-C7YvhtJH.js";const i=30,c=.6,g=7,h=/\d/g,l=/[bcdfghj-np-tvwxz]{7,}/,u=/(.)\1{4,}/,R=r=>{const e=a(r);if(!e)return{digitRatio:0,irregular:!0,length:0,reasons:["invalid-format"]};const{localPart:t}=e,n=[],o=(t.match(h)??[]).length,s=t.length===0?0:o/t.length;return t.length>i&&n.push("excessive-length"),s>=c&&t.length>4&&n.push("digit-heavy"),l.test(t)&&n.push(`consonant-run-${String(g)}+`),u.test(t)&&n.push("repeated-character"),{digitRatio:s,irregular:n.length>0,length:t.length,reasons:n}};export{R as analyzeCharacters,R as default};

package/dist/checks/mx.d.ts

@@ -1 +1 @@
-export { type C as Cache, type I as InMemoryCache, type M as MxCheckOptions, type b as MxCheckResult, type c as MxRecord, type d as MxResolution, e as checkMxRecords, e as default } from "../packem_shared/mx.d-NAesS5sg.js";
+export { type C as Cache, type I as InMemoryCache, type M as MxCheckOptions, type b as MxCheckResult, type c as MxRecord, type d as MxResolution, e as checkMxRecords, e as default } from "../packem_shared/mx.d-HxIDdxvR.js";

package/dist/checks/mx.js

@@ -1 +1 @@
-import{createRequire as d}from"node:module";const u=d(import.meta.url),o=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,f=e=>{if(typeof o<"u"&&o.versions&&o.versions.node){const[r,s]=o.versions.node.split(".").map(Number);if(r>22||r===22&&s>=3||r===20&&s>=16)return o.getBuiltinModule(e)}return u(e)},{resolveMx:v,resolve4:p,resolve6:h}=f("node:dns/promises"),c=async e=>{try{if((await p(e)).length>0)return!0}catch{}try{return(await h(e)).length>0}catch{return!1}},l=e=>({domainResolves:!0,records:[{exchange:e,priority:0}],resolvedVia:"address",valid:!0}),g=async(e,r)=>{try{const s=(await v(e)).map(t=>({exchange:t.exchange,priority:t.priority}));return s.length>0?{domainResolves:!0,records:s.toSorted((t,a)=>t.priority-a.priority),resolvedVia:"mx",valid:!0}:r&&await c(e)?l(e):{domainResolves:!1,records:[],resolvedVia:"none",valid:!1}}catch(s){return r&&await c(e)?l(e):{domainResolves:!1,error:s instanceof Error?s.message:String(s),resolvedVia:"none",valid:!1}}},y=async(e,r={})=>{const{fallbackToAddress:s=!0}=r,t=r.ttl??36e5,a=`${e}:${String(s)}`;if(r.cache){const n=await r.cache.get(a);if(n!==void 0)return n}const i=await g(e,s);return r.cache&&await r.cache.set(a,i,t),i};export{y as checkMxRecords,y as default};
+import{createRequire as f}from"node:module";let h;const v=e=>(h??=f(import.meta.url))(e),o=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,g=e=>{if(typeof o<"u"&&o.versions&&o.versions.node){const[r,s]=o.versions.node.split(".").map(Number);if(r>22||r===22&&s>=3||r===20&&s>=16)return o.getBuiltinModule(e)}return v(e)},{resolveMx:_,resolve4:y,resolve6:E}=g("node:dns/promises"),R=new Set(["EAI_AGAIN","ECONNREFUSED","EREFUSED","ESERVFAIL","ETIMEDOUT","ETIMEOUT"]),p=e=>{const{code:r}=e??{};return r!==void 0&&R.has(r)},l=async e=>{try{if((await y(e)).length>0)return!0}catch{}try{return(await E(e)).length>0}catch{return!1}},u=e=>({domainResolves:!0,records:[{exchange:e,priority:0}],resolvedVia:"address",valid:!0}),m=async(e,r)=>{try{const c=(await _(e)).map(t=>({exchange:t.exchange,priority:t.priority}));return c.length>0?{domainResolves:!0,records:c.toSorted((t,a)=>t.priority-a.priority),resolvedVia:"mx",valid:!0}:r&&await l(e)?u(e):{domainResolves:!1,records:[],resolvedVia:"none",valid:!1}}catch(s){return r&&await l(e)?u(e):{deferred:p(s),domainResolves:!1,error:s instanceof Error?s.message:String(s),resolvedVia:"none",valid:!1}}},i=new Map,A=async(e,r={})=>{const{fallbackToAddress:s=!0}=r,c=r.ttl??36e5,t=`${e}:${String(s)}`;if(r.cache){const n=await r.cache.get(t);if(n!==void 0)return n}const a=i.get(t);if(a)return a;const d=(async()=>{const n=await m(e,s);return r.cache&&!n.deferred&&await r.cache.set(t,n,c),n})();i.set(t,d);try{return await d}finally{i.delete(t)}};export{A as checkMxRecords,A as default};

package/dist/checks/role.d.ts

@@ -1,41 +1,41 @@
 /**
-* Local-part prefixes that indicate a no-reply / do-not-reply mailbox.
-* These are a strict subset of {@link ROLE_ACCOUNT_PREFIXES}.
-*/
+ * Local-part prefixes that indicate a no-reply / do-not-reply mailbox.
+ * These are a strict subset of {@link ROLE_ACCOUNT_PREFIXES}.
+ */
 declare const NO_REPLY_PREFIXES: ReadonlySet<string>;
 /**
-* Local-part prefixes that identify a role-based (shared, function) mailbox
-* rather than a personal one. Superset of RFC 2142 plus common real-world roles.
-*/
+ * Local-part prefixes that identify a role-based (shared, function) mailbox
+ * rather than a personal one. Superset of RFC 2142 plus common real-world roles.
+ */
 declare const ROLE_ACCOUNT_PREFIXES: ReadonlySet<string>;
 /**
-* Determines whether an email address is a role-based account.
-*
-* Matches the whole local part, the part before any `+tag`, and each
-* dot/dash/underscore-separated token (so `sales.john`, `info+news`, and
-* `no-reply` are all caught).
-* @param email The email address to check.
-* @param customPrefixes Optional additional role prefixes to recognize.
-* @returns True when the address is a role account.
-* @example
-* ```ts
-* import { isRoleAccount } from "@visulima/email-verifier/checks/role";
-*
-* isRoleAccount("info@example.com"); // true
-* isRoleAccount("john.doe@example.com"); // false
-* ```
-*/
+ * Determines whether an email address is a role-based account.
+ *
+ * Matches the whole local part, the part before any `+tag`, and each
+ * dot/dash/underscore-separated token (so `sales.john`, `info+news`, and
+ * `no-reply` are all caught).
+ * @param email The email address to check.
+ * @param customPrefixes Optional additional role prefixes to recognize.
+ * @returns True when the address is a role account.
+ * @example
+ * ```ts
+ * import { isRoleAccount } from "@visulima/email-verifier/checks/role";
+ *
+ * isRoleAccount("info@example.com"); // true
+ * isRoleAccount("john.doe@example.com"); // false
+ * ```
+ */
 declare const isRoleAccount: (email: string, customPrefixes?: Iterable<string>) => boolean;
 /**
-* Determines whether an email address is a no-reply / do-not-reply mailbox.
-* @param email The email address to check.
-* @returns True when the address is a no-reply mailbox.
-* @example
-* ```ts
-* import { isNoReply } from "@visulima/email-verifier/checks/role";
-*
-* isNoReply("no-reply@example.com"); // true
-* ```
-*/
+ * Determines whether an email address is a no-reply / do-not-reply mailbox.
+ * @param email The email address to check.
+ * @returns True when the address is a no-reply mailbox.
+ * @example
+ * ```ts
+ * import { isNoReply } from "@visulima/email-verifier/checks/role";
+ *
+ * isNoReply("no-reply@example.com"); // true
+ * ```
+ */
 declare const isNoReply: (email: string) => boolean;
 export { NO_REPLY_PREFIXES, ROLE_ACCOUNT_PREFIXES, isRoleAccount as default, isNoReply, isRoleAccount };

package/dist/checks/role.js

@@ -1 +1 @@
-import{splitAddress as c}from"../packem_shared/extractDomain-CYJf1_0N.js";const l=new Set(["do-not-reply","do_not_reply","donotreply","no-reply","no_reply","noreply","notification","notifications","notify"]),n=new Set(["abuse","accounting","accounts","admin","administrator","all","billing","board","career","careers","ceo","cfo","compliance","contact","contacts","cto","customercare","customerservice","dev","developer","devnull","do-not-reply","do_not_reply","donotreply","enquiries","enquiry","everyone","feedback","finance","ftp","hello","help","helpdesk","hi","hostmaster","hr","info","information","inquiries","inquiry","investor","investors","it","jobs","legal","list","list-request","mail","mailer-daemon","mailerdaemon","majordomo","marketing","media","members","newsletter","no-reply","no_reply","noc","noreply","notification","notifications","notify","office","operations","order","orders","postmaster","press","privacy","purchasing","recruitment","register","registration","root","sales","secretary","security","service","services","shop","spam","staff","subscribe","support","sysadmin","team","tech","test","unsubscribe","usenet","uucp","webmaster","welcome","www"]),u=/[.\-_+]/,o=(t,e,r)=>{if(e.has(t))return!0;if(r){for(const s of r)if(s.toLowerCase()===t)return!0}return!1},m=(t,e)=>{const r=c(t);if(!r)return!1;const{localPart:s}=r,i=s.split("+")[0];if(o(s,n,e)||o(i,n,e))return!0;const a=i.split(u).filter(Boolean);return a.length>1&&a.some(p=>o(p,n,e))},d=t=>{const e=c(t);if(!e)return!1;const r=e.localPart.split("+")[0];return o(e.localPart,l)||o(r,l)};export{l as NO_REPLY_PREFIXES,n as ROLE_ACCOUNT_PREFIXES,m as default,d as isNoReply,m as isRoleAccount};
+import{splitAddress as m}from"../packem_shared/extractDomain-C7YvhtJH.js";const p=new Set(["do-not-reply","do_not_reply","donotreply","no-reply","no_reply","noreply","notification","notifications","notify"]),i=new Set(["abuse","accounting","accounts","admin","administrator","all","billing","board","career","careers","ceo","cfo","compliance","contact","contacts","cto","customercare","customerservice","dev","developer","devnull","do-not-reply","do_not_reply","donotreply","enquiries","enquiry","everyone","feedback","finance","ftp","hello","help","helpdesk","hi","hostmaster","hr","info","information","inquiries","inquiry","investor","investors","it","jobs","legal","list","list-request","mail","mailer-daemon","mailerdaemon","majordomo","marketing","media","members","newsletter","no-reply","no_reply","noc","noreply","notification","notifications","notify","office","operations","order","orders","postmaster","press","privacy","purchasing","recruitment","register","registration","root","sales","secretary","security","service","services","shop","spam","staff","subscribe","support","sysadmin","team","tech","test","unsubscribe","usenet","uucp","webmaster","welcome","www"]),u=/[.\-_+]/,r=(o,e,t)=>e.has(o)||(t?.has(o)??!1),d=(o,e)=>{const t=m(o);if(!t)return!1;const{localPart:a}=t,c=a.split("+")[0],s=e?new Set([...e].map(n=>n.toLowerCase())):void 0;if(r(a,i,s)||r(c,i,s))return!0;const l=c.split(u).filter(Boolean);return l.length>1&&l.some(n=>r(n,i,s))},y=o=>{const e=m(o);if(!e)return!1;const t=e.localPart.split("+")[0];return r(e.localPart,p)||r(t,p)};export{p as NO_REPLY_PREFIXES,i as ROLE_ACCOUNT_PREFIXES,d as default,y as isNoReply,d as isRoleAccount};

package/dist/checks/smtp.d.ts

@@ -1,43 +1,43 @@
-import { b as MxCheckResult, C as Cache, c as MxRecord } from "../packem_shared/mx.d-NAesS5sg.js";
+import { b as MxCheckResult, C as Cache, c as MxRecord } from "../packem_shared/mx.d-HxIDdxvR.js";
 /**
-* Options for SMTP verification.
-*/
+ * Options for SMTP verification.
+ */
 interface SmtpVerificationOptions {
   /** Cache for the underlying MX lookup. */
   cache?: Cache<MxCheckResult>;
   /**
-  * Number of random, almost-certainly-nonexistent addresses to probe for
-  * catch-all detection. More probes reduce false positives from
-  * deferred-rejection servers. Set to 0 to disable.
-  * @default 1
-  */
+   * Number of random, almost-certainly-nonexistent addresses to probe for
+   * catch-all detection. More probes reduce false positives from
+   * deferred-rejection servers. Set to 0 to disable.
+   * @default 1
+   */
   catchAllProbes?: number;
   /**
-  * MAIL FROM address used during the probe; defaults to `verify@` followed by
-  * the HELO host.
-  */
+   * MAIL FROM address used during the probe; defaults to `verify@` followed by
+   * the HELO host.
+   */
   fromEmail?: string;
   /**
-  * HELO/EHLO hostname presented to the remote server.
-  * @default the address domain
-  */
+   * HELO/EHLO hostname presented to the remote server.
+   * @default the address domain
+   */
   heloHost?: string;
   /**
-  * Pre-resolved MX records to probe, in priority order. When provided, the
-  * probe skips its own DNS lookup — the orchestrator passes the records it
-  * already resolved so the domain is not queried twice.
-  */
+   * Pre-resolved MX records to probe, in priority order. When provided, the
+   * probe skips its own DNS lookup — the orchestrator passes the records it
+   * already resolved so the domain is not queried twice.
+   */
   mxRecords?: MxRecord[];
   port?: number;
   /**
-  * Number of times to retry the whole probe on a temporary (greylist) failure.
-  * @default 1
-  */
+   * Number of times to retry the whole probe on a temporary (greylist) failure.
+   * @default 1
+   */
   retries?: number;
   /**
-  * Delay in milliseconds between greylist retries.
-  * @default 5000
-  */
+   * Delay in milliseconds between greylist retries.
+   * @default 5000
+   */
   retryDelay?: number;
   /** Cache for SMTP results. */
   smtpCache?: Cache<SmtpVerificationResult>;
@@ -45,8 +45,8 @@ interface SmtpVerificationOptions {
   ttl?: number;
 }
 /**
-* Detailed result of an SMTP verification attempt.
-*/
+ * Detailed result of an SMTP verification attempt.
+ */
 interface SmtpVerificationResult {
   /** True when the server accepts a random, nonexistent recipient (catch-all). */
   acceptAll?: boolean;
@@ -64,30 +64,5 @@ interface SmtpVerificationResult {
   /** True when the real RCPT TO was accepted (250). */
   valid: boolean;
 }
-/**
-* Verifies an email address over SMTP without sending a message.
-*
-* Performs the full handshake (greeting → EHLO/HELO → MAIL FROM → RCPT TO),
-* then — when the real recipient is accepted — issues additional RCPT TO probes
-* for random addresses to detect catch-all (accept-all) servers. Temporary
-* (4xx) failures are surfaced as `deferred` and retried up to `retries` times to
-* survive greylisting, and over-quota responses set `mailboxFull`.
-*
-* Note: many networks block outbound port 25 and many servers refuse or tarpit
-* verification probes, so treat a `deferred`/errored result as inconclusive
-* rather than undeliverable.
-* @param email The email address to verify.
-* @param options Verification options.
-* @returns The detailed SMTP verification result.
-* @example
-* ```ts
-* import { verifySmtp } from "@visulima/email-verifier/checks/smtp";
-*
-* const result = await verifySmtp("user@example.com", { catchAllProbes: 2 });
-* if (result.valid && !result.acceptAll) {
-*     console.log("Mailbox exists");
-* }
-* ```
-*/
 declare const verifySmtp: (email: string, options?: SmtpVerificationOptions) => Promise<SmtpVerificationResult>;
 export { type SmtpVerificationOptions, type SmtpVerificationResult, verifySmtp as default, verifySmtp };

package/dist/checks/smtp.js

@@ -1,7 +1,7 @@
-import{createRequire as x}from"node:module";import{splitAddress as M}from"../packem_shared/extractDomain-CYJf1_0N.js";import{checkMxRecords as j}from"./mx.js";const $=x(import.meta.url),h=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,R=r=>{if(typeof h<"u"&&h.versions&&h.versions.node){const[e,t]=h.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return h.getBuiltinModule(r)}return $(r)},{Socket:T}=R("node:net"),y=/[\u0000-\u001F\u007F]/,k=/\b([245]\.\d{1,3}\.\d{1,3})\b/,C=/^(\d{3})(?: |$)/,E=/\r?\n/,g="abcdefghijklmnopqrstuvwxyz0123456789",P=(r=20)=>{let e="";for(let t=0;t<r;t+=1)e+=g[Math.floor(Math.random()*g.length)]??"";return e},S=async r=>new Promise(e=>{setTimeout(e,r)});class _{transcript="";buffer="";completed=[];failure;finished=!1;socket;waiter;constructor(e){this.socket=e,e.on("data",o=>{this.transcript+=o.toString(),this.buffer+=o.toString(),this.drain()});const t=o=>{this.finished=!0,this.failure=o??new Error("Connection closed by server"),this.completed.length===0&&this.waiter&&(this.waiter.reject(this.failure),this.waiter=void 0)};e.on("error",t),e.on("close",()=>{t()}),e.on("timeout",()=>{t(new Error("SMTP socket timeout")),e.destroy()})}async command(e){return this.transcript+=`${e}\r
+import{createRequire as b}from"node:module";import{splitAddress as T}from"../packem_shared/extractDomain-C7YvhtJH.js";import{checkMxRecords as j}from"./mx.js";let _;const x=r=>(_??=b(import.meta.url))(r),h=typeof globalThis<"u"&&typeof globalThis.process<"u"?globalThis.process:process,L=r=>{if(typeof h<"u"&&h.versions&&h.versions.node){const[e,t]=h.versions.node.split(".").map(Number);if(e>22||e===22&&t>=3||e===20&&t>=16)return h.getBuiltinModule(r)}return x(r)},{Socket:C}=L("node:net"),E=/[\u0000-\u001F\u007F]/,M=/\b([245]\.\d{1,3}\.\d{1,3})\b/,P=/^(\d{3})(?: |$)/,$=/\r?\n/,R="abcdefghijklmnopqrstuvwxyz0123456789",A=(r=20)=>{let e="";for(let t=0;t<r;t+=1)e+=R[Math.floor(Math.random()*R.length)]??"";return e},S=async r=>new Promise(e=>{setTimeout(e,r)});class H{transcript="";buffer="";completed=[];failure;finished=!1;socket;waiter;constructor(e){this.socket=e,e.on("data",n=>{this.transcript+=n.toString(),this.buffer+=n.toString(),this.drain()});const t=n=>{this.finished=!0,this.failure=n??new Error("Connection closed by server"),this.completed.length===0&&this.waiter&&(this.waiter.reject(this.failure),this.waiter=void 0)};e.on("error",t),e.on("close",()=>{t()}),e.on("timeout",()=>{t(new Error("SMTP socket timeout")),e.destroy()})}async command(e){return this.transcript+=`${e}\r
 `,this.socket.write(`${e}\r
 `),this.readReply()}close(){try{this.socket.write(`QUIT\r
-`)}catch{}this.socket.removeAllListeners(),this.socket.destroy()}async readReply(){if(this.completed.length>0)return this.completed.shift();if(this.finished)throw this.failure??new Error("Connection closed");return new Promise((e,t)=>{this.waiter={reject:t,resolve:e}})}drain(){const e=this.buffer.split(E);this.buffer=e.pop()??"";let t=[];for(const o of e){t.push(o);const a=C.exec(o);if(a){const i=t.join(`
-`),c=k.exec(i)?.[1];this.completed.push({code:Number.parseInt(a[1],10),enhanced:c,text:i}),t=[]}}if(t.length>0&&(this.buffer=`${t.join(`
+`)}catch{}this.socket.removeAllListeners(),this.socket.destroy()}async readReply(){if(this.completed.length>0)return this.completed.shift();if(this.finished)throw this.failure??new Error("Connection closed");return new Promise((e,t)=>{this.waiter={reject:t,resolve:e}})}drain(){const e=this.buffer.split($);this.buffer=e.pop()??"";let t=[];for(const n of e){t.push(n);const c=P.exec(n);if(c){const o=t.join(`
+`),l=M.exec(o)?.[1];this.completed.push({code:Number.parseInt(c[1],10),enhanced:l,text:o}),t=[]}}if(t.length>0&&(this.buffer=`${t.join(`
 `)}
-${this.buffer}`),this.waiter&&this.completed.length>0){const{resolve:o}=this.waiter;this.waiter=void 0,o(this.completed.shift())}}}const A=r=>{const{code:e,enhanced:t}=r;return e>=200&&e<300?{code:e,enhancedCode:t,valid:!0}:e===452||e===552||t==="4.2.2"||t==="5.2.2"?{code:e,deferred:e===452,enhancedCode:t,mailboxFull:!0,valid:!1}:e>=400&&e<500?{code:e,deferred:!0,enhancedCode:t,valid:!1}:{code:e,enhancedCode:t,valid:!1}},L=async(r,e,t)=>new Promise((o,a)=>{const i=new T;i.setTimeout(t);const c=f=>{i.removeAllListeners(),i.destroy(),a(f)},l=()=>{c(new Error("SMTP connection timeout"))};i.once("error",c),i.once("timeout",l),i.connect(e,r,()=>{i.removeListener("error",c),i.removeListener("timeout",l),o(new _(i))})}),H=async(r,e,t,o)=>{const{catchAllProbes:a=1,port:i=25,timeout:c=5e3}=o,l=o.heloHost??e,f=o.fromEmail??`verify@${l}`;let n;try{n=await L(t.exchange,i,c);const d=await n.readReply();if(d.code!==220)return{deferred:!0,error:`Unexpected greeting: ${d.text}`,valid:!1};let s=await n.command(`EHLO ${l}`);if(s.code!==250&&(s=await n.command(`HELO ${l}`),s.code!==250))return{deferred:!0,error:`HELO rejected: ${s.text}`,valid:!1};const u=await n.command(`MAIL FROM:<${f}>`);if(u.code!==250)return{deferred:!0,error:`MAIL FROM rejected: ${u.text}`,valid:!1};const b=await n.command(`RCPT TO:<${r}>`),p=A(b);let m;if(p.valid&&a>0){m=!0;for(let v=0;v<a;v+=1){const w=await n.command(`RCPT TO:<${P()}@${e}>`);if(w.code<200||w.code>=300){m=!1;break}}}return{...p,acceptAll:m,smtpResponse:n.transcript}}finally{n?.close()}},O=async(r,e,t,o)=>{let a="SMTP verification did not complete";for(const i of t)try{return await H(r,e,i,o)}catch(c){a=c instanceof Error?c.message:String(c)}return{deferred:!0,error:a,valid:!1}},I=r=>{if(r.heloHost!==void 0&&y.test(r.heloHost))return{error:"Invalid heloHost: control characters are not allowed",valid:!1};if(r.fromEmail!==void 0&&y.test(r.fromEmail))return{error:"Invalid fromEmail: control characters are not allowed",valid:!1}},B=async(r,e={})=>{const t=M(r);if(!t)return{error:"Invalid email format",valid:!1};const{domain:o}=t,a=I(e);if(a)return a;const{retries:i=1,retryDelay:c=5e3,ttl:l=36e5}=e,f=["smtp",t.address,e.fromEmail??"",String(e.port??25),e.heloHost??"",String(e.catchAllProbes??1),(e.mxRecords??[]).map(s=>s.exchange).join(",")].join("|");if(e.smtpCache){const s=await e.smtpCache.get(f);if(s!==void 0)return s}let n=e.mxRecords;if(!n||n.length===0){const s=await j(o,{cache:e.cache,fallbackToAddress:!1});if(!s.valid||!s.records||s.records.length===0)return{error:s.error??"No MX records found",mxRecords:s.records,valid:!1};n=s.records}let d={error:"SMTP verification did not complete",valid:!1};for(let s=0;s<=i&&(d=await O(t.address,o,n,e),!(!d.deferred||s===i));s+=1)await S(c);return d={...d,mxRecords:n},e.smtpCache&&!d.deferred&&await e.smtpCache.set(f,d,l),d};export{B as default,B as verifySmtp};
+${this.buffer}`),this.waiter&&this.completed.length>0){const{resolve:n}=this.waiter;this.waiter=void 0,n(this.completed.shift())}}}const I=r=>{const{code:e,enhanced:t}=r;return e>=200&&e<300?{code:e,enhancedCode:t,valid:!0}:e===452||e===552||t==="4.2.2"||t==="5.2.2"?{code:e,deferred:e===452,enhancedCode:t,mailboxFull:!0,valid:!1}:e>=400&&e<500?{code:e,deferred:!0,enhancedCode:t,valid:!1}:{code:e,enhancedCode:t,valid:!1}},O=async(r,e,t)=>new Promise((n,c)=>{const o=new C;o.setTimeout(t);const l=a=>{o.removeAllListeners(),o.destroy(),c(a)},i=()=>{l(new Error("SMTP connection timeout"))};o.once("error",l),o.once("timeout",i),o.connect(e,r,()=>{o.removeListener("error",l),o.removeListener("timeout",i),n(new H(o))})}),k=async(r,e,t,n)=>{const{catchAllProbes:c=1,port:o=25,timeout:l=5e3}=n,i=n.heloHost??e,a=n.fromEmail??`verify@${i}`;let d;try{d=await O(t.exchange,o,l);const m=await d.readReply();if(m.code!==220)return{connectionLevel:!0,deferred:!0,error:`Unexpected greeting: ${m.text}`,valid:!1};let s=await d.command(`EHLO ${i}`);if(s.code!==250&&(s=await d.command(`HELO ${i}`),s.code!==250))return{connectionLevel:!0,deferred:!0,error:`HELO rejected: ${s.text}`,valid:!1};const u=await d.command(`MAIL FROM:<${a}>`);if(u.code!==250)return{connectionLevel:!0,deferred:!0,error:`MAIL FROM rejected: ${u.text}`,valid:!1};const f=await d.command(`RCPT TO:<${r}>`),w=I(f);let p;if(w.valid&&c>0){p=!0;for(let g=0;g<c;g+=1){const y=await d.command(`RCPT TO:<${A()}@${e}>`);if(y.code<200||y.code>=300){p=!1;break}}}return{...w,acceptAll:p,smtpResponse:d.transcript}}finally{d?.close()}},N=async(r,e,t,n)=>{let c="SMTP verification did not complete",o;for(const l of t){let i;try{i=await k(r,e,l,n)}catch(a){c=a instanceof Error?a.message:String(a);continue}if(i.connectionLevel){o=i;continue}return i}if(o){const{connectionLevel:l,...i}=o;return i}return{deferred:!0,error:c,valid:!1}},F=r=>{if(r.heloHost!==void 0&&E.test(r.heloHost))return{error:"Invalid heloHost: control characters are not allowed",valid:!1};if(r.fromEmail!==void 0&&E.test(r.fromEmail))return{error:"Invalid fromEmail: control characters are not allowed",valid:!1}},v=new Map,B=async(r,e={})=>{const t=T(r);if(!t)return{error:"Invalid email format",valid:!1};const{domain:n}=t,c=F(e);if(c)return c;const{retries:o=1,retryDelay:l=5e3,ttl:i=36e5}=e,a=["smtp",t.address,e.fromEmail??"",String(e.port??25),e.heloHost??"",String(e.catchAllProbes??1),(e.mxRecords??[]).map(s=>s.exchange).join(",")].join("|");if(e.smtpCache){const s=await e.smtpCache.get(a);if(s!==void 0)return s}const d=v.get(a);if(d)return d;const m=(async()=>{let s=e.mxRecords;if(!s||s.length===0){const f=await j(n,{cache:e.cache,fallbackToAddress:!1});if(!f.valid||!f.records||f.records.length===0)return{error:f.error??"No MX records found",mxRecords:f.records,valid:!1};s=f.records}let u={error:"SMTP verification did not complete",valid:!1};for(let f=0;f<=o&&(u=await N(t.address,n,s,e),!(!u.deferred||f===o));f+=1)await S(l);return u={...u,mxRecords:s},e.smtpCache&&!u.deferred&&await e.smtpCache.set(a,u,i),u})();v.set(a,m);try{return await m}finally{v.delete(a)}};export{B as default,B as verifySmtp};

package/dist/checks/symbol.d.ts

@@ -1,6 +1,6 @@
 /**
-* The result of symbol / Unicode analysis.
-*/
+ * The result of symbol / Unicode analysis.
+ */
 interface SymbolResult {
   /** True when the address mixes Unicode scripts (a homoglyph-spoofing signal). */
   hasMixedScripts: boolean;
@@ -12,18 +12,18 @@ interface SymbolResult {
   scripts: string[];
 }
 /**
-* Detects symbols, emoji, and mixed Unicode scripts in an email address.
-*
-* Mixed-script local parts (e.g. Latin + Cyrillic) are a classic homoglyph /
-* spoofing signal; symbol or emoji characters indicate a non-standard address.
-* @param email The email address to analyze.
-* @returns The symbol analysis result.
-* @example
-* ```ts
-* import { analyzeSymbols } from "@visulima/email-verifier/checks/symbol";
-*
-* analyzeSymbols("раypal@example.com").hasMixedScripts; // true (Cyrillic "ра")
-* ```
-*/
+ * Detects symbols, emoji, and mixed Unicode scripts in an email address.
+ *
+ * Mixed-script local parts (e.g. Latin + Cyrillic) are a classic homoglyph /
+ * spoofing signal; symbol or emoji characters indicate a non-standard address.
+ * @param email The email address to analyze.
+ * @returns The symbol analysis result.
+ * @example
+ * ```ts
+ * import { analyzeSymbols } from "@visulima/email-verifier/checks/symbol";
+ *
+ * analyzeSymbols("раypal@example.com").hasMixedScripts; // true (Cyrillic "ра")
+ * ```
+ */
 declare const analyzeSymbols: (email: string) => SymbolResult;
 export { type SymbolResult, analyzeSymbols, analyzeSymbols as default };

package/dist/checks/symbol.js

@@ -1 +1 @@
-import{splitAddress as n}from"../packem_shared/extractDomain-CYJf1_0N.js";const l=new RegExp("\\P{ASCII}","u"),c=new RegExp("\\p{S}","u"),p=[["Latin",new RegExp("\\p{Script=Latin}","u")],["Cyrillic",new RegExp("\\p{Script=Cyrillic}","u")],["Greek",new RegExp("\\p{Script=Greek}","u")],["Han",new RegExp("\\p{Script=Han}","u")],["Hiragana",new RegExp("\\p{Script=Hiragana}","u")],["Katakana",new RegExp("\\p{Script=Katakana}","u")],["Hangul",new RegExp("\\p{Script=Hangul}","u")],["Arabic",new RegExp("\\p{Script=Arabic}","u")],["Hebrew",new RegExp("\\p{Script=Hebrew}","u")]],g=i=>{const e=n(i);if(!e)return{hasMixedScripts:!1,hasNonAscii:!1,hasSymbols:!1,scripts:[]};const t=`${e.localPart}${e.domain}`,r=p.filter(([,a])=>a.test(t)).map(([a])=>a);return{hasMixedScripts:[e.localPart,...e.domain.split(".").filter(Boolean)].some(a=>p.filter(([,s])=>s.test(a)).length>1),hasNonAscii:l.test(e.address),hasSymbols:c.test(t),scripts:r}};export{g as analyzeSymbols,g as default};
+import{splitAddress as r}from"../packem_shared/extractDomain-C7YvhtJH.js";const c=new RegExp("\\P{ASCII}","u"),l=new RegExp("\\p{S}","u"),a=[["Latin",new RegExp("\\p{Script=Latin}","u")],["Cyrillic",new RegExp("\\p{Script=Cyrillic}","u")],["Greek",new RegExp("\\p{Script=Greek}","u")],["Han",new RegExp("\\p{Script=Han}","u")],["Hiragana",new RegExp("\\p{Script=Hiragana}","u")],["Katakana",new RegExp("\\p{Script=Katakana}","u")],["Hangul",new RegExp("\\p{Script=Hangul}","u")],["Arabic",new RegExp("\\p{Script=Arabic}","u")],["Hebrew",new RegExp("\\p{Script=Hebrew}","u")]],E=n=>{const e=r(n);if(!e)return{hasMixedScripts:!1,hasNonAscii:!1,hasSymbols:!1,scripts:[]};const s=`${e.localPart}${e.domain}`,p=a.filter(([,t])=>t.test(s)).map(([t])=>t);return{hasMixedScripts:[e.localPart,...e.domain.split(".").filter(Boolean)].some(t=>a.filter(([,i])=>i.test(t)).length>1),hasNonAscii:c.test(e.address),hasSymbols:l.test(s),scripts:p}};export{E as analyzeSymbols,E as default};

package/dist/checks/syntax.d.ts

@@ -1,19 +1,19 @@
 /**
-* Validates an email address format according to basic RFC standards.
-*
-* This is intentionally pragmatic rather than a full RFC 5322 parser: it rejects
-* the address shapes that never deliver (missing parts, consecutive dots, leading
-* or trailing dots, hyphen-bounded domain labels) while accepting the long tail
-* of legitimate real-world addresses.
-* @param email The email address string to validate.
-* @returns True if the email address is syntactically valid, false otherwise.
-* @example
-* ```ts
-* import { validateSyntax } from "@visulima/email-verifier/checks/syntax";
-*
-* validateSyntax("user@example.com"); // true
-* validateSyntax("user@@example.com"); // false
-* ```
-*/
+ * Validates an email address format according to basic RFC standards.
+ *
+ * This is intentionally pragmatic rather than a full RFC 5322 parser: it rejects
+ * the address shapes that never deliver (missing parts, consecutive dots, leading
+ * or trailing dots, hyphen-bounded domain labels) while accepting the long tail
+ * of legitimate real-world addresses.
+ * @param email The email address string to validate.
+ * @returns True if the email address is syntactically valid, false otherwise.
+ * @example
+ * ```ts
+ * import { validateSyntax } from "@visulima/email-verifier/checks/syntax";
+ *
+ * validateSyntax("user@example.com"); // true
+ * validateSyntax("user@@example.com"); // false
+ * ```
+ */
 declare const validateSyntax: (email: string) => boolean;
 export { validateSyntax as default, validateSyntax };

package/dist/checks/syntax.js

@@ -1 +1 @@
-import{splitAddress as n}from"../packem_shared/extractDomain-CYJf1_0N.js";const r=/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/,l=/^[\p{L}\p{N}-]+$/u,o=s=>{if(!s||typeof s!="string"||!r.test(s)||s.includes(".."))return!1;const a=n(s);if(!a)return!1;const{domain:t,localPart:i}=a;return i.startsWith(".")||i.endsWith(".")||!t.includes(".")||t.startsWith("-")||t.endsWith("-")?!1:t.split(".").every(e=>e.length>0&&!e.startsWith("-")&&!e.endsWith("-")&&l.test(e))};export{o as default,o as validateSyntax};
+import{splitAddress as i}from"../packem_shared/extractDomain-C7YvhtJH.js";const f=/^[^\s@]+@[^\s@][^\s.@]*\.[^\s@]+$/,a=/^[\p{L}\p{N}-]+$/u,u=t=>{if(!t||typeof t!="string"||!f.test(t)||t.includes(".."))return!1;const e=i(t);if(!e)return!1;const{domain:s,localPart:n}=e;return n.startsWith(".")||n.endsWith(".")||!s.includes(".")||s.startsWith("-")||s.endsWith("-")?!1:s.split(".").every(r=>r.length>0&&!r.startsWith("-")&&!r.endsWith("-")&&a.test(r))};export{u as default,u as validateSyntax};

package/dist/checks/tag.d.ts

@@ -1,6 +1,6 @@
 /**
-* The result of sub-address (tag) detection.
-*/
+ * The result of sub-address (tag) detection.
+ */
 interface TagResult {
   /** The local part with the tag and separator removed (the "real" mailbox). */
   baseLocalPart: string;
@@ -12,20 +12,20 @@ interface TagResult {
   tag?: string;
 }
 /**
-* Detects plus-addressing / sub-addressing tags in an email address.
-*
-* Most providers (Gmail, Outlook, iCloud, Proton, …) delimit the tag with `+`;
-* a few (Fastmail, Yahoo) use `-`. The returned {@link TagResult.baseLocalPart}
-* is the canonical mailbox with the tag stripped.
-* @param email The email address to inspect.
-* @returns The tag detection result.
-* @example
-* ```ts
-* import { detectTag } from "@visulima/email-verifier/checks/tag";
-*
-* detectTag("user+newsletter@gmail.com");
-* // { hasTag: true, tag: "newsletter", separator: "+", baseLocalPart: "user" }
-* ```
-*/
+ * Detects plus-addressing / sub-addressing tags in an email address.
+ *
+ * Most providers (Gmail, Outlook, iCloud, Proton, …) delimit the tag with `+`;
+ * a few (Fastmail, Yahoo) use `-`. The returned {@link TagResult.baseLocalPart}
+ * is the canonical mailbox with the tag stripped.
+ * @param email The email address to inspect.
+ * @returns The tag detection result.
+ * @example
+ * ```ts
+ * import { detectTag } from "@visulima/email-verifier/checks/tag";
+ *
+ * detectTag("user+newsletter@gmail.com");
+ * // { hasTag: true, tag: "newsletter", separator: "+", baseLocalPart: "user" }
+ * ```
+ */
 declare const detectTag: (email: string) => TagResult;
 export { type TagResult, detectTag as default, detectTag };

package/dist/checks/tag.js

@@ -1 +1 @@
-import{splitAddress as c}from"../packem_shared/extractDomain-CYJf1_0N.js";const l=new Set(["fastmail.com","fastmail.fm","yahoo.co.uk","yahoo.com"]),f=r=>{const e=c(r);if(!e)return{baseLocalPart:"",hasTag:!1};const{domain:o,localPart:a}=e,s=a.indexOf("+");if(s>0)return{baseLocalPart:a.slice(0,s),hasTag:!0,separator:"+",tag:a.slice(s+1)};if(l.has(o)){const t=a.indexOf("-");if(t>0)return{baseLocalPart:a.slice(0,t),hasTag:!0,separator:"-",tag:a.slice(t+1)}}return{baseLocalPart:a,hasTag:!1}};export{f as default,f as detectTag};
+import{splitAddress as c}from"../packem_shared/extractDomain-C7YvhtJH.js";const l=new Set(["fastmail.com","fastmail.fm","yahoo.co.uk","yahoo.com"]),i=o=>{const e=c(o);if(!e)return{baseLocalPart:"",hasTag:!1};const{domain:r,localPart:a}=e,s=a.indexOf("+");if(s>0)return{baseLocalPart:a.slice(0,s),hasTag:!0,separator:"+",tag:a.slice(s+1)};if(l.has(r)){const t=a.indexOf("-");if(t>0)return{baseLocalPart:a.slice(0,t),hasTag:!0,separator:"-",tag:a.slice(t+1)}}return{baseLocalPart:a,hasTag:!1}};export{i as default,i as detectTag};

package/dist/enrich/name.d.ts

@@ -1,6 +1,6 @@
 /**
-* A name parsed from an email's local part.
-*/
+ * A name parsed from an email's local part.
+ */
 interface NameResult {
   /** Confidence in the parse: `high` (clear separator), `medium` (camelCase), `low` (heuristic), `none`. */
   confidence: "high" | "low" | "medium" | "none";
@@ -12,21 +12,21 @@ interface NameResult {
   lastName?: string;
 }
 /**
-* Heuristically parses a person's name from the local part of an email address.
-*
-* Handles separator-delimited (`john.doe`), camelCase (`johnDoe`), and
-* single-token local parts, stripping trailing digits. This is best-effort name
-* parsing only — no gender detection — and confidence is reported so callers
-* can decide how much to trust it.
-* @param email The email address to parse.
-* @returns The parsed name and a confidence level.
-* @example
-* ```ts
-* import { parseName } from "@visulima/email-verifier/enrich/name";
-*
-* parseName("john.doe@example.com");
-* // { firstName: "John", lastName: "Doe", fullName: "John Doe", confidence: "high" }
-* ```
-*/
+ * Heuristically parses a person's name from the local part of an email address.
+ *
+ * Handles separator-delimited (`john.doe`), camelCase (`johnDoe`), and
+ * single-token local parts, stripping trailing digits. This is best-effort name
+ * parsing only — no gender detection — and confidence is reported so callers
+ * can decide how much to trust it.
+ * @param email The email address to parse.
+ * @returns The parsed name and a confidence level.
+ * @example
+ * ```ts
+ * import { parseName } from "@visulima/email-verifier/enrich/name";
+ *
+ * parseName("john.doe@example.com");
+ * // { firstName: "John", lastName: "Doe", fullName: "John Doe", confidence: "high" }
+ * ```
+ */
 declare const parseName: (email: string) => NameResult;
 export { type NameResult, parseName as default, parseName };

package/dist/enrich/name.js

@@ -1 +1 @@
-import{splitAddress as p}from"../packem_shared/extractDomain-CYJf1_0N.js";const f=/[.\-_]/,u=/^[a-z]+(?:[A-Z][a-z]+)+$/,d=/\d+$/,N=/\d/,r=e=>e.length===0?e:e.charAt(0).toUpperCase()+e.slice(1).toLowerCase(),h=e=>e.replaceAll(/([a-z])([A-Z])/g,"$1 $2").split(" "),g=e=>{const s=p(e);if(!s)return{confidence:"none"};const i=e.trim().lastIndexOf("@"),t=(i>0?e.trim().slice(0,i):s.localPart).split("+")[0].replace(d,"");if(t.length===0)return{confidence:"none"};let a,o;if(f.test(t))a=t.split(f).filter(Boolean),o="high";else if(u.test(t))a=h(t),o="medium";else return N.test(t)?{confidence:"none"}:{confidence:"low",firstName:r(t),fullName:r(t)};const n=a.map(m=>m.replace(d,"")).filter(Boolean);if(n.length===0)return{confidence:"none"};const l=r(n[0]);if(n.length===1)return{confidence:"low",firstName:l,fullName:l};const c=r(n.at(-1));return{confidence:o,firstName:l,fullName:`${l} ${c}`,lastName:c}};export{g as default,g as parseName};
+import{splitAddress as m}from"../packem_shared/extractDomain-C7YvhtJH.js";const f=/[.\-_]/,u=/^[a-z]+(?:[A-Z][a-z]+)+$/,d=/\d+$/,A=/\d/,r=e=>e.length===0?e:e.charAt(0).toUpperCase()+e.slice(1).toLowerCase(),E=e=>e.replaceAll(/([a-z])([A-Z])/g,"$1 $2").split(" "),_=e=>{const l=m(e);if(!l)return{confidence:"none"};const a=e.trim().lastIndexOf("@"),t=(a>0?e.trim().slice(0,a):l.localPart).split("+")[0].replace(d,"");if(t.length===0)return{confidence:"none"};let s,c;if(f.test(t))s=t.split(f).filter(Boolean),c="high";else if(u.test(t))s=E(t),c="medium";else return A.test(t)?{confidence:"none"}:{confidence:"low",firstName:r(t),fullName:r(t)};const n=s.map(p=>p.replace(d,"")).filter(Boolean);if(n.length===0)return{confidence:"none"};const o=r(n[0]);if(n.length===1)return{confidence:"low",firstName:o,fullName:o};const i=r(n.at(-1));return{confidence:c,firstName:o,fullName:`${o} ${i}`,lastName:i}};export{_ as default,_ as parseName};

package/dist/enrich/provider.d.ts

@@ -1,9 +1,9 @@
 import { MxProviderInfo } from '@visulima/email-provider-mx';
 export { type MxProviderInfo, classifyMx, classifyMxRecords, isSecureEmailGateway } from '@visulima/email-provider-mx';
-import { c as MxRecord, b as MxCheckResult, C as Cache } from "../packem_shared/mx.d-NAesS5sg.js";
+import { c as MxRecord, b as MxCheckResult, C as Cache } from "../packem_shared/mx.d-HxIDdxvR.js";
 /**
-* The enriched provider details for an email address.
-*/
+ * The enriched provider details for an email address.
+ */
 interface ProviderDetails {
   /** True when the resolving MX is a Secure Email Gateway (Proofpoint, Mimecast, …). */
   isSecureEmailGateway: boolean;
@@ -13,28 +13,28 @@ interface ProviderDetails {
   provider?: MxProviderInfo;
 }
 /**
-* Options for provider enrichment.
-*/
+ * Options for provider enrichment.
+ */
 interface ProviderEnrichOptions {
   cache?: Cache<MxCheckResult>;
   ttl?: number;
 }
 /**
-* Resolves an email address's mailbox/SEG provider from its MX records.
-*
-* Looks up the domain's MX records, then classifies the highest-priority host
-* via `@visulima/email-provider-mx` — emailable's "SMTP Provider Details" plus
-* Secure-Email-Gateway detection.
-* @param email The email address to enrich.
-* @param options Caching options for the MX lookup.
-* @returns The provider details, including the MX records used.
-* @example
-* ```ts
-* import { enrichProvider } from "@visulima/email-verifier/enrich/provider";
-*
-* const details = await enrichProvider("user@gmail.com");
-* console.log(details.provider?.display); // "Google"
-* ```
-*/
+ * Resolves an email address's mailbox/SEG provider from its MX records.
+ *
+ * Looks up the domain's MX records, then classifies the highest-priority host
+ * via `@visulima/email-provider-mx` — emailable's "SMTP Provider Details" plus
+ * Secure-Email-Gateway detection.
+ * @param email The email address to enrich.
+ * @param options Caching options for the MX lookup.
+ * @returns The provider details, including the MX records used.
+ * @example
+ * ```ts
+ * import { enrichProvider } from "@visulima/email-verifier/enrich/provider";
+ *
+ * const details = await enrichProvider("user@gmail.com");
+ * console.log(details.provider?.display); // "Google"
+ * ```
+ */
 declare const enrichProvider: (email: string, options?: ProviderEnrichOptions) => Promise<ProviderDetails>;
 export { type ProviderDetails, type ProviderEnrichOptions, enrichProvider as default, enrichProvider };

package/dist/enrich/provider.js

@@ -1 +1 @@
-import{classifyMxRecords as t}from"@visulima/email-provider-mx";import{classifyMx as y,classifyMxRecords as u,isSecureEmailGateway as p}from"@visulima/email-provider-mx";import{checkMxRecords as o}from"../checks/mx.js";import{extractDomain as i}from"../packem_shared/extractDomain-CYJf1_0N.js";const d=async(c,a={})=>{const r=i(c);if(!r)return{isSecureEmailGateway:!1,mxRecords:[]};const e=(await o(r,{cache:a.cache,fallbackToAddress:!1,ttl:a.ttl})).records??[];if(e.length===0)return{isSecureEmailGateway:!1,mxRecords:e};const s=t(e);return{isSecureEmailGateway:s?.type==="seg",mxRecords:e,provider:s}};export{y as classifyMx,u as classifyMxRecords,d as default,d as enrichProvider,p as isSecureEmailGateway};
+import{classifyMxRecords as t}from"@visulima/email-provider-mx";import{classifyMx as u,classifyMxRecords as h,isSecureEmailGateway as p}from"@visulima/email-provider-mx";import{checkMxRecords as o}from"../checks/mx.js";import{extractDomain as i}from"../packem_shared/extractDomain-C7YvhtJH.js";const n=async(s,r={})=>{const a=i(s);if(!a)return{isSecureEmailGateway:!1,mxRecords:[]};const e=(await o(a,{cache:r.cache,fallbackToAddress:!1,ttl:r.ttl})).records??[];if(e.length===0)return{isSecureEmailGateway:!1,mxRecords:e};const c=t(e);return{isSecureEmailGateway:c?.type==="seg",mxRecords:e,provider:c}};export{u as classifyMx,h as classifyMxRecords,n as default,n as enrichProvider,p as isSecureEmailGateway};