disposable-email-domain 1.0.1 → 1.0.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +55 -0
- package/package.json +7 -2
package/README.md
ADDED
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
# disposable-email-domain
|
|
2
|
+
|
|
3
|
+
[](https://www.npmjs.com/package/disposable-email-domain)
|
|
4
|
+
[](https://www.npmjs.com/package/disposable-email-domain)
|
|
5
|
+
[](https://github.com/mehrtat/disposable-email-domain/blob/main/LICENSE)
|
|
6
|
+
|
|
7
|
+
A large, **auto-updated** list of disposable / temporary / throwaway email domains (mailinator, 10minutemail, guerrillamail, …), with a tiny zero-dependency `isDisposable()` helper.
|
|
8
|
+
|
|
9
|
+
- **160,000+ domains**, aggregated from 6 well-maintained public blocklists, deduped and normalized (lowercased, IDNA/punycode).
|
|
10
|
+
- **Refreshed daily** by a GitHub Action — a new version is published only when the set actually changes.
|
|
11
|
+
- **Zero dependencies.** Ships the raw list too, so you can use it however you like.
|
|
12
|
+
|
|
13
|
+
## Install
|
|
14
|
+
|
|
15
|
+
```bash
|
|
16
|
+
npm install disposable-email-domain
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
## Usage
|
|
20
|
+
|
|
21
|
+
```ts
|
|
22
|
+
import { isDisposable, domains } from "disposable-email-domain";
|
|
23
|
+
|
|
24
|
+
isDisposable("someone@mailinator.com"); // true
|
|
25
|
+
isDisposable("someone@gmail.com"); // false
|
|
26
|
+
isDisposable("mailinator.com"); // true (bare domain also works)
|
|
27
|
+
|
|
28
|
+
domains.length; // 160000+ — the full array if you want it
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
CommonJS:
|
|
32
|
+
|
|
33
|
+
```js
|
|
34
|
+
const { isDisposable } = require("disposable-email-domain");
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
`isDisposable(input)` accepts a full email (`user@domain`) or a bare domain, is case-insensitive, and returns `boolean`.
|
|
38
|
+
|
|
39
|
+
## Why
|
|
40
|
+
|
|
41
|
+
Blocking disposable-email signups cuts fraud, fake accounts, and junk. Hand-maintaining such a list is a losing battle — this package keeps it fresh for you automatically.
|
|
42
|
+
|
|
43
|
+
## Data sources
|
|
44
|
+
|
|
45
|
+
Aggregated + deduped from: `disposable/disposable-email-domains`, `ivolo/disposable-email-domains`, `FGRibreau/mailchecker`, `wesbos/burner-email-providers`, `disposable-email-domains/disposable-email-domains`, `7c/fakefilter`. Credit to their maintainers.
|
|
46
|
+
|
|
47
|
+
## Also available for
|
|
48
|
+
|
|
49
|
+
Go — `go get github.com/mehrtat/disposable-email-domain` · .NET — `dotnet add package DisposableEmailDomain`
|
|
50
|
+
|
|
51
|
+
Source, issues, and how to contribute a source: **https://github.com/mehrtat/disposable-email-domain**
|
|
52
|
+
|
|
53
|
+
## License
|
|
54
|
+
|
|
55
|
+
MIT © Mehrdad TAT
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "disposable-email-domain",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.2",
|
|
4
4
|
"description": "Aggregated, deduped, normalized list of disposable / temporary email domains, with an isDisposable() helper. Auto-refreshed daily.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"disposable",
|
|
@@ -17,11 +17,16 @@
|
|
|
17
17
|
"url": "https://github.com/mehrtat/disposable-email-domain.git",
|
|
18
18
|
"directory": "packages/npm"
|
|
19
19
|
},
|
|
20
|
+
"homepage": "https://github.com/mehrtat/disposable-email-domain#readme",
|
|
21
|
+
"bugs": {
|
|
22
|
+
"url": "https://github.com/mehrtat/disposable-email-domain/issues"
|
|
23
|
+
},
|
|
20
24
|
"main": "dist/index.js",
|
|
21
25
|
"types": "dist/index.d.ts",
|
|
22
26
|
"files": [
|
|
23
27
|
"dist",
|
|
24
|
-
"domains.json"
|
|
28
|
+
"domains.json",
|
|
29
|
+
"README.md"
|
|
25
30
|
],
|
|
26
31
|
"scripts": {
|
|
27
32
|
"build": "tsc",
|