@visulima/disposable-email-domains 1.1.24 → 1.1.25

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## @visulima/disposable-email-domains [1.1.25](https://github.com/visulima/visulima/compare/@visulima/disposable-email-domains@1.1.24...@visulima/disposable-email-domains@1.1.25) (2026-10-14)
+
+### Bug Fixes
+
+* **disposable-email-domains,free-email-domains:** resolve disk loaders lazily ([#962](https://github.com/visulima/visulima/issues/962)) ([0b5b734](https://github.com/visulima/visulima/commit/0b5b734e75877903993dc953df381fb5744835d4)), closes [#966](https://github.com/visulima/visulima/issues/966) [#968](https://github.com/visulima/visulima/issues/968)
+
 ## @visulima/disposable-email-domains [1.1.24](https://github.com/visulima/visulima/compare/@visulima/disposable-email-domains@1.1.23...@visulima/disposable-email-domains@1.1.24) (2026-10-14)
 
 ### Bug Fixes

package/README.md

@@ -54,21 +54,21 @@ pnpm add @visulima/disposable-email-domains
 
 | Repository | Domains | Success | Performance |
 |------------|---------|---------|-------------|
-| disposable/disposable-email-domains | 98,530 | ✅ | 0.47s (1.5 MB) |
-| willwhite/freemail | 88,162 | ✅ | 0.64s (1.3 MB) |
-| FGRibreau/mailchecker | 56,512 | ✅ | 0.49s (848.5 KB) |
-| wesbos/burner-email-providers | 27,277 | ✅ | 0.04s (388.0 KB) |
-| groundcat/disposable-email-domain-list | 21,453 | ✅ | 0.08s (329.4 KB) |
-| 7c/fakefilter | 10,630 | ✅ | 0.37s (146.1 KB) |
+| disposable/disposable-email-domains | 98,610 | ✅ | 1.05s (1.5 MB) |
+| willwhite/freemail | 88,162 | ✅ | 0.87s (1.3 MB) |
+| FGRibreau/mailchecker | 56,512 | ✅ | 0.29s (848.5 KB) |
+| wesbos/burner-email-providers | 27,277 | ✅ | 0.10s (388.0 KB) |
+| groundcat/disposable-email-domain-list | 21,453 | ✅ | 0.19s (329.4 KB) |
+| 7c/fakefilter | 10,630 | ✅ | 0.05s (146.1 KB) |
 | sublime-security/static-files | 10,522 | ✅ | 0.05s (144.0 KB) |
-| disposable-email-domains/disposable-email-domains | 9,881 | ✅ | 0.33s (139.6 KB) |
-| eser/sanitizer-svc | 3,855 | ✅ | 0.19s (48.9 KB) |
-| unkn0w/disposable-email-domain-list | 3,616 | ✅ | 0.04s (45.7 KB) |
-| MattKetmo/EmailChecker | 2,515 | ✅ | 0.07s (32.4 KB) |
-| GeroldSetz/emailondeck.com-domains | 1,121 | ✅ | 0.16s (15.4 KB) |
-| castle/disposable-email-domains | 1,000 | ✅ | 0.22s (13.1 KB) |
-| jespernissen/disposable-maildomain-list | 982 | ✅ | 0.03s (12.6 KB) |
-| TheDahoom/disposable-email | 18 | ✅ | 0.15s (234 B) |
+| disposable-email-domains/disposable-email-domains | 9,881 | ✅ | 0.53s (139.6 KB) |
+| eser/sanitizer-svc | 3,855 | ✅ | 0.20s (48.9 KB) |
+| unkn0w/disposable-email-domain-list | 3,616 | ✅ | 0.10s (45.7 KB) |
+| MattKetmo/EmailChecker | 2,515 | ✅ | 0.24s (32.4 KB) |
+| GeroldSetz/emailondeck.com-domains | 1,121 | ✅ | 0.14s (15.4 KB) |
+| castle/disposable-email-domains | 1,000 | ✅ | 0.21s (13.1 KB) |
+| jespernissen/disposable-maildomain-list | 982 | ✅ | 0.09s (12.6 KB) |
+| TheDahoom/disposable-email | 18 | ✅ | 0.13s (234 B) |
 
 <!-- END_PLACEHOLDER_CONTRIBUTING -->
 <!-- START_PLACEHOLDER_LAST_UPDATED -->
@@ -161,11 +161,23 @@ extractDomain("User@Example.COM"); // "example.com"
 
 ### Edge / browser / bundled runtimes
 
-By default the package reads `dist/domains.json` from disk via `node:fs`. That does not work in Cloudflare Workers, Next.js middleware/edge, Deno, or bundles that relocate `index.js` away from the data file. For those environments, import the list statically and inject it once at startup with `setDomains`:
+For Cloudflare Workers, Next.js middleware/edge and other bundles, import from the `/edge` subpath. It exports the same API as the main entry, but ships the list inside your bundle and registers it for you, so there is no filesystem access and no `setDomains` call:
+
+```typescript
+import { isDisposableEmail } from "@visulima/disposable-email-domains/edge";
+
+isDisposableEmail("user@mailinator.com"); // true, no setup
+```
+
+The list is about 2.8 MB (about 0.9 MB gzipped) of your bundle and cannot be tree-shaken, which is why it is a separate entry: use `/edge` only where you need it, and use the main entry with `setDomains` if you supply your own list.
+
+**Using the main entry instead?** By default the package reads `dist/domains.json` from disk via `node:fs`, the first time a lookup needs it. That is not possible in Cloudflare Workers, Next.js middleware/edge, or bundles that relocate `index.js` away from the data file, and in Deno it needs `process.getBuiltinModule`, `import.meta.url` and read permission for the data file. Importing the package is safe everywhere, but when the loader cannot read the list nothing matches the built-in list (only `customDomains` you pass per call still match) and a single warning is logged.
+
+Inject the list once at startup with `setDomains` and, since disposable detection is often a signup gate, call `assertListLoaded()` at startup so a missed or failed load throws instead of failing open (`isListLoaded()` is the non-throwing check):
 
 ```typescript
 import { setDomains, isDisposableEmail } from "@visulima/disposable-email-domains";
-import domains from "@visulima/disposable-email-domains/domains" with { type: "json" };
+import domains from "@visulima/disposable-email-domains/domains";
 
 setDomains(domains);
 
@@ -186,10 +198,10 @@ if (!isListLoaded()) {
 
 ### Raw domain list (`./domains`)
 
-The raw, sorted array of disposable domains is exported from the `./domains` subpath. In Node ESM you must use a JSON import attribute:
+The raw, sorted array of disposable domains is the default export of the `./domains` subpath. It is a plain ES module, so no JSON import attribute is needed:
 
 ```typescript
-import domains from "@visulima/disposable-email-domains/domains" with { type: "json" };
+import domains from "@visulima/disposable-email-domains/domains";
 
 console.log(domains.length); // number of disposable domains
 ```