@mikkelscheike/email-provider-links 4.0.10 → 5.0.0

package/dist/index.js

@@ -3,7 +3,7 @@
  * Email Provider Links
  *
  * A modern, robust email provider detection library with:
- * - 93+ verified email providers covering 180+ domains
+ * - 130+ verified email providers covering 210+ domains
  * - Concurrent DNS detection for business domains
  * - Zero runtime dependencies
  * - Comprehensive error handling with detailed context
@@ -13,7 +13,7 @@
  *
  * @author Email Provider Links Team
  * @license MIT
- * @version 2.7.0
+ * @version See package.json
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.VERSION = exports.DOMAIN_COUNT = exports.PROVIDER_COUNT = exports.isValidEmailAddress = exports.domainToPunycode = exports.emailToPunycode = exports.validateInternationalEmail = exports.detectProviderConcurrent = exports.loadProviders = exports.Config = exports.emailsMatch = exports.normalizeEmail = exports.getEmailProviderFast = exports.getEmailProviderSync = exports.getEmailProvider = void 0;
@@ -24,22 +24,18 @@ exports.extractDomain = extractDomain;
 exports.isValidEmail = isValidEmail;
 exports.getLibraryStats = getLibraryStats;
 exports.batchProcessEmails = batchProcessEmails;
-// ===== PRIMARY API =====
-// Core functions that 95% of users need
-var api_1 = require("./api");
+const loader_1 = require("./loader");
+Object.defineProperty(exports, "loadProviders", { enumerable: true, get: function () { return loader_1.loadProviders; } });
+const api_1 = require("./api");
 Object.defineProperty(exports, "getEmailProvider", { enumerable: true, get: function () { return api_1.getEmailProvider; } });
 Object.defineProperty(exports, "getEmailProviderSync", { enumerable: true, get: function () { return api_1.getEmailProviderSync; } });
 Object.defineProperty(exports, "getEmailProviderFast", { enumerable: true, get: function () { return api_1.getEmailProviderFast; } });
 Object.defineProperty(exports, "normalizeEmail", { enumerable: true, get: function () { return api_1.normalizeEmail; } });
 Object.defineProperty(exports, "emailsMatch", { enumerable: true, get: function () { return api_1.emailsMatch; } });
 Object.defineProperty(exports, "Config", { enumerable: true, get: function () { return api_1.Config; } });
-// ===== ADVANCED FEATURES =====
-// For power users and custom implementations
-var loader_1 = require("./loader");
-Object.defineProperty(exports, "loadProviders", { enumerable: true, get: function () { return loader_1.loadProviders; } });
-var concurrent_dns_1 = require("./concurrent-dns");
+const concurrent_dns_1 = require("./concurrent-dns");
 Object.defineProperty(exports, "detectProviderConcurrent", { enumerable: true, get: function () { return concurrent_dns_1.detectProviderConcurrent; } });
-var idn_1 = require("./idn");
+const idn_1 = require("./idn");
 Object.defineProperty(exports, "validateInternationalEmail", { enumerable: true, get: function () { return idn_1.validateInternationalEmail; } });
 Object.defineProperty(exports, "emailToPunycode", { enumerable: true, get: function () { return idn_1.emailToPunycode; } });
 Object.defineProperty(exports, "domainToPunycode", { enumerable: true, get: function () { return idn_1.domainToPunycode; } });
@@ -86,7 +82,7 @@ function validateEmailAddress(email) {
         };
     }
     // Use international validation
-    const idnError = (0, idn_2.validateInternationalEmail)(trimmedEmail);
+    const idnError = (0, idn_1.validateInternationalEmail)(trimmedEmail);
     if (idnError) {
         return {
             isValid: false,
@@ -104,10 +100,6 @@ function validateEmailAddress(email) {
 }
 // ===== UTILITY FUNCTIONS =====
 // Helper functions for common tasks
-const loader_2 = require("./loader");
-const api_2 = require("./api");
-const concurrent_dns_2 = require("./concurrent-dns");
-const idn_2 = require("./idn");
 /**
  * Get comprehensive list of all supported email providers
  *
@@ -124,7 +116,7 @@ const idn_2 = require("./idn");
  */
 function getSupportedProviders() {
     try {
-        const { providers } = (0, loader_2.loadProviders)();
+        const { providers } = (0, loader_1.loadProviders)();
         return [...providers]; // Return defensive copy to prevent external mutations
     }
     catch (error) {
@@ -150,7 +142,7 @@ function isEmailProviderSupported(email) {
         if (!email || typeof email !== 'string') {
             return false;
         }
-        const result = (0, api_2.getEmailProviderSync)(email);
+        const result = (0, api_1.getEmailProviderSync)(email);
         return result.provider !== null;
     }
     catch {
@@ -227,7 +219,7 @@ function getLibraryStats() {
         return {
             providerCount: providers.length,
             domainCount,
-            version: '2.7.0',
+            version: exports.VERSION,
             supportsAsync: true,
             supportsIDN: true,
             supportsAliasDetection: true,
@@ -238,7 +230,7 @@ function getLibraryStats() {
         return {
             providerCount: 0,
             domainCount: 0,
-            version: '2.7.0',
+            version: exports.VERSION,
             supportsAsync: true,
             supportsIDN: true,
             supportsAliasDetection: true,
@@ -282,7 +274,7 @@ function batchProcessEmails(emails, options = {}) {
             // Add normalized email if requested
             if (normalizeEmails && validation.normalizedEmail) {
                 try {
-                    result.normalized = (0, api_2.normalizeEmail)(validation.normalizedEmail);
+                    result.normalized = (0, api_1.normalizeEmail)(validation.normalizedEmail);
                 }
                 catch {
                     result.normalized = validation.normalizedEmail;
@@ -300,7 +292,7 @@ function batchProcessEmails(emails, options = {}) {
             // Add provider info if requested
             if (includeProviderInfo && validation.normalizedEmail) {
                 try {
-                    const providerResult = (0, api_2.getEmailProviderSync)(validation.normalizedEmail);
+                    const providerResult = (0, api_1.getEmailProviderSync)(validation.normalizedEmail);
                     result.provider = providerResult.provider?.companyProvider || null;
                     result.loginUrl = providerResult.loginUrl;
                 }
@@ -329,8 +321,8 @@ exports.isValidEmailAddress = isValidEmail;
 /**
  * Library metadata (legacy constants)
  */
-exports.PROVIDER_COUNT = 93;
-exports.DOMAIN_COUNT = 178;
+exports.PROVIDER_COUNT = api_1.Config?.SUPPORTED_PROVIDERS_COUNT ?? 130;
+exports.DOMAIN_COUNT = api_1.Config?.SUPPORTED_DOMAINS_COUNT ?? 218;
 /**
  * Default export for convenience
  *
@@ -343,14 +335,14 @@ exports.DOMAIN_COUNT = 178;
  */
 exports.default = {
     // Core functions
-    getEmailProvider: api_2.getEmailProvider,
-    getEmailProviderSync: api_2.getEmailProviderSync,
-    getEmailProviderFast: api_2.getEmailProviderFast,
+    getEmailProvider: api_1.getEmailProvider,
+    getEmailProviderSync: api_1.getEmailProviderSync,
+    getEmailProviderFast: api_1.getEmailProviderFast,
     // Validation
     validateEmailAddress,
     isValidEmail,
-    normalizeEmail: api_2.normalizeEmail,
-    emailsMatch: api_2.emailsMatch,
+    normalizeEmail: api_1.normalizeEmail,
+    emailsMatch: api_1.emailsMatch,
     // Utilities
     getSupportedProviders,
     isEmailProviderSupported,
@@ -358,16 +350,25 @@ exports.default = {
     getLibraryStats,
     batchProcessEmails,
     // Advanced
-    loadProviders: loader_2.loadProviders,
-    detectProviderConcurrent: concurrent_dns_2.detectProviderConcurrent,
-    validateInternationalEmail: idn_2.validateInternationalEmail,
+    loadProviders: loader_1.loadProviders,
+    detectProviderConcurrent: concurrent_dns_1.detectProviderConcurrent,
+    validateInternationalEmail: idn_1.validateInternationalEmail,
     // Constants
-    Config: api_2.Config,
+    Config: api_1.Config,
     PROVIDER_COUNT: exports.PROVIDER_COUNT,
     DOMAIN_COUNT: exports.DOMAIN_COUNT
 };
 /**
  * Version information
  */
-exports.VERSION = '2.7.0';
+function readPackageVersion() {
+    try {
+        const pkg = require('../package.json');
+        return pkg.version || 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+exports.VERSION = readPackageVersion();
 //# sourceMappingURL=index.js.map

package/dist/loader.js

@@ -10,9 +10,8 @@ exports.clearCache = clearCache;
 exports.getLoadingStats = getLoadingStats;
 exports.loadProviders = loadProviders;
 exports.loadProvidersDebug = loadProvidersDebug;
-const fs_1 = require("fs");
 const path_1 = require("path");
-const schema_1 = require("./schema");
+const provider_store_1 = require("./provider-store");
 /**
  * Internal cached data
  */
@@ -25,35 +24,6 @@ let loadingStats = null;
 const DEFAULT_CONFIG = {
     debug: false
 };
-/**
- * Convert compressed provider to EmailProvider format
- */
-function convertProviderToEmailProvider(compressedProvider) {
-    if (!compressedProvider.type) {
-        console.warn(`Missing type for provider ${compressedProvider.id}`);
-    }
-    const provider = {
-        companyProvider: compressedProvider.companyProvider,
-        loginUrl: compressedProvider.loginUrl || null,
-        domains: compressedProvider.domains || [],
-        type: compressedProvider.type,
-        alias: compressedProvider.alias
-    };
-    // Include DNS detection patterns for business email services and proxy services
-    const needsCustomDomainDetection = compressedProvider.type === 'custom_provider' ||
-        compressedProvider.type === 'proxy_service';
-    if (needsCustomDomainDetection && (compressedProvider.mx?.length || compressedProvider.txt?.length)) {
-        provider.customDomainDetection = {};
-        if (compressedProvider.mx?.length) {
-            provider.customDomainDetection.mxPatterns = compressedProvider.mx;
-        }
-        if (compressedProvider.txt?.length) {
-            // Decompress TXT patterns
-            provider.customDomainDetection.txtPatterns = compressedProvider.txt.map(schema_1.decompressTxtPattern);
-        }
-    }
-    return provider;
-}
 /**
  * Internal provider data loader with configuration
  */
@@ -73,14 +43,8 @@ function loadProvidersInternal(config = {}) {
         const dataPath = mergedConfig.path || (0, path_1.join)(basePath, 'emailproviders.json');
         if (mergedConfig.debug)
             console.log('🔄 Loading provider data...');
-        const content = (0, fs_1.readFileSync)(dataPath, 'utf8');
-        const data = JSON.parse(content);
-        // Validate format
-        if (!data.version || !data.providers || !Array.isArray(data.providers)) {
-            throw new Error('Invalid provider data format');
-        }
-        const providers = data.providers.map(convertProviderToEmailProvider);
-        const fileSize = content.length;
+        const { data, fileSize } = (0, provider_store_1.readProvidersDataFile)(dataPath);
+        const providers = data.providers.map(provider_store_1.convertProviderToEmailProviderShared);
         if (mergedConfig.debug) {
             console.log(`✅ Loaded ${providers.length} providers`);
             console.log(`📊 File size: ${(fileSize / 1024).toFixed(1)} KB`);
@@ -120,14 +84,8 @@ function buildDomainMap(providers) {
     if (cachedDomainMap) {
         return cachedDomainMap;
     }
-    const domainMap = new Map();
-    for (const provider of providers) {
-        for (const domain of provider.domains) {
-            domainMap.set(domain.toLowerCase(), provider);
-        }
-    }
-    cachedDomainMap = domainMap;
-    return domainMap;
+    cachedDomainMap = (0, provider_store_1.buildDomainMapShared)(providers);
+    return cachedDomainMap;
 }
 /**
  * Clear all caches (useful for testing or hot reloading)

package/dist/provider-loader.d.ts

@@ -4,7 +4,17 @@
  * Integrates URL validation and hash verification to load and validate
  * email provider data with security checks.
  */
-import type { EmailProvider } from './index';
+import type { EmailProvider } from './api';
+type MiddlewareRequestLike = Record<string, unknown> & {
+    secureProviders?: EmailProvider[];
+    securityReport?: LoadResult['securityReport'];
+};
+type MiddlewareResponseLike = {
+    status: (code: number) => {
+        json: (body: unknown) => unknown;
+    };
+};
+type MiddlewareNextLike = () => void;
 export interface LoadResult {
     success: boolean;
     providers: EmailProvider[];
@@ -43,7 +53,7 @@ interface SecurityMiddlewareOptions {
     onSecurityIssue?: (report: LoadResult['securityReport']) => void;
     getProviders?: () => LoadResult;
 }
-export declare function createSecurityMiddleware(options?: SecurityMiddlewareOptions): (req: any, res: any, next: any) => any;
+export declare function createSecurityMiddleware(options?: SecurityMiddlewareOptions): (req: MiddlewareRequestLike, res: MiddlewareResponseLike, next: MiddlewareNextLike) => void;
 declare const _default: {
     loadProviders: typeof loadProviders;
     initializeSecurity: typeof initializeSecurity;

package/dist/provider-loader.js

@@ -10,11 +10,10 @@ exports.clearCache = clearCache;
 exports.loadProviders = loadProviders;
 exports.initializeSecurity = initializeSecurity;
 exports.createSecurityMiddleware = createSecurityMiddleware;
-const fs_1 = require("fs");
 const path_1 = require("path");
 const url_validator_1 = require("./url-validator");
 const hash_verifier_1 = require("./hash-verifier");
-const schema_1 = require("./schema");
+const provider_store_1 = require("./provider-store");
 // Cache for load results
 let cachedLoadResult = null;
 /**
@@ -23,35 +22,6 @@ let cachedLoadResult = null;
 function clearCache() {
     cachedLoadResult = null;
 }
-/**
- * Convert compressed provider to EmailProvider format
- */
-function convertProviderToEmailProvider(compressedProvider) {
-    if (!compressedProvider.type) {
-        console.warn(`Missing type for provider ${compressedProvider.id}`);
-    }
-    const provider = {
-        companyProvider: compressedProvider.companyProvider,
-        loginUrl: compressedProvider.loginUrl || null,
-        domains: compressedProvider.domains || [],
-        type: compressedProvider.type,
-        alias: compressedProvider.alias
-    };
-    // Include DNS detection patterns for business email services and proxy services
-    const needsCustomDomainDetection = compressedProvider.type === 'custom_provider' ||
-        compressedProvider.type === 'proxy_service';
-    if (needsCustomDomainDetection && (compressedProvider.mx?.length || compressedProvider.txt?.length)) {
-        provider.customDomainDetection = {};
-        if (compressedProvider.mx?.length) {
-            provider.customDomainDetection.mxPatterns = compressedProvider.mx;
-        }
-        if (compressedProvider.txt?.length) {
-            // Decompress TXT patterns
-            provider.customDomainDetection.txtPatterns = compressedProvider.txt.map(schema_1.decompressTxtPattern);
-        }
-    }
-    return provider;
-}
 /**
  * Loads and validates email provider data with security checks
  *
@@ -83,14 +53,8 @@ function loadProviders(providersPath, expectedHash) {
     }
     // Step 2: Load and parse JSON
     try {
-        const fileContent = (0, fs_1.readFileSync)(filePath, 'utf8');
-        const data = JSON.parse(fileContent);
-        // Validate format
-        if (!data.version || !data.providers || !Array.isArray(data.providers)) {
-            throw new Error('Invalid provider data format');
-        }
-        // Convert to EmailProvider format
-        providers = data.providers.map(convertProviderToEmailProvider);
+        const { data } = (0, provider_store_1.readProvidersDataFile)(filePath);
+        providers = data.providers.map(provider_store_1.convertProviderToEmailProviderShared);
     }
     catch (error) {
         issues.push(`Failed to load providers file: ${error instanceof Error ? error.message : 'Unknown error'}`);
@@ -178,15 +142,17 @@ function createSecurityMiddleware(options = {}) {
             if (options.onSecurityIssue) {
                 options.onSecurityIssue(result.securityReport);
             }
-            return res.status(500).json({
+            res.status(500).json({
                 error: 'Security validation failed',
                 details: result.securityReport
             });
+            return;
         }
         // Attach secure providers to request
         req.secureProviders = result.providers;
         req.securityReport = result.securityReport;
         next();
+        return;
     };
 }
 exports.default = {

package/dist/provider-store.d.ts

@@ -0,0 +1,9 @@
+import type { EmailProvider } from './api';
+import { Provider, ProvidersData } from './schema';
+export declare function convertProviderToEmailProviderShared(compressedProvider: Provider): EmailProvider;
+export declare function readProvidersDataFile(filePath: string): {
+    data: ProvidersData;
+    fileSize: number;
+};
+export declare function buildDomainMapShared(providers: EmailProvider[]): Map<string, EmailProvider>;
+//# sourceMappingURL=provider-store.d.ts.map

package/dist/provider-store.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertProviderToEmailProviderShared = convertProviderToEmailProviderShared;
+exports.readProvidersDataFile = readProvidersDataFile;
+exports.buildDomainMapShared = buildDomainMapShared;
+const fs_1 = require("fs");
+const schema_1 = require("./schema");
+function convertProviderToEmailProviderShared(compressedProvider) {
+    if (!compressedProvider.type) {
+        console.warn(`Missing type for provider ${compressedProvider.id}`);
+    }
+    const provider = {
+        companyProvider: compressedProvider.companyProvider,
+        loginUrl: compressedProvider.loginUrl || null,
+        domains: compressedProvider.domains || [],
+        type: compressedProvider.type,
+        alias: compressedProvider.alias
+    };
+    const needsCustomDomainDetection = compressedProvider.type === 'custom_provider' ||
+        compressedProvider.type === 'proxy_service';
+    if (needsCustomDomainDetection && (compressedProvider.mx?.length || compressedProvider.txt?.length)) {
+        provider.customDomainDetection = {};
+        if (compressedProvider.mx?.length) {
+            provider.customDomainDetection.mxPatterns = compressedProvider.mx;
+        }
+        if (compressedProvider.txt?.length) {
+            provider.customDomainDetection.txtPatterns = compressedProvider.txt.map(schema_1.decompressTxtPattern);
+        }
+    }
+    return provider;
+}
+function readProvidersDataFile(filePath) {
+    const content = (0, fs_1.readFileSync)(filePath, 'utf8');
+    const data = JSON.parse(content);
+    if (!data.version || !data.providers || !Array.isArray(data.providers)) {
+        throw new Error('Invalid provider data format');
+    }
+    return { data, fileSize: content.length };
+}
+function buildDomainMapShared(providers) {
+    const domainMap = new Map();
+    for (const provider of providers) {
+        for (const domain of provider.domains) {
+            domainMap.set(domain.toLowerCase(), provider);
+        }
+    }
+    return domainMap;
+}
+//# sourceMappingURL=provider-store.js.map

package/dist/url-validator.d.ts

@@ -4,6 +4,10 @@
  * Provides validation and allowlisting for email provider URLs to prevent
  * malicious redirects and supply chain attacks.
  */
+type ProviderUrlLike = {
+    companyProvider?: string;
+    loginUrl?: string | null;
+};
 export interface URLValidationResult {
     isValid: boolean;
     reason?: string;
@@ -23,7 +27,7 @@ export declare function validateEmailProviderUrl(url: string): URLValidationResu
  * @param providers - Array of email providers to validate
  * @returns Array of validation results
  */
-export declare function validateAllProviderUrls(providers: any[]): Array<{
+export declare function validateAllProviderUrls(providers: ProviderUrlLike[]): Array<{
     provider: string;
     url: string;
     validation: URLValidationResult;
@@ -34,7 +38,7 @@ export declare function validateAllProviderUrls(providers: any[]): Array<{
  * @param providers - Array of email providers to audit
  * @returns Security audit report
  */
-export declare function auditProviderSecurity(providers: any[]): {
+export declare function auditProviderSecurity(providers: ProviderUrlLike[]): {
     total: number;
     valid: number;
     invalid: number;
@@ -45,4 +49,5 @@ export declare function auditProviderSecurity(providers: any[]): {
     }[];
     report: string;
 };
+export {};
 //# sourceMappingURL=url-validator.d.ts.map

package/dist/url-validator.js

@@ -9,19 +9,31 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.validateEmailProviderUrl = validateEmailProviderUrl;
 exports.validateAllProviderUrls = validateAllProviderUrls;
 exports.auditProviderSecurity = auditProviderSecurity;
-const loader_1 = require("./loader");
+const fs_1 = require("fs");
+const path_1 = require("path");
+const hash_verifier_1 = require("./hash-verifier");
 /**
  * Get allowlisted domains from provider data
  * Only URLs from these domains will be considered safe.
  */
 function getAllowedDomains() {
-    const { providers } = (0, loader_1.loadProviders)();
+    const filePath = (0, path_1.join)(__dirname, '..', 'providers', 'emailproviders.json');
+    const integrity = (0, hash_verifier_1.verifyProvidersIntegrity)(filePath);
+    if (!integrity.isValid) {
+        return new Set();
+    }
+    if (cachedAllowedDomains && cachedAllowlistHash === integrity.actualHash) {
+        return cachedAllowedDomains;
+    }
+    const fileContent = (0, fs_1.readFileSync)(filePath, 'utf8');
+    const data = JSON.parse(fileContent);
+    const providers = data.providers;
     const allowedDomains = new Set();
     for (const provider of providers) {
         if (provider.loginUrl) {
             try {
                 const url = new URL(provider.loginUrl);
-                allowedDomains.add(url.hostname);
+                allowedDomains.add((0, idn_1.domainToPunycode)(url.hostname.toLowerCase()));
             }
             catch {
                 // Skip invalid URLs
@@ -29,8 +41,12 @@ function getAllowedDomains() {
             }
         }
     }
+    cachedAllowedDomains = allowedDomains;
+    cachedAllowlistHash = integrity.actualHash;
     return allowedDomains;
 }
+let cachedAllowedDomains = null;
+let cachedAllowlistHash = null;
 /**
  * Suspicious URL patterns that should always be rejected
  */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mikkelscheike/email-provider-links",
-  "version": "4.0.10",
-  "description": "TypeScript library for email provider detection with 93 providers (207 domains), concurrent DNS resolution, optimized performance, 94.65% test coverage, and enterprise security for login and password reset flows",
+  "version": "5.0.0",
+  "description": "TypeScript library for email provider detection with 130 providers (218 domains), concurrent DNS resolution, optimized performance, 94.65% test coverage, and enterprise security for login and password reset flows",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [