@mailzeno/core 0.1.0 → 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MailZeno
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -100,14 +100,14 @@ async function retry(fn, attempts = 3) {
 
 // src/render/render-html.ts
 function renderHtml(html, text) {
-  const hasHtml = html && html.trim().length > 0;
-  const hasText = text && text.trim().length > 0;
-  if (!hasHtml && !hasText) {
+  const cleanHtml = html?.trim();
+  const cleanText = text?.trim();
+  if (!cleanHtml && !cleanText) {
     throw new Error("Email must contain html or text");
   }
   return {
-    html: hasHtml ? html : void 0,
-    text: hasText ? text : void 0
+    html: cleanHtml || void 0,
+    text: cleanText || void 0
   };
 }
 
@@ -171,83 +171,73 @@ async function renderReact(component) {
 
 // src/smtp/send.ts
 async function sendEmail(smtp, options) {
+  validateOptions(options);
+  const { html, text } = await resolveContent(options);
+  const transporter = getTransporter(smtp);
   try {
-    if (!options.from || !options.to || !options.subject) {
-      throw new ValidationError(
-        "Missing required fields: from, to, subject"
-      );
-    }
-    let html = options.html;
-    let text = options.text;
-    if (options.react) {
-      try {
-        const rendered2 = await renderReact(options.react);
-        html = rendered2.html;
-      } catch (err) {
-        throw new RenderError("React email rendering failed", err);
-      }
-    }
-    const rendered = renderHtml(html, text);
-    const transporter = getTransporter(smtp);
     const info = await retry(
       () => transporter.sendMail({
         from: options.from,
         to: options.to,
         subject: options.subject,
-        html: rendered.html,
-        text: rendered.text
+        html: html || void 0,
+        text: text || void 0
       })
     );
     return {
-      success: true,
       messageId: info.messageId,
       accepted: info.accepted,
       rejected: info.rejected,
       response: info.response
     };
   } catch (err) {
-    if (err instanceof MailZenoError) {
-      return {
-        success: false,
-        error: err.message
-      };
-    }
-    if (err?.code === "EAUTH") {
-      return {
-        success: false,
-        error: new SMTPAuthError(
-          "SMTP authentication failed",
-          err
-        ).message
-      };
-    }
-    if (err?.code === "ETIMEDOUT") {
-      return {
-        success: false,
-        error: new SMTPTimeoutError(
-          "SMTP connection timed out",
-          err
-        ).message
-      };
+    throw mapSMTPError(err);
+  }
+}
+function validateOptions(options) {
+  if (!options.from?.trim()) {
+    throw new ValidationError("Invalid 'from' address");
+  }
+  if (!options.subject?.trim()) {
+    throw new ValidationError("Subject is required");
+  }
+  if (!options.to || Array.isArray(options.to) && options.to.length === 0) {
+    throw new ValidationError("Invalid 'to' address");
+  }
+}
+async function resolveContent(options) {
+  switch (options.type) {
+    case "react": {
+      try {
+        const rendered = await renderReact(options.react);
+        return renderHtml(rendered.html);
+      } catch (err) {
+        throw new RenderError("React email rendering failed", err);
+      }
     }
-    if (err?.code === "ECONNECTION") {
-      return {
-        success: false,
-        error: new SMTPConnectionError(
-          "SMTP connection failed",
-          err
-        ).message
-      };
+    case "raw": {
+      return renderHtml(options.html, options.text);
     }
-    return {
-      success: false,
-      error: new SMTPResponseError(
-        err?.message || "SMTP sending failed",
-        err
-      ).message
-    };
   }
 }
+function mapSMTPError(err) {
+  if (err instanceof MailZenoError) {
+    return err;
+  }
+  if (err?.code === "EAUTH") {
+    return new SMTPAuthError("SMTP authentication failed", err);
+  }
+  if (err?.code === "ETIMEDOUT") {
+    return new SMTPTimeoutError("SMTP connection timed out", err);
+  }
+  if (err?.code === "ECONNECTION") {
+    return new SMTPConnectionError("SMTP connection failed", err);
+  }
+  if (err?.responseCode) {
+    return new SMTPResponseError(`SMTP error ${err.responseCode}`, err);
+  }
+  return new SMTPResponseError(err?.message || "SMTP sending failed", err);
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   sendEmail

package/dist/index.d.cts

@@ -1,3 +1,8 @@
+import React from 'react';
+
+/**
+ * SMTP configuration (engine-level only)
+ */
 interface SMTPConfig {
     id: string;
     host: string;
@@ -11,23 +16,44 @@ interface SMTPConfig {
     maxConnections?: number;
     maxMessages?: number;
 }
-interface SendEmailOptions {
+/**
+ * Raw HTML email content
+ */
+type RawContent = {
+    type: "raw";
+    html?: string;
+    text?: string;
+};
+/**
+ * React email content
+ */
+type ReactContent = {
+    type: "react";
+    react: React.ReactElement;
+};
+/**
+ * Strict email options
+ */
+type SendEmailOptions = {
     from: string;
     to: string | string[];
     subject: string;
-    html?: string;
-    text?: string;
-    react?: React.ReactElement;
-}
+} & (RawContent | ReactContent);
+/**
+ * Engine success response
+ * Throws on failure
+ */
 interface SendEmailResponse {
-    success: boolean;
-    messageId?: string;
-    accepted?: string[];
-    rejected?: string[];
-    response?: string;
-    error?: string;
+    messageId: string;
+    accepted: string[];
+    rejected: string[];
+    response: string;
 }
 
+/**
+ * Core email sending engine
+ * Throws errors on failure
+ */
 declare function sendEmail(smtp: SMTPConfig, options: SendEmailOptions): Promise<SendEmailResponse>;
 
 export { type SMTPConfig, type SendEmailOptions, type SendEmailResponse, sendEmail };

package/dist/index.d.ts

@@ -1,3 +1,8 @@
+import React from 'react';
+
+/**
+ * SMTP configuration (engine-level only)
+ */
 interface SMTPConfig {
     id: string;
     host: string;
@@ -11,23 +16,44 @@ interface SMTPConfig {
     maxConnections?: number;
     maxMessages?: number;
 }
-interface SendEmailOptions {
+/**
+ * Raw HTML email content
+ */
+type RawContent = {
+    type: "raw";
+    html?: string;
+    text?: string;
+};
+/**
+ * React email content
+ */
+type ReactContent = {
+    type: "react";
+    react: React.ReactElement;
+};
+/**
+ * Strict email options
+ */
+type SendEmailOptions = {
     from: string;
     to: string | string[];
     subject: string;
-    html?: string;
-    text?: string;
-    react?: React.ReactElement;
-}
+} & (RawContent | ReactContent);
+/**
+ * Engine success response
+ * Throws on failure
+ */
 interface SendEmailResponse {
-    success: boolean;
-    messageId?: string;
-    accepted?: string[];
-    rejected?: string[];
-    response?: string;
-    error?: string;
+    messageId: string;
+    accepted: string[];
+    rejected: string[];
+    response: string;
 }
 
+/**
+ * Core email sending engine
+ * Throws errors on failure
+ */
 declare function sendEmail(smtp: SMTPConfig, options: SendEmailOptions): Promise<SendEmailResponse>;
 
 export { type SMTPConfig, type SendEmailOptions, type SendEmailResponse, sendEmail };

package/dist/index.js

@@ -64,14 +64,14 @@ async function retry(fn, attempts = 3) {
 
 // src/render/render-html.ts
 function renderHtml(html, text) {
-  const hasHtml = html && html.trim().length > 0;
-  const hasText = text && text.trim().length > 0;
-  if (!hasHtml && !hasText) {
+  const cleanHtml = html?.trim();
+  const cleanText = text?.trim();
+  if (!cleanHtml && !cleanText) {
     throw new Error("Email must contain html or text");
   }
   return {
-    html: hasHtml ? html : void 0,
-    text: hasText ? text : void 0
+    html: cleanHtml || void 0,
+    text: cleanText || void 0
   };
 }
 
@@ -135,83 +135,73 @@ async function renderReact(component) {
 
 // src/smtp/send.ts
 async function sendEmail(smtp, options) {
+  validateOptions(options);
+  const { html, text } = await resolveContent(options);
+  const transporter = getTransporter(smtp);
   try {
-    if (!options.from || !options.to || !options.subject) {
-      throw new ValidationError(
-        "Missing required fields: from, to, subject"
-      );
-    }
-    let html = options.html;
-    let text = options.text;
-    if (options.react) {
-      try {
-        const rendered2 = await renderReact(options.react);
-        html = rendered2.html;
-      } catch (err) {
-        throw new RenderError("React email rendering failed", err);
-      }
-    }
-    const rendered = renderHtml(html, text);
-    const transporter = getTransporter(smtp);
     const info = await retry(
       () => transporter.sendMail({
         from: options.from,
         to: options.to,
         subject: options.subject,
-        html: rendered.html,
-        text: rendered.text
+        html: html || void 0,
+        text: text || void 0
       })
     );
     return {
-      success: true,
       messageId: info.messageId,
       accepted: info.accepted,
       rejected: info.rejected,
       response: info.response
     };
   } catch (err) {
-    if (err instanceof MailZenoError) {
-      return {
-        success: false,
-        error: err.message
-      };
-    }
-    if (err?.code === "EAUTH") {
-      return {
-        success: false,
-        error: new SMTPAuthError(
-          "SMTP authentication failed",
-          err
-        ).message
-      };
-    }
-    if (err?.code === "ETIMEDOUT") {
-      return {
-        success: false,
-        error: new SMTPTimeoutError(
-          "SMTP connection timed out",
-          err
-        ).message
-      };
+    throw mapSMTPError(err);
+  }
+}
+function validateOptions(options) {
+  if (!options.from?.trim()) {
+    throw new ValidationError("Invalid 'from' address");
+  }
+  if (!options.subject?.trim()) {
+    throw new ValidationError("Subject is required");
+  }
+  if (!options.to || Array.isArray(options.to) && options.to.length === 0) {
+    throw new ValidationError("Invalid 'to' address");
+  }
+}
+async function resolveContent(options) {
+  switch (options.type) {
+    case "react": {
+      try {
+        const rendered = await renderReact(options.react);
+        return renderHtml(rendered.html);
+      } catch (err) {
+        throw new RenderError("React email rendering failed", err);
+      }
     }
-    if (err?.code === "ECONNECTION") {
-      return {
-        success: false,
-        error: new SMTPConnectionError(
-          "SMTP connection failed",
-          err
-        ).message
-      };
+    case "raw": {
+      return renderHtml(options.html, options.text);
     }
-    return {
-      success: false,
-      error: new SMTPResponseError(
-        err?.message || "SMTP sending failed",
-        err
-      ).message
-    };
   }
 }
+function mapSMTPError(err) {
+  if (err instanceof MailZenoError) {
+    return err;
+  }
+  if (err?.code === "EAUTH") {
+    return new SMTPAuthError("SMTP authentication failed", err);
+  }
+  if (err?.code === "ETIMEDOUT") {
+    return new SMTPTimeoutError("SMTP connection timed out", err);
+  }
+  if (err?.code === "ECONNECTION") {
+    return new SMTPConnectionError("SMTP connection failed", err);
+  }
+  if (err?.responseCode) {
+    return new SMTPResponseError(`SMTP error ${err.responseCode}`, err);
+  }
+  return new SMTPResponseError(err?.message || "SMTP sending failed", err);
+}
 export {
   sendEmail
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailzeno/core",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "SMTP engine for MailZeno",
   "license": "MIT",
   "type": "module",
@@ -10,8 +10,7 @@
   "exports": {
     ".": {
       "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "types": "./dist/index.d.ts"
+      "require": "./dist/index.cjs"
     }
   },
   "files": [