@visulima/email 1.0.0-alpha.9 → 1.0.0

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

@@ -1,21 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-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/validation/validate-email-options.d.ts

@@ -1,8 +0,0 @@
-import type { EmailOptions } from "../../types.d.ts";
-/**
- * Validates email options and returns any validation errors.
- * @param options The email options to validate.
- * @returns Array of error messages (empty if validation passes).
- */
-declare const validateEmailOptions: <T extends EmailOptions>(options: T) => string[];
-export default validateEmailOptions;

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

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

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

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

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