@rosepetal/node-red-contrib-async-function 1.0.3 → 1.1.0

package/README.md

@@ -20,7 +20,7 @@ Run heavy computations in Node-RED without slowing down your flows. This node wo
 
 ## How It Works
 
-Drop an **async function** node into your flow. Write your code just like you would in a regular function node. The difference? Your code runs in a separate worker thread by default (or a child process if configured), so heavy operations won't freeze Node-RED.
+Drop a **worker function** node into your flow. Write your code just like you would in a regular function node. The difference? Your code runs in a separate worker thread by default (or a child process if configured), so heavy operations won't freeze Node-RED.
 
 ## When to Use This
 
@@ -66,7 +66,7 @@ return msg;
 
 ## Typical Flow
 
-1. Add an **async function** node to your workspace.
+1. Add a **worker function** node to your workspace.
 2. Connect an Inject node (input) and a Debug node (output).
 3. Write a simple script:
    ```javascript
@@ -194,7 +194,9 @@ npm install @rosepetal/node-red-contrib-async-function
 
 Restart Node-RED and find the node in the **function** category.
 
-## Migration from Earlier Versions
+## Migration
+
+### From minWorkers/maxWorkers
 
 If you're upgrading from a version that used `minWorkers` and `maxWorkers`:
 - Your existing flows will automatically migrate to use the new `numWorkers` parameter

package/nodes/lib/child-process-script.js

@@ -226,7 +226,7 @@ async function loadConfiguredModules(libs) {
             moduleVars.push(lib.var);
             moduleValues.push(loadedModules[lib.var]);
         } catch (err) {
-            console.error(`[async-function] Failed to load module ${lib.module}: ${err.message}`);
+            console.error(`[worker-function] Failed to load module ${lib.module}: ${err.message}`);
             failedModules.push({ module: lib.module, var: lib.var, error: err.message });
         }
     }

package/nodes/lib/module-installer.js

@@ -1,7 +1,7 @@
 /**
  * Module Installer
  *
- * Handles automatic installation of npm modules for the async-function node.
+ * Handles automatic installation of npm modules for the worker-function node.
  * Modules are installed in the Node-RED user directory (~/.node-red).
  */
 
@@ -43,21 +43,21 @@ async function getNodeRedUserDir() {
  */
 async function installModule(moduleName) {
     if (!moduleName || typeof moduleName !== 'string') {
-        console.error('[async-function] Invalid module name');
+        console.error('[worker-function] Invalid module name');
         return false;
     }
 
     // Sanitize module name to prevent command injection
     const sanitizedName = moduleName.trim();
     if (!/^(@[\w-]+\/)?[\w.-]+(@[\w.-]+)?$/.test(sanitizedName)) {
-        console.error(`[async-function] Invalid module name format: ${sanitizedName}`);
+        console.error(`[worker-function] Invalid module name format: ${sanitizedName}`);
         return false;
     }
 
     const userDir = await getNodeRedUserDir();
 
     try {
-        console.log(`[async-function] Installing module: ${sanitizedName} in ${userDir}`);
+        console.log(`[worker-function] Installing module: ${sanitizedName} in ${userDir}`);
 
         await new Promise((resolve, reject) => {
             const child = spawn('npm', ['install', sanitizedName], {
@@ -98,11 +98,11 @@ async function installModule(moduleName) {
             });
         });
 
-        console.log(`[async-function] Successfully installed: ${sanitizedName}`);
+        console.log(`[worker-function] Successfully installed: ${sanitizedName}`);
         return true;
 
     } catch (err) {
-        console.error(`[async-function] Failed to install ${sanitizedName}: ${err.message}`);
+        console.error(`[worker-function] Failed to install ${sanitizedName}: ${err.message}`);
         return false;
     }
 }

package/nodes/lib/worker-script.js

@@ -233,7 +233,7 @@ async function loadConfiguredModules() {
             moduleVars.push(lib.var);
             moduleValues.push(loadedModules[lib.var]);
         } catch (err) {
-            console.error(`[async-function] Failed to load module ${lib.module}: ${err.message}`);
+            console.error(`[worker-function] Failed to load module ${lib.module}: ${err.message}`);
             failedModules.push({ module: lib.module, var: lib.var, error: err.message });
         }
     }

package/nodes/{async-function.html → worker-function.html}

@@ -1,13 +1,13 @@
-<!-- Async Function Node - Node-RED Editor Configuration -->
+<!-- Worker Function Node - Node-RED Editor Configuration -->
 
 <script type="text/javascript">
-    RED.nodes.registerType('async-function', {
+    RED.nodes.registerType('worker-function', {
         category: 'function',
         color: '#d7d9dc',
         defaults: {
             name: { value: '' },
             func: {
-                value: '// Write your async code here\n// The code runs in a worker thread or child process\n// Available: msg, return, async/await, require(), node.warn/error/log,\n//           flow/global/context (snapshot-based)\n\nreturn msg;'
+                value: '// Write your code here\n// The code runs in a worker thread or child process\n// Available: msg, return, async/await, require(), node.warn/error/log,\n//           flow/global/context (snapshot-based)\n\nreturn msg;'
             },
             outputs: { value: 1, validate: RED.validators.number() },
             timeout: { value: 30000, validate: RED.validators.number() },
@@ -21,7 +21,7 @@
         outputs: 1,
         icon: 'function.svg',
         label: function() {
-            return this.name || 'async function';
+            return this.name || 'worker function';
         },
         labelStyle: function() {
             return this.name ? 'node_label_italic' : '';
@@ -250,7 +250,7 @@
                 status.text('Restarting...').css('color', '#666');
 
                 $.ajax({
-                    url: 'async-function/' + nodeId + '/restart',
+                    url: 'worker-function/' + nodeId + '/restart',
                     type: 'POST',
                     success: function(data) {
                         status.text('✓ Workers restarted').css('color', 'green');
@@ -346,7 +346,7 @@
     });
 </script>
 
-<script type="text/html" data-template-name="async-function">
+<script type="text/html" data-template-name="worker-function">
     <style>
         .async-func-tabs-row {
             margin-bottom: 0;
@@ -519,7 +519,7 @@
     </div>
 </script>
 
-<script type="text/html" data-help-name="async-function">
+<script type="text/html" data-help-name="worker-function">
     <p>Execute custom JavaScript code in a worker thread or child process to prevent event loop blocking.</p>
 
     <h3>Inputs</h3>

package/nodes/{async-function.js → worker-function.js}

@@ -1,8 +1,8 @@
 /**
- * Async Function Node
+ * Worker Function Node
  *
  * A Node-RED function node that executes user code in worker threads
- * to prevent event loop blocking.
+ * or child processes to prevent event loop blocking.
  */
 
 const path = require('path');
@@ -387,7 +387,7 @@ function applyPerformanceMetrics(node, originalMsg, targetMsg, performance) {
         return;
     }
 
-    const label = (typeof node.name === 'string' && node.name.trim()) ? node.name.trim() : 'async function';
+    const label = (typeof node.name === 'string' && node.name.trim()) ? node.name.trim() : 'worker function';
     if (!label) {
         return;
     }
@@ -656,7 +656,7 @@ module.exports = function(RED) {
                 }
 
                 // Log error
-                node.error(`Async function error: ${err.message}`, msg);
+                node.error(`Worker function error: ${err.message}`, msg);
 
                 // Propagate error to Catch node
                 done(err);
@@ -703,12 +703,12 @@ module.exports = function(RED) {
     }
 
     // Register the node type
-    RED.nodes.registerType('async-function', AsyncFunctionNode, {
+    RED.nodes.registerType('worker-function', AsyncFunctionNode, {
         dynamicModuleList: 'libs'
     });
 
     // HTTP endpoint to restart workers for a specific node
-    RED.httpAdmin.post('/async-function/:id/restart', async function(req, res) {
+    RED.httpAdmin.post('/worker-function/:id/restart', async function(req, res) {
         const node = RED.nodes.getNode(req.params.id);
         if (!node || !node.pool) {
             return res.status(404).json({ error: 'Node not found or pool not initialized' });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rosepetal/node-red-contrib-async-function",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "A Node-RED function node that runs code in worker threads to keep your flows responsive",
   "repository": {
     "type": "git",
@@ -9,7 +9,7 @@
   "keywords": [
     "node-red",
     "function",
-    "async",
+    "worker-function",
     "worker-threads",
     "non-blocking",
     "performance",
@@ -34,7 +34,7 @@
   "node-red": {
     "version": ">=2.0.0",
     "nodes": {
-      "async-function": "nodes/async-function.js"
+      "worker-function": "nodes/worker-function.js"
     }
   },
   "dependencies": {}