@rosepetal/node-red-contrib-utils 1.1.1
Utility and I/O nodes for Node-RED, including array helpers and file saving.
@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
sharpnative 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