@mikkelscheike/email-provider-links 2.7.0 → 2.8.0

package/README.md

@@ -1,16 +1,31 @@
 # Email Provider Links
 
-🔒 **Modern email provider detection library with concurrent DNS resolution and enterprise security**
+🔒 **Modern email provider detection library with enhanced TypeScript support and enterprise security**
 
-A TypeScript library providing direct links to **93 email providers** (178 domains) with **concurrent DNS resolution**, **optimized performance**, **email alias detection**, and comprehensive security features for login and password reset flows.
+A robust TypeScript library providing direct links to **93 email providers** (180 domains) with **concurrent DNS resolution**, **optimized performance**, **comprehensive email validation**, and advanced security features for login and password reset flows.
 
-## ✨ Features
+## 🚀 Try it out
 
-- 🚀 **Fast & Lightweight**: Zero dependencies, ultra-low memory (~0.39MB initial, ~0.02MB per 1000 ops)
+**[Live Demo](https://demo.mikkelscheike.com)** - Test the library with any email address and see it in action!
+
+## ✨ New in Version 2.7.0
+
+- 🚀 **Modern TypeScript**: Updated to latest TypeScript 2025 standards with strict type checking
+- 🌍 **Enhanced International Support**: Improved IDN validation and Punycode handling
+- 📧 **Advanced Email Validation**: Comprehensive validation with detailed error reporting
+- 🔄 **Batch Processing**: Efficiently process multiple emails with deduplication
+- 🛡️ **Improved Security**: Enhanced cryptographic integrity verification
+- ⚡ **Better Performance**: Optimized concurrent DNS with smart caching
+- 🎯 **Developer Experience**: Enhanced error messages and debugging information
+- 📊 **Development Mode**: Memory usage tracking when NODE_ENV=development
+
+## ✨ Core Features
+
+- 🚀 **Fast & Lightweight**: Zero dependencies, ultra-low memory (~0.08MB initial, ~0.03MB per 1000 ops)
 - 📧 **93 Email Providers**: Gmail, Outlook, Yahoo, ProtonMail, iCloud, and many more
-- 🌐 **178 Domains Supported**: Comprehensive international coverage
-- 🌍 **IDN Support**: Full internationalized domain name (punycode) support with RFC compliance
-- ✅ **Email Validation**: International email validation following RFC 5321, 5322, and 6530 standards
+- 🌐 **207 Domains Supported**: Comprehensive international coverage
+- 🌍 **Full IDN Support**: International domain names with RFC compliance and Punycode
+- ✅ **Advanced Email Validation**: International email validation with detailed error reporting
 - 🏢 **Business Domain Detection**: DNS-based detection for custom domains (Google Workspace, Microsoft 365, etc.)
 - 🔒 **Enterprise Security**: Multi-layer protection against malicious URLs and supply chain attacks
 - 🛡️ **URL Validation**: HTTPS-only enforcement with domain allowlisting
@@ -20,7 +35,8 @@ A TypeScript library providing direct links to **93 email providers** (178 domai
 - 🚦 **Rate Limiting**: Built-in DNS query rate limiting to prevent abuse
 - 🔄 **Email Alias Detection**: Normalize Gmail dots, plus addressing, and provider-specific aliases
 - 🛡️ **Fraud Prevention**: Detect duplicate accounts through email alias manipulation
-- 🧪 **Thoroughly Tested**: 370 tests with 92.89% code coverage
+- 📦 **Batch Processing**: Efficiently process multiple emails with deduplication
+- 🧪 **Thoroughly Tested**: 424 tests with 93.16% code coverage
 
 ## Installation
 
@@ -32,7 +48,7 @@ npm install @mikkelscheike/email-provider-links
 ## Requirements
 
 - **Node.js**: `>=18.0.0` (Tested on 18.x, 20.x, 22.x, **24.x**)
-- **TypeScript**: `>=4.0.0` (optional)
+- **TypeScript**: `>=4.0.0` (optional, but recommended)
 - **Zero runtime dependencies** - No external packages required
 
 ### Node.js 24 Support ✨
@@ -43,30 +59,9 @@ Fully compatible with the latest Node.js 24.x! The library is tested on:
 - Node.js 22.x (Current)
 - **Node.js 24.x (Latest)** - Full support with latest features
 
-## Quick Start
-
-**One function handles everything** - consumer emails, business domains, and unknown providers:
-
-```typescript
-import { getEmailProvider } from '@mikkelscheike/email-provider-links';
-
-// Works for ANY email address - the only function you need
-const result = await getEmailProvider('user@gmail.com');
-console.log(result.loginUrl);                    // "https://mail.google.com/mail/"
-console.log(result.provider?.companyProvider);   // "Gmail"
-
-// Automatically detects business domains too
-const business = await getEmailProvider('user@mycompany.com');
-console.log(business.provider?.companyProvider); // "Google Workspace" (if detected)
-
-// Gracefully handles unknown providers
-const unknown = await getEmailProvider('user@unknown.com');
-console.log(unknown.loginUrl);                   // null
-```
-
 ## Supported Providers
 
-**📊 Current Coverage: 93 providers supporting 178 domains**
+**📊 Current Coverage: 93 providers supporting 207 domains**
 
 **Consumer Email Providers:**
 - **Gmail** (2 domains): gmail.com, googlemail.com
@@ -95,7 +90,7 @@ console.log(unknown.loginUrl);                   // null
 - **Eastern Europe**: Centrum (Czech/Slovak), Interia, Onet (Poland), Rambler (Russia)
 - **Other Regions**: UOL, Terra (Brazil), Telkom (South Africa), Xtra (New Zealand)
 
-## API
+## API Reference
 
 ### `getEmailProvider(email, timeout?)`
 **Recommended** - Detects any email provider including business domains.
@@ -128,21 +123,42 @@ const result = getEmailProviderSync('user@gmail.com');
 // Returns: { provider, loginUrl, email }
 ```
 
+### `getEmailProviderFast(email, options?)`
+**High-performance** - Concurrent DNS with detailed timing information.
+
+```typescript
+const result = await getEmailProviderFast('user@mycompany.com', {
+  enableParallel: true,
+  collectDebugInfo: true,
+  timeout: 3000
+});
+
+console.log(result.timing);    // { mx: 120, txt: 95, total: 125 }
+console.log(result.confidence); // 0.9
+```
+
 ## Real-World Example
 
 ```typescript
 async function handlePasswordReset(email: string) {
-  const result = await getEmailProvider(email);
+  // Validate email first
+  const validation = validateEmailAddress(email);
+  if (!validation.isValid) {
+    throw new Error(`Invalid email: ${validation.error?.message}`);
+  }
+
+  // Get provider information
+  const result = await getEmailProvider(validation.normalizedEmail);
   
   return {
     providerUrl: result.loginUrl,
     providerName: result.provider?.companyProvider || null,
-    isSupported: result.provider !== null
+    isSupported: result.provider !== null,
+    detectionMethod: result.detectionMethod
   };
 }
 ```
 
-
 ## Configuration
 
 ```typescript
@@ -155,97 +171,24 @@ console.log('Max requests:', Config.MAX_DNS_REQUESTS_PER_MINUTE); // 10
 console.log('Default timeout:', Config.DEFAULT_DNS_TIMEOUT);       // 5000ms
 ```
 
-## Email Validation
-
-The library includes comprehensive email validation following international standards:
-
-```typescript
-import { validateInternationalEmail } from '@mikkelscheike/email-provider-links';
-
-// Validate any email address
-const result = validateInternationalEmail('user@example.com');
-
-// Returns undefined for valid emails
-console.log(result); // undefined
-
-// Returns detailed error information for invalid emails
-const invalid = validateInternationalEmail('user@münchen.com');
-if (invalid) {
-  console.log(invalid.code);    // IDN_VALIDATION_ERROR
-  console.log(invalid.message); // Human-readable error message
-}
-```
-
-### Validation Features
-
-- ✅ **RFC Compliance**: Follows RFC 5321, 5322, and 6530 standards
-- 🌍 **International Support**: Full IDN (Punycode) validation
-- 📝 **Detailed Errors**: Clear, translatable error messages
-- 🔍 **Comprehensive Checks**:
-  - Local part validation (username)
-  - Domain format validation
-  - IDN encoding validation
-  - Length limits (local part, domain, total)
-  - TLD validation
-
 ## Advanced Usage
 
 <details>
-<summary><strong>📚 Secondary Functions & Specialized Use Cases</strong></summary>
+<summary><strong>📚 Advanced Features & Specialized Use Cases</strong></summary>
 
-### Synchronous Provider Detection (No DNS)
-
-If you can't use async or don't want DNS lookups:
+### Library Statistics
 
 ```typescript
-import { getEmailProviderSync } from '@mikkelscheike/email-provider-links';
-
-// Synchronous - only checks predefined domains
-const result = getEmailProviderSync('user@gmail.com');
-console.log(result.loginUrl); // Works for known domains only
-```
+import { getLibraryStats, getSupportedProviders } from '@mikkelscheike/email-provider-links';
 
-### Provider Support Checking
-
-```typescript
-import { isEmailProviderSupported, getSupportedProviders } from '@mikkelscheike/email-provider-links';
+const stats = getLibraryStats();
+console.log(`Version ${stats.version} supports ${stats.providerCount} providers`);
 
-// Check if provider is supported
-const supported = isEmailProviderSupported('user@gmail.com');
-
-// Get all supported providers
-const allProviders = getSupportedProviders();
-console.log(`Supports ${allProviders.length} providers`);
-```
-
-### Advanced Provider Detection
-
-```typescript
-import { getEmailProviderFast, detectProviderConcurrent } from '@mikkelscheike/email-provider-links';
-
-// High-performance detection with concurrent DNS
-const fastResult = await getEmailProviderFast('user@mycompany.com', {
-  enableParallel: true,
-  collectDebugInfo: true
-});
-console.log(fastResult.provider?.companyProvider); // "Google Workspace"
-console.log(fastResult.timing);                    // Performance metrics
+const providers = getSupportedProviders();
+console.log(`Total providers: ${providers.length}`);
 ```
 
-### Configuration Options
-
-```typescript
-import { Config } from '@mikkelscheike/email-provider-links';
-
-// Access configuration constants
-console.log(Config.DEFAULT_DNS_TIMEOUT);           // 5000ms
-console.log(Config.MAX_DNS_REQUESTS_PER_MINUTE);   // 10
-console.log(Config.SUPPORTED_PROVIDERS_COUNT);     // 93
-```
-
-### 🔄 Email Alias Detection & Normalization
-
-**Specialized feature** for preventing duplicate accounts and fraud detection:
+### Email Alias Detection & Normalization
 
 ```typescript
 import { 
@@ -274,107 +217,63 @@ const canonical = normalizeEmail('u.s.e.r+work@gmail.com');
 console.log(canonical);  // 'user@gmail.com'
 ```
 
-**Supported alias types:**
-- **Gmail dots**: `u.s.e.r@gmail.com` → `user@gmail.com`
-- **Plus addressing**: `user+tag@provider.com` → `user@provider.com`
-- **Provider-specific rules**: Different providers have different capabilities
-
-</details>
-
-## TypeScript Support
+### Provider Support Checking
 
 ```typescript
-interface EmailProviderResult {
-  provider: EmailProvider | null;
-  email: string;
-  loginUrl: string | null;
-  detectionMethod?: 'domain_match' | 'mx_record' | 'txt_record' | 'proxy_detected';
-  proxyService?: string;
-  error?: {
-    type: 'INVALID_EMAIL' | 'DNS_TIMEOUT' | 'RATE_LIMITED' | 'UNKNOWN_DOMAIN' | 
-          'NETWORK_ERROR' | 'IDN_VALIDATION_ERROR';
-    message: string;
-    idnError?: string;  // Specific IDN validation error message
-  };
-}
-
-interface ConfigConstants {
-  DEFAULT_DNS_TIMEOUT: number;          // 5000ms
-  MAX_DNS_REQUESTS_PER_MINUTE: number;  // 10 requests
-  SUPPORTED_PROVIDERS_COUNT: number;    // 93 providers
-  SUPPORTED_DOMAINS_COUNT: number;      // 178 domains
-}
-```
-
-## 🛡️ Security Features
-
-This package implements **enterprise-grade security** to protect against malicious redirects and supply chain attacks:
+import { isEmailProviderSupported, extractDomain } from '@mikkelscheike/email-provider-links';
 
-### ✅ Multi-Layer Protection
-
-- **HTTPS-Only Enforcement**: All provider URLs must use HTTPS protocol
-- **Domain Allowlisting**: Only pre-approved domains are allowed (93+ verified providers)
-- **Malicious Pattern Detection**: Blocks IP addresses, URL shorteners, suspicious TLDs
-- **Path Traversal Prevention**: Detects and blocks `../` and encoded variants
-- **JavaScript Injection Protection**: Prevents `javascript:`, `data:`, and script injections
-- **File Integrity Verification**: SHA-256 hash verification for provider database
+// Check if provider is supported
+const supported = isEmailProviderSupported('user@gmail.com');
 
-### 🔒 Attack Prevention
+// Extract domain safely
+const domain = extractDomain('USER@EXAMPLE.COM');
+console.log(domain); // 'example.com'
+```
 
-Protects against common attack vectors:
-- ❌ **URL Injection**: Blocked by strict allowlisting
-- ❌ **Typosquatting**: Blocked by domain validation
-- ❌ **URL Shorteners**: Blocked by pattern detection
-- ❌ **Protocol Downgrade**: Blocked by HTTPS enforcement
-- ❌ **Path Traversal**: Blocked by path validation
-- ❌ **Script Injection**: Blocked by content validation
-- ❌ **Supply Chain Attacks**: Blocked by integrity verification
+</details>
 
-### 🧪 Security Testing
+## Performance and Detection System
 
-- **92 dedicated security tests** covering all attack vectors
-- **Comprehensive security module coverage** with edge case testing
-- **Automated security validation** in CI/CD pipeline
-- **Regular security audits** of provider database
+For detailed performance metrics and information about the detection system, refer to [Performance and Detection System](docs/PERFORMANCE.md).
 
-### 🔐 For Security Teams
+### Development Mode Features
 
-Security validation can be integrated into your workflow:
+When `NODE_ENV` is set to 'development', the library provides additional insights:
 
 ```typescript
-import { secureLoadProviders } from '@mikkelscheike/email-provider-links/security';
-
-// Secure loading with integrity verification
-const result = secureLoadProviders();
-if (result.securityReport.securityLevel === 'CRITICAL') {
-  // Handle security incident
-  console.error('Security validation failed:', result.securityReport.issues);
-}
+// Memory usage is automatically logged:
+// 🚀 Current memory usage: 0.08 MB
 ```
 
-## Performance Benchmarks
+### Memory Management
 
-This package is designed to be extremely memory efficient and fast. We continuously monitor performance metrics through automated benchmarks that run on every PR and release.
+The library implements careful memory management:
+- Initial load: ~0.08MB heap usage
+- Batch operations: ~0.03MB per 1000 operations
+- Maximum load: < 25MB even under heavy concurrent operations
+- Automatic garbage collection hints
+- Memory usage logging in development mode
 
-Latest benchmark results show:
-- Provider loading: ~0.39MB heap usage, <0.5ms
-- Email lookups: ~0.02MB heap usage per 100 operations
-- Concurrent DNS: ~0.03MB heap usage, ~110ms for 10 lookups
-- Large scale (1000 ops): ~0.02MB heap usage, <3ms total
-- Cache effectiveness: ~0.01MB impact on subsequent loads
+### Performance Benchmarks
+
+This package is designed to be extremely memory efficient and fast:
+
+- **Provider loading**: ~0.08MB heap usage, ~0.5ms
+- **Email lookups**: ~0.03MB heap usage per 100 operations
+- **Concurrent DNS**: ~0.03MB heap usage, ~27ms for 10 lookups
+- **Large scale (1000 ops)**: ~0.03MB heap usage, ~1.1ms total
+- **International validation**: <1ms for complex IDN domains
 
 To run benchmarks locally:
 ```bash
 npm run benchmark
 ```
 
-Benchmarks are automatically run in CI to catch any performance regressions.
-
 ## Contributing
 
 We welcome contributions! See [CONTRIBUTING.md](docs/CONTRIBUTING.md) for guidelines on adding new email providers.
 
-**Quality Assurance**: This project maintains high standards with 370 comprehensive tests achieving 92.89% code coverage.
+**Quality Assurance**: This project maintains high standards with 424 comprehensive tests achieving 93.16% code coverage (96.46% function coverage).
 **Security Note**: All new providers undergo security validation and must pass our allowlist verification.
 
 ## Security
@@ -387,5 +286,4 @@ MIT License - see [LICENSE](LICENSE) file for details.
 
 ---
 
-**Zero dependencies • TypeScript-first • Production ready**
-
+**Zero dependencies • TypeScript-first • Production ready • International support**

package/dist/alias-detection.d.ts

@@ -56,3 +56,4 @@ export declare function normalizeEmail(email: string): string;
  * ```
  */
 export declare function emailsMatch(email1: string, email2: string): boolean;
+//# sourceMappingURL=alias-detection.d.ts.map

package/dist/alias-detection.js

@@ -18,7 +18,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: true,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             // Remove dots and everything after +
             const cleanUsername = username.replace(/\./g, '').split('+')[0];
             return `${cleanUsername}@${domain}`;
@@ -29,7 +34,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             // Only remove plus addressing for Outlook
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
@@ -40,7 +50,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
         }
@@ -50,7 +65,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
         }
@@ -60,7 +80,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
         }
@@ -70,7 +95,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
         }
@@ -80,7 +110,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
         }
@@ -90,7 +125,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
         }
@@ -100,7 +140,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
         }
@@ -116,7 +161,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
         }
@@ -126,7 +176,12 @@ const ALIAS_RULES = [
         supportsPlusAddressing: true,
         ignoresDots: false,
         normalize: (email) => {
-            const [username, domain] = email.toLowerCase().split('@');
+            const parts = email.toLowerCase().split('@');
+            const username = parts[0];
+            const domain = parts[1];
+            if (!username || !domain) {
+                return email.toLowerCase();
+            }
             const cleanUsername = username.split('+')[0];
             return `${cleanUsername}@${domain}`;
         }
@@ -143,7 +198,7 @@ function isValidEmail(email) {
  * Gets the alias rule for a given domain
  */
 function getAliasRule(domain) {
-    return ALIAS_RULES.find(rule => rule.domains.includes(domain.toLowerCase()));
+    return ALIAS_RULES.find(rule => rule.domains.includes(domain.toLowerCase())) || null;
 }
 /**
  * Detects and analyzes email aliases
@@ -156,7 +211,12 @@ function detectEmailAlias(email) {
         throw new Error('Invalid email format');
     }
     const originalEmail = email.trim();
-    const [username, domain] = originalEmail.toLowerCase().split('@');
+    const emailParts = originalEmail.toLowerCase().split('@');
+    const username = emailParts[0];
+    const domain = emailParts[1];
+    if (!username || !domain) {
+        throw new Error('Invalid email format - missing username or domain');
+    }
     const rule = getAliasRule(domain);
     const result = {
         canonical: originalEmail.toLowerCase(),
@@ -243,3 +303,4 @@ function emailsMatch(email1, email2) {
         return false;
     }
 }
+//# sourceMappingURL=alias-detection.js.map

package/dist/api.d.ts

@@ -6,7 +6,7 @@
  */
 export interface EmailProvider {
     companyProvider: string;
-    loginUrl: string;
+    loginUrl: string | null;
     domains: string[];
     customDomainDetection?: {
         mxPatterns?: string[];
@@ -51,13 +51,13 @@ export interface EmailProviderResult {
  * ```typescript
  * // Consumer email
  * const gmail = await getEmailProvider('user@gmail.com');
- * console.log(gmail.provider?.name); // "Gmail"
- * console.log(gmail.loginUrl);       // "https://mail.google.com/mail/"
+ * console.log(gmail.provider?.companyProvider); // "Gmail"
+ * console.log(gmail.loginUrl);                  // "https://mail.google.com/mail/"
  *
  * // Business domain
  * const business = await getEmailProvider('user@mycompany.com');
- * console.log(business.provider?.name); // "Google Workspace" (if detected)
- * console.log(business.detectionMethod); // "mx_record"
+ * console.log(business.provider?.companyProvider); // "Google Workspace" (if detected)
+ * console.log(business.detectionMethod);          // "mx_record"
  *
  * // Error handling
  * const invalid = await getEmailProvider('invalid-email');
@@ -79,7 +79,7 @@ export declare function getEmailProvider(email: string, timeout?: number): Promi
  * ```typescript
  * // Works for known domains
  * const gmail = getEmailProviderSync('user@gmail.com');
- * console.log(gmail.provider?.name); // "Gmail"
+ * console.log(gmail.provider?.companyProvider); // "Gmail"
  *
  * // Unknown domains return null
  * const unknown = getEmailProviderSync('user@mycompany.com');
@@ -171,3 +171,4 @@ export declare const Config: {
     readonly SUPPORTED_PROVIDERS_COUNT: 93;
     readonly SUPPORTED_DOMAINS_COUNT: 180;
 };
+//# sourceMappingURL=api.d.ts.map