@mikkelscheike/email-provider-links 1.0.0

package/dist/index.js

@@ -0,0 +1,516 @@
+"use strict";
+/**
+ * Email Provider Links
+ *
+ * A TypeScript package that provides direct links to email providers
+ * based on email addresses to streamline login and password reset flows.
+ *
+ * The package uses a two-tier detection system:
+ * 1. Fast domain lookup against a JSON database of known providers
+ * 2. DNS-based detection for custom business domains using MX/TXT record analysis
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidEmail = isValidEmail;
+exports.extractDomain = extractDomain;
+exports.findEmailProvider = findEmailProvider;
+exports.getEmailProviderLink = getEmailProviderLink;
+exports.getSupportedProviders = getSupportedProviders;
+exports.isEmailProviderSupported = isEmailProviderSupported;
+exports.detectProviderByDNS = detectProviderByDNS;
+exports.getEmailProviderLinkWithDNS = getEmailProviderLinkWithDNS;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const util_1 = require("util");
+const dns_1 = require("dns");
+// Convert Node.js callback-style DNS functions to Promise-based
+const resolveMxAsync = (0, util_1.promisify)(dns_1.resolveMx);
+const resolveTxtAsync = (0, util_1.promisify)(dns_1.resolveTxt);
+/**
+ * Default timeout for DNS queries in milliseconds.
+ */
+const DEFAULT_DNS_TIMEOUT = 5000; // 5 seconds
+/**
+ * Creates a Promise that rejects after the specified timeout.
+ *
+ * @param ms - Timeout in milliseconds
+ * @returns Promise that rejects with timeout error
+ * @internal
+ */
+function createTimeout(ms) {
+    return new Promise((_, reject) => {
+        setTimeout(() => reject(new Error(`DNS query timeout after ${ms}ms`)), ms);
+    });
+}
+/**
+ * Wraps a DNS query with a timeout.
+ *
+ * @param promise - The DNS query promise
+ * @param timeoutMs - Timeout in milliseconds
+ * @returns Promise that resolves with DNS result or rejects on timeout
+ * @internal
+ */
+function withTimeout(promise, timeoutMs) {
+    return Promise.race([promise, createTimeout(timeoutMs)]);
+}
+// Load providers from external JSON file
+let EMAIL_PROVIDERS = [];
+// Performance optimization: Create a domain-to-provider Map for O(1) lookups
+let DOMAIN_TO_PROVIDER_MAP = new Map();
+/**
+ * Builds a Map for fast domain-to-provider lookups.
+ * This optimization improves lookup performance from O(n*m) to O(1)
+ * where n = number of providers, m = average domains per provider.
+ *
+ * @internal
+ */
+function buildDomainMap() {
+    DOMAIN_TO_PROVIDER_MAP.clear();
+    for (const provider of EMAIL_PROVIDERS) {
+        for (const domain of provider.domains) {
+            DOMAIN_TO_PROVIDER_MAP.set(domain.toLowerCase(), provider);
+        }
+    }
+}
+try {
+    const providersPath = (0, path_1.join)(__dirname, '..', 'providers', 'emailproviders.json');
+    const providersData = JSON.parse((0, fs_1.readFileSync)(providersPath, 'utf8'));
+    EMAIL_PROVIDERS = providersData.providers;
+    buildDomainMap(); // Build optimized lookup map
+}
+catch (error) {
+    // Fallback to hardcoded providers if JSON file is not found
+    console.warn('Could not load providers from JSON file, using fallback providers');
+    EMAIL_PROVIDERS = [
+        {
+            companyProvider: 'Google',
+            loginUrl: 'https://accounts.google.com/signin',
+            domains: ['gmail.com', 'googlemail.com']
+        },
+        {
+            companyProvider: 'Microsoft',
+            loginUrl: 'https://outlook.live.com/owa/',
+            domains: ['outlook.com', 'hotmail.com', 'live.com', 'msn.com']
+        },
+        {
+            companyProvider: 'Yahoo',
+            loginUrl: 'https://login.yahoo.com/',
+            domains: ['yahoo.com', 'yahoo.co.uk', 'yahoo.ca', 'yahoo.com.au', 'ymail.com', 'rocketmail.com']
+        }
+    ];
+    buildDomainMap(); // Build optimized lookup map for fallback too
+}
+/**
+ * Validates if a string is a valid email address using a basic regex pattern.
+ *
+ * @param email - The string to validate as an email address
+ * @returns true if the string matches basic email format, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidEmail('user@gmail.com');     // true
+ * isValidEmail('invalid-email');      // false
+ * isValidEmail('user@domain');        // false
+ * ```
+ *
+ * @remarks
+ * This uses a simple regex pattern that covers most common email formats.
+ * It may not catch all edge cases defined in RFC 5322, but works for
+ * standard email addresses.
+ */
+function isValidEmail(email) {
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+/**
+ * Extracts the domain portion from an email address.
+ *
+ * @param email - The email address to extract the domain from
+ * @returns The domain in lowercase, or null if the email is invalid
+ *
+ * @example
+ * ```typescript
+ * extractDomain('user@Gmail.com');    // 'gmail.com'
+ * extractDomain('test@yahoo.co.uk');  // 'yahoo.co.uk'
+ * extractDomain('invalid-email');     // null
+ * ```
+ *
+ * @remarks
+ * The domain is automatically normalized to lowercase for consistent matching.
+ */
+function extractDomain(email) {
+    if (!isValidEmail(email)) {
+        return null;
+    }
+    const parts = email.split('@');
+    return parts.length === 2 ? parts[1].toLowerCase() : null;
+}
+/**
+ * Finds an email provider by matching the domain against the known providers database.
+ * Uses an optimized Map for O(1) lookup performance.
+ *
+ * @param domain - The email domain to look up (e.g., 'gmail.com')
+ * @returns The matching EmailProvider object, or null if not found
+ *
+ * @example
+ * ```typescript
+ * const provider = findEmailProvider('gmail.com');
+ * console.log(provider?.companyProvider); // 'Gmail'
+ * console.log(provider?.loginUrl);        // 'https://mail.google.com/mail/'
+ * ```
+ *
+ * @remarks
+ * This function performs a case-insensitive O(1) lookup using a pre-built Map.
+ * It only checks the predefined JSON database, not DNS records.
+ * Performance optimized from O(n*m) to O(1) where n=providers, m=domains per provider.
+ */
+function findEmailProvider(domain) {
+    const normalizedDomain = domain.toLowerCase();
+    return DOMAIN_TO_PROVIDER_MAP.get(normalizedDomain) || null;
+}
+/**
+ * Gets email provider information and login URL for a given email address.
+ * This is the basic/synchronous version that only checks predefined domains.
+ *
+ * @param email - The email address to analyze
+ * @returns EmailProviderResult containing provider info and login URL
+ *
+ * @example
+ * ```typescript
+ * const result = getEmailProviderLink('user@gmail.com');
+ * console.log(result.loginUrl);        // 'https://mail.google.com/mail/'
+ * console.log(result.provider?.companyProvider); // 'Gmail'
+ * ```
+ *
+ * @remarks
+ * This function only checks against the predefined JSON database of known domains.
+ * It will NOT detect business domains that use major email providers (e.g.,
+ * mycompany.com using Google Workspace). For comprehensive detection including
+ * business domains, use {@link getEmailProviderLinkWithDNS} instead.
+ *
+ * **Limitations:**
+ * - Only synchronous operation (no DNS lookups)
+ * - Limited to domains in the JSON database
+ * - Won't detect custom business domains
+ * - No proxy service detection
+ */
+function getEmailProviderLink(email) {
+    const domain = extractDomain(email);
+    if (!domain) {
+        return {
+            provider: null,
+            email,
+            loginUrl: null
+        };
+    }
+    const provider = findEmailProvider(domain);
+    return {
+        provider,
+        email,
+        loginUrl: provider ? provider.loginUrl : null
+    };
+}
+/**
+ * Returns an array of all supported email providers.
+ *
+ * @returns A copy of the EMAIL_PROVIDERS array
+ *
+ * @example
+ * ```typescript
+ * const providers = getSupportedProviders();
+ * console.log(providers.length);  // 55+
+ * console.log(providers[0].companyProvider); // 'Gmail'
+ * ```
+ *
+ * @remarks
+ * Returns a shallow copy to prevent external modification of the internal
+ * providers array. The returned array includes both consumer email providers
+ * (gmail.com, yahoo.com) and business email providers with DNS detection patterns.
+ */
+function getSupportedProviders() {
+    return [...EMAIL_PROVIDERS];
+}
+/**
+ * Checks if an email address uses a supported email provider.
+ *
+ * @param email - The email address to check
+ * @returns true if the provider is supported, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isEmailProviderSupported('user@gmail.com');     // true
+ * isEmailProviderSupported('user@unknown.com');   // false
+ * ```
+ *
+ * @remarks
+ * This is a convenience function that uses {@link getEmailProviderLink} internally.
+ * It only checks predefined domains, not DNS-based detection. For business
+ * domain support checking, you would need to use {@link getEmailProviderLinkWithDNS}.
+ */
+function isEmailProviderSupported(email) {
+    const result = getEmailProviderLink(email);
+    return result.provider !== null;
+}
+/**
+ * Detects proxy services that obscure the actual email provider by analyzing MX records.
+ *
+ * @param mxRecords - Array of MX records from DNS lookup
+ * @returns The name of the detected proxy service, or null if none detected
+ *
+ * @internal
+ * @remarks
+ * This function checks MX record patterns against known proxy/CDN services.
+ * When a proxy is detected, it means we cannot determine the actual email
+ * provider behind the proxy service. Currently detects:
+ * - Cloudflare Email Routing
+ * - CloudFront (AWS)
+ * - Fastly
+ * - MaxCDN
+ * - KeyCDN
+ * - Mailgun proxy configurations
+ * - SendGrid proxy configurations
+ *
+ * @example
+ * ```typescript
+ * const mxRecords = [{ exchange: 'isaac.mx.cloudflare.net', priority: 10 }];
+ * const proxy = detectProxyService(mxRecords);
+ * console.log(proxy); // 'Cloudflare'
+ * ```
+ */
+function detectProxyService(mxRecords) {
+    const proxyPatterns = [
+        { service: 'Cloudflare', patterns: ['mxrecord.io', 'mxrecord.mx', 'cloudflare'] },
+        { service: 'CloudFront', patterns: ['cloudfront.net'] },
+        { service: 'Fastly', patterns: ['fastly.com'] },
+        { service: 'MaxCDN', patterns: ['maxcdn.com'] },
+        { service: 'KeyCDN', patterns: ['keycdn.com'] },
+        { service: 'Mailgun Proxy', patterns: ['mailgun.org', 'mg.', 'mailgun'] },
+        { service: 'SendGrid Proxy', patterns: ['sendgrid.net', 'sendgrid.com'] }
+    ];
+    for (const mxRecord of mxRecords) {
+        const exchange = mxRecord.exchange.toLowerCase();
+        for (const proxyService of proxyPatterns) {
+            for (const pattern of proxyService.patterns) {
+                if (exchange.includes(pattern.toLowerCase())) {
+                    return proxyService.service;
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Performs DNS-based detection for custom business domains using MX and TXT record analysis.
+ * This function is used internally by {@link getEmailProviderLinkWithDNS} but can also be
+ * called directly to analyze domain email configuration.
+ *
+ * @param domain - The domain to analyze (e.g., 'mycompany.com')
+ * @param timeoutMs - Optional timeout for DNS queries in milliseconds (default: 5000ms)
+ * @returns Promise resolving to DNSDetectionResult with provider info or proxy detection
+ *
+ * @example
+ * ```typescript
+ * const result = await detectProviderByDNS('microsoft.com');
+ * console.log(result.provider?.companyProvider); // 'Microsoft 365 (Business)'
+ * console.log(result.detectionMethod);           // 'mx_record'
+ * ```
+ *
+ * @remarks
+ * **Detection Algorithm:**
+ * 1. Performs MX record lookup for the domain
+ * 2. Checks if MX records match known proxy services (Cloudflare, etc.)
+ * 3. If proxy detected, returns null provider with proxy info
+ * 4. Otherwise, matches MX records against business email provider patterns
+ * 5. If no MX match, falls back to TXT record analysis (SPF records, etc.)
+ * 6. Returns the first matching provider or null if none found
+ *
+ * **Provider Patterns Checked:**
+ * - Google Workspace: aspmx.l.google.com, aspmx2.googlemail.com, etc.
+ * - Microsoft 365: *.protection.outlook.com, *.outlook.com
+ * - ProtonMail: mail.protonmail.ch, mailsec.protonmail.ch
+ * - FastMail: *.messagingengine.com
+ * - And many others...
+ *
+ * **Error Handling:**
+ * DNS lookup failures are caught and the function gracefully falls back
+ * to the next detection method or returns null if all methods fail.
+ */
+async function detectProviderByDNS(domain, timeoutMs = DEFAULT_DNS_TIMEOUT) {
+    const normalizedDomain = domain.toLowerCase();
+    // Get providers that support custom domain detection
+    const customDomainProviders = EMAIL_PROVIDERS.filter(provider => provider.customDomainDetection &&
+        (provider.customDomainDetection.mxPatterns || provider.customDomainDetection.txtPatterns));
+    // Try MX record detection first with timeout
+    try {
+        const mxRecords = await withTimeout(resolveMxAsync(normalizedDomain), timeoutMs);
+        // Check for proxy services first
+        const proxyService = detectProxyService(mxRecords);
+        if (proxyService) {
+            return {
+                provider: null,
+                detectionMethod: 'proxy_detected',
+                proxyService
+            };
+        }
+        for (const provider of customDomainProviders) {
+            if (provider.customDomainDetection?.mxPatterns) {
+                for (const mxRecord of mxRecords) {
+                    const exchange = mxRecord.exchange.toLowerCase();
+                    for (const pattern of provider.customDomainDetection.mxPatterns) {
+                        if (exchange.includes(pattern.toLowerCase())) {
+                            return {
+                                provider,
+                                detectionMethod: 'mx_record'
+                            };
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch (error) {
+        // MX lookup failed, continue to TXT records
+    }
+    // Try TXT record detection with timeout
+    try {
+        const txtRecords = await withTimeout(resolveTxtAsync(normalizedDomain), timeoutMs);
+        const flatTxtRecords = txtRecords.flat();
+        for (const provider of customDomainProviders) {
+            if (provider.customDomainDetection?.txtPatterns) {
+                for (const txtRecord of flatTxtRecords) {
+                    const record = txtRecord.toLowerCase();
+                    for (const pattern of provider.customDomainDetection.txtPatterns) {
+                        if (record.includes(pattern.toLowerCase())) {
+                            return {
+                                provider,
+                                detectionMethod: 'txt_record'
+                            };
+                        }
+                    }
+                }
+            }
+        }
+    }
+    catch (error) {
+        // TXT lookup failed
+    }
+    return {
+        provider: null,
+        detectionMethod: null
+    };
+}
+/**
+ * Enhanced email provider detection with automatic DNS-based custom domain detection.
+ * This is the recommended function for most use cases as it provides comprehensive
+ * detection coverage including business domains and proxy services.
+ *
+ * @param email - The email address to analyze
+ * @param timeoutMs - Optional timeout for DNS queries in milliseconds (default: 5000ms)
+ * @returns Promise resolving to EmailProviderResult with provider info and detection method
+ *
+ * @example
+ * ```typescript
+ * // Consumer email (fast domain match)
+ * const gmail = await getEmailProviderLinkWithDNS('user@gmail.com');
+ * console.log(gmail.provider?.companyProvider); // 'Gmail'
+ * console.log(gmail.detectionMethod);           // 'domain_match'
+ *
+ * // Business domain (DNS detection)
+ * const business = await getEmailProviderLinkWithDNS('user@mycompany.com');
+ * console.log(business.provider?.companyProvider); // 'Google Workspace' (if detected)
+ * console.log(business.detectionMethod);           // 'mx_record'
+ *
+ * // Proxied domain (proxy detection)
+ * const proxied = await getEmailProviderLinkWithDNS('user@proxied-domain.com');
+ * console.log(proxied.provider);         // null
+ * console.log(proxied.proxyService);     // 'Cloudflare'
+ * console.log(proxied.detectionMethod);  // 'proxy_detected'
+ * ```
+ *
+ * @remarks
+ * **Detection Hierarchy (in order):**
+ * 1. **Domain Match**: Fast lookup against predefined domains (gmail.com, yahoo.com, etc.)
+ * 2. **DNS MX Records**: Analyzes mail exchange records for business email providers
+ * 3. **DNS TXT Records**: Checks SPF and verification records as fallback
+ * 4. **Proxy Detection**: Identifies when domains are behind CDN/proxy services
+ *
+ * **Supported Detection Cases:**
+ * - ✅ Consumer emails: gmail.com, yahoo.com, outlook.com, etc.
+ * - ✅ Business domains: Google Workspace, Microsoft 365, ProtonMail Business, etc.
+ * - ✅ Proxy services: Cloudflare, CloudFront, Fastly, etc.
+ * - ✅ International providers: QQ Mail, NetEase, Yandex, etc.
+ *
+ * **Performance:**
+ * - Fast for known consumer domains (synchronous JSON lookup)
+ * - Additional DNS lookup time for unknown domains (~100-500ms)
+ * - Graceful degradation if DNS lookups fail
+ *
+ * **Error Handling:**
+ * - Invalid email addresses return null provider
+ * - DNS lookup failures are caught and don't throw errors
+ * - Network timeouts gracefully fall back to null detection
+ *
+ * **Use Cases:**
+ * - Password reset flows ("Check your Gmail inbox")
+ * - Login form enhancements (direct links to email providers)
+ * - Email client detection for support purposes
+ * - Business domain analysis for enterprise features
+ */
+async function getEmailProviderLinkWithDNS(email, timeoutMs = DEFAULT_DNS_TIMEOUT) {
+    const domain = extractDomain(email);
+    if (!domain) {
+        return {
+            provider: null,
+            email,
+            loginUrl: null
+        };
+    }
+    // First try standard domain matching
+    const provider = findEmailProvider(domain);
+    if (provider) {
+        return {
+            provider,
+            email,
+            loginUrl: provider.loginUrl,
+            detectionMethod: 'domain_match'
+        };
+    }
+    // If no direct match, try DNS-based detection for custom domains
+    const dnsResult = await detectProviderByDNS(domain, timeoutMs);
+    if (dnsResult.provider) {
+        return {
+            provider: dnsResult.provider,
+            email,
+            loginUrl: dnsResult.provider.loginUrl,
+            detectionMethod: dnsResult.detectionMethod || 'mx_record'
+        };
+    }
+    // Handle proxy detection case
+    if (dnsResult.detectionMethod === 'proxy_detected') {
+        return {
+            provider: null,
+            email,
+            loginUrl: null,
+            detectionMethod: 'proxy_detected',
+            proxyService: dnsResult.proxyService
+        };
+    }
+    return {
+        provider: null,
+        email,
+        loginUrl: null
+    };
+}
+// Default export for convenience
+exports.default = {
+    getEmailProviderLink,
+    getEmailProviderLinkWithDNS,
+    detectProviderByDNS,
+    isValidEmail,
+    extractDomain,
+    findEmailProvider,
+    getSupportedProviders,
+    isEmailProviderSupported
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@mikkelscheike/email-provider-links",
+  "version": "1.0.0",
+  "description": "A TypeScript package that provides direct links to email providers based on email addresses to streamline login and password reset flows",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/**/*",
+    "providers/**/*"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "prepublishOnly": "npm run build",
+    "dev": "tsx src/index.ts"
+  },
+  "keywords": [
+    "email",
+    "provider",
+    "login",
+    "password-reset",
+    "gmail",
+    "outlook",
+    "yahoo",
+    "typescript",
+    "npm",
+    "utility"
+  ],
+  "author": "Mikkel Scheike",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikkelscheike/email-provider-links.git"
+  },
+  "homepage": "https://github.com/mikkelscheike/email-provider-links#readme",
+  "bugs": {
+    "url": "https://github.com/mikkelscheike/email-provider-links/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "packageManager": "pnpm@10.11.1",
+  "devDependencies": {
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/github": "^11.0.3",
+    "@semantic-release/npm": "^12.0.1",
+    "@semantic-release/release-notes-generator": "^14.0.3",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.0.3",
+    "conventional-changelog-conventionalcommits": "^9.0.0",
+    "jest": "^30.0.1",
+    "semantic-release": "^24.2.5",
+    "ts-jest": "^29.4.0",
+    "tsx": "^4.20.3",
+    "typescript": "^5.8.3"
+  }
+}