@yroshcha/node-red-contrib-redis-full 1.0.7 → 1.0.8

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to this project are documented in this file.
 
+## 1.0.8 — 2026-08-12
+
+### Fixed
+
+- `redis xreadgroup` and `redis xautoclaim` now restore nested object and array fields that were serialised by `redis xadd`, while preserving scalar Redis fields as strings.
+
 ## 1.0.7 — 2026-08-12
 
 ### Added

package/README.md

@@ -45,7 +45,7 @@ For a local archive, use `npm install /path/to/yroshcha-node-red-contrib-redis-f
 
 ## Release status
 
-**`1.0.7` is the current stable release.** See [CHANGELOG.md](CHANGELOG.md) for release notes and compatibility information.
+**`1.0.8` is the current stable release.** See [CHANGELOG.md](CHANGELOG.md) for release notes and compatibility information.
 
 ## Production profile
 
@@ -58,6 +58,7 @@ Safe consumer defaults and important settings:
 - **Rate limit (msg/s) = 0** is unlimited. For example, `500` limits average downstream delivery to 500 events per second.
 - **Read interval (ms) = 0** reads as fast as Redis responds. `1000` calls `XREADGROUP` no more often than once per second, independent of queue depth.
 - **Batch wait (ms) = 0** emits one event at a time. With a positive value, the node emits an array once it has collected `COUNT` events or the wait expires. `msg.payload` and `msg.streamId` become arrays.
+- Nested object and array fields written by `redis xadd` are automatically decoded from JSON by `redis xreadgroup` and `redis xautoclaim`; scalar Redis fields remain strings.
 - **Batch interval (ms)** sets the minimum delay between emitted batches regardless of queue depth. For one batch of up to 50 entries per second, use `COUNT = 50` and `Batch interval = 1000`.
 - **Max deliveries = 5.** After the limit is exceeded, an entry is atomically moved to `<stream>:dlq` and acknowledged. In Redis Cluster, source and DLQ keys must share a hash tag, for example `orders:{eu}` and `orders:{eu}:dlq`.
 - **Start paused (wait for resume)** makes a consumer create/verify its group without calling `XREADGROUP`. It takes no work until a control-plane `resume` request arrives; use it for controlled pod startup after readiness checks.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yroshcha/node-red-contrib-redis-full",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Production-oriented Redis palette for Node-RED: generic commands, Pub/Sub, scans, transactions, and Redis Streams consumer groups.",
   "keywords": ["node-red", "redis", "redis-streams", "pubsub", "xadd", "xreadgroup", "ioredis"],
   "license": "MIT",

package/redis.js

@@ -173,6 +173,22 @@ module.exports = function (RED) {
     return obj;
   }
 
+  function parseStreamFields(flat) {
+    const obj = parseFlatFields(flat);
+    for (const [field, value] of Object.entries(obj)) {
+      // redis xadd serialises nested objects and arrays to JSON. Restore only
+      // these compound JSON values; scalar strings such as "true", "42", or
+      // "null" remain strings and preserve Redis field semantics.
+      if (typeof value !== 'string' || !/^[\[{]/.test(value.trim())) continue;
+      try {
+        obj[field] = JSON.parse(value);
+      } catch (_) {
+        // A value that merely looks like JSON is still a valid Redis string.
+      }
+    }
+    return obj;
+  }
+
   function isNoGroupError(err) {
     return String(err && err.message ? err.message : err).includes('NOGROUP');
   }
@@ -868,7 +884,7 @@ module.exports = function (RED) {
       if (!Array.isArray(flat)) {
         throw new Error(`Stream entry ${id} no longer has a payload; do not trim streams below the PEL horizon`);
       }
-      const payload = parseFlatFields(flat);
+      const payload = parseStreamFields(flat);
       if (checkDeliveryCount && await shouldDeadLetter(id, payload)) return;
       if (!await waitForDeliverySlot() || paused) return false;
 
@@ -1173,7 +1189,7 @@ module.exports = function (RED) {
           const [nextCursor, entries] = res;
           cursor = nextCursor;
           for (const [id, flat] of entries || []) {
-            claimed.push({ streamId: id, payload: parseFlatFields(flat) });
+            claimed.push({ streamId: id, payload: parseStreamFields(flat) });
           }
         } while (cursor !== '0' && claimed.length < node.maxMessages);