mikromail 0.0.1

package/lib/index.mjs

@@ -0,0 +1,10 @@
+import {
+  MikroMail
+} from "./chunk-XNGASLEZ.mjs";
+import "./chunk-V2NYOKWA.mjs";
+import "./chunk-TCYL3UFZ.mjs";
+import "./chunk-47VXJTWV.mjs";
+import "./chunk-UDLJWUFN.mjs";
+export {
+  MikroMail
+};

package/lib/interfaces/index.d.mts

@@ -0,0 +1,60 @@
+/**
+ * Configuration options for SMTP client.
+ */
+interface SMTPConfiguration {
+    user: string;
+    password: string;
+    host: string;
+    port?: number;
+    secure?: boolean;
+    timeout?: number;
+    debug?: boolean;
+    clientName?: string;
+    maxRetries?: number;
+    retryDelay?: number;
+    skipAuthentication?: boolean;
+}
+/**
+ * Email sending options.
+ */
+interface EmailOptions {
+    from?: string;
+    to: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    replyTo?: string;
+    subject: string;
+    text?: string;
+    html?: string;
+    attachments?: Attachment[];
+    headers?: Record<string, string>;
+}
+/**
+ * Email attachment definition.
+ */
+interface Attachment {
+    filename: string;
+    content: string | Buffer;
+    contentType?: string;
+    encoding?: 'base64' | 'hex' | 'binary';
+}
+/**
+ * Result of email sending operation.
+ */
+interface SendResult {
+    success: boolean;
+    messageId?: string;
+    message?: string;
+    error?: string;
+}
+/**
+ * Supported authentication methods.
+ */
+type AuthMethod = 'PLAIN' | 'LOGIN' | 'CRAM-MD5';
+type ConfigurationOptions = {
+    config?: SMTPConfiguration;
+    configFilePath?: string;
+    args?: string[];
+};
+
+export type { Attachment, AuthMethod, ConfigurationOptions, EmailOptions, SMTPConfiguration, SendResult };

package/lib/interfaces/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Configuration options for SMTP client.
+ */
+interface SMTPConfiguration {
+    user: string;
+    password: string;
+    host: string;
+    port?: number;
+    secure?: boolean;
+    timeout?: number;
+    debug?: boolean;
+    clientName?: string;
+    maxRetries?: number;
+    retryDelay?: number;
+    skipAuthentication?: boolean;
+}
+/**
+ * Email sending options.
+ */
+interface EmailOptions {
+    from?: string;
+    to: string;
+    cc?: string | string[];
+    bcc?: string | string[];
+    replyTo?: string;
+    subject: string;
+    text?: string;
+    html?: string;
+    attachments?: Attachment[];
+    headers?: Record<string, string>;
+}
+/**
+ * Email attachment definition.
+ */
+interface Attachment {
+    filename: string;
+    content: string | Buffer;
+    contentType?: string;
+    encoding?: 'base64' | 'hex' | 'binary';
+}
+/**
+ * Result of email sending operation.
+ */
+interface SendResult {
+    success: boolean;
+    messageId?: string;
+    message?: string;
+    error?: string;
+}
+/**
+ * Supported authentication methods.
+ */
+type AuthMethod = 'PLAIN' | 'LOGIN' | 'CRAM-MD5';
+type ConfigurationOptions = {
+    config?: SMTPConfiguration;
+    configFilePath?: string;
+    args?: string[];
+};
+
+export type { Attachment, AuthMethod, ConfigurationOptions, EmailOptions, SMTPConfiguration, SendResult };

package/lib/interfaces/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/interfaces/index.ts
+var interfaces_exports = {};
+module.exports = __toCommonJS(interfaces_exports);

package/lib/utils/index.d.mts

@@ -0,0 +1,19 @@
+/**
+ * Encode text using quoted-printable encoding
+ * Follows RFC 2045 specification for MIME encoding
+ */
+declare function encodeQuotedPrintable(text: string): string;
+/**
+ * Validates an email address using stricter rules
+ */
+declare function validateEmail(email: string): boolean;
+/**
+ * Helper function to verify SMTP server MX records
+ */
+declare function verifyMXRecords(domain: string): Promise<boolean>;
+/**
+ * Helper function to verify email domain has proper MX records
+ */
+declare function verifyEmailDomain(email: string): Promise<boolean>;
+
+export { encodeQuotedPrintable, validateEmail, verifyEmailDomain, verifyMXRecords };

package/lib/utils/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Encode text using quoted-printable encoding
+ * Follows RFC 2045 specification for MIME encoding
+ */
+declare function encodeQuotedPrintable(text: string): string;
+/**
+ * Validates an email address using stricter rules
+ */
+declare function validateEmail(email: string): boolean;
+/**
+ * Helper function to verify SMTP server MX records
+ */
+declare function verifyMXRecords(domain: string): Promise<boolean>;
+/**
+ * Helper function to verify email domain has proper MX records
+ */
+declare function verifyEmailDomain(email: string): Promise<boolean>;
+
+export { encodeQuotedPrintable, validateEmail, verifyEmailDomain, verifyMXRecords };

package/lib/utils/index.js

@@ -0,0 +1,110 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/utils/index.ts
+var utils_exports = {};
+__export(utils_exports, {
+  encodeQuotedPrintable: () => encodeQuotedPrintable,
+  validateEmail: () => validateEmail,
+  verifyEmailDomain: () => verifyEmailDomain,
+  verifyMXRecords: () => verifyMXRecords
+});
+module.exports = __toCommonJS(utils_exports);
+var import_node_dns = require("dns");
+function encodeQuotedPrintable(text) {
+  let result = text.replace(/\r?\n/g, "\r\n");
+  result = result.replace(/=/g, "=3D");
+  const utf8Bytes = new TextEncoder().encode(result);
+  let encoded = "";
+  let lineLength = 0;
+  for (let i = 0; i < utf8Bytes.length; i++) {
+    const byte = utf8Bytes[i];
+    let chunk = "";
+    if (byte >= 33 && byte <= 126 && byte !== 61 || byte === 32) {
+      chunk = String.fromCharCode(byte);
+    } else if (byte === 13 || byte === 10) {
+      chunk = String.fromCharCode(byte);
+      if (byte === 10) {
+        lineLength = 0;
+      }
+    } else {
+      const hex = byte.toString(16).toUpperCase();
+      chunk = `=${hex.length < 2 ? `0${hex}` : hex}`;
+    }
+    if (lineLength + chunk.length > 75 && !(byte === 13 || byte === 10)) {
+      encoded += "=\r\n";
+      lineLength = 0;
+    }
+    encoded += chunk;
+    lineLength += chunk.length;
+  }
+  return encoded;
+}
+function validateEmail(email) {
+  try {
+    const [localPart, domain] = email.split("@");
+    if (!localPart || localPart.length > 64) return false;
+    if (localPart.startsWith(".") || localPart.endsWith(".") || localPart.includes(".."))
+      return false;
+    if (!/^[a-zA-Z0-9!#$%&'*+\-/=?^_`{|}~.]+$/.test(localPart)) return false;
+    if (!domain || domain.length > 255) return false;
+    if (domain.startsWith("[") && domain.endsWith("]")) {
+      const ipContent = domain.slice(1, -1);
+      if (ipContent.startsWith("IPv6:")) return true;
+      const ipv4Regex = /^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$/;
+      return ipv4Regex.test(ipContent);
+    }
+    if (domain.startsWith(".") || domain.endsWith(".") || domain.includes(".."))
+      return false;
+    const domainParts = domain.split(".");
+    if (domainParts.length < 2 || domainParts[domainParts.length - 1].length < 2)
+      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;
+    }
+    return true;
+  } catch (_error) {
+    return false;
+  }
+}
+async function verifyMXRecords(domain) {
+  try {
+    const records = await import_node_dns.promises.resolveMx(domain);
+    return !!records && records.length > 0;
+  } catch (_error) {
+    return false;
+  }
+}
+async function verifyEmailDomain(email) {
+  try {
+    const domain = email.split("@")[1];
+    if (!domain) return false;
+    return await verifyMXRecords(domain);
+  } catch (_error) {
+    return false;
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  encodeQuotedPrintable,
+  validateEmail,
+  verifyEmailDomain,
+  verifyMXRecords
+});

package/lib/utils/index.mjs

@@ -0,0 +1,12 @@
+import {
+  encodeQuotedPrintable,
+  validateEmail,
+  verifyEmailDomain,
+  verifyMXRecords
+} from "../chunk-UDLJWUFN.mjs";
+export {
+  encodeQuotedPrintable,
+  validateEmail,
+  verifyEmailDomain,
+  verifyMXRecords
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "mikromail",
+  "description": "Lightweight replacement for Nodemailer, supporting HTML, international symbols, and more.",
+  "version": "0.0.1",
+  "author": "Mikael Vesavuori",
+  "license": "MIT",
+  "keywords": [],
+  "main": "lib/index.js",
+  "module": "lib/index.mjs",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mikaelvesavuori/mikromail"
+  },
+  "bugs": {
+    "url": "https://github.com/mikaelvesavuori/mikromail/issues"
+  },
+  "homepage": "https://github.com/mikaelvesavuori/mikromail",
+  "exports": {
+    ".": {
+      "require": "./lib/index.js",
+      "import": "./lib/index.mjs"
+    }
+  },
+  "files": [
+    "/lib",
+    "!/lib/**/*.map",
+    "!/tests"
+  ],
+  "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",
+    "test:watch": "npx vitest --watch",
+    "build": "npm run clean && npm run build:tsup",
+    "build:tsup": "npm run clean && tsup src --format esm,cjs --dts && mv dist lib",
+    "clean": "rm -rf lib && rm -rf dist",
+    "lint": "npx @biomejs/biome check --write ./src ./tests",
+    "package": "npm pack",
+    "prepublishOnly": "npm run build"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "1",
+    "@types/node": "latest",
+    "@vitest/coverage-v8": "2",
+    "husky": "9",
+    "license-compliance": "latest",
+    "tslib": "latest",
+    "tsup": "8",
+    "tsx": "latest",
+    "type-coverage": "2",
+    "typescript": "5",
+    "vitest": "2"
+  }
+}