mikromail 0.0.7 → 1.0.0

package/README.md

@@ -89,6 +89,49 @@ const emailOptions = {
 await new MikroMail({ config }).send(emailOptions);
 ```
 
+## Provider-specific configurations
+
+### Proton Mail
+
+Proton Mail works reliably with port 465 and implicit TLS:
+
+```typescript
+const config = {
+  user: 'your-email@proton.me',
+  password: 'YOUR_APP_PASSWORD',
+  host: 'smtp.protonmail.ch',
+  port: 465,
+  secure: true
+};
+```
+
+Note: Port 587 with STARTTLS (`secure: false`) may have connectivity issues with some Proton Mail configurations. Use port 465 for the most reliable connection.
+
+### Test providers (Mailtrap, etc.)
+
+Some test SMTP providers use long random IDs instead of email addresses. To support these providers, use the `skipEmailValidation` and `skipMXRecordCheck` options:
+
+```typescript
+const config = {
+  user: 'your-mailtrap-username',
+  password: 'your-mailtrap-password',
+  host: 'smtp.mailtrap.io',
+  port: 587,
+  secure: false,
+  skipEmailValidation: true,
+  skipMXRecordCheck: true
+};
+
+const emailOptions = {
+  from: 'sender@example.com',
+  subject: 'Test Email',
+  text: 'Hello!',
+  to: 'a1b2c3d4e5f6g7' // Long random ID used by test providers
+};
+
+await new MikroMail({ config }).send(emailOptions);
+```
+
 ## Testing
 
 Some of the tests require faking an SMTP server. Here we use [Mailpit](https://github.com/axllent/mailpit), which will run a server on `http://localhost:8025`.

package/lib/Configuration.js

@@ -67,7 +67,9 @@ var Configuration = class {
       port: 465,
       secure: true,
       debug: false,
-      maxRetries: 2
+      maxRetries: 2,
+      skipEmailValidation: false,
+      skipMXRecordCheck: false
     };
     let fileConfig = {};
     if ((0, import_node_fs.existsSync)(configFilePath)) {

package/lib/Configuration.mjs

@@ -1,6 +1,6 @@
 import {
   Configuration
-} from "./chunk-YVXB6HCK.mjs";
+} from "./chunk-ULVDQIAT.mjs";
 import "./chunk-47VXJTWV.mjs";
 export {
   Configuration

package/lib/MikroMail.d.mts

@@ -20,6 +20,7 @@ import { ConfigurationOptions, EmailOptions } from './interfaces/index.mjs';
  */
 declare class MikroMail {
     private readonly smtpClient;
+    private readonly config;
     constructor(options?: ConfigurationOptions);
     /**
      * Sends an email to valid domains.

package/lib/MikroMail.d.ts

@@ -20,6 +20,7 @@ import { ConfigurationOptions, EmailOptions } from './interfaces/index.js';
  */
 declare class MikroMail {
     private readonly smtpClient;
+    private readonly config;
     constructor(options?: ConfigurationOptions);
     /**
      * Sends an email to valid domains.

package/lib/MikroMail.js

@@ -79,7 +79,9 @@ var Configuration = class {
       port: 465,
       secure: true,
       debug: false,
-      maxRetries: 2
+      maxRetries: 2,
+      skipEmailValidation: false,
+      skipMXRecordCheck: false
     };
     let fileConfig = {};
     if ((0, import_node_fs.existsSync)(configFilePath)) {
@@ -189,7 +191,7 @@ function validateEmail(email) {
       return false;
     for (const part of domainParts) {
       if (!part || part.length > 63) return false;
-      if (!/^[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?$/.test(part)) return false;
+      if (!/^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(part)) return false;
     }
     return true;
   } catch (_error) {
@@ -237,7 +239,9 @@ var SMTPClient = class {
       clientName: config.clientName ?? import_node_os.default.hostname(),
       maxRetries: config.maxRetries ?? 3,
       retryDelay: config.retryDelay ?? 1e3,
-      skipAuthentication: config.skipAuthentication || false
+      skipAuthentication: config.skipAuthentication || false,
+      skipEmailValidation: config.skipEmailValidation || false,
+      skipMXRecordCheck: config.skipMXRecordCheck || false
     };
     this.socket = null;
     this.connected = false;
@@ -642,20 +646,24 @@ ${text || ""}`;
         error: "Missing required email parameters (from, to, subject, and either text or html)"
       };
     }
-    if (!validateEmail(from)) {
-      return {
-        success: false,
-        error: "Invalid email address format"
-      };
-    }
     const recipients = Array.isArray(options.to) ? options.to : [options.to];
-    for (const recipient of recipients) {
-      if (!validateEmail(recipient)) {
+    if (!this.config.skipEmailValidation) {
+      if (!validateEmail(from)) {
         return {
           success: false,
-          error: `Invalid recipient email address format: ${recipient}`
+          error: "Invalid email address format"
         };
       }
+      for (const recipient of recipients) {
+        if (!validateEmail(recipient)) {
+          return {
+            success: false,
+            error: `Invalid recipient email address format: ${recipient}`
+          };
+        }
+      }
+    } else {
+      this.log("Email validation skipped (testing mode)");
     }
     for (this.retryCount = 0; this.retryCount <= this.config.maxRetries; this.retryCount++) {
       try {
@@ -754,10 +762,12 @@ ${text || ""}`;
 // src/MikroMail.ts
 var MikroMail = class {
   smtpClient;
+  config;
   constructor(options) {
     const config = new Configuration(options).get();
     const smtpClient = new SMTPClient(config);
     this.smtpClient = smtpClient;
+    this.config = config;
   }
   /**
    * Sends an email to valid domains.
@@ -765,12 +775,14 @@ var MikroMail = class {
   async send(emailOptions) {
     try {
       const recipients = Array.isArray(emailOptions.to) ? emailOptions.to : [emailOptions.to];
-      for (const recipient of recipients) {
-        const hasMXRecords = await verifyEmailDomain(recipient);
-        if (!hasMXRecords)
-          console.error(
-            `Warning: No MX records found for recipient domain: ${recipient}`
-          );
+      if (!this.config.skipMXRecordCheck) {
+        for (const recipient of recipients) {
+          const hasMXRecords = await verifyEmailDomain(recipient);
+          if (!hasMXRecords)
+            console.error(
+              `Warning: No MX records found for recipient domain: ${recipient}`
+            );
+        }
       }
       const result = await this.smtpClient.sendEmail(emailOptions);
       if (result.success) console.log(`Message ID: ${result.messageId}`);

package/lib/MikroMail.mjs

@@ -1,10 +1,10 @@
 import {
   MikroMail
-} from "./chunk-422R3NOG.mjs";
-import "./chunk-YVXB6HCK.mjs";
-import "./chunk-NGT3KX7A.mjs";
+} from "./chunk-IYCQK5YZ.mjs";
+import "./chunk-ULVDQIAT.mjs";
+import "./chunk-QCFOUQRH.mjs";
 import "./chunk-47VXJTWV.mjs";
-import "./chunk-UDLJWUFN.mjs";
+import "./chunk-5BK3VY6I.mjs";
 export {
   MikroMail
 };

package/lib/SMTPClient.js

@@ -62,7 +62,7 @@ function validateEmail(email) {
       return false;
     for (const part of domainParts) {
       if (!part || part.length > 63) return false;
-      if (!/^[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?$/.test(part)) return false;
+      if (!/^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(part)) return false;
     }
     return true;
   } catch (_error) {
@@ -93,7 +93,9 @@ var SMTPClient = class {
       clientName: config.clientName ?? import_node_os.default.hostname(),
       maxRetries: config.maxRetries ?? 3,
       retryDelay: config.retryDelay ?? 1e3,
-      skipAuthentication: config.skipAuthentication || false
+      skipAuthentication: config.skipAuthentication || false,
+      skipEmailValidation: config.skipEmailValidation || false,
+      skipMXRecordCheck: config.skipMXRecordCheck || false
     };
     this.socket = null;
     this.connected = false;
@@ -498,20 +500,24 @@ ${text || ""}`;
         error: "Missing required email parameters (from, to, subject, and either text or html)"
       };
     }
-    if (!validateEmail(from)) {
-      return {
-        success: false,
-        error: "Invalid email address format"
-      };
-    }
     const recipients = Array.isArray(options.to) ? options.to : [options.to];
-    for (const recipient of recipients) {
-      if (!validateEmail(recipient)) {
+    if (!this.config.skipEmailValidation) {
+      if (!validateEmail(from)) {
         return {
           success: false,
-          error: `Invalid recipient email address format: ${recipient}`
+          error: "Invalid email address format"
         };
       }
+      for (const recipient of recipients) {
+        if (!validateEmail(recipient)) {
+          return {
+            success: false,
+            error: `Invalid recipient email address format: ${recipient}`
+          };
+        }
+      }
+    } else {
+      this.log("Email validation skipped (testing mode)");
     }
     for (this.retryCount = 0; this.retryCount <= this.config.maxRetries; this.retryCount++) {
       try {

package/lib/SMTPClient.mjs

@@ -1,7 +1,7 @@
 import {
   SMTPClient
-} from "./chunk-NGT3KX7A.mjs";
-import "./chunk-UDLJWUFN.mjs";
+} from "./chunk-QCFOUQRH.mjs";
+import "./chunk-5BK3VY6I.mjs";
 export {
   SMTPClient
 };

package/lib/{chunk-UDLJWUFN.mjs → chunk-5BK3VY6I.mjs}

@@ -1,5 +1,5 @@
 // src/utils/index.ts
-import { promises as dnsPromises } from "node:dns";
+import { promises as dnsPromises } from "dns";
 function encodeQuotedPrintable(text) {
   let result = text.replace(/\r?\n/g, "\r\n");
   result = result.replace(/=/g, "=3D");
@@ -50,7 +50,7 @@ function validateEmail(email) {
       return false;
     for (const part of domainParts) {
       if (!part || part.length > 63) return false;
-      if (!/^[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?$/.test(part)) return false;
+      if (!/^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(part)) return false;
     }
     return true;
   } catch (_error) {

package/lib/{chunk-422R3NOG.mjs → chunk-IYCQK5YZ.mjs}

@@ -1,20 +1,22 @@
 import {
   Configuration
-} from "./chunk-YVXB6HCK.mjs";
+} from "./chunk-ULVDQIAT.mjs";
 import {
   SMTPClient
-} from "./chunk-NGT3KX7A.mjs";
+} from "./chunk-QCFOUQRH.mjs";
 import {
   verifyEmailDomain
-} from "./chunk-UDLJWUFN.mjs";
+} from "./chunk-5BK3VY6I.mjs";
 
 // src/MikroMail.ts
 var MikroMail = class {
   smtpClient;
+  config;
   constructor(options) {
     const config = new Configuration(options).get();
     const smtpClient = new SMTPClient(config);
     this.smtpClient = smtpClient;
+    this.config = config;
   }
   /**
    * Sends an email to valid domains.
@@ -22,12 +24,14 @@ var MikroMail = class {
   async send(emailOptions) {
     try {
       const recipients = Array.isArray(emailOptions.to) ? emailOptions.to : [emailOptions.to];
-      for (const recipient of recipients) {
-        const hasMXRecords = await verifyEmailDomain(recipient);
-        if (!hasMXRecords)
-          console.error(
-            `Warning: No MX records found for recipient domain: ${recipient}`
-          );
+      if (!this.config.skipMXRecordCheck) {
+        for (const recipient of recipients) {
+          const hasMXRecords = await verifyEmailDomain(recipient);
+          if (!hasMXRecords)
+            console.error(
+              `Warning: No MX records found for recipient domain: ${recipient}`
+            );
+        }
       }
       const result = await this.smtpClient.sendEmail(emailOptions);
       if (result.success) console.log(`Message ID: ${result.messageId}`);

package/lib/{chunk-NGT3KX7A.mjs → chunk-QCFOUQRH.mjs}

@@ -1,13 +1,13 @@
 import {
   validateEmail
-} from "./chunk-UDLJWUFN.mjs";
+} from "./chunk-5BK3VY6I.mjs";
 
 // src/SMTPClient.ts
-import { Buffer } from "node:buffer";
-import crypto from "node:crypto";
-import net from "node:net";
-import os from "node:os";
-import tls from "node:tls";
+import { Buffer } from "buffer";
+import crypto from "crypto";
+import net from "net";
+import os from "os";
+import tls from "tls";
 var SMTPClient = class {
   config;
   socket;
@@ -30,7 +30,9 @@ var SMTPClient = class {
       clientName: config.clientName ?? os.hostname(),
       maxRetries: config.maxRetries ?? 3,
       retryDelay: config.retryDelay ?? 1e3,
-      skipAuthentication: config.skipAuthentication || false
+      skipAuthentication: config.skipAuthentication || false,
+      skipEmailValidation: config.skipEmailValidation || false,
+      skipMXRecordCheck: config.skipMXRecordCheck || false
     };
     this.socket = null;
     this.connected = false;
@@ -435,20 +437,24 @@ ${text || ""}`;
         error: "Missing required email parameters (from, to, subject, and either text or html)"
       };
     }
-    if (!validateEmail(from)) {
-      return {
-        success: false,
-        error: "Invalid email address format"
-      };
-    }
     const recipients = Array.isArray(options.to) ? options.to : [options.to];
-    for (const recipient of recipients) {
-      if (!validateEmail(recipient)) {
+    if (!this.config.skipEmailValidation) {
+      if (!validateEmail(from)) {
         return {
           success: false,
-          error: `Invalid recipient email address format: ${recipient}`
+          error: "Invalid email address format"
         };
       }
+      for (const recipient of recipients) {
+        if (!validateEmail(recipient)) {
+          return {
+            success: false,
+            error: `Invalid recipient email address format: ${recipient}`
+          };
+        }
+      }
+    } else {
+      this.log("Email validation skipped (testing mode)");
     }
     for (this.retryCount = 0; this.retryCount <= this.config.maxRetries; this.retryCount++) {
       try {

package/lib/{chunk-YVXB6HCK.mjs → chunk-ULVDQIAT.mjs}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-47VXJTWV.mjs";
 
 // src/Configuration.ts
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync } from "fs";
 var Configuration = class {
   config;
   defaults = {
@@ -35,7 +35,9 @@ var Configuration = class {
       port: 465,
       secure: true,
       debug: false,
-      maxRetries: 2
+      maxRetries: 2,
+      skipEmailValidation: false,
+      skipMXRecordCheck: false
     };
     let fileConfig = {};
     if (existsSync(configFilePath)) {

package/lib/index.js

@@ -79,7 +79,9 @@ var Configuration = class {
       port: 465,
       secure: true,
       debug: false,
-      maxRetries: 2
+      maxRetries: 2,
+      skipEmailValidation: false,
+      skipMXRecordCheck: false
     };
     let fileConfig = {};
     if ((0, import_node_fs.existsSync)(configFilePath)) {
@@ -189,7 +191,7 @@ function validateEmail(email) {
       return false;
     for (const part of domainParts) {
       if (!part || part.length > 63) return false;
-      if (!/^[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?$/.test(part)) return false;
+      if (!/^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(part)) return false;
     }
     return true;
   } catch (_error) {
@@ -237,7 +239,9 @@ var SMTPClient = class {
       clientName: config.clientName ?? import_node_os.default.hostname(),
       maxRetries: config.maxRetries ?? 3,
       retryDelay: config.retryDelay ?? 1e3,
-      skipAuthentication: config.skipAuthentication || false
+      skipAuthentication: config.skipAuthentication || false,
+      skipEmailValidation: config.skipEmailValidation || false,
+      skipMXRecordCheck: config.skipMXRecordCheck || false
     };
     this.socket = null;
     this.connected = false;
@@ -642,20 +646,24 @@ ${text || ""}`;
         error: "Missing required email parameters (from, to, subject, and either text or html)"
       };
     }
-    if (!validateEmail(from)) {
-      return {
-        success: false,
-        error: "Invalid email address format"
-      };
-    }
     const recipients = Array.isArray(options.to) ? options.to : [options.to];
-    for (const recipient of recipients) {
-      if (!validateEmail(recipient)) {
+    if (!this.config.skipEmailValidation) {
+      if (!validateEmail(from)) {
         return {
           success: false,
-          error: `Invalid recipient email address format: ${recipient}`
+          error: "Invalid email address format"
         };
       }
+      for (const recipient of recipients) {
+        if (!validateEmail(recipient)) {
+          return {
+            success: false,
+            error: `Invalid recipient email address format: ${recipient}`
+          };
+        }
+      }
+    } else {
+      this.log("Email validation skipped (testing mode)");
     }
     for (this.retryCount = 0; this.retryCount <= this.config.maxRetries; this.retryCount++) {
       try {
@@ -754,10 +762,12 @@ ${text || ""}`;
 // src/MikroMail.ts
 var MikroMail = class {
   smtpClient;
+  config;
   constructor(options) {
     const config = new Configuration(options).get();
     const smtpClient = new SMTPClient(config);
     this.smtpClient = smtpClient;
+    this.config = config;
   }
   /**
    * Sends an email to valid domains.
@@ -765,12 +775,14 @@ var MikroMail = class {
   async send(emailOptions) {
     try {
       const recipients = Array.isArray(emailOptions.to) ? emailOptions.to : [emailOptions.to];
-      for (const recipient of recipients) {
-        const hasMXRecords = await verifyEmailDomain(recipient);
-        if (!hasMXRecords)
-          console.error(
-            `Warning: No MX records found for recipient domain: ${recipient}`
-          );
+      if (!this.config.skipMXRecordCheck) {
+        for (const recipient of recipients) {
+          const hasMXRecords = await verifyEmailDomain(recipient);
+          if (!hasMXRecords)
+            console.error(
+              `Warning: No MX records found for recipient domain: ${recipient}`
+            );
+        }
       }
       const result = await this.smtpClient.sendEmail(emailOptions);
       if (result.success) console.log(`Message ID: ${result.messageId}`);

package/lib/index.mjs

@@ -1,10 +1,10 @@
 import {
   MikroMail
-} from "./chunk-422R3NOG.mjs";
-import "./chunk-YVXB6HCK.mjs";
-import "./chunk-NGT3KX7A.mjs";
+} from "./chunk-IYCQK5YZ.mjs";
+import "./chunk-ULVDQIAT.mjs";
+import "./chunk-QCFOUQRH.mjs";
 import "./chunk-47VXJTWV.mjs";
-import "./chunk-UDLJWUFN.mjs";
+import "./chunk-5BK3VY6I.mjs";
 export {
   MikroMail
 };

package/lib/interfaces/index.d.mts

@@ -13,6 +13,8 @@ interface SMTPConfiguration {
     maxRetries?: number;
     retryDelay?: number;
     skipAuthentication?: boolean;
+    skipEmailValidation?: boolean;
+    skipMXRecordCheck?: boolean;
 }
 /**
  * Email sending options.

package/lib/interfaces/index.d.ts

@@ -13,6 +13,8 @@ interface SMTPConfiguration {
     maxRetries?: number;
     retryDelay?: number;
     skipAuthentication?: boolean;
+    skipEmailValidation?: boolean;
+    skipMXRecordCheck?: boolean;
 }
 /**
  * Email sending options.

package/lib/utils/index.js

@@ -77,7 +77,7 @@ function validateEmail(email) {
       return false;
     for (const part of domainParts) {
       if (!part || part.length > 63) return false;
-      if (!/^[a-zA-Z0-9]([a-zA-Z0-9\-]*[a-zA-Z0-9])?$/.test(part)) return false;
+      if (!/^[a-zA-Z0-9]([a-zA-Z0-9-]*[a-zA-Z0-9])?$/.test(part)) return false;
     }
     return true;
   } catch (_error) {

package/lib/utils/index.mjs

@@ -3,7 +3,7 @@ import {
   validateEmail,
   verifyEmailDomain,
   verifyMXRecords
-} from "../chunk-UDLJWUFN.mjs";
+} from "../chunk-5BK3VY6I.mjs";
 export {
   encodeQuotedPrintable,
   validateEmail,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mikromail",
   "description": "Lightweight replacement for Nodemailer, supporting HTML, international symbols, and more.",
-  "version": "0.0.7",
+  "version": "1.0.0",
   "author": "Mikael Vesavuori",
   "license": "MIT",
   "keywords": [
@@ -31,7 +31,6 @@
   ],
   "scripts": {
     "test": "npm run test:licenses && npm run test:types && npm run lint && npm run test:unit",
-    "test:data": "rm -rf test-db && npx tsx random-data.ts",
     "test:types": "npx type-coverage --at-least 95 --strict --ignore-files \"tests/**/*.ts\" --ignore-files \"*.ts\" --ignore-files \"src/errors/*.ts\" --ignore-files \"testdata/*.ts\"",
     "test:licenses": "npx license-compliance --direct --allow 'MIT;ISC;0BSD;BSD-2-Clause;BSD-3-Clause;Apache-2.0;Unlicense;CC0-1.0'",
     "test:unit": "npx vitest run --coverage",
@@ -45,9 +44,9 @@
     "prepare": "husky"
   },
   "devDependencies": {
-    "@biomejs/biome": "1",
+    "@biomejs/biome": "2",
     "@types/node": "latest",
-    "@vitest/coverage-v8": "2",
+    "@vitest/coverage-v8": "4",
     "husky": "9",
     "license-compliance": "latest",
     "tslib": "latest",
@@ -55,6 +54,6 @@
     "tsx": "latest",
     "type-coverage": "2",
     "typescript": "5",
-    "vitest": "2"
+    "vitest": "4"
   }
 }