node-red-aquila

0.3.0 verified Sat Apr 25 auth: no javascript

Node-RED nodes for Aquila's IoT platform, version 0.3.0. Provides integration with Aquila, makerslab, and Altair IoT services within Node-RED. Installation requires Node-RED user directory and may be done locally or globally. The package is lightweight and specific to the Aquila ecosystem, not actively maintained.

Common errors

error Error: Cannot find module 'node-red-aquila' ↓

cause Node-RED cannot locate the package; likely installed in wrong directory or not installed.

fix

Ensure npm install is run from ~/.node-red directory.

error TypeError: RED.nodes.registerType is not a function ↓

cause Trying to use registerType outside of Node-RED context or before RED is available.

fix

Use registerType only in Node-RED settings.js or within a Node-RED plugin context.

error Error: The module 'node-red-aquila' is not a Node-RED module ↓

cause Node-RED failed to load the module because it lacks proper package.json node-red section.

fix

Ensure package.json contains 'node-red' key with nodes array.

Warnings

gotcha Installation must be from Node-RED user directory (~/.node-red) or globally, otherwise nodes are not detected. ↓

fix Run 'cd ~/.node-red && npm install node-red-aquila' or use global install with -g.

deprecated Using 'npm install -g' to install Node-RED nodes globally may cause version conflicts with other Node-RED instances. ↓

fix Prefer local installation in ~/.node-red directory.

breaking The package may not be compatible with Node-RED 3.x due to changes in node registration API. ↓

fix Check for updates or fork and update node registration calls.

Install

npm install node-red-aquila

yarn add node-red-aquila

pnpm add node-red-aquila

Imports

AQ_Node

wrong

import { AQ_Node } from 'node-red-aquila'

correct

const AQ_Node = require('node-red-aquila').AQ_Node

Node-RED environments typically use CommonJS require() in Node.js.

aquilaNode

wrong

const aquilaNode = require('node-red-aquila')

correct

const { aquilaNode } = require('node-red-aquila')

Be careful to destructure if only one is needed.

default

wrong

import Aquila from 'node-red-aquila'

correct

const Aquila = require('node-red-aquila')

The package exports a namespace object, not a default export.

Quickstart

Shows how to manually register an Aquila node type in Node-RED using CommonJS require and registerType.

// In Node-RED function node or settings.js
const Aquila = require('node-red-aquila');
// Node-RED will auto-discover nodes if installed correctly.
// Manual registration example:
RED.nodes.registerType('aquila-out', Aquila.aquilaNode);