@rosepetal/node-red-contrib-utils 1.1.3 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rosepetal/node-red-contrib-utils",
-  "version": "1.1.3",
+  "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"