qm-hub-websocket

library1.0.8jsnpmunverified

qm-hub-websocket is a WebSocket module for Node-RED, version 1.0.8, used to integrate with the Quimera Hub ecosystem. It provides custom WebSocket nodes within Node-RED for real-time communication. Release cadence is not documented; updates are infrequent. Differentiators: tightly coupled with Quimera Hub JIG framework, not a standalone WebSocket library. Primarily used in Node-RED flows for industrial IoT and automation scenarios. Minimal documentation available; limited community support.

messaging

npm install qm-hub-websocket

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · QM-HUB-WEBSOCKET

qm-hub-websocket

messagingjavascriptv1.0.8

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

QMHubWebSocketNode

✓ No standard programmatic import; used as Node-RED node via palette.

✗ Try to import as CommonJS module

This is a Node-RED custom node, not a library. Install via npm and restart Node-RED; nodes appear in palette under 'quimera'.

Installing and using the qm-hub-websocket node in Node-RED, including npm install and flow JSON example.

// Install the package in your Node-RED user data directory // Replace ~/.node-red with your Node-RED userDir cd ~/.node-red npm install qm-hub-websocket // Then restart Node-RED node-red-stop node-red-start // After restart, find the node in the palette under 'quimera' category. // Drag 'WebSocket' node onto canvas, configure Hub URL and credentials. // Example flow: [{"id":"e1b2c3d4","type":"qm-hub-websocket","z":"flow","name":"","hubUrl":"ws://your-hub-url","credentials":{"token":""},"x":400,"y":200,"wires":[]}] // Use with other Node-RED nodes to send/receive messages. // Ensure Node-RED version >= 1.0.0.

Debug

Known issues

gotchaThis package is a Node-RED custom node; it does not export any programmatic API. Do not attempt to require() or import it in Node.js scripts.

fix

Use only within Node-RED context. Install the package in your Node-RED user directory and use the node in flows.

affects: all

gotchaThe node requires a running Quimera Hub instance. Without a Hub, the node will fail to connect and may not function.

fix

Ensure you have access to a Quimera Hub WebSocket endpoint. Configure the 'hubUrl' property accordingly.

affects: all

gotchaDocumentation is sparse. The package does not provide extensive usage examples beyond basic Node-RED integration.

fix

Refer to Quimera Hub JIG documentation or contact the package maintainers for detailed usage.

affects: all

gotchaVersion 1.0.8 is the latest; no active development observed. Check for updates if you encounter issues.

fix

Monitor the GitHub repository for new releases or fork to patch.

affects: <=1.0.8

Errors

Common errors & fixes

Error: Cannot find module 'qm-hub-websocket'

Package installed globally or in wrong directory instead of Node-RED user data directory.

fix

cd ~/.node-red && npm install qm-hub-websocket

TypeError: qm_hub_websocket is not a function

Attempting to use require('qm-hub-websocket') programmatically. The package is a Node-RED node, not a library.

fix

Use the node in Node-RED flows only. Remove any require() calls.

Node-RED: Error loading [qm-hub-websocket]: TypeError: Cannot read properties of undefined (reading 'registerType')

Node-RED version mismatch or incorrect installation path.

fix

Ensure Node-RED is installed and you are in the correct userDir. Check Node-RED version >= 1.0.0.

WebSocket connection to 'ws://...' failed: Connection closed before receiving a handshake response

Quimera Hub is not running or the URL is incorrect.

fix

Verify the Hub URL and ensure the Hub WebSocket server is active.

Upgrade

Version history

1.0.8latest on npm

Audit

Dependencies

node-redrequiredRequired as peer dependency for Node-RED node development

Agent activity

15 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/modulesQuimera/qm-hub-websocket ↗

packageqm-hub-websocket ↗

homepagehttps://github.com/modulesQuimera/qm-hub-websocket#readme ↗