@inteli.city/node-red-contrib-http-plus 1.0.0 → 1.0.1

package/httpin+.html

@@ -80,6 +80,17 @@
     <p><b>Cognito JWT:</b> validates a Bearer token against a JWKS endpoint. Enable <b>"Expose user to flow"</b> in the config node to populate <code>msg.user</code> with mapped JWT claims. When disabled, no JWT data enters the flow.</p>
     <p>After successful authentication, <code>Authorization</code> headers and <code>?token=</code> query parameters are always removed before the message is dispatched.</p>
 
+    <h3>Backend Cache</h3>
+    <p>Enable <b>Enable backend cache</b> to cache GET responses on the server. Repeated identical requests skip the flow entirely and return the cached response.</p>
+    <ul>
+        <li>Only active for GET requests with no authentication.</li>
+        <li>Cache key is derived from the URL path and query parameters.</li>
+        <li>Responses are stored in <code>&lt;userDir&gt;/cache/http+/</code>.</li>
+        <li>Expired entries are ignored lazily — no active cleanup is needed.</li>
+        <li>The response header <code>X-Cache: HIT</code> or <code>MISS</code> indicates cache status.</li>
+    </ul>
+    <p>Not suitable for dynamic or user-specific responses.</p>
+
     <h3>Details</h3>
     <p>The URL field supports Express route patterns, including named parameters such as <code>/users/:id</code>.</p>
     <p>For more examples see the package <a href="https://github.com/inteli-city/node-red-contrib-http-plus">README</a>.</p>
@@ -104,14 +115,15 @@
 
     <h3>Details</h3>
     <p>This node is the standard response pair for <b>http.in+</b>.</p>
-    <p>It is fully compatible with the built-in Node-RED <i>http response</i> node, with one key addition: support for streaming responses.</p>
+    <p>It is fully compatible with the built-in Node-RED <i>http response</i> node, with two additions: browser cache control and streaming support.</p>
     <p>The <code>msg.res</code> object from the originating <b>http.in+</b> must reach this node unchanged.</p>
 
-    <h3>Difference from the standard node</h3>
-    <p>The only behavioral difference from the built-in <i>http response</i> node is support for streaming.</p>
+    <h3>Browser Cache</h3>
+    <p>Enable <b>Enable browser cache</b> to automatically set <code>Cache-Control: public, max-age=&lt;seconds&gt;</code> on every response.</p>
     <ul>
-        <li>If <code>msg.stream</code> is set, the stream is piped directly to the HTTP response.</li>
-        <li>If not, the node behaves exactly like the standard <i>http response</i> node.</li>
+        <li>Safe for static assets (images, scripts, stylesheets).</li>
+        <li>Avoid for dynamic or user-specific responses.</li>
+        <li>If <code>msg.headers['cache-control']</code> is already set in the flow, it takes precedence and the node-level setting is ignored.</li>
     </ul>
 
     <h3>Streaming</h3>
@@ -210,25 +222,51 @@
         <b>Zod docs</b><br>
         <a href="https://zod.dev/api" target="_blank">https://zod.dev/api</a>
     </div>
+    <div class="form-row">
+        <input type="checkbox" id="node-input-enableCache" style="display:inline-block; width:auto; vertical-align:top;">
+        <label for="node-input-enableCache" style="width:auto;"> Enable backend cache</label>
+    </div>
+    <div class="form-row httpin-cache-duration-row">
+        <label for="node-input-cacheDuration"><i class="fa fa-clock-o"></i> Cache duration (s)</label>
+        <input type="number" id="node-input-cacheDuration" style="width:100px;" min="1" placeholder="300">
+    </div>
+    <div class="httpin-cache-duration-row" style="font-size:12px; color:#666; margin: -4px 0 8px 110px; line-height:1.5;">
+        Caches GET responses server-side. Repeated identical requests skip the flow entirely.<br>
+        Only active for unauthenticated GET requests.<br>
+        Not suitable for dynamic or user-specific responses.
+    </div>
     <div id="node-input-tip" class="form-tips"><span data-i18n="httpin.tip.in"></span><code><span id="node-input-path"></span></code>.</div>
 </script>
 
 <script type="text/html" data-template-name="http.out+">
     <div class="form-row">
-        <label for="node-input-name"><i class="fa fa-tag"></i> <span data-i18n="common.label.name"></span></label>
-        <input type="text" id="node-input-name" data-i18n="[placeholder]common.label.name">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name">
     </div>
     <div class="form-row">
-        <label for="node-input-statusCode"><i class="fa fa-long-arrow-left"></i> <span data-i18n="httpin.label.status"></span></label>
+        <label for="node-input-statusCode"><i class="fa fa-long-arrow-left"></i> Status code</label>
         <input type="text" id="node-input-statusCode" placeholder="msg.statusCode">
     </div>
+    <div class="form-row">
+        <input type="checkbox" id="node-input-enableCache" style="display:inline-block; width:auto; vertical-align:top;">
+        <label for="node-input-enableCache" style="width:auto;"> Enable browser cache</label>
+    </div>
+    <div class="form-row http-out-cache-duration-row">
+        <label for="node-input-cacheDuration"><i class="fa fa-clock-o"></i> Cache duration (s)</label>
+        <input type="number" id="node-input-cacheDuration" style="width:100px;" min="1" placeholder="3600">
+    </div>
+    <div class="http-out-cache-duration-row" style="font-size:12px; color:#666; margin: -4px 0 8px 110px; line-height:1.5;">
+        Sets <code>Cache-Control: public, max-age=N</code> on the response.<br>
+        Safe for static assets. Avoid for dynamic or user-specific responses.<br>
+        Overridden by <code>msg.headers['cache-control']</code> if set in the flow.
+    </div>
     <div class="form-row" style="margin-bottom:0;">
-        <label><i class="fa fa-list"></i> <span data-i18n="httpin.label.headers"></span></label>
+        <label><i class="fa fa-list"></i> Headers</label>
     </div>
     <div class="form-row node-input-headers-container-row">
         <ol id="node-input-headers-container"></ol>
     </div>
-    <div class="form-tips"><span data-i18n="[html]httpin.tip.res"></span></div>
+    <div class="form-tips">The messages sent to this node <b>must</b> originate from an <i>http input</i> node</div>
 </script>
 
 <script type="text/javascript">
@@ -248,7 +286,9 @@
             uploadDir:     {value: ''},
             authConfig: {type:"http.auth.config+", required:false},
             enableZod: {value: false},
-            zodSchema: {value: ""}
+            zodSchema: {value: ""},
+            enableCache: {value: false},
+            cacheDuration: {value: 300}
         },
         inputs:0,
         outputs:1,
@@ -316,6 +356,12 @@
             $("#node-input-enableZod").on("change", toggleZodSchema);
             toggleZodSchema();
 
+            function toggleCacheDuration() {
+                $(".httpin-cache-duration-row").toggle($("#node-input-enableCache").is(":checked"));
+            }
+            $("#node-input-enableCache").on("change", toggleCacheDuration);
+            toggleCacheDuration();
+
             var httpRoot = (RED.settings.httpNodeRoot || "").replace(/\/$/, "");
             var docsUrl = window.location.origin + httpRoot + "/docs";
             var specUrl = window.location.origin + httpRoot + "/openapi.json";
@@ -367,7 +413,9 @@
                 value:"",
                 label: RED._("node-red:httpin.label.status"),
                 validate: RED.validators.number(true)},
-            headers: {value:{}}
+            headers: {value:{}},
+            enableCache: {value: false},
+            cacheDuration: {value: 3600}
         },
         inputs:1,
         outputs:0,
@@ -380,6 +428,12 @@
             return this.name?"node_label_italic":"";
         },
         oneditprepare: function() {
+            function toggleCacheDuration() {
+                $(".http-out-cache-duration-row").toggle($("#node-input-enableCache").is(":checked"));
+            }
+            $("#node-input-enableCache").on("change", toggleCacheDuration);
+            toggleCacheDuration();
+
             var headerList = $("#node-input-headers-container").css('min-height','150px').css('min-width','450px').editableList({
                 addItem: function(container,i,header) {
                     var row = $('<div/>').css({

package/httpin+.js

@@ -38,7 +38,10 @@ module.exports = function(RED) {
     var jwt = require('jsonwebtoken');
     var jwksRsa = require('jwks-rsa');
     var { z } = require('zod');
-    var os   = require('os');
+    var os     = require('os');
+    var path   = require('path');
+    var fs     = require('fs');
+    var crypto = require('crypto');
 
     function rawBodyParser(req, res, next) {
         if (req.skipRawBodyParser) { next(); } // don't parse this if told to skip
@@ -187,6 +190,29 @@ module.exports = function(RED) {
         RED.httpNode.options("*",corsHandler);
     }
 
+    // ── Backend cache utilities ────────────────────────────────────────────
+    function computeCacheKey(req) {
+        var query = req.query || {};
+        var sorted = Object.keys(query).sort().map(function(k) {
+            return encodeURIComponent(k) + '=' + encodeURIComponent(String(query[k]));
+        }).join('&');
+        return crypto.createHash('sha256').update(req.path + '?' + sorted).digest('hex');
+    }
+
+    function readCacheEntry(dir, key) {
+        try {
+            var data = JSON.parse(fs.readFileSync(path.join(dir, key + '.json'), 'utf8'));
+            return Date.now() < data.expires ? data : null;
+        } catch(e) { return null; }
+    }
+
+    function writeCacheEntry(dir, key, entry) {
+        try {
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(path.join(dir, key + '.json'), JSON.stringify(entry), 'utf8');
+        } catch(e) {}
+    }
+
     function HTTPIn(n) {
         RED.nodes.createNode(this,n);
 
@@ -255,6 +281,9 @@ module.exports = function(RED) {
             this.method        = n.method;
             this.swaggerDoc    = n.swaggerDoc;
             this.enableUpload  = n.enableUpload;
+            this.enableCache   = n.enableCache === true;
+            this.cacheDuration = parseInt(n.cacheDuration) || 300;
+            this.cacheDir      = path.join(RED.settings.userDir || process.cwd(), 'cache', 'http+');
             this.uploadStorage = n.uploadStorage || 'memory';
             this.maxFileSize   = n.maxFileSize   || 5;
             this.uploadDir     = n.uploadDir     || '';
@@ -267,6 +296,24 @@ module.exports = function(RED) {
             };
 
             this.callback = function(req,res) {
+                // ── Backend cache hit check ────────────────────────────────
+                var isAuthFree = !authConfig || authConfig.authType === 'none';
+                if (node.enableCache && node.method === 'get' && isAuthFree) {
+                    var cKey = computeCacheKey(req);
+                    var hit  = readCacheEntry(node.cacheDir, cKey);
+                    if (hit) {
+                        res.set('X-Cache', 'HIT');
+                        if (hit.contentType) { res.set('Content-Type', hit.contentType); }
+                        var hitBody = hit.bodyEncoding === 'base64'
+                            ? Buffer.from(hit.body, 'base64')
+                            : hit.body;
+                        return res.status(hit.statusCode).send(hitBody);
+                    }
+                    req._httpPlusCacheKey = cKey;
+                    req._httpPlusCacheTtl = node.cacheDuration;
+                    req._httpPlusCacheDir = node.cacheDir;
+                }
+
                 // Dispatch msg downstream after successful auth
                 function dispatchMsg(user) {
                     var msgid = RED.util.generateId();
@@ -531,6 +578,8 @@ module.exports = function(RED) {
         var node = this;
         this.headers = n.headers||{};
         this.statusCode = parseInt(n.statusCode);
+        this.enableCache = n.enableCache === true;
+        this.cacheDuration = parseInt(n.cacheDuration) || 3600;
         this.on("input",function(msg,_send,done) {
             if (msg.res) {
                 var headers = RED.util.cloneMessage(node.headers);
@@ -551,6 +600,13 @@ module.exports = function(RED) {
                         }
                     }
                 }
+                // ── Browser cache ──────────────────────────────────────────
+                if (node.enableCache && !headers.hasOwnProperty('cache-control')) {
+                    headers['cache-control'] = 'public, max-age=' + node.cacheDuration;
+                }
+                // ── Backend cache write coordination ───────────────────────
+                var rawReq = msg.res._res && msg.res._res.req;
+                var httpPlusCacheKey = rawReq && rawReq._httpPlusCacheKey;
                 // ── Streaming mode ─────────────────────────────────────────
                 var stream = msg.stream || (msg.payload && typeof msg.payload.pipe === 'function' && !Buffer.isBuffer(msg.payload) ? msg.payload : null);
                 if (stream) {
@@ -572,6 +628,9 @@ module.exports = function(RED) {
                     return;
                 }
 
+                if (httpPlusCacheKey) {
+                    headers['x-cache'] = 'MISS';
+                }
                 if (Object.keys(headers).length > 0) {
                     msg.res._res.set(headers);
                 }
@@ -596,6 +655,14 @@ module.exports = function(RED) {
                 var statusCode = node.statusCode || parseInt(msg.statusCode) || 200;
                 if (typeof msg.payload == "object" && !Buffer.isBuffer(msg.payload)) {
                     msg.res._res.status(statusCode).jsonp(msg.payload);
+                    if (httpPlusCacheKey) {
+                        writeCacheEntry(rawReq._httpPlusCacheDir, httpPlusCacheKey, {
+                            expires: Date.now() + rawReq._httpPlusCacheTtl * 1000,
+                            statusCode: statusCode,
+                            contentType: 'application/json',
+                            body: JSON.stringify(msg.payload)
+                        });
+                    }
                 } else {
                     if (msg.res._res.get('content-length') == null) {
                         var len;
@@ -615,6 +682,16 @@ module.exports = function(RED) {
                         msg.payload = ""+msg.payload;
                     }
                     msg.res._res.status(statusCode).send(msg.payload);
+                    if (httpPlusCacheKey) {
+                        var isBuffer = Buffer.isBuffer(msg.payload);
+                        writeCacheEntry(rawReq._httpPlusCacheDir, httpPlusCacheKey, {
+                            expires: Date.now() + rawReq._httpPlusCacheTtl * 1000,
+                            statusCode: statusCode,
+                            contentType: msg.res._res.getHeader('content-type') || '',
+                            body: isBuffer ? msg.payload.toString('base64') : String(msg.payload == null ? '' : msg.payload),
+                            bodyEncoding: isBuffer ? 'base64' : 'text'
+                        });
+                    }
                 }
             } else {
                 node.warn(RED._("httpin.errors.no-response"));

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@inteli.city/node-red-contrib-http-plus",
-    "version": "1.0.0",
+    "version": "1.0.1",
     "dependencies": {
         "body-parser": "1.20.3",
         "content-type": "1.0.5",