📧 email-typo-fixer

A TypeScript library that fixes common email typos and formatting issues. It handles various advanced scenarios like Outlook-style emails, special characters, multiple @ symbols, and more.

🌟 Features

• Fixes common email typos and formatting issues
• Handles Outlook-style emails (e.g., "Name email@example.com")
• Handle common prefixes like "mailto:"
• Handles repeated domains (e.g., "user@gmail.com@gmail.com")
• Removes invalid special characters while preserving valid ones
• Preserves valid email characters (including +, _, -, .)
• Case-sensitive local part, lowercase domain
• No external dependencies
• Lightweight: ~2.4KB minified (ESM/CJS)

Installation

1npm install email-typo-fixer
2# or
3yarn add email-typo-fixer
4# or
5pnpm add email-typo-fixer
6# or
7bun add email-typo-fixer

🚀 Usage

1import { emailTypoFixer, DEFAULT_DOMAINS } from 'email-typo-fixer';
2
3// Basic usage (using default domains)
4const result = emailTypoFixer('user@gmial.com');
5console.log(result); 
6// Output:
7// {
8//   original: 'user@gmial.com',
9//   suggested: 'user@gmail.com',
10//   hasCorrection: true
11// }
12
13// Outlook-style email
14const result2 = emailTypoFixer('John Doe <john.doe@@gmail.com>');
15console.log(result2.suggested); // 'john.doe@gmail.com'
16
17// With custom domains (overriding defaults)
18const result3 = emailTypoFixer('user@company.internal', {
19  domains: ['company.internal', 'corp.example.com']
20});
21console.log(result3.suggested); // 'user@company.internal'
22
23// Combining default domains with custom domains
24const result4 = emailTypoFixer('user@comapny.com', {
25  domains: [...DEFAULT_DOMAINS, 'company.com']
26});
27console.log(result4.suggested); // 'user@comapny.com'

📘 API

emailTypoFixer(email: string, opts?: EmailTypoFixerOptions): EmailTypoFixerResult

Parameters

• email: The email address to fix
• opts (optional): Configuration options
  • domains: Array of valid domains to use for corrections. Defaults to:

    1[
    2  "gmail.com",
    3  "yahoo.com",
    4  "hotmail.com",
    5  "outlook.com",
    6  "icloud.com",
    7  "aol.com"
    8]

  • domainMatchDistance: Maximum allowed distance for domain corrections (default: 3). Lower values are more strict:

    1// More strict (only minor typos)
    2emailTypoFixer('user@outl00k.com', { domainMatchDistance: 2 }); // No correction
    3
    4// Default behavior
    5emailTypoFixer('user@outl00k.com', { domainMatchDistance: 3 }); // Suggests: user@outlook.com
    6
    7// More lenient
    8emailTypoFixer('user@gmaillll.com', { domainMatchDistance: 5 }); // Suggests: user@gmail.com

Returns

1interface EmailTypoFixerResult {
2  original: string;               // Original input
3  suggested: string | undefined;  // Corrected email (if changes were made)
4  hasCorrection: boolean;         // Whether any corrections were made
5}

📝 Examples of Fixes

Here are some common fixes the library handles:

• Outlook Format: "John Doe <john.doe@example.com>" → "john.doe@example.com"
• Multiple @: "user@@gmail.com" → "user@gmail.com"
• Special Characters: "user.name+tag@domain.com$" → "user.name+tag@domain.com"
• Domain Typos: "user@gmial.com" → "user@gmail.com"
• Multiple Fixes: "John Smith <test,user@@gmial..com>" → "test.user@gmail.com"

For a comprehensive list of examples and edge cases, check out our test file

❤️ Acknowledgments

This project builds upon ideas from:

• email-spell-checker - Implementation of the Sift3 algorithm and configurable domains approach

📄 License

MIT

🤝 Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.