@5minds/node-red-contrib-processcube-tools 1.0.1-feature-122227-mfgey2et → 1.0.1-feature-24a79f-mfgha47l

package/email-sender/email-sender.html

@@ -40,7 +40,7 @@
         outputs: 1,
         icon: "font-awesome/fa-paper-plane",
         label: function() {
-            return this.name || "Email Sender";
+            return this.name || "E-Mail Sender";
         },
         oneditprepare: function() {
             // Mail Fields
@@ -232,7 +232,6 @@
 
         <dt>Attachments <span class="property-type">array | variable</span></dt>
         <dd>A list of file attachments. This should be a variable containing an array of attachment objects.</dd>
-
     </dl>
 
     <h4>SMTP Configuration</h4>
@@ -255,4 +254,13 @@
         <dt>Reject Unauthorized <span class="property-type">boolean | variable</span></dt>
         <dd>If <code>true</code>, the server's certificate is rejected if it's not authorized by a trusted CA.</dd>
     </dl>
+
+    <h3>Usage</h3>
+    <p>Inject a message to trigger the node and send an email.<br>
+    Credentials and other properties can be provided via message properties, flow/global context, or environment variables.<br>
+    The node supports sending HTML emails and attachments.</p>
+
+    <h3>Tips</h3>
+    <p><b>HTML Content Creation:</b><br>
+    To generate or format HTML content for your email, you can use a <b>template node</b> before the email-sender node. This allows you to create dynamic and customized email bodies.</p>
 </script>

package/email-sender/email-sender.js

@@ -18,7 +18,7 @@ module.exports = function(RED) {
             const bcc = RED.util.evaluateNodeProperty(config.bcc, config.bccType, node, msg) || "";
             const subject = RED.util.evaluateNodeProperty(config.subject, config.subjectType, node, msg) || msg.topic || "Message from Node-RED";
             const htmlContent = RED.util.evaluateNodeProperty(config.htmlContent, config.htmlContentType, node, msg);
-            const attachments = RED.util.evaluateNodeProperty(config.attachments, config.attachmentsType, node, msg);
+            const attachments = safeEvaluatePropertyAttachment(config, node, msg);
 
             // Retrieve and evaluate SMTP configuration values
             const host = RED.util.evaluateNodeProperty(config.host, config.hostType, node, msg);
@@ -83,7 +83,20 @@ module.exports = function(RED) {
             transporter.sendMail(mailOptions, (error, info) => {
                 if (error) {
                     node.status({ fill: "red", shape: "dot", text: "error sending" });
-                    done(error);
+                    if (
+                        error.message &&
+                        error.message.includes("SSL routines") &&
+                        error.message.includes("wrong version number")
+                    ) {
+                        // Improved error message for SSL/TLS issues
+                        done(new Error(
+                            "SSL/TLS connection failed: Wrong version number. " +
+                            "This usually means the wrong port or security settings are used. " +
+                            "For SMTP: use port 587 with secure=false (STARTTLS) or port 465 with secure=true (SSL/TLS)."
+                        ));
+                    } else {
+                        done(error);
+                    }
                 } else {
                     node.log('Email sent: ' + info.response);
                     msg.payload = info;
@@ -111,4 +124,17 @@ module.exports = function(RED) {
     }
 
     RED.nodes.registerType("email-sender", EmailSenderNode);
+
+    function safeEvaluatePropertyAttachment(config, node, msg) {
+        if (config.attachments && config.attachments.trim() !== '') {
+            try {
+                return RED.util.evaluateNodeProperty(config.attachments, config.attachmentsType, node, msg);
+            } catch (e) {
+                node.error("Failed to evaluate attachments property: " + e.message, msg);
+                return null;
+            }
+        }
+
+        return null;
+    }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@5minds/node-red-contrib-processcube-tools",
-    "version": "1.0.1-feature-122227-mfgey2et",
+    "version": "1.0.1-feature-24a79f-mfgha47l",
     "license": "MIT",
     "description": "Node-RED tools nodes for ProcessCube",
     "scripts": {