node-red-contrib-iit-execwin 0.1.0

package/README.md

@@ -0,0 +1,32 @@
+# node-red-contrib-iit-execwin
+
+Nodo Node-RED para ejecutar comandos de PowerShell o CMD en Windows, con salida estructurada (stdout, stderr, exitCode).
+
+Diferencias frente al nodo `exec` incluido en Node-RED:
+- Por defecto usa PowerShell en vez de CMD (configurable).
+- Devuelve `stdout`, `stderr` y `exitCode` en propiedades separadas de `msg`, en vez de tres salidas del nodo.
+- Corta la ejecución sola si se pasa de un timeout configurable (por defecto 30s).
+- `windowsHide: true` — no abre una ventana de consola visible al ejecutar.
+
+## Instalación
+
+```bash
+npm install node-red-contrib-iit-execwin
+```
+
+## Ejemplo de uso
+
+```js
+msg.payload = "Get-Service -Name Spooler | Select-Object Status";
+return msg;
+```
+
+La salida llega en `msg.payload` (texto), `msg.stderr` (si hubo errores) y `msg.exitCode` (0 = éxito).
+
+## Seguridad
+
+Este nodo ejecuta directamente lo que llegue en `msg.payload`. No lo conectes a una fuente de datos externa no confiable (un webhook público, un formulario sin validar, etc.) sin sanitizar antes el contenido — es funcionalmente equivalente a darle acceso a una terminal de tu equipo a quien controle ese mensaje.
+
+## Licencia
+
+MIT

package/iit-exec-win.html

@@ -0,0 +1,68 @@
+<script type="text/javascript">
+  RED.nodes.registerType('iit-exec-win', {
+    category: 'IIT',
+    color: '#7FB2E5',
+    defaults: {
+      name: { value: '' },
+      shellType: { value: 'powershell' },
+      workingDir: { value: '' },
+      timeoutMs: { value: 30000, validate: RED.validators.number() },
+    },
+    inputs: 1,
+    outputs: 1,
+    icon: 'font-awesome/fa-terminal',
+    label: function () {
+      return this.name || 'iit-exec-win';
+    },
+  });
+</script>
+
+<script type="text/html" data-template-name="iit-exec-win">
+  <div class="form-row">
+    <label for="node-input-name"><i class="fa fa-tag"></i> Nombre</label>
+    <input type="text" id="node-input-name" placeholder="Nombre">
+  </div>
+  <div class="form-row">
+    <label for="node-input-shellType"><i class="fa fa-terminal"></i> Shell</label>
+    <select id="node-input-shellType" style="width:70%">
+      <option value="powershell">PowerShell</option>
+      <option value="cmd">CMD</option>
+    </select>
+  </div>
+  <div class="form-row">
+    <label for="node-input-workingDir"><i class="fa fa-folder-open"></i> Carpeta de trabajo</label>
+    <input type="text" id="node-input-workingDir" placeholder="C:\ruta\opcional">
+  </div>
+  <div class="form-row">
+    <label for="node-input-timeoutMs"><i class="fa fa-clock-o"></i> Timeout (ms)</label>
+    <input type="number" id="node-input-timeoutMs" placeholder="30000">
+  </div>
+  <div class="form-tips">
+    <p><i class="fa fa-info-circle"></i> El comando a ejecutar llega en <code>msg.payload</code> como texto. Nunca conectes este nodo a una entrada que reciba texto sin validar desde fuera de tu red de confianza — el comando se ejecuta tal cual.</p>
+  </div>
+</script>
+
+<script type="text/html" data-help-name="iit-exec-win">
+  <p>Ejecuta un comando de PowerShell o CMD en Windows y devuelve su resultado estructurado.</p>
+  <h3>Entradas</h3>
+  <dl class="message-properties">
+    <dt>payload <span class="property-type">string</span></dt>
+    <dd>El comando a ejecutar.</dd>
+    <dt class="optional">shellType <span class="property-type">string</span></dt>
+    <dd>Sobrescribe el shell configurado: "powershell" o "cmd".</dd>
+    <dt class="optional">workingDir <span class="property-type">string</span></dt>
+    <dd>Sobrescribe la carpeta de trabajo.</dd>
+    <dt class="optional">timeoutMs <span class="property-type">number</span></dt>
+    <dd>Sobrescribe el timeout en milisegundos.</dd>
+  </dl>
+  <h3>Salidas</h3>
+  <dl class="message-properties">
+    <dt>payload <span class="property-type">string</span></dt>
+    <dd>La salida estándar (stdout) del comando, sin espacios extra al inicio/fin.</dd>
+    <dt>stderr <span class="property-type">string</span></dt>
+    <dd>La salida de error (stderr), si la hubo.</dd>
+    <dt>exitCode <span class="property-type">number</span></dt>
+    <dd>Código de salida del proceso. 0 = éxito.</dd>
+  </dl>
+  <p><strong>Seguridad:</strong> este nodo ejecuta el texto de <code>msg.payload</code> directamente en una shell del sistema. No lo expongas a entradas externas no confiables (ej. un formulario web público) sin validar/filtrar antes.</p>
+</script>

package/iit-exec-win.js

@@ -0,0 +1,92 @@
+const { spawn } = require('child_process');
+
+module.exports = function (RED) {
+  function IitExecWinNode(config) {
+    RED.nodes.createNode(this, config);
+    const node = this;
+
+    node.shellType = config.shellType || 'powershell'; // 'powershell' | 'cmd'
+    node.workingDir = config.workingDir || '';
+    node.timeoutMs = parseInt(config.timeoutMs) || 30000;
+
+    node.on('input', function (msg, send, done) {
+      send = send || function () { node.send.apply(node, arguments); };
+
+      const command = msg.payload;
+      if (typeof command !== 'string' || !command.trim()) {
+        node.status({ fill: 'red', shape: 'ring', text: 'comando vacío' });
+        node.error('msg.payload debe ser un string con el comando a ejecutar', msg);
+        if (done) done();
+        return;
+      }
+
+      const shellType = msg.shellType || node.shellType;
+      const cwd = msg.workingDir || node.workingDir || undefined;
+      const timeoutMs = msg.timeoutMs || node.timeoutMs;
+
+      let bin, args;
+      if (shellType === 'cmd') {
+        bin = 'cmd.exe';
+        args = ['/d', '/s', '/c', command];
+      } else {
+        bin = 'powershell.exe';
+        args = ['-NoProfile', '-NonInteractive', '-Command', command];
+      }
+
+      node.status({ fill: 'blue', shape: 'dot', text: 'ejecutando…' });
+
+      let stdout = '';
+      let stderr = '';
+      let finished = false;
+
+      const child = spawn(bin, args, { cwd, windowsHide: true });
+
+      const timer = setTimeout(() => {
+        if (!finished) {
+          finished = true;
+          child.kill();
+          node.status({ fill: 'red', shape: 'ring', text: 'timeout' });
+          node.error('El comando excedió el timeout de ' + timeoutMs + ' ms', msg);
+          if (done) done();
+        }
+      }, timeoutMs);
+
+      child.stdout.on('data', (d) => { stdout += d.toString(); });
+      child.stderr.on('data', (d) => { stderr += d.toString(); });
+
+      child.on('error', (err) => {
+        if (finished) return;
+        finished = true;
+        clearTimeout(timer);
+        node.status({ fill: 'red', shape: 'ring', text: 'error' });
+        node.error('No se pudo iniciar el proceso: ' + err.message, msg);
+        if (done) done(err);
+      });
+
+      child.on('close', (code) => {
+        if (finished) return;
+        finished = true;
+        clearTimeout(timer);
+
+        msg.payload = stdout.trim();
+        msg.stderr = stderr.trim();
+        msg.exitCode = code;
+
+        if (code === 0) {
+          node.status({ fill: 'green', shape: 'dot', text: 'ok' });
+        } else {
+          node.status({ fill: 'yellow', shape: 'ring', text: 'código ' + code });
+        }
+
+        send(msg);
+        if (done) done();
+      });
+    });
+
+    node.on('close', function () {
+      node.status({});
+    });
+  }
+
+  RED.nodes.registerType('iit-exec-win', IitExecWinNode);
+};

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "node-red-contrib-iit-execwin",
+  "version": "0.1.0",
+  "description": "Nodo Node-RED para ejecutar comandos PowerShell/CMD en Windows, con salida estructurada",
+  "keywords": ["node-red", "exec", "windows", "powershell", "iit"],
+  "node-red": {
+    "nodes": {
+      "iit-exec-win": "iit-exec-win.js"
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "MIT",
+  "author": "Jairo Sepúlveda",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/infraestructura-it/node-red-contrib-iit-execwin.git"
+  }
+}