@rosepetal/node-red-contrib-utils

Utility and I/O nodes for Node-RED, focused on array assembly, queueing, safe debugging, promise aggregation, event loop monitoring, and file saving.

Quick Start

Installation (Palette Manager)

• Open Palette Manager -> Install -> search @rosepetal/node-red-contrib-utils.

Installation (npm)

cd ~/.node-red
npm install @rosepetal/node-red-contrib-utils

Requirements

• Node.js >= 16
• Node-RED >= 1.0.0
• sharp native addon (fetched via npm; builds from source if no prebuilt is available)

Node Type Prefix

All node types are prefixed with rp- to avoid collisions with other packages. In flow JSON you will see types like rp-array-in. In the editor, nodes appear under the "RP Utils" category with human-friendly labels.

Nodes

I/O and Array Tools

| Node | Purpose | |------|---------| | rp-array-in | Tag incoming data with a position index for ordered array assembly. | | rp-array-out | Collect indexed data into ordered arrays with timeout handling. | | rp-array-select | Select array elements using index and slice syntax. | | rp-queue | Buffer messages, enforce output intervals, and drop stale or overflow items. | | rp-save-file | Save payloads to disk as image, JSON, text, or binary with auto-detection. |

Async and Workflow

| Node | Purpose | |------|---------| | rp-promise-reader | Resolve arrays of promises, merge results, and record timing. |

Utilities

| Node | Purpose | |------|---------| | rp-clean-debug | Debug output that sanitizes large payloads to keep the sidebar responsive. | | rp-block-detect | Event loop delay watchdog with live status and log warnings. |

Project Structure

node-red-contrib-utils/
├── docs/nodes/          # Node documentation
├── nodes/               # Node-RED node implementations
│   ├── io/              # Array, queue, save-file nodes
│   ├── util/            # clean-debug, block-detect
│   └── promise-reader/  # promise-reader node
├── lib/                 # Shared utilities
└── assets/              # Documentation assets

License

Apache-2.0

Author

Rosepetal SL - https://www.rosepetal.ai