@brilab-mailer/utils 0.2.0 → 0.2.2

package/cjs/decorators/email-field.decorator.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailField = EmailField;
+const common_1 = require("@nestjs/common");
+const class_validator_1 = require("class-validator");
+const class_transformer_1 = require("class-transformer");
+const is_real_email_decorator_js_1 = require("./is-real-email.decorator.js");
+function EmailField(options) {
+    return (0, common_1.applyDecorators)((0, class_validator_1.IsEmail)(), (0, is_real_email_decorator_js_1.IsRealEmail)(), (0, class_validator_1.IsString)(), (0, class_validator_1.MaxLength)(255), (0, class_validator_1.Matches)(/^(?!\s*$).+/, { message: 'should not be only spaces' }), ...(options?.required !== false ? [(0, class_validator_1.IsNotEmpty)()] : []), (0, class_transformer_1.Transform)(({ value }) => (value === '' ? null : value)));
+}

package/cjs/decorators/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./is-real-email.decorator.js"), exports);
+__exportStar(require("./email-field.decorator.js"), exports);

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

@@ -0,0 +1,93 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IsRealEmailConstraint = void 0;
+exports.IsRealEmail = IsRealEmail;
+const class_validator_1 = require("class-validator");
+const promises_1 = require("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, 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 promises_1.Resolver();
+        if (opts.servers?.length)
+            resolver.setServers(opts.servers);
+        let timer;
+        const timeout = new Promise((resolve) => {
+            timer = setTimeout(() => resolve(TIMEOUT), opts.timeoutMs);
+        });
+        try {
+            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 {
+            // Genuine resolution failure (NXDOMAIN/ENODATA): domain cannot receive mail.
+            return { value: false, cacheable: true };
+        }
+        finally {
+            if (timer)
+                clearTimeout(timer);
+        }
+    }
+    defaultMessage() {
+        return 'This email cannot receive messages (invalid domain)';
+    }
+};
+exports.IsRealEmailConstraint = IsRealEmailConstraint;
+exports.IsRealEmailConstraint = IsRealEmailConstraint = __decorate([
+    (0, class_validator_1.ValidatorConstraint)({ async: true })
+], IsRealEmailConstraint);
+function IsRealEmail(options) {
+    const { disabled, servers, timeoutMs, cacheTtlMs, failOpen, ...validationOptions } = options ?? {};
+    const constraintOptions = {
+        disabled,
+        servers,
+        timeoutMs,
+        cacheTtlMs,
+        failOpen,
+    };
+    return function (target, propertyKey) {
+        (0, class_validator_1.registerDecorator)({
+            name: 'IsRealEmail',
+            target: target.constructor,
+            propertyName: String(propertyKey),
+            options: validationOptions,
+            constraints: [constraintOptions],
+            validator: IsRealEmailConstraint,
+        });
+    };
+}

package/cjs/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./decorators/index.js"), exports);

package/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@brilab-mailer/utils",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "author": "Bohdan Radchenko <radchenkobs@gmail.com>",
   "type": "module",
-  "main": "./index.js",
+  "main": "./cjs/index.js",
   "module": "./index.js",
   "types": "./index.d.ts",
   "exports": {
@@ -11,7 +11,7 @@
     ".": {
       "types": "./index.d.ts",
       "import": "./index.js",
-      "default": "./index.js"
+      "require": "./cjs/index.js"
     }
   },
   "files": [