@visulima/email 1.0.0-alpha.2 → 1.0.0-alpha.21

package/dist/utils/cache.d.ts

@@ -1,54 +1,55 @@
 /**
- * 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>;
+* Generic cache interface for caching any type of data.
+* Implementations can use in-memory cache, LRU cache, Redis, etc.
+*/
+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;
+* Options for creating an in-memory cache.
+*/
+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>;
+* Default in-memory cache implementation using LRU cache.
+*/
+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>;
 }
+export { Cache, InMemoryCache, InMemoryCacheOptions };

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

@@ -1,9 +1,10 @@
-import type { EmailAddress } from "../types.d.ts";
+import { b as EmailAddress } from "../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
 /**
- * Formats an email address as "Name <email@example.com>" or just "email@example.com" if no name is provided.
- * @param address The email address object to format.
- * @returns The formatted email address string in RFC 5322 format.
- * @throws {EmailError} When the email address is invalid.
- */
+* Formats an email address as "Name <email@example.com>" or just "email@example.com" if no name is provided.
+* @param address The email address object to format.
+* @returns The formatted email address string in RFC 5322 format.
+* @throws {EmailError} When the email address is invalid.
+*/
 declare const formatEmailAddress: (address: EmailAddress) => string;
-export default formatEmailAddress;
+export { formatEmailAddress as default };

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

@@ -1,22 +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)
- * ```
- */
+* 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;
+export { normalizeEmailAliases as default };

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

@@ -1,19 +1,20 @@
-import type { EmailAddress } from "../types.d.ts";
+import { b as EmailAddress } from "../packem_shared/types.d-wwpgA3to.js";
+import 'node:buffer';
 /**
- * Parses a string representation of an email address into an EmailAddress object.
- * Supports formats: "email@example.com", "Name <email@example.com>", "<email@example.com>".
- * @example Parsing an address with a name
- * ```ts
- * const address = parseAddress("John Doe <john@example.com>");
- * // { name: "John Doe", email: "john@example.com" }
- * ```
- * @example Parsing an address without a name
- * ```ts
- * const address = parseAddress("jane@example.com");
- * // { email: "jane@example.com" }
- * ```
- * @param address The string representation of the address to parse.
- * @returns An EmailAddress object if parsing is successful, or undefined if invalid.
- */
+* Parses a string representation of an email address into an EmailAddress object.
+* Supports formats: "email@example.com", "Name &lt;email@example.com>", "&lt;email@example.com>".
+* @example Parsing an address with a name
+* ```ts
+* const address = parseAddress("John Doe <john@example.com>");
+* // { name: "John Doe", email: "john@example.com" }
+* ```
+* @example Parsing an address without a name
+* ```ts
+* const address = parseAddress("jane@example.com");
+* // { email: "jane@example.com" }
+* ```
+* @param address The string representation of the address to parse.
+* @returns An EmailAddress object if parsing is successful, or undefined if invalid.
+*/
 declare const parseAddress: (address: string) => EmailAddress | undefined;
-export default parseAddress;
+export { parseAddress as default };

package/dist/utils/parse-address.js

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

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

@@ -1,42 +1,43 @@
-import type { Cache } from "../cache.d.ts";
-export type { Cache, InMemoryCache } from "../cache.d.ts";
+import { Cache } from "../cache.js";
+export { type InMemoryCache } from "../cache.js";
 /**
- * MX record information.
- */
-export interface MxRecord {
-    exchange: string;
-    priority: number;
+* MX record information.
+*/
+interface MxRecord {
+  exchange: string;
+  priority: number;
 }
 /**
- * Result of MX record check.
- */
-export interface MxCheckResult {
-    error?: string;
-    records?: MxRecord[];
-    valid: boolean;
+* Result of MX record check.
+*/
+interface MxCheckResult {
+  error?: string;
+  records?: MxRecord[];
+  valid: boolean;
 }
 /**
- * Options for MX record checking.
- */
-export interface MxCheckOptions {
-    cache?: Cache<MxCheckResult>;
-    ttl?: number;
+* Options for MX record checking.
+*/
+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>;
+* 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);
+* }
+* ```
+*/
+declare const checkMxRecords: (domain: string, options?: MxCheckOptions) => Promise<MxCheckResult>;
+export { type Cache, MxCheckOptions, MxCheckResult, MxRecord, checkMxRecords };

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

@@ -1,13 +1 @@
-/**
- * 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";
+export * from '@visulima/disposable-email-domains';

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

@@ -1,21 +1,21 @@
 /**
- * Common role account prefixes that indicate non-personal email addresses.
- * Includes RFC 2142 standard role accounts and common business/operational prefixes.
- */
+* 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 };
+* 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");
+* }
+* ```
+*/
+declare const isRoleAccount: (email: string, customPrefixes?: Set<string>) => boolean;
+export { ROLE_ACCOUNT_PREFIXES, isRoleAccount };

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

@@ -1,7 +1,7 @@
 /**
- * Validates an email address format according to basic RFC standards.
- * @param email The email address string to validate.
- * @returns True if the email address is valid, false otherwise.
- */
+* Validates an email address format according to basic RFC standards.
+* @param email The email address string to validate.
+* @returns True if the email address is valid, false otherwise.
+*/
 declare const validateEmail: (email: string) => boolean;
-export default validateEmail;
+export { validateEmail as default };

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

@@ -1,47 +1,50 @@
-import type { SmtpVerificationOptions } from "./verify-smtp.d.ts";
+import { SmtpVerificationOptions } from "./verify-smtp.js";
+import "../cache.js";
+import "./check-mx-records.js";
 /**
- * Options for comprehensive email verification.
- */
-export interface EmailVerificationOptions extends SmtpVerificationOptions {
-    checkDisposable?: boolean;
-    checkMx?: boolean;
-    checkRoleAccount?: boolean;
-    checkSmtp?: boolean;
-    customDisposableDomains?: Set<string>;
-    customRolePrefixes?: Set<string>;
+* Options for comprehensive email verification.
+*/
+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[];
+* Result of comprehensive email verification.
+*/
+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>;
+* 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!");
+* }
+* ```
+*/
+declare const verifyEmail: (email: string, options?: EmailVerificationOptions) => Promise<EmailVerificationResult>;
+export { EmailVerificationOptions, EmailVerificationResult, verifyEmail };

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

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

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

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