The OTM Detector module is a lightweight module that allows you to detect one-time mail services by checking the MX (Mail Exchange) records of a given hostname. Most of similar modules have block list of one-time mail services, but this module uses a different approach to detect one-time mail services. It checks the MX records of the hostname to determine if it belongs to a one-time mail service. Usually such services purchase a lot of domains and use them as one-time mail services. This module is able to detect such services.
Install otm-detector with npm
npm install otm-detectorTo use the OTM Detector module in your project, require it and call the isOneTimeMail function, passing the hostname as a parameter. The function will return true if the hostname belongs to a one-time mail service, and false otherwise.
Import:
import { isOneTimeMail } from 'otm-detector';
const hostname = 'example.com';
const isOTM = await isOneTimeMail(hostname);
console.log(`Is ${hostname} a one-time mail service? ${isOTM}`);Require:
const { isOneTimeMail } = require('otm-detector');
const hostname = 'example.com';
const isOTM = await isOneTimeMail(hostname);
console.log(`Is ${hostname} a one-time mail service? ${isOTM}`);Many services offer a limited free version of their product. While 99.9% of users create only one account, some malicious actors create thousands. The purpose of this module is to prevent such abuse.
We add a service to the list if it matches one of the following criteria:
- Provides one-off temporary emails without requiring registration.
- Allows the creation of a large number of aliases.
- Is heavily used to circumvent email validation limits.
We do not add services to this list for the following reasons:
- Email proxy services.
- Secure email services.
- Sending SPAM.
Please submit a pull request (PR) with an explanation.
Contributions are welcome! If you have any ideas, suggestions, or bug reports, please open an issue or submit a pull request on the GitHub repository.
We recommend using this module with existing burner email providers (for example, https://github.com/wesbos/burner-email-providers) to provide better results
After editing index.js, run npx rollup index.js --file index.cjs --format cjs to generate a CommonJS module.
Do not edit index.cjs directly.