Registry / devops / node-red-iced-coffeescript

node-red-iced-coffeescript

JSON →
library1.0.7jsnpmunverified

The `node-red-iced-coffeescript` package provides a custom node for the Node-RED low-code programming platform, enabling users to execute code written in IcedCoffeeScript within their flows. Node-RED is an open-source tool for wiring together hardware devices, APIs, and online services in event-driven applications, often used for IoT and automation. IcedCoffeeScript is a superset of CoffeeScript that introduced `await` and `defer` keywords for simplified asynchronous control flow, predating the native `async/await` features in modern JavaScript. This package, currently at version 1.0.7, effectively allows Node-RED flows to leverage IcedCoffeeScript's asynchronous syntax. However, given its last update was approximately nine years ago, and `iced-coffee-script` itself has not been updated in six years, the package is considered abandoned. Its primary differentiator, async handling, has been largely superseded by standard JavaScript capabilities. The package requires `iced-coffee-script` to be installed separately.

npm install node-red-iced-coffeescript
INSTALL
IMPORT
SIG · NODE-RED-ICED-COFF
N
node-red-iced-coffeescript
devopsjavascriptv1.0.7
Install
Import
Disk
Pass rate
0/ 6
Env Coverage0 / 6
glibc
1822
musl
1822
Install & Compatibility
Where this runs
tested against v? · npm install
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
node 18226 runs
build_error
glibc
node 18226 runs
build_error
Code
Verified usage

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

Node-RED Editor Palette
Install via npm, then drag the 'iced-coffeescript' node from the palette in the Node-RED editor.
This package provides a Node-RED node, not a JavaScript/TypeScript library for direct code import. Its 'import' is handled by the Node-RED runtime after installation, making it available in the visual editor's palette for flow construction. The node typically appears under a 'function' or 'utility' category.
IcedCoffeeScript Node (within a flow)
Wire messages into the 'iced-coffeescript' node within a Node-RED flow to execute IcedCoffeeScript logic.
Once installed and available in the palette, the node is conceptually 'imported' into a specific flow by dragging and dropping it onto the canvas. Configuration, including the IcedCoffeeScript code, is done via the node's editor dialog.
Node Definition (for Node-RED runtime)
The Node-RED runtime automatically loads and registers the node's definition files (e.g., `.js` and `.html`) from the installed npm package.
import { IcedCoffeeScriptNode } from 'node-red-iced-coffeescript'
From a Node-RED runtime perspective, the package exports node definitions rather than symbols for direct application-level import. Developers consuming this package in a Node-RED environment do not use standard JavaScript import/require statements to access the node's functionality.

This quickstart guides you through setting up Node-RED, installing the `iced-coffee-script` compiler and the `node-red-iced-coffeescript` node, and demonstrates creating a basic Node-RED flow to execute simple IcedCoffeeScript code.

# 1. Install Node-RED (if not already installed) sudo npm install -g --unsafe-perm node-red # 2. Start Node-RED node-red # 3. In a new terminal, install the IcedCoffeeScript compiler globally (as recommended by the package README) sudo npm install -g iced-coffee-script # 4. Install the Node-RED IcedCoffeeScript node npm install node-red-iced-coffeescript # 5. Restart Node-RED to load the new node node-red // 6. Access the Node-RED editor (usually http://localhost:1880) // 7. Drag an 'Inject' node, an 'iced-coffeescript' node, and a 'Debug' node onto the canvas. // 8. Wire them together: Inject -> iced-coffeescript -> Debug. // 9. Double-click the 'iced-coffeescript' node to edit its code. // Replace the default content with the following IcedCoffeeScript example: # IcedCoffeeScript code for the node: msg.payload = "Hello, IcedCoffeeScript!" # Example of IcedCoffeeScript's async features (for context, if `defer` was relevant) # Not directly executable without an async operation, but demonstrates the syntax. # Assuming 'someAsyncFunction' exists and takes a callback: # someAsyncFunction (value) defer cb value # msg.payload = "Async operation result: #{value}" return msg // 10. Deploy the flow. // 11. Click the 'Inject' node button. Observe the output in the Debug sidebar.
Debug
Known issues
deprecatedThe `node-red-iced-coffeescript` package is effectively abandoned, with its last commit over nine years ago. The underlying `iced-coffee-script` compiler also received its last update six years ago.
fix
For new projects, prefer using the standard Node-RED 'Function' node with modern JavaScript (ES6+) and native `async/await` syntax, which offers similar asynchronous control flow capabilities and is actively maintained. Consider `node-red-contrib-typescript` for TypeScript support if strong typing is desired.
affects: >=1.0.0
gotchaThis package relies on the `iced-coffee-script` compiler, which must be installed separately, either locally or globally, for the Node-RED node to function correctly. The `node-red-iced-coffeescript` package does not bundle or automatically install this dependency.
fix
Ensure `iced-coffee-script` is installed via `npm install -g iced-coffee-script` (globally) or `npm install iced-coffee-script` (locally within your Node-RED user directory) *before* attempting to use the Node-RED node.
affects: >=1.0.0
gotchaIcedCoffeeScript's core value proposition (simplified asynchronous control flow via `await`/`defer`) has largely been superseded by native `async/await` in modern JavaScript (ES2017+). Using IcedCoffeeScript might introduce unnecessary complexity or reliance on outdated language features.
fix
Evaluate if IcedCoffeeScript truly provides a benefit over modern JavaScript in the Node-RED 'Function' node. If asynchronous operations are the goal, use standard `async/await` directly in JavaScript function nodes.
affects: >=1.0.0
Errors
Common errors & fixes
Error: Cannot find module 'iced-coffee-script' in Node-RED debug log.
The `iced-coffee-script` compiler, a peer dependency, has not been installed on the system where Node-RED is running.
fix
Run `npm install -g iced-coffee-script` to install the compiler globally, then restart your Node-RED instance.
SyntaxError: Unexpected token 'await' (or 'defer') in iced-coffeescript node.
This error is unlikely for IcedCoffeeScript itself, but could occur if trying to use *modern JavaScript's* `await` syntax directly in an IcedCoffeeScript node, or if the `iced-coffee-script` compiler itself is misconfigured or missing.
fix
Ensure the `iced-coffee-script` compiler is correctly installed. If attempting to use modern JavaScript `async/await`, switch to a standard Node-RED 'Function' node set to JavaScript, not an `iced-coffeescript` node.
Upgrade
Version history
1.0.7latest on npm
Audit
Dependencies
iced-coffee-scriptrequiredThis is the core compiler for IcedCoffeeScript, required at runtime by the Node-RED node. The package README explicitly states it must be installed either locally or globally. Without it, the node cannot execute IcedCoffeeScript code.
Agent activity
4 hits · last 30 days
node
4
Resources
node-red-iced-coffeescript — npm install node-red-iced-coffeescript · libregistry