@emailcheck/email-validator-js 3.3.0 → 3.4.1

package/dist/is-spam-email.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Spam detection helper for email addresses.
+ * Detects artificially generated email addresses using linguistic heuristics.
+ */
+/**
+ * Checks if an email address appears to be spam/generated.
+ *
+ * Spam characteristics detected:
+ * - Unusually long local part (16+ characters before @)
+ * - Low vowel ratio (< 35%) - real words typically have higher vowel density
+ * - High uppercase ratio (> 30%) - indicating random capitalization
+ * - High consonant cluster ratio - many consecutive consonants
+ * - Repeated character patterns (e.g., "aaaa", "xxx")
+ * - Random-looking character sequences
+ *
+ * @param email - The email address to validate
+ * @returns true if the email appears to be spam, false otherwise
+ *
+ * @example
+ * isSpamEmail("FalDxivcRyvFRbMU@example.com") // true
+ * isSpamEmail("john.doe@example.com") // false
+ */
+export declare function isSpamEmail(email: string): boolean;
+/**
+ * Checks if an email address local part appears to be spam/generated.
+ * This is an alias for isSpamEmail with a more descriptive name.
+ *
+ * @param email - The email address to validate
+ * @returns true if the email local part appears to be spam, false otherwise
+ */
+export declare function isSpamEmailLocalPart(email: string): boolean;

package/dist/types.d.ts

@@ -28,6 +28,8 @@ export interface VerificationResult {
     domainAge?: DomainAgeInfo | null;
     domainRegistration?: DomainRegistrationInfo | null;
     domainSuggestion?: DomainSuggestion | null;
+    /** MX records found for the domain (if MX verification was performed) */
+    mxRecords?: string[] | null;
     /** Whether SMTP connection was successful */
     canConnectSmtp?: boolean;
     /** Whether the mailbox is full */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@emailcheck/email-validator-js",
-  "version": "3.3.0",
+  "version": "3.4.1",
   "private": false,
   "description": "Advanced email validation with MX records, SMTP verification, disposable email detection, batch processing, and caching. Production-ready with TypeScript support.",
   "keywords": [