How otwl/emailverifier works
EmailVerifier is an Express API that accepts authenticated, rate-limited email verification requests and returns format, domain, MX, disposable-provider, role, and free-provider results. Its request handler checks the cache, performs validation and lookups, assembles the response, and caches successful results. The README also documents health endpoints. The source excerpts show these runtime relationships directly; domain and provider list modules are data consumed by the handler.
Main entry points: index.js Email endpoint · domains.js Trusted domains · emailRoles.js Role list · freeEmailProvider.js Free-provider list
Components 18
API service
- Express server
index.js - Health checks
index.js - Secret authentication
index.js - Rate limiting
index.js - Email endpoint
index.js
Verification
- Format validation
index.js - Domain verification
index.js - MX lookup
index.js - Disposable detection
index.js - Role detection
index.js - Free-provider detection
index.js
Reference data
- Trusted domains
domains.js - Role list
emailRoles.js - Free-provider list
freeEmailProvider.js
Caching
- LRU result cache
index.js
Other components
- API client
- DNS resolver
- Disposable-domain library
Connections 20
- API client → Express server: sends requests
README.md - Express server → Health checks: routes health
index.js - Express server → Secret authentication: checks secrets
index.js - Express server → Rate limiting: limits email
index.js - Express server → Email endpoint: routes email
index.js - Email endpoint → LRU result cache: reads cache
index.js - Email endpoint → Format validation: validates format
index.js - Email endpoint → Domain verification: validates domain
index.js - Domain verification → Trusted domains: checks list
index.js - Domain verification → DNS resolver: looks up domain
index.js - Email endpoint → MX lookup: checks MX
index.js - MX lookup → DNS resolver: resolves MX
index.js - Email endpoint → Disposable detection: checks address
index.js - Disposable detection → Disposable-domain library: queries library
index.js - Email endpoint → Role detection: detects role
index.js - Role detection → Role list: checks list
index.js - Email endpoint → Free-provider detection: checks provider
index.js - Free-provider detection → Free-provider list: checks list
index.js - Email endpoint → LRU result cache: writes result
index.js - Email endpoint → API client: returns response
README.md