@brilab-mailer/disposable 0.0.1

package/README.md

@@ -0,0 +1,9 @@
+# disposable
+
+## Source: [ivolo/disposable-email-domains](https://github.com/ivolo/disposable-email-domains) — list of disposable email domains used in this library
+
+This library was generated with [Nx](https://nx.dev).
+
+## Building
+
+Run `nx build disposable` to build the library.

package/data/wildcard.json

@@ -0,0 +1,401 @@
+[
+  "0x01.gq",
+  "0x01.tk",
+  "10mail.org",
+  "10mail.tk",
+  "33m.co",
+  "33mail.com",
+  "3dxtras.com",
+  "3utilities.com",
+  "567map.xyz",
+  "8191.at",
+  "aa.am",
+  "accountsite.me",
+  "acmetoy.com",
+  "acusupply.com",
+  "adultvidlite.com",
+  "aji.kr",
+  "anonaddy.com",
+  "anonaddy.me",
+  "anonbox.net",
+  "anyalias.com",
+  "asanatest1.us",
+  "azzawajalla.store",
+  "bajetesik.store",
+  "band-freier.de",
+  "bandband1.com",
+  "bangmadid.store",
+  "batikbantul.com",
+  "bccto.me",
+  "bebekpenyet.buzz",
+  "bei.kr",
+  "bel.kr",
+  "beo.kr",
+  "bfo.kr",
+  "bgsaddrmwn.me",
+  "bho.kr",
+  "biasaelho.space",
+  "biz.st",
+  "biz.tm",
+  "bko.kr",
+  "blacksong.pw",
+  "blueauramassage.com",
+  "bounceme.net",
+  "bum.net",
+  "buwosok.tech",
+  "buzzndaraiangop2wae.buzz",
+  "byui.me",
+  "caboodle.buzz",
+  "cad.edu.gr",
+  "cempue.online",
+  "chickenkiller.com",
+  "choirul.host",
+  "cid.kr",
+  "ciran.xyz",
+  "cko.kr",
+  "cloudns.asia",
+  "cloudns.cc",
+  "cloudns.cx",
+  "cloudns.nz",
+  "com.com",
+  "coms.hk",
+  "comx.cf",
+  "craigslist.org",
+  "creo.site",
+  "creo.tips",
+  "creou.dev",
+  "crowdpress.it",
+  "cu.cc",
+  "cua77.xyz",
+  "d3vs.net",
+  "dadosa.xyz",
+  "danuarte.online",
+  "darrels.site",
+  "daseus.online",
+  "dayatan.host",
+  "dbo.kr",
+  "ddns.net",
+  "ddnsfree.com",
+  "deail.com",
+  "dedyn.io",
+  "defaultdomain.ml",
+  "discard-email.cf",
+  "dko.kr",
+  "dlink.cf",
+  "dlink.gq",
+  "dlyemail.com",
+  "dmtc.dev",
+  "dmtc.edu.pl",
+  "dmtc.press",
+  "dns-cloud.net",
+  "dns.navy",
+  "dnsabr.com",
+  "dnses.ro",
+  "doy.kr",
+  "drope.ml",
+  "dropmail.me",
+  "dynu.net",
+  "dzalaev-advokat.ru",
+  "e4ward.com",
+  "ediantenan.site",
+  "edu.auction",
+  "efo.kr",
+  "eho.kr",
+  "ely.kr",
+  "email-temp.com",
+  "emailfake.com",
+  "emailfake.ml",
+  "emailfreedom.ml",
+  "emlhub.com",
+  "emlpro.com",
+  "emltmp.com",
+  "emy.kr",
+  "enu.kr",
+  "eny.kr",
+  "epizy.com",
+  "escritossad.net",
+  "ese.kr",
+  "esy.es",
+  "ewa.kr",
+  "exi.kr",
+  "ezyro.com",
+  "fackme.gq",
+  "fassagforpresident.ga",
+  "firste.ml",
+  "flu.cc",
+  "foy.kr",
+  "fr.nf",
+  "freeml.net",
+  "gadzooks.buzz",
+  "gettrials.com",
+  "giize.com",
+  "gmail.gr.com",
+  "gmeil.me",
+  "gok.kr",
+  "gotdns.ch",
+  "gpa.lu",
+  "grigio.cf",
+  "guardmail.cf",
+  "haddo.eu",
+  "heliohost.org",
+  "higogoya.com",
+  "historial.store",
+  "hitechinfo.com",
+  "hix.kr",
+  "hiz.kr",
+  "hmail.us",
+  "hopto.org",
+  "hostingarif.me",
+  "idn.vn",
+  "iesco.info",
+  "igg.biz",
+  "ignorelist.com",
+  "iki.kr",
+  "ilovemyniggers.club",
+  "imouto.pro",
+  "info.tm",
+  "infos.st",
+  "irr.kr",
+  "isgre.at",
+  "it2-mail.tk",
+  "jil.kr",
+  "jindmail.club",
+  "jto.kr",
+  "junnuok.com",
+  "justemail.ml",
+  "kadokawa.top",
+  "kantal.buzz",
+  "keitin.site",
+  "kentel.buzz",
+  "kerl.cf",
+  "kerl.gq",
+  "kikwet.com",
+  "kondomeus.site",
+  "kozow.com",
+  "kranjingan.store",
+  "kranjingan.tech",
+  "kranjingans.tech",
+  "kro.kr",
+  "lal.kr",
+  "laste.ml",
+  "lbe.kr",
+  "legundi.site",
+  "lei.kr",
+  "likevip.net",
+  "liopers.link",
+  "lko.co.kr",
+  "lko.kr",
+  "ll47.net",
+  "lofteone.ru",
+  "lom.kr",
+  "longdz.site",
+  "longmusic.com",
+  "lostandalone.com",
+  "loudcannabisapp.com",
+  "loy.kr",
+  "loyalherceghalom.ml",
+  "luk2.com",
+  "luksarcenter.ru",
+  "luo.kr",
+  "lyrics-lagu.me",
+  "mail-temp.com",
+  "mail0.ga",
+  "mailinator.com",
+  "mailr.eu",
+  "marrone.cf",
+  "mbe.kr",
+  "mblimbingan.space",
+  "mebelnovation.ru",
+  "mefound.com",
+  "mintemail.com",
+  "mishmash.buzz",
+  "mko.kr",
+  "mlo.kr",
+  "mooo.com",
+  "motifasidiri.website",
+  "mp-j.cf",
+  "mp-j.ga",
+  "mp-j.gq",
+  "mp-j.ml",
+  "mp-j.tk",
+  "mr-meshkat.com",
+  "mrossi.cf",
+  "mrossi.gq",
+  "mrossi.ml",
+  "ms1.email",
+  "msdc.co",
+  "muabanwin.net",
+  "museumplanet.com",
+  "my.id",
+  "my3mail.cf",
+  "my3mail.ga",
+  "my3mail.gq",
+  "my3mail.ml",
+  "my3mail.tk",
+  "myddns.me",
+  "myeslbookclub.com",
+  "mymy.cf",
+  "mysafe.ml",
+  "mzon.store",
+  "n-e.kr",
+  "nafko.cf",
+  "nctu.me",
+  "netmail.tk",
+  "netricity.nl",
+  "new-mgmt.ga",
+  "ngalasmoen.xyz",
+  "ngguwokulon.online",
+  "njambon.space",
+  "nko.kr",
+  "now.im",
+  "npv.kr",
+  "nuo.co.kr",
+  "nuo.kr",
+  "nut.cc",
+  "o-r.kr",
+  "oazis.site",
+  "obo.kr",
+  "ocry.com",
+  "office.gy",
+  "okezone.bid",
+  "one.pl",
+  "onlysext.com",
+  "oovy.org",
+  "oppoesrt.online",
+  "orangotango.ml",
+  "otherinbox.com",
+  "ourhobby.com",
+  "owa.kr",
+  "owh.ooo",
+  "oyu.kr",
+  "p-e.kr",
+  "pafnuty.com",
+  "pandies.space",
+  "paqeh.online",
+  "pe.hu",
+  "petinggiean.tech",
+  "peyekkolipi.buzz",
+  "poderosamulher.com",
+  "poistaa.com",
+  "porco.cf",
+  "poy.kr",
+  "prapto.host",
+  "probatelawarizona.com",
+  "ptcu.dev",
+  "pubgm.website",
+  "qbi.kr",
+  "qc.to",
+  "r-e.kr",
+  "ragel.me",
+  "rao.kr",
+  "reilis.site",
+  "rf.gd",
+  "ringen.host",
+  "rko.kr",
+  "rosso.ml",
+  "row.kr",
+  "rr.nu",
+  "rshagor.xyz",
+  "s-ly.me",
+  "safe-mail.gq",
+  "sagun.info",
+  "samsueng.site",
+  "saucent.online",
+  "sborra.tk",
+  "schwarzmail.ga",
+  "seluang.com",
+  "sempak.link",
+  "sendaljepit.site",
+  "sendangagung.online",
+  "servegame.com",
+  "shp7.cn",
+  "siambretta.com",
+  "skodaauto.cf",
+  "soju.buzz",
+  "solidplai.us",
+  "somee.com",
+  "spamtrap.ro",
+  "spymail.one",
+  "ssanphone.me",
+  "standeight.com",
+  "statuspage.ga",
+  "steakbeef.site",
+  "stonedogdigital.com",
+  "stop-my-spam.pp.ua",
+  "storeyee.com",
+  "sumanan.site",
+  "supere.ml",
+  "svblog.com",
+  "sytes.net",
+  "tandy.co",
+  "tangtingtung.tech",
+  "teml.net",
+  "tempembus.buzz",
+  "tempremail.cf",
+  "tempremail.tk",
+  "tgwrzqr.top",
+  "thepieter.com",
+  "theworkpc.com",
+  "thinktimessolve.info",
+  "thumoi.com",
+  "tko.co.kr",
+  "tko.kr",
+  "tmo.kr",
+  "tmpeml.com",
+  "toh.info",
+  "toi.kr",
+  "tomcrusenono.host",
+  "topikurrohman.xyz",
+  "tourbalitravel.com",
+  "traveldesk.com",
+  "tricakesi.store",
+  "trillianpro.com",
+  "twilightparadox.com",
+  "tyrex.cf",
+  "uha.kr",
+  "uk.to",
+  "uko.kr",
+  "umy.kr",
+  "unaux.com",
+  "undo.it",
+  "uny.kr",
+  "uola.org",
+  "upy.kr",
+  "urbanban.com",
+  "us.to",
+  "usa.cc",
+  "uu.gl",
+  "uvy.kr",
+  "uyu.kr",
+  "vay.kr",
+  "vba.kr",
+  "veo.kr",
+  "viola.gq",
+  "vivoheroes.xyz",
+  "vkbags.in",
+  "vo.uk",
+  "volvo-xc.tk",
+  "vuforia.us",
+  "wakultimbo.buzz",
+  "web.id",
+  "weprof.it",
+  "werkuldino.buzz",
+  "wil.kr",
+  "wingkobabat.buzz",
+  "x24hr.com",
+  "xiaomie.store",
+  "xo.uk",
+  "xxi2.com",
+  "yarien.eu",
+  "yawahid.host",
+  "ye.vc",
+  "yertxenor.tk",
+  "yomail.info",
+  "yopmail.com",
+  "yoqoyyum.space",
+  "youdontcare.com",
+  "zalvisual.us",
+  "zapto.org",
+  "ze.cx",
+  "zeroe.ml"
+]

package/data/wildcard.sha256

@@ -0,0 +1 @@
+3b3e9d56e2f98f19f3d7ddf76cd09615531b69616b8aa20520c2aa3bc9bf9bb8

package/index.d.ts

@@ -0,0 +1,5 @@
+import { DisposableMatcher } from './matcher.js';
+export declare function isDisposableEmail(email: string): boolean;
+export declare function isDisposableDomain(domain: string): boolean;
+export { DisposableMatcher };
+//# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA2BjD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAE1D;AAED,OAAO,EAAE,iBAAiB,EAAE,CAAC"}

package/index.js

@@ -0,0 +1,31 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import path from 'node:path';
+import { DisposableMatcher } from './matcher.js';
+function loadWildcardJson() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = path.dirname(__filename);
+    // dist/index.js -> ../data/wildcard.json (because "data" is shipped)
+    const p = path.join(__dirname, '..', 'data', 'wildcard.json');
+    const raw = readFileSync(p, 'utf8');
+    const json = JSON.parse(raw);
+    if (Array.isArray(json))
+        return json;
+    // In case format changes in the future
+    if (json && typeof json === 'object') {
+        const anyJson = json;
+        if (Array.isArray(anyJson.wildcard))
+            return anyJson.wildcard;
+        if (Array.isArray(anyJson.domains))
+            return anyJson.domains;
+    }
+    throw new Error('Unsupported wildcard.json format');
+}
+const matcher = new DisposableMatcher(loadWildcardJson());
+export function isDisposableEmail(email) {
+    return matcher.isDisposable(email);
+}
+export function isDisposableDomain(domain) {
+    return matcher.isDisposable(domain);
+}
+export { DisposableMatcher };

package/matcher.d.ts

@@ -0,0 +1,18 @@
+export type WildcardEntry = string;
+/**
+ * Matches disposable domains from a list that can include wildcard entries.
+ * Supported patterns:
+ *  - "example.com" (exact)
+ *  - "*.example.com" (any subdomain OR the root; see notes below)
+ *
+ * NOTE: For practicality, we treat "*.example.com" as matching both:
+ *  - example.com
+ *  - anything.example.com
+ */
+export declare class DisposableMatcher {
+    private readonly exact;
+    private readonly suffixes;
+    constructor(entries: WildcardEntry[]);
+    isDisposable(emailOrDomain: string): boolean;
+}
+//# sourceMappingURL=matcher.d.ts.map

package/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../src/matcher.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC;AAcnC;;;;;;;;;GASG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,OAAO,EAAE,aAAa,EAAE;IAgBpC,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO;CAa7C"}

package/matcher.js

@@ -0,0 +1,53 @@
+function normalizeDomain(d) {
+    return d.trim().toLowerCase().replace(/\.$/, '');
+}
+function extractDomain(emailOrDomain) {
+    const v = emailOrDomain.trim();
+    const at = v.lastIndexOf('@');
+    const domain = at >= 0 ? v.slice(at + 1) : v;
+    const norm = normalizeDomain(domain);
+    return norm ? norm : null;
+}
+/**
+ * Matches disposable domains from a list that can include wildcard entries.
+ * Supported patterns:
+ *  - "example.com" (exact)
+ *  - "*.example.com" (any subdomain OR the root; see notes below)
+ *
+ * NOTE: For practicality, we treat "*.example.com" as matching both:
+ *  - example.com
+ *  - anything.example.com
+ */
+export class DisposableMatcher {
+    exact = new Set();
+    suffixes = [];
+    constructor(entries) {
+        for (const raw of entries) {
+            const e = normalizeDomain(raw);
+            if (!e)
+                continue;
+            if (e.startsWith('*.')) {
+                this.suffixes.push(e.slice(2));
+            }
+            else {
+                this.exact.add(e);
+            }
+        }
+        // check longer suffixes first (micro-optimization)
+        this.suffixes.sort((a, b) => b.length - a.length);
+    }
+    isDisposable(emailOrDomain) {
+        const domain = extractDomain(emailOrDomain);
+        if (!domain)
+            return false;
+        if (this.exact.has(domain))
+            return true;
+        for (const s of this.suffixes) {
+            if (domain === s)
+                return true;
+            if (domain.endsWith('.' + s))
+                return true;
+        }
+        return false;
+    }
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@brilab-mailer/disposable",
+  "version": "0.0.1",
+  "description": "Fast disposable email/domain detection with bundled wildcard list and optional postinstall refresh.",
+  "author": "Bohdan Radchenko <radchenkobs@gmail.com>",
+  "type": "module",
+  "main": "./index.js",
+  "module": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "**/*",
+    "!**/*.tsbuildinfo",
+    "data",
+    "scripts"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "email",
+    "disposable",
+    "validation",
+    "domain",
+    "blocklist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "directory": "dist"
+  },
+  "scripts": {
+    "postinstall": "node scripts/postinstall.cjs"
+  }
+}

package/scripts/postinstall.cjs

@@ -0,0 +1,62 @@
+/* eslint-disable no-console */
+const fs = require('node:fs');
+const path = require('node:path');
+const https = require('node:https');
+const crypto = require('node:crypto');
+
+const URL =
+  'https://raw.githubusercontent.com/ivolo/disposable-email-domains/master/wildcard.json';
+
+const DATA_DIR = path.join(__dirname, '..', 'data');
+const TARGET_JSON = path.join(DATA_DIR, 'wildcard.json');
+const TARGET_SHA = path.join(DATA_DIR, 'wildcard.sha256');
+
+const HARD_FAIL = process.env.DISPOSABLE_DOMAINS_HARD_FAIL === '1';
+const TIMEOUT_MS = Number(process.env.DISPOSABLE_DOMAINS_TIMEOUT_MS || 2500);
+
+function sha256(buf) {
+  return crypto.createHash('sha256').update(buf).digest('hex');
+}
+
+function fetch(url) {
+  return new Promise((resolve, reject) => {
+    const req = https.get(url, { timeout: TIMEOUT_MS }, (res) => {
+      if (res.statusCode !== 200) {
+        reject(new Error(`HTTP ${res.statusCode}`));
+        res.resume();
+        return;
+      }
+      const chunks = [];
+      res.on('data', (c) => chunks.push(c));
+      res.on('end', () => resolve(Buffer.concat(chunks)));
+    });
+    req.on('timeout', () => req.destroy(new Error('timeout')));
+    req.on('error', reject);
+  });
+}
+
+(async () => {
+  try {
+    fs.mkdirSync(DATA_DIR, { recursive: true });
+
+    const buf = await fetch(URL);
+
+    // basic sanity check (avoid saving HTML/errors)
+    const parsed = JSON.parse(buf.toString('utf8'));
+    if (!Array.isArray(parsed) || parsed.length < 100) {
+      throw new Error('Unexpected JSON format/size');
+    }
+
+    fs.writeFileSync(TARGET_JSON, buf);
+    fs.writeFileSync(TARGET_SHA, sha256(buf), 'utf8');
+
+    console.log(
+      `[disposable-domain-kit] updated wildcard.json (${parsed.length} entries)`
+    );
+  } catch (e) {
+    console.warn(
+      `[disposable-domain-kit] could not update list, using bundled snapshot. reason: ${e.message}`
+    );
+    if (HARD_FAIL) process.exit(1);
+  }
+})();