{"id":18607,"library":"node-red-aquila","title":"node-red-aquila","description":"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.","status":"active","version":"0.3.0","language":"javascript","source_language":"en","source_url":"https://github.com/makerlabmx/node-red-aquila","tags":["javascript","node-red","aquila","altair","makerlab","node-red-aquila"],"install":[{"cmd":"npm install node-red-aquila","lang":"bash","label":"npm"},{"cmd":"yarn add node-red-aquila","lang":"bash","label":"yarn"},{"cmd":"pnpm add node-red-aquila","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Runtime dependency; nodes are loaded by Node-RED","package":"node-red","optional":true}],"imports":[{"note":"Node-RED environments typically use CommonJS require() in Node.js.","wrong":"import { AQ_Node } from 'node-red-aquila'","symbol":"AQ_Node","correct":"const AQ_Node = require('node-red-aquila').AQ_Node"},{"note":"Be careful to destructure if only one is needed.","wrong":"const aquilaNode = require('node-red-aquila')","symbol":"aquilaNode","correct":"const { aquilaNode } = require('node-red-aquila')"},{"note":"The package exports a namespace object, not a default export.","wrong":"import Aquila from 'node-red-aquila'","symbol":"default","correct":"const Aquila = require('node-red-aquila')"}],"quickstart":{"code":"// In Node-RED function node or settings.js\nconst Aquila = require('node-red-aquila');\n// Node-RED will auto-discover nodes if installed correctly.\n// Manual registration example:\nRED.nodes.registerType('aquila-out', Aquila.aquilaNode);\n","lang":"javascript","description":"Shows how to manually register an Aquila node type in Node-RED using CommonJS require and registerType."},"warnings":[{"fix":"Run 'cd ~/.node-red && npm install node-red-aquila' or use global install with -g.","message":"Installation must be from Node-RED user directory (~/.node-red) or globally, otherwise nodes are not detected.","severity":"gotcha","affected_versions":"all"},{"fix":"Prefer local installation in ~/.node-red directory.","message":"Using 'npm install -g' to install Node-RED nodes globally may cause version conflicts with other Node-RED instances.","severity":"deprecated","affected_versions":"<0.3.0"},{"fix":"Check for updates or fork and update node registration calls.","message":"The package may not be compatible with Node-RED 3.x due to changes in node registration API.","severity":"breaking","affected_versions":">=3.0"}],"env_vars":null,"last_verified":"2026-04-25T00:00:00.000Z","next_check":"2026-07-24T00:00:00.000Z","problems":[{"fix":"Ensure npm install is run from ~/.node-red directory.","cause":"Node-RED cannot locate the package; likely installed in wrong directory or not installed.","error":"Error: Cannot find module 'node-red-aquila'"},{"fix":"Use registerType only in Node-RED settings.js or within a Node-RED plugin context.","cause":"Trying to use registerType outside of Node-RED context or before RED is available.","error":"TypeError: RED.nodes.registerType is not a function"},{"fix":"Ensure package.json contains 'node-red' key with nodes array.","cause":"Node-RED failed to load the module because it lacks proper package.json node-red section.","error":"Error: The module 'node-red-aquila' is not a Node-RED module"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}