@visulima/email-verifier 1.0.0 → 1.0.2

package/dist/enrich/typo.d.ts

@@ -1,6 +1,6 @@
 /**
-* A suggested correction for a likely-misspelled email address.
-*/
+ * A suggested correction for a likely-misspelled email address.
+ */
 interface TypoSuggestion {
   /** The suggested corrected domain. */
   domain: string;
@@ -8,52 +8,52 @@ interface TypoSuggestion {
   full: string;
 }
 /**
-* Options for typo suggestion.
-*/
+ * Options for typo suggestion.
+ */
 interface TypoOptions {
   /** Popular full domains to match against (e.g. `gmail.com`). */
   domains?: string[];
   /**
-  * Distance threshold for the full-domain match.
-  * @default 2
-  */
+   * Distance threshold for the full-domain match.
+   * @default 2
+   */
   domainThreshold?: number;
   /** Popular second-level domains to match against (e.g. `gmail`). */
   secondLevelDomains?: string[];
   /**
-  * Distance threshold for the second-level match.
-  * @default 2
-  */
+   * Distance threshold for the second-level match.
+   * @default 2
+   */
   secondLevelThreshold?: number;
   /** Popular top-level domains to match against (e.g. `com`). */
   topLevelDomains?: string[];
   /**
-  * Distance threshold for the top-level match.
-  * @default 2
-  */
+   * Distance threshold for the top-level match.
+   * @default 2
+   */
   topLevelThreshold?: number;
 }
 declare const sift3Distance: (s1: string, s2: string) => number;
 /**
-* Suggests a corrected domain for a likely-misspelled one, using the mailcheck
-* algorithm (full-domain match, then second-level + top-level matching).
-* @param domain The domain to check.
-* @param options Override domain lists and thresholds.
-* @returns The suggested domain, or `undefined` when the domain looks fine.
-*/
+ * Suggests a corrected domain for a likely-misspelled one, using the mailcheck
+ * algorithm (full-domain match, then second-level + top-level matching).
+ * @param domain The domain to check.
+ * @param options Override domain lists and thresholds.
+ * @returns The suggested domain, or `undefined` when the domain looks fine.
+ */
 declare const suggestDomain: (domain: string, options?: TypoOptions) => string | undefined;
 /**
-* Suggests a corrected email address when the domain looks misspelled
-* (e.g. `user@gmial.com` → `user@gmail.com`).
-* @param email The email address to check.
-* @param options Override domain lists and thresholds.
-* @returns A {@link TypoSuggestion}, or `undefined` when nothing looks wrong.
-* @example
-* ```ts
-* import { suggestEmailTypo } from "@visulima/email-verifier/enrich/typo";
-*
-* suggestEmailTypo("user@gmial.com")?.full; // "user@gmail.com"
-* ```
-*/
+ * Suggests a corrected email address when the domain looks misspelled
+ * (e.g. `user@gmial.com` → `user@gmail.com`).
+ * @param email The email address to check.
+ * @param options Override domain lists and thresholds.
+ * @returns A {@link TypoSuggestion}, or `undefined` when nothing looks wrong.
+ * @example
+ * ```ts
+ * import { suggestEmailTypo } from "@visulima/email-verifier/enrich/typo";
+ *
+ * suggestEmailTypo("user@gmial.com")?.full; // "user@gmail.com"
+ * ```
+ */
 declare const suggestEmailTypo: (email: string, options?: TypoOptions) => TypoSuggestion | undefined;
 export { type TypoOptions, type TypoSuggestion, suggestEmailTypo as default, sift3Distance, suggestDomain, suggestEmailTypo };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export { type CharacterResult, analyzeCharacters } from "./checks/character.js";
 export { type DisposableEmailOptions, areDisposableEmails, isDisposableDomain, isDisposableEmail } from '@visulima/disposable-email-domains';
 export { type FreeEmailOptions, areFreeEmails, isFreeDomain, isFreeEmail } from '@visulima/free-email-domains';
-export { type C as Cache, I as InMemoryCache, type a as InMemoryCacheOptions, type M as MxCheckOptions, type b as MxCheckResult, type c as MxRecord, type d as MxResolution, e as checkMxRecords } from "./packem_shared/mx.d-NAesS5sg.js";
+export { type C as Cache, I as InMemoryCache, type a as InMemoryCacheOptions, type M as MxCheckOptions, type b as MxCheckResult, type c as MxRecord, type d as MxResolution, e as checkMxRecords } from "./packem_shared/mx.d-HxIDdxvR.js";
 export { NO_REPLY_PREFIXES, ROLE_ACCOUNT_PREFIXES, isNoReply, default as isRoleAccount } from "./checks/role.js";
 export { type SmtpVerificationOptions, type SmtpVerificationResult, default as verifySmtp } from "./checks/smtp.js";
 export { type SymbolResult, analyzeSymbols } from "./checks/symbol.js";
@@ -10,12 +10,12 @@ export { type TagResult, default as detectTag } from "./checks/tag.js";
 export { type NameResult, default as parseName } from "./enrich/name.js";
 export { type ProviderDetails, type ProviderEnrichOptions, default as enrichProvider } from "./enrich/provider.js";
 export { type TypoOptions, type TypoSuggestion, sift3Distance, suggestDomain, default as suggestEmailTypo } from "./enrich/typo.js";
-export { D as DEFAULT_WEIGHTS, type a as DomainReport, type E as EmailVerificationReport, type S as ScoreInput, type b as ScoreResult, type c as ScoreWeights, type V as VerificationState, s as scoreReport } from "./packem_shared/score.d-BTcZnl2L.js";
+export { D as DEFAULT_WEIGHTS, type a as DomainReport, type E as EmailVerificationReport, type S as ScoreInput, type b as ScoreResult, type c as ScoreWeights, type V as VerificationState, s as scoreReport } from "./packem_shared/score.d-a6cl6fPu.js";
 export { type VerifyEmailOptions, default as verifyEmail } from "./verify-email.js";
 export { type MxProviderInfo, classifyMx, classifyMxRecords, isSecureEmailGateway } from '@visulima/email-provider-mx';
 /**
-* The split parts of an email address.
-*/
+ * The split parts of an email address.
+ */
 interface AddressParts {
   /** The full normalized (lowercased, trimmed) address. */
   address: string;
@@ -25,21 +25,21 @@ interface AddressParts {
   localPart: string;
 }
 /**
-* Splits an email address into its normalized local and domain parts.
-*
-* Uses the last `@` as the separator so quoted local parts containing `@` are
-* handled the same way the SMTP/MX probes treat them. Inputs containing
-* whitespace (after trimming) are rejected so a payload that embeds a CRLF
-* followed by a second SMTP command cannot be smuggled into the SMTP dialogue
-* by callers of the standalone probes.
-* @param email The email address to split.
-* @returns The normalized parts, or `undefined` if the address is structurally invalid.
-*/
+ * Splits an email address into its normalized local and domain parts.
+ *
+ * Uses the last `@` as the separator so quoted local parts containing `@` are
+ * handled the same way the SMTP/MX probes treat them. Inputs containing
+ * whitespace (after trimming) are rejected so a payload that embeds a CRLF
+ * followed by a second SMTP command cannot be smuggled into the SMTP dialogue
+ * by callers of the standalone probes.
+ * @param email The email address to split.
+ * @returns The normalized parts, or `undefined` if the address is structurally invalid.
+ */
 declare const splitAddress: (email: string) => AddressParts | undefined;
 /**
-* Extracts and normalizes just the domain from an email address.
-* @param email The email address to extract the domain from.
-* @returns The normalized domain, or `undefined` if invalid.
-*/
+ * Extracts and normalizes just the domain from an email address.
+ * @param email The email address to extract the domain from.
+ * @returns The normalized domain, or `undefined` if invalid.
+ */
 declare const extractDomain: (email: string) => string | undefined;
 export { type AddressParts, extractDomain, splitAddress };

package/dist/packem_shared/mx.d-HxIDdxvR.d.ts

@@ -0,0 +1,104 @@
+/**
+ * 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.
+ */
+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.
+ *
+ * Shared by the MX and SMTP probes so repeated lookups against the same domain
+ * (e.g. when verifying a list) avoid redundant DNS/socket work.
+ */
+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>;
+}
+/**
+ * MX record information.
+ */
+interface MxRecord {
+  exchange: string;
+  priority: number;
+}
+/**
+ * How the domain's mail-acceptance was established.
+ *
+ * - `mx`: the domain published MX records.
+ * - `address`: the domain has no MX but resolves to an A/AAAA record, so by RFC 5321 §5.1 the address itself is treated as an implicit MX.
+ * - `none`: neither MX nor address records exist.
+ */
+type MxResolution = "address" | "mx" | "none";
+/**
+ * Result of an MX/domain check.
+ */
+interface MxCheckResult {
+  /**
+   * True when the lookup was inconclusive because of a transient DNS failure
+   * (timeout, SERVFAIL, refused, …) rather than a definitive "no records"
+   * answer. Such a result is neither cached nor treated as undeliverable.
+   */
+  deferred?: boolean;
+  /** True when the domain itself resolves but publishes no MX records. */
+  domainResolves: boolean;
+  error?: string;
+  records?: MxRecord[];
+  resolvedVia: MxResolution;
+  /** True when the domain can accept mail (has MX or A/AAAA records). */
+  valid: boolean;
+}
+/**
+ * Options for MX record checking.
+ */
+interface MxCheckOptions {
+  cache?: Cache<MxCheckResult>;
+  /**
+   * When true (the default), a domain with no MX records but a resolvable
+   * A/AAAA record is still considered able to accept mail (implicit MX).
+   */
+  fallbackToAddress?: boolean;
+  ttl?: number;
+}
+declare const checkMxRecords: (domain: string, options?: MxCheckOptions) => Promise<MxCheckResult>;
+export { Cache as C, InMemoryCache as I, MxCheckOptions as M, InMemoryCacheOptions as a, MxCheckResult as b, MxRecord as c, MxResolution as d, checkMxRecords as e };

package/dist/packem_shared/{score.d-BTcZnl2L.d.ts → score.d-a6cl6fPu.d.ts}

@@ -1,23 +1,29 @@
 import { CharacterResult } from "../checks/character.js";
-import { c as MxRecord, d as MxResolution } from "./mx.d-NAesS5sg.js";
+import { c as MxRecord, d as MxResolution } from "./mx.d-HxIDdxvR.js";
 import { SmtpVerificationResult } from "../checks/smtp.js";
 import { SymbolResult } from "../checks/symbol.js";
 import { TagResult } from "../checks/tag.js";
 import { NameResult } from "../enrich/name.js";
 import { MxProviderInfo } from '@visulima/email-provider-mx';
 /**
-* The overall deliverability verdict for an address, mirroring emailable's states.
-*
-* - `deliverable`: the mailbox almost certainly exists and accepts mail.
-* - `risky`: deliverable but lower-quality (catch-all, role, disposable, full mailbox).
-* - `undeliverable`: syntax/domain/mailbox failure — do not send.
-* - `unknown`: could not be determined (SMTP blocked, greylisted, or not probed).
-*/
+ * The overall deliverability verdict for an address, mirroring emailable's states.
+ *
+ * - `deliverable`: the mailbox almost certainly exists and accepts mail.
+ * - `risky`: deliverable but lower-quality (catch-all, role, disposable, full mailbox).
+ * - `undeliverable`: syntax/domain/mailbox failure — do not send.
+ * - `unknown`: could not be determined (SMTP blocked, greylisted, or not probed).
+ */
 type VerificationState = "deliverable" | "risky" | "undeliverable" | "unknown";
 /**
-* The resolved domain portion of a verification report.
-*/
+ * The resolved domain portion of a verification report.
+ */
 interface DomainReport {
+  /**
+   * True when the domain lookup was inconclusive because of a transient DNS
+   * failure (timeout, SERVFAIL, refused). The domain is neither confirmed nor
+   * proven undeliverable — treat as `unknown`.
+   */
+  deferred?: boolean;
   /** The MX records found (empty when resolved via A/AAAA or not at all). */
   records: MxRecord[];
   /** How mail-acceptance was established (`unchecked` when DNS was skipped). */
@@ -26,11 +32,11 @@ interface DomainReport {
   valid: boolean;
 }
 /**
-* A complete email verification + enrichment report.
-*
-* Aggregates every check and enrichment into a single object whose shape reads
-* as a drop-in mental model for emailable's API response.
-*/
+ * A complete email verification + enrichment report.
+ *
+ * Aggregates every check and enrichment into a single object whose shape reads
+ * as a drop-in mental model for emailable's API response.
+ */
 interface EmailVerificationReport {
   /** True when the SMTP server accepts any recipient (catch-all / accept-all). */
   acceptAll: boolean;
@@ -76,16 +82,16 @@ interface EmailVerificationReport {
   tag: TagResult;
 }
 /**
-* The fields of a report the scorer consumes (everything except the derived
-* `score`, `state`, and `reason`).
-*/
+ * The fields of a report the scorer consumes (everything except the derived
+ * `score`, `state`, and `reason`).
+ */
 type ScoreInput = Omit<EmailVerificationReport, "reason" | "score" | "state">;
 /**
-* Overridable penalty/bonus weights for the quality score.
-*
-* Each value is points applied to a 100-point baseline. Penalties are positive
-* numbers that get subtracted; bonuses are added.
-*/
+ * Overridable penalty/bonus weights for the quality score.
+ *
+ * Each value is points applied to a 100-point baseline. Penalties are positive
+ * numbers that get subtracted; bonuses are added.
+ */
 interface ScoreWeights {
   acceptAll: number;
   character: number;
@@ -102,33 +108,33 @@ interface ScoreWeights {
   symbol: number;
 }
 /**
-* The default scoring rubric. Transparent and additive so callers can reason
-* about — and override — every weight.
-*/
+ * The default scoring rubric. Transparent and additive so callers can reason
+ * about — and override — every weight.
+ */
 declare const DEFAULT_WEIGHTS: ScoreWeights;
 /**
-* The outcome of scoring: the numeric score plus the derived state and reason.
-*/
+ * The outcome of scoring: the numeric score plus the derived state and reason.
+ */
 interface ScoreResult {
   reason: string;
   score: number;
   state: VerificationState;
 }
 /**
-* Computes a 0–100 quality score and the deliverability state for a report.
-*
-* The state is derived from hard signals (syntax, domain, SMTP verdict); the
-* score layers transparent penalties/bonuses on top so two `risky` addresses can
-* still be ranked against each other.
-* @param input The verification signals (a report without its derived fields).
-* @param weights Optional weight overrides.
-* @returns The score, state, and reason.
-* @example
-* ```ts
-* import { scoreReport } from "@visulima/email-verifier/score";
-*
-* const { score, state } = scoreReport(report);
-* ```
-*/
+ * Computes a 0–100 quality score and the deliverability state for a report.
+ *
+ * The state is derived from hard signals (syntax, domain, SMTP verdict); the
+ * score layers transparent penalties/bonuses on top so two `risky` addresses can
+ * still be ranked against each other.
+ * @param input The verification signals (a report without its derived fields).
+ * @param weights Optional weight overrides.
+ * @returns The score, state, and reason.
+ * @example
+ * ```ts
+ * import { scoreReport } from "@visulima/email-verifier/score";
+ *
+ * const { score, state } = scoreReport(report);
+ * ```
+ */
 declare const scoreReport: (input: ScoreInput, weights?: Partial<ScoreWeights>) => ScoreResult;
 export { DEFAULT_WEIGHTS as D, EmailVerificationReport as E, ScoreInput as S, VerificationState as V, DomainReport as a, ScoreResult as b, ScoreWeights as c, scoreReport as s };

package/dist/score.d.ts

@@ -1,6 +1,6 @@
-export { D as DEFAULT_WEIGHTS, type S as ScoreInput, type b as ScoreResult, type c as ScoreWeights, s as default, s as scoreReport } from "./packem_shared/score.d-BTcZnl2L.js";
+export { D as DEFAULT_WEIGHTS, type S as ScoreInput, type b as ScoreResult, type c as ScoreWeights, s as default, s as scoreReport } from "./packem_shared/score.d-a6cl6fPu.js";
 import "./checks/character.js";
-import "./packem_shared/mx.d-NAesS5sg.js";
+import "./packem_shared/mx.d-HxIDdxvR.js";
 import "./checks/smtp.js";
 import "./checks/symbol.js";
 import "./checks/tag.js";

package/dist/score.js

@@ -1 +1 @@
-const t={acceptAll:25,character:15,deferred:15,didYouMean:20,disposable:60,free:5,knownProvider:5,mailboxFull:40,mixedScripts:30,noReply:25,role:25,smtpUnverified:10,symbol:10},i=e=>Math.max(0,Math.min(100,Math.round(e))),n=e=>e.smtp!==void 0&&!e.smtp.valid&&!e.smtp.deferred&&!e.mailboxFull&&(e.smtp.code??0)>=500,d=e=>e.disposable?{reason:"disposable_mailbox",state:"risky"}:e.mailboxFull?{reason:"mailbox_full",state:"risky"}:e.acceptAll?{reason:"accept_all",state:"risky"}:e.noReply?{reason:"no_reply",state:"risky"}:e.role?{reason:"role_account",state:"risky"}:{reason:"accepted_email",state:"deliverable"},m=e=>n(e)?{reason:"rejected_email",state:"undeliverable"}:e.smtp?.valid?d(e):e.mailboxFull?{reason:"mailbox_full",state:"risky"}:e.smtp?.deferred?{reason:"greylisted",state:"unknown"}:{reason:"unknown",state:"unknown"},c=e=>e.syntaxValid?e.domain.resolvedVia!=="unchecked"&&!e.domain.valid?{reason:e.domain.resolvedVia==="none"?"no_mx_records":"invalid_domain",state:"undeliverable"}:e.smtp?m(e):e.disposable?{reason:"disposable_mailbox",state:"risky"}:{reason:"smtp_not_checked",state:"unknown"}:{reason:"invalid_syntax",state:"undeliverable"},p=(e,o={})=>{const s={...t,...o},{reason:l,state:r}=c(e);if(r==="undeliverable")return{reason:l,score:0,state:r};let a=100;return e.smtp?.valid!==!0&&(a-=s.smtpUnverified),e.deferred&&(a-=s.deferred),e.disposable&&(a-=s.disposable),e.acceptAll&&(a-=s.acceptAll),e.mailboxFull&&(a-=s.mailboxFull),e.role&&(a-=s.role),e.noReply&&(a-=s.noReply),e.free&&(a-=s.free),e.character.irregular&&(a-=s.character),e.symbol.hasMixedScripts?a-=s.mixedScripts:e.symbol.hasSymbols&&(a-=s.symbol),e.didYouMean&&(a-=s.didYouMean),e.provider&&(a+=s.knownProvider),{reason:l,score:i(a),state:r}};export{t as DEFAULT_WEIGHTS,p as default,p as scoreReport};
+const t={acceptAll:25,character:15,deferred:15,didYouMean:20,disposable:60,free:5,knownProvider:5,mailboxFull:40,mixedScripts:30,noReply:25,role:25,smtpUnverified:10,symbol:10},n=e=>Math.max(0,Math.min(100,Math.round(e))),i=e=>e.smtp!==void 0&&!e.smtp.valid&&!e.smtp.deferred&&!e.mailboxFull&&(e.smtp.code??0)>=500,d=e=>e.disposable?{reason:"disposable_mailbox",state:"risky"}:e.mailboxFull?{reason:"mailbox_full",state:"risky"}:e.acceptAll?{reason:"accept_all",state:"risky"}:e.noReply?{reason:"no_reply",state:"risky"}:e.role?{reason:"role_account",state:"risky"}:{reason:"accepted_email",state:"deliverable"},m=e=>i(e)?{reason:"rejected_email",state:"undeliverable"}:e.smtp?.valid?d(e):e.mailboxFull?{reason:"mailbox_full",state:"risky"}:e.smtp?.deferred?{reason:"greylisted",state:"unknown"}:{reason:"unknown",state:"unknown"},c=e=>e.syntaxValid?e.domain.resolvedVia!=="unchecked"&&!e.domain.valid?e.domain.deferred?{reason:"dns_error",state:"unknown"}:{reason:e.domain.resolvedVia==="none"?"no_mx_records":"invalid_domain",state:"undeliverable"}:e.smtp?m(e):e.disposable?{reason:"disposable_mailbox",state:"risky"}:{reason:"smtp_not_checked",state:"unknown"}:{reason:"invalid_syntax",state:"undeliverable"},p=(e,l={})=>{const s={...t,...l},{reason:o,state:r}=c(e);if(r==="undeliverable")return{reason:o,score:0,state:r};let a=100;return e.smtp?.valid!==!0&&(a-=s.smtpUnverified),e.deferred&&(a-=s.deferred),e.disposable&&(a-=s.disposable),e.acceptAll&&(a-=s.acceptAll),e.mailboxFull&&(a-=s.mailboxFull),e.role&&(a-=s.role),e.noReply&&(a-=s.noReply),e.free&&(a-=s.free),e.character.irregular&&(a-=s.character),e.symbol.hasMixedScripts?a-=s.mixedScripts:e.symbol.hasSymbols&&(a-=s.symbol),e.didYouMean&&(a-=s.didYouMean),e.provider&&(a+=s.knownProvider),{reason:o,score:n(a),state:r}};export{t as DEFAULT_WEIGHTS,p as default,p as scoreReport};

package/dist/verify-email.d.ts

@@ -1,35 +1,35 @@
 import { DisposableEmailOptions } from '@visulima/disposable-email-domains';
 import { FreeEmailOptions } from '@visulima/free-email-domains';
-import { b as MxCheckResult, C as Cache } from "./packem_shared/mx.d-NAesS5sg.js";
+import { b as MxCheckResult, C as Cache } from "./packem_shared/mx.d-HxIDdxvR.js";
 import { SmtpVerificationOptions } from "./checks/smtp.js";
 import { TypoOptions } from "./enrich/typo.js";
-import { c as ScoreWeights, E as EmailVerificationReport } from "./packem_shared/score.d-BTcZnl2L.js";
-export type { V as VerificationState } from "./packem_shared/score.d-BTcZnl2L.js";
+import { c as ScoreWeights, E as EmailVerificationReport } from "./packem_shared/score.d-a6cl6fPu.js";
+export type { V as VerificationState } from "./packem_shared/score.d-a6cl6fPu.js";
 import "./checks/character.js";
 import "./checks/symbol.js";
 import "./checks/tag.js";
 import "./enrich/name.js";
 import '@visulima/email-provider-mx';
 /**
-* Options for `verifyEmail`.
-*/
+ * Options for `verifyEmail`.
+ */
 interface VerifyEmailOptions {
   /** Shared cache for MX/SMTP lookups (dedupes work when verifying lists). */
   cache?: Cache<MxCheckResult>;
   /**
-  * Run live SMTP verification (catch-all, mailbox-full, greylist).
-  * @default true
-  */
+   * Run live SMTP verification (catch-all, mailbox-full, greylist).
+   * @default true
+   */
   checkSmtp?: boolean;
   /** Disposable-list overrides. */
   disposable?: DisposableEmailOptions;
   /** Free-list overrides. */
   free?: FreeEmailOptions;
   /**
-  * Skip all network checks (MX, SMTP, provider) and produce a syntax +
-  * heuristic-only report. Overrides `checkSmtp`.
-  * @default false
-  */
+   * Skip all network checks (MX, SMTP, provider) and produce a syntax +
+   * heuristic-only report. Overrides `checkSmtp`.
+   * @default false
+   */
   offline?: boolean;
   /** Additional role-account prefixes to recognize. */
   roleCustomPrefixes?: Iterable<string>;
@@ -41,22 +41,22 @@ interface VerifyEmailOptions {
   weights?: Partial<ScoreWeights>;
 }
 /**
-* Verifies and enriches a single email address end-to-end.
-*
-* Runs the offline checks (syntax, disposable, free, role, tag, character,
-* symbol, name, typo) immediately, then — unless `offline` is set — resolves the
-* domain's MX and runs the SMTP probe and provider classification concurrently.
-* Everything is aggregated into one {@link EmailVerificationReport} and scored.
-* @param email The email address to verify.
-* @param options Verification options.
-* @returns The complete verification report.
-* @example
-* ```ts
-* import { verifyEmail } from "@visulima/email-verifier";
-*
-* const report = await verifyEmail("user@gmail.com");
-* console.log(report.state, report.score); // "deliverable" 95
-* ```
-*/
+ * Verifies and enriches a single email address end-to-end.
+ *
+ * Runs the offline checks (syntax, disposable, free, role, tag, character,
+ * symbol, name, typo) immediately, then — unless `offline` is set — resolves the
+ * domain's MX and runs the SMTP probe and provider classification concurrently.
+ * Everything is aggregated into one {@link EmailVerificationReport} and scored.
+ * @param email The email address to verify.
+ * @param options Verification options.
+ * @returns The complete verification report.
+ * @example
+ * ```ts
+ * import { verifyEmail } from "@visulima/email-verifier";
+ *
+ * const report = await verifyEmail("user@gmail.com");
+ * console.log(report.state, report.score); // "deliverable" 95
+ * ```
+ */
 declare const verifyEmail: (email: string, options?: VerifyEmailOptions) => Promise<EmailVerificationReport>;
 export { type EmailVerificationReport, type VerifyEmailOptions, verifyEmail as default, verifyEmail };

package/dist/verify-email.js

@@ -1 +1 @@
-import{analyzeCharacters as h}from"./checks/character.js";import{checkMxRecords as v}from"./checks/mx.js";import x,{isNoReply as b}from"./checks/role.js";import g from"./checks/smtp.js";import{analyzeSymbols as w}from"./checks/symbol.js";import V from"./checks/syntax.js";import E from"./checks/tag.js";import R from"./enrich/name.js";import $ from"./enrich/typo.js";import{splitAddress as k}from"./packem_shared/extractDomain-CYJf1_0N.js";import f from"./score.js";import{classifyMxRecords as A}from"@visulima/email-provider-mx";import{isFreeEmail as F}from"@visulima/free-email-domains";import{isDisposableEmail as C}from"@visulima/disposable-email-domains";const p=(e,a)=>({character:h(e),didYouMean:$(e,a.typo)?.full,disposable:C(e,a.disposable),free:F(e,a.free),name:R(e),noReply:b(e),role:x(e,a.roleCustomPrefixes),symbol:w(e),tag:E(e)}),J=async(e,a={})=>{const{checkSmtp:n=!0,offline:y=!1}=a,o=k(e),t=o?.address??(typeof e=="string"?e.trim().toLowerCase():"");if(!V(e)||!o){const s={...p(t,a),acceptAll:!1,deferred:!1,domain:{records:[],resolvedVia:"unchecked",valid:!1},email:t,mailboxFull:!1,secureEmailGateway:!1,syntaxValid:!1};return{...s,...f(s,a.weights)}}const u=p(o.address,a);let m={records:[],resolvedVia:"unchecked",valid:!1},r,l,d=!1;if(!y){const s=await v(o.domain,{cache:a.cache});m={records:s.records??[],resolvedVia:s.resolvedVia,valid:s.valid};const i=s.records??[];s.valid&&i.length>0&&(l=A(i),d=l?.type==="seg",n&&(r=await g(o.address,{cache:a.cache,...a.smtp,mxRecords:i})))}const c={...u,acceptAll:r?.acceptAll??!1,deferred:r?.deferred??!1,domain:m,email:o.address,mailboxFull:r?.mailboxFull??!1,provider:l,secureEmailGateway:d,smtp:r,syntaxValid:!0};return{...c,...f(c,a.weights)}};export{J as default,J as verifyEmail};
+import{analyzeCharacters as h}from"./checks/character.js";import{checkMxRecords as v}from"./checks/mx.js";import x,{isNoReply as b}from"./checks/role.js";import g from"./checks/smtp.js";import{analyzeSymbols as w}from"./checks/symbol.js";import V from"./checks/syntax.js";import E from"./checks/tag.js";import R from"./enrich/name.js";import k from"./enrich/typo.js";import{splitAddress as A}from"./packem_shared/extractDomain-CYJf1_0N.js";import f from"./score.js";import{classifyMxRecords as F}from"@visulima/email-provider-mx";import{isFreeEmail as C}from"@visulima/free-email-domains";import{isDisposableEmail as M}from"@visulima/disposable-email-domains";const p=(e,a)=>({character:h(e),didYouMean:k(e,a.typo)?.full,disposable:M(e,a.disposable),free:C(e,a.free),name:R(e),noReply:b(e),role:x(e,a.roleCustomPrefixes),symbol:w(e),tag:E(e)}),J=async(e,a={})=>{const{checkSmtp:n=!0,offline:u=!1}=a,r=A(e),d=r?.address??(typeof e=="string"?e.trim().toLowerCase():"");if(!V(r?.address??e)||!r){const s={...p(d,a),acceptAll:!1,deferred:!1,domain:{records:[],resolvedVia:"unchecked",valid:!1},email:d,mailboxFull:!1,secureEmailGateway:!1,syntaxValid:!1};return{...s,...f(s,a.weights)}}const y=p(r.address,a);let t={records:[],resolvedVia:"unchecked",valid:!1},o,l,m=!1;if(!u){const s=await v(r.domain,{cache:a.cache});t={deferred:s.deferred,records:s.records??[],resolvedVia:s.resolvedVia,valid:s.valid};const i=s.records??[];s.valid&&i.length>0&&(l=F(i),m=l?.type==="seg",n&&(o=await g(r.address,{cache:a.cache,...a.smtp,mxRecords:i})))}const c={...y,acceptAll:o?.acceptAll??!1,deferred:o?.deferred??!1,domain:t,email:r.address,mailboxFull:o?.mailboxFull??!1,provider:l,secureEmailGateway:m,smtp:o,syntaxValid:!0};return{...c,...f(c,a.weights)}};export{J as default,J as verifyEmail};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@visulima/email-verifier",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Mailer-free email address verification and enrichment: syntax, MX/SMTP probing, disposable/free/role detection, catch-all, provider & secure-email-gateway classification, typo suggestions, and a 0–100 quality score.",
   "keywords": [
     "accept-all",
@@ -19,6 +19,11 @@
   ],
   "homepage": "https://visulima.com/packages/email-verifier",
   "bugs": "https://github.com/visulima/visulima/issues",
+  "license": "MIT",
+  "author": {
+    "name": "Daniel Bannert",
+    "email": "d.bannert@anolilab.de"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/visulima/visulima.git",
@@ -34,13 +39,13 @@
       "url": "https://anolilab.com/support"
     }
   ],
-  "license": "MIT",
-  "author": {
-    "name": "Daniel Bannert",
-    "email": "d.bannert@anolilab.de"
-  },
-  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
   "type": "module",
+  "sideEffects": false,
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -104,22 +109,17 @@
     },
     "./package.json": "./package.json"
   },
-  "files": [
-    "dist",
-    "README.md",
-    "CHANGELOG.md"
-  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
   "dependencies": {
-    "@visulima/disposable-email-domains": "1.0.0",
-    "@visulima/email-provider-mx": "1.0.0",
-    "@visulima/free-email-domains": "1.0.0",
+    "@visulima/disposable-email-domains": "1.1.0",
+    "@visulima/email-provider-mx": "1.0.1",
+    "@visulima/free-email-domains": "1.0.1",
     "lru-cache": "11.5.1"
   },
   "engines": {
     "node": "^22.14.0 || >=24.10.0"
-  },
-  "publishConfig": {
-    "access": "public",
-    "provenance": true
   }
 }