oluwatunmiisheii

disposable-email-validator: Block Temporary Email Signups

A TypeScript library for rejecting disposable email domains and optionally blocking plus-addressed email addresses. It applies configurable rules by environment, making it useful when signup policies differ between development and production.

InactiveTypeScriptMITLibraryEmailSecurity
View on GitHub Compare
Stars
120
Forks
5
Stars, last 30 days
+0
Last commit
1.3 years ago
Contributors
1

Our take

Inactiveno commits in over a year

Health score

16/100

How it is scored
Activity
19
Community
4
Issues
21
Pull requests
20

+0 stars in the last 30 days

  • Fewer contributors than 91% of the projects we track

This is a focused, configurable validation library, but its inactive project status and reliance on a single contributor warrant extra scrutiny before adopting it for critical signup flows.

Good fit if

  • Your Node.js application needs environment-specific checks for disposable email and plus addressing.
  • You want to combine a built-in domain list with your own rules and trusted domains.
  • An MIT-licensed library suits your project, and your team can review or maintain it if needed.

Look elsewhere if

  • You need an actively maintained dependency: there have been no commits in over a year and no releases in the past year.
  • You require evidence of a broader maintainer base: the project’s code contributions are concentrated in one person.
  • You need recent issue or pull-request activity as a signal of ongoing support; none were closed or merged in the measured recent period.
All health signals
Last commit2025-07-04 (1.3 years ago)
Commits, last 90 days0
Releases, last 12 months0
Contributors1
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age16 months

Checked on 2026-10-13 with the GitHub API.

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

120

Forks

5

Change since Nov 18, 2026: 0 stars·0 forks

Overview

disposable-email-validator is a Node.js TypeScript library for checking email addresses against rules you define per environment. It can reject addresses from disposable-email domains and, optionally, addresses that use plus addressing, such as [email hidden].

It is intended for application teams that want stricter signup checks in production while retaining more flexibility in development. The package includes a built-in disposable-domain list and supports custom domains and trusted domains.

Key Features

  • Reject email addresses using known disposable domains.
  • Enable or disable plus-addressing validation by environment.
  • Configure distinct rules for named environments, including custom environment names.
  • Add trusted domains that are allowed regardless of the other rules.
  • Merge custom disposable domains with the built-in list, or use only the custom list.
  • Receive typed validation results with success status and an error message.

Use Cases

  • A signup service can block throwaway email domains in production while allowing them in development.
  • A product team can decide whether addresses such as [email hidden] are acceptable for account creation.
  • An application can maintain its own list of disposable domains alongside the package’s built-in list.
  • A team can allow trusted email domains even when stricter disposable-email rules are enabled.

What you need

Detected in the repository

  • Node.js (from package.json)
  • A test suite

License in plain words

MITpermissive

  • Commercial use: yes
  • Modify and redistribute: yes
  • You must keep: the copyright and license notice
  • Share your changes: no

A summary, not legal advice: the LICENSE file is what applies.

Getting Started

Install the package:

npm install disposable-email-validator

See the README for configuration and API details.

Alternatives

  • disposable-email-domains: This project supplies a disposable-domain blocklist, while disposable-email-validator adds configurable validation rules and optional plus-address blocking.
ProjectLanguageLicenseStarsStatus
disposable-email-validatorTypeScriptMIT120Inactive
disposable-email-domainsPython–5.7kActive

Considerations

The repository is marked inactive, with no commits in over a year, and its contributions are concentrated in one person. There have also been no releases in the past year, so check the package and its domain data against your requirements before relying on it. The documented setup requires Node.js, and the README describes tests but does not indicate CI. The included domain list is sourced from another project; teams with specific coverage needs should review their custom-domain and merge settings.

Found this useful?

Share it with someone who would like disposable-email-validator.

Comparisons