@brilab-mailer/utils 0.0.5-4 → 0.1.0

package/decorators/is-real-email.decorator.d.ts

@@ -1,7 +1,20 @@
-import { ValidationOptions, ValidatorConstraintInterface } from 'class-validator';
+import { ValidationOptions, ValidationArguments, ValidatorConstraintInterface } from 'class-validator';
+export interface IsRealEmailOptions {
+    /** Disable the MX lookup entirely (e.g. in tests/CI). Default: false. */
+    disabled?: boolean;
+    /** Custom DNS servers for the MX lookup. Default: ['1.1.1.1', '8.8.8.8']. */
+    servers?: string[];
+    /** Lookup timeout in ms. Default: 3000. */
+    timeoutMs?: number;
+    /** Cache TTL in ms for resolved domains. Default: 300000 (5 min). */
+    cacheTtlMs?: number;
+    /** Result to return on timeout/transient DNS failure. Default: true (fail-open). */
+    failOpen?: boolean;
+}
 export declare class IsRealEmailConstraint implements ValidatorConstraintInterface {
-    validate(email: string): Promise<boolean>;
+    validate(email: string, args?: ValidationArguments): Promise<boolean>;
+    private lookup;
     defaultMessage(): string;
 }
-export declare function IsRealEmail(validationOptions?: ValidationOptions): PropertyDecorator;
+export declare function IsRealEmail(options?: IsRealEmailOptions & ValidationOptions): PropertyDecorator;
 //# sourceMappingURL=is-real-email.decorator.d.ts.map

package/decorators/is-real-email.decorator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"is-real-email.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/is-real-email.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EAEjB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AAIzB,qBACa,qBAAsB,YAAW,4BAA4B;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM;IAqB5B,cAAc;CAGf;AAGD,wBAAgB,WAAW,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,iBAAiB,CAWpF"}
+{"version":3,"file":"is-real-email.decorator.d.ts","sourceRoot":"","sources":["../../src/decorators/is-real-email.decorator.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iBAAiB,EACjB,mBAAmB,EAEnB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AAGzB,MAAM,WAAW,kBAAkB;IACjC,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6EAA6E;IAC7E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAeD,qBACa,qBAAsB,YAAW,4BAA4B;IAClE,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;YAqB7D,MAAM;IAwBpB,cAAc,IAAI,MAAM;CAGzB;AAED,wBAAgB,WAAW,CACzB,OAAO,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,GAC/C,iBAAiB,CAoBnB"}

package/decorators/is-real-email.decorator.js

@@ -1,26 +1,57 @@
 import { __decorate } from "tslib";
 import { registerDecorator, ValidatorConstraint, } from 'class-validator';
-import { Resolver, resolveMx } from 'node:dns/promises';
+import { Resolver } from 'node:dns/promises';
+const DEFAULTS = {
+    disabled: false,
+    servers: ['1.1.1.1', '8.8.8.8'],
+    timeoutMs: 3000,
+    cacheTtlMs: 5 * 60 * 1000,
+    failOpen: true,
+};
+const mxCache = new Map();
+const TIMEOUT = Symbol('timeout');
 let IsRealEmailConstraint = class IsRealEmailConstraint {
-    async validate(email) {
+    async validate(email, args) {
+        const opts = { ...DEFAULTS, ...(args?.constraints?.[0] ?? {}) };
+        if (opts.disabled)
+            return true;
+        if (typeof email !== 'string')
+            return false;
+        const domain = email.split('@').at(-1)?.trim().toLowerCase();
+        if (!domain)
+            return false;
+        const cached = mxCache.get(domain);
+        const now = Date.now();
+        if (cached && cached.expires > now)
+            return cached.result;
+        const result = await this.lookup(domain, opts);
+        // Only cache definitive answers, not fail-open timeouts.
+        if (result.cacheable) {
+            mxCache.set(domain, { result: result.value, expires: now + opts.cacheTtlMs });
+        }
+        return result.value;
+    }
+    async lookup(domain, opts) {
+        const resolver = new Resolver();
+        if (opts.servers?.length)
+            resolver.setServers(opts.servers);
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => resolve(TIMEOUT), opts.timeoutMs);
+        });
         try {
-            const domain = email.split('@').at(-1);
-            if (!domain)
-                return false;
-            const USE_CUSTOM_RESOLVER = true;
-            let mxRecords = [];
-            if (USE_CUSTOM_RESOLVER) {
-                const resolver = new Resolver();
-                resolver.setServers(['1.1.1.1', '8.8.8.8']);
-                mxRecords = await resolver.resolveMx(domain);
-            }
-            else {
-                mxRecords = await resolveMx(domain);
-            }
-            return !!mxRecords?.length;
+            const outcome = await Promise.race([resolver.resolveMx(domain), timeout]);
+            if (outcome === TIMEOUT)
+                return { value: opts.failOpen ?? true, cacheable: false };
+            return { value: Array.isArray(outcome) && outcome.length > 0, cacheable: true };
         }
         catch {
-            return false;
+            // Genuine resolution failure (NXDOMAIN/ENODATA): domain cannot receive mail.
+            return { value: false, cacheable: true };
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
         }
     }
     defaultMessage() {
@@ -31,14 +62,22 @@ IsRealEmailConstraint = __decorate([
     ValidatorConstraint({ async: true })
 ], IsRealEmailConstraint);
 export { IsRealEmailConstraint };
-export function IsRealEmail(validationOptions) {
+export function IsRealEmail(options) {
+    const { disabled, servers, timeoutMs, cacheTtlMs, failOpen, ...validationOptions } = options ?? {};
+    const constraintOptions = {
+        disabled,
+        servers,
+        timeoutMs,
+        cacheTtlMs,
+        failOpen,
+    };
     return function (target, propertyKey) {
         registerDecorator({
             name: 'IsRealEmail',
             target: target.constructor,
             propertyName: String(propertyKey),
             options: validationOptions,
-            constraints: [],
+            constraints: [constraintOptions],
             validator: IsRealEmailConstraint,
         });
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brilab-mailer/utils",
-  "version": "0.0.5-4",
+  "version": "0.1.0",
   "author": "Bohdan Radchenko <radchenkobs@gmail.com>",
   "type": "module",
   "main": "./index.js",