@rosepetal/node-red-contrib-utils 1.1.2 → 1.1.4

package/nodes/io/save-file.html

@@ -14,6 +14,9 @@
             imageFormat: { value: "jpg" },
             imageQuality: { value: 90 },
             pngOptimize: { value: false },
+            webpLossless: { value: false },
+            webpSmartSubsample: { value: false },
+            webpEffort: { value: 4 },
             jsonIndent: { value: 2 },
             overwriteProtection: { value: "true" },
             outputPath: { value: "savedFile" },
@@ -63,6 +66,7 @@
             const imageFields = $(".savefile-image-options");
             const jsonFields = $(".savefile-json-options");
             const pngOnlyFields = $(".savefile-png-only");
+            const webpOnlyFields = $(".savefile-webp-only");
             const qualityFields = $(".savefile-quality");
             const imageSeparators = $(".savefile-image-separator");
             const jsonSeparators = $(".savefile-json-separator");
@@ -80,6 +84,7 @@
                 const fmt = imageFormatField.val();
                 const showImage = fileTypeField.val() === 'image' || fileTypeField.val() === 'auto';
                 pngOnlyFields.toggle(showImage && fmt === 'png');
+                webpOnlyFields.toggle(showImage && fmt === 'webp');
                 qualityFields.toggle(showImage && fmt !== 'png');
             }
 
@@ -169,6 +174,21 @@
             <input type="checkbox" id="node-input-pngOptimize" style="margin-right: 5px;"> Optimize PNG
         </label>
     </div>
+    <div class="form-row savefile-image-options savefile-webp-only">
+        <label for="node-input-webpLossless"><i class="fa fa-lock"></i> WebP Lossless</label>
+        <input type="checkbox" id="node-input-webpLossless" style="display:inline-block; width:auto; vertical-align:baseline;">
+        <label for="node-input-webpLossless" style="width:auto; margin-left:5px;">Encode WebP without loss</label>
+    </div>
+    <div class="form-row savefile-image-options savefile-webp-only">
+        <label for="node-input-webpSmartSubsample"><i class="fa fa-magic"></i> WebP Smart Subsample</label>
+        <input type="checkbox" id="node-input-webpSmartSubsample" style="display:inline-block; width:auto; vertical-align:baseline;">
+        <label for="node-input-webpSmartSubsample" style="width:auto; margin-left:5px;">Improve chroma downsampling (lossy WebP only)</label>
+    </div>
+    <div class="form-row savefile-image-options savefile-webp-only">
+        <label for="node-input-webpEffort"><i class="fa fa-tachometer"></i> WebP Effort</label>
+        <input type="number" id="node-input-webpEffort" min="0" max="6" placeholder="4" style="width: 70px;">
+        <span style="margin-left: 10px; color: #666;">0-6 (higher = smaller file, slower)</span>
+    </div>
     <div class="form-row savefile-image-options savefile-separator savefile-image-separator">
         <hr>
     </div>
@@ -225,6 +245,8 @@
         <dd>Force saving as image, JSON, text, or binary, or let the node auto-detect from data/extension.</dd>
         <dt>Image Format / Quality / Optimize PNG <span class="property-type">enum/number/bool</span></dt>
         <dd>Applies when saving images. Raw image objects are validated and encoded with Sharp.</dd>
+        <dt>WebP Lossless / Smart Subsample / Effort <span class="property-type">bool/bool/number</span></dt>
+        <dd>WebP-specific encoding options. <b>Lossless</b> encodes without quality loss. <b>Smart Subsample</b> improves chroma downsampling for lossy WebP. <b>Effort</b> (0-6) controls the compression effort trade-off; higher values produce smaller files but encode more slowly.</dd>
         <dt>JSON Indent <span class="property-type">number</span></dt>
         <dd>Spacing for pretty-printed JSON output.</dd>
         <dt>Overwrite <span class="property-type">enum</span></dt>

package/nodes/io/save-file.js

@@ -136,6 +136,10 @@ module.exports = function (RED) {
         // Prepare data to write
         const quality = parseInt(config.imageQuality, 10) || 90;
         const pngOptimize = config.pngOptimize === true || config.pngOptimize === 'true';
+        const webpLossless = config.webpLossless === true || config.webpLossless === 'true';
+        const webpSmartSubsample = config.webpSmartSubsample === true || config.webpSmartSubsample === 'true';
+        const webpEffort = parseInt(config.webpEffort, 10);
+        const webpOptions = { lossless: webpLossless, smartSubsample: webpSmartSubsample, effort: webpEffort };
         const jsonIndent = Number.isInteger(parseInt(config.jsonIndent, 10))
           ? parseInt(config.jsonIndent, 10)
           : 2;
@@ -144,7 +148,7 @@ module.exports = function (RED) {
         let isText = false;
 
         if (fileType === 'image') {
-          payloadToWrite = await toImageBuffer(incoming, imageFormat, quality, pngOptimize, NodeUtils, node);
+          payloadToWrite = await toImageBuffer(incoming, imageFormat, quality, pngOptimize, webpOptions, NodeUtils, node);
         } else if (fileType === 'json') {
           if (typeof incoming === 'string') {
             try {
@@ -341,7 +345,7 @@ async function toBinary(value) {
   return Buffer.from(JSON.stringify(value ?? ''), 'utf8');
 }
 
-async function toImageBuffer(imageValue, format, quality, pngOptimize, NodeUtils, node) {
+async function toImageBuffer(imageValue, format, quality, pngOptimize, webpOptions, NodeUtils, node) {
   // Encoded buffer path
   if (Buffer.isBuffer(imageValue) && !(imageValue.width && imageValue.height)) {
     let inputFormat;
@@ -357,7 +361,7 @@ async function toImageBuffer(imageValue, format, quality, pngOptimize, NodeUtils
     }
 
     const sharpInstance = sharp(imageValue);
-    return encodeSharp(sharpInstance, format, quality, pngOptimize);
+    return encodeSharp(sharpInstance, format, quality, pngOptimize, webpOptions);
   }
 
   // Raw image path (uses validator for clear errors)
@@ -391,10 +395,10 @@ async function toImageBuffer(imageValue, format, quality, pngOptimize, NodeUtils
     sharpInstance = sharpInstance.toColourspace('b-w');
   }
 
-  return encodeSharp(sharpInstance, format, quality, pngOptimize);
+  return encodeSharp(sharpInstance, format, quality, pngOptimize, webpOptions);
 }
 
-function encodeSharp(sharpInstance, format, quality, pngOptimize) {
+function encodeSharp(sharpInstance, format, quality, pngOptimize, webpOptions) {
   if (format === 'png') {
     const pngOptions = pngOptimize
       ? { compressionLevel: 9, palette: true }
@@ -402,7 +406,15 @@ function encodeSharp(sharpInstance, format, quality, pngOptimize) {
     return sharpInstance.png(pngOptions).toBuffer();
   }
   if (format === 'webp') {
-    return sharpInstance.webp({ quality }).toBuffer();
+    const opts = { quality };
+    if (webpOptions) {
+      if (webpOptions.lossless) opts.lossless = true;
+      if (webpOptions.smartSubsample) opts.smartSubsample = true;
+      if (typeof webpOptions.effort === 'number' && webpOptions.effort >= 0 && webpOptions.effort <= 6) {
+        opts.effort = webpOptions.effort;
+      }
+    }
+    return sharpInstance.webp(opts).toBuffer();
   }
   return sharpInstance.jpeg({ quality }).toBuffer();
 }

package/nodes/util/clean-debug.js

@@ -102,8 +102,7 @@ module.exports = function registerCleanDebugNode(RED) {
         return;
       }
 
-      const format = detectValueType(value);
-      const debugMessage = {
+      var debugMessage = {
         id: node.id,
         z: node.z,
         _alias: node._alias,
@@ -112,13 +111,45 @@ module.exports = function registerCleanDebugNode(RED) {
         property: node.targetType === "full" ? "msg" : node.complete,
         propertyType: node.targetType,
         clean: node.clean,
-        format,
         msg: value,
         _msgid: msg && msg._msgid
       };
 
+      encodeDebugValue(debugMessage);
+
       RED.comms.publish("debug", debugMessage);
     }
+
+    /**
+     * Encode debugMsg.msg and set debugMsg.format in-place so the value
+     * matches the format expected by Node-RED's debug-utils.js in the editor.
+     * RED.util.encodeObject expects the whole debug message object — it reads
+     * from debugMsg.msg and sets debugMsg.msg + debugMsg.format in-place.
+     * @param {object} debugMsg
+     */
+    function encodeDebugValue(debugMsg) {
+      var value = debugMsg.msg;
+      if (value === null || typeof value === "undefined") {
+        debugMsg.format = (value === null) ? "null" : "undefined";
+        debugMsg.msg = (value === null) ? "null" : "(undefined)";
+      } else if (typeof value === "object") {
+        try {
+          RED.util.encodeObject(debugMsg, { maxLength: DEFAULT_DEBUG_MAX_LENGTH });
+        } catch (_e) {
+          debugMsg.format = "error";
+          debugMsg.msg = "Failed to encode debug value";
+        }
+      } else if (typeof value === "boolean") {
+        debugMsg.format = "boolean";
+        debugMsg.msg = value.toString();
+      } else if (typeof value === "number") {
+        debugMsg.format = "number";
+        debugMsg.msg = value.toString();
+      } else {
+        debugMsg.format = "string[" + ("" + value).length + "]";
+        debugMsg.msg = "" + value;
+      }
+    }
   }
 
   /**
@@ -330,30 +361,6 @@ module.exports = function registerCleanDebugNode(RED) {
     return `[${type} withheld: ${detail}]`;
   }
 
-  /**
-   * Detect broad value type to help the editor render icons.
-   * @param {*} value
-   */
-  function detectValueType(value) {
-    if (value === null) {
-      return "null";
-    }
-    if (value && typeof value === "object" && value.type === "Buffer" && Array.isArray(value.data)) {
-      return "buffer";
-    }
-    const t = typeof value;
-    if (t === "string" || t === "number" || t === "boolean" || t === "bigint") {
-      return t;
-    }
-    if (Array.isArray(value)) {
-      return "array";
-    }
-    if (value instanceof Date) {
-      return "date";
-    }
-    return "object";
-  }
-
   /**
    * Format for console/log output.
    * @param {*} value

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rosepetal/node-red-contrib-utils",
-  "version": "1.1.2",
+  "version": "1.1.4",
   "description": "Utility and I/O nodes for Node-RED, including array helpers and file saving.",
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1"