n8n-nodes-while-loop 0.1.0

package/dist/index.js

@@ -0,0 +1,2 @@
+"use strict";
+module.exports = {};

package/dist/nodes/WhileLoop/WhileLoop.node.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhileLoop = void 0;
+const { NodeApiError } = require("n8n-workflow");
+class WhileLoop {
+    constructor() {
+        this.description = {
+            displayName: "While Loop",
+            name: "whileLoop",
+            icon: "file:icon.svg",
+            group: ["transform"],
+            version: 1,
+            description: "Control-flow node to loop until a condition is false",
+            defaults: {
+                name: "While Loop",
+            },
+            inputs: ["main"],
+            outputs: ["main", "main"],
+            outputNames: ["Continue", "Done"],
+            properties: [
+                {
+                    displayName: "Mode",
+                    name: "mode",
+                    type: "options",
+                    options: [
+                        { name: "Counter", value: "counter", description: "Loop a fixed number of times" },
+                        { name: "Expression", value: "expression", description: "Loop while an expression is true" },
+                    ],
+                    default: "counter",
+                    description: "How to decide whether to continue the loop",
+                },
+                {
+                    displayName: "Max Iterations",
+                    name: "maxIterations",
+                    type: "number",
+                    default: 5,
+                    typeOptions: { minValue: 1, maxValue: 100000 },
+                    description: "Safety cap to prevent infinite loops",
+                },
+                {
+                    displayName: "Condition Expression",
+                    name: "conditionExpression",
+                    type: "string",
+                    typeOptions: { rows: 2 },
+                    default: "={{$json.counter < 5}}",
+                    description: "n8n expression that must evaluate to true to continue looping. You can use {{$loop.iteration}}.",
+                    displayOptions: { show: { mode: ["expression"] } },
+                },
+                {
+                    displayName: "Add Loop Metadata",
+                    name: "addMeta",
+                    type: "boolean",
+                    default: true,
+                    description: "Whether to add loop info (loopIteration, loopFirst, loopMax) to each item",
+                },
+            ],
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const mode = this.getNodeParameter("mode", 0, "counter");
+        const maxIterations = this.getNodeParameter("maxIterations", 0, 5);
+        const addMeta = this.getNodeParameter("addMeta", 0, true);
+        const conditionExpression = mode === "expression"
+            ? this.getNodeParameter("conditionExpression", 0, "")
+            : "";
+        const state = this.getWorkflowStaticData("execution");
+        const nodeKey = this.getNode().id;
+        state.__whileLoop = state.__whileLoop || {};
+        const loopState = state.__whileLoop[nodeKey] || { iteration: 0 };
+        const continueItems = [];
+        const doneItems = [];
+        for (let i = 0; i < items.length; i++) {
+            let iteration = loopState.iteration || 0;
+            let shouldContinue = false;
+            if (mode === "counter") {
+                shouldContinue = iteration < maxIterations;
+            }
+            else {
+                try {
+                    const exprResult = this.evaluateExpression(conditionExpression, i, items[i], { $loop: { iteration } });
+                    shouldContinue = Boolean(exprResult) && iteration < maxIterations;
+                }
+                catch (error) {
+                    throw new NodeApiError(this.getNode(), error);
+                }
+            }
+            if (shouldContinue) {
+                const newItem = { ...items[i] };
+                if (addMeta) {
+                    newItem.json = {
+                        ...newItem.json,
+                        loopIteration: iteration,
+                        loopFirst: iteration === 0,
+                        loopMax: maxIterations,
+                    };
+                }
+                continueItems.push(newItem);
+                loopState.iteration = iteration + 1;
+            }
+            else {
+                // reset state for next execution
+                delete state.__whileLoop[nodeKey];
+                doneItems.push(items[i]);
+            }
+        }
+        if (continueItems.length) {
+            state.__whileLoop[nodeKey] = loopState;
+        }
+        else {
+            delete state.__whileLoop[nodeKey];
+        }
+        return [continueItems, doneItems];
+    }
+}
+exports.WhileLoop = WhileLoop;

package/dist/nodes/icon.svg

@@ -0,0 +1,10 @@
+<svg width="60" height="60" viewBox="0 0 60 60" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_23_4)">
+<path d="M12.92 41.2178C14.89 44.5412 17.735 47.2218 21.1251 48.9486C24.5151 50.6753 28.3113 51.3776 32.0735 50.974C35.8356 50.5703 39.4094 49.0772 42.3806 46.6679C45.3517 44.2586 47.5984 41.0317 48.86 37.3616H55.8267C54.5483 42.4471 51.8794 47.0485 48.1365 50.6198C44.3937 54.1911 39.734 56.5823 34.7104 57.5098C29.6868 58.4373 24.5102 57.8621 19.7947 55.8524C15.0791 53.8428 11.0227 50.4831 8.10667 46.1719L0 54.5156V33.9308H20L12.92 41.2178ZM47.0833 19.7787C45.1123 16.4549 42.2663 13.7741 38.8752 12.0473C35.4841 10.3205 31.687 9.61836 27.924 10.0224C24.161 10.4264 20.5863 11.9199 17.6145 14.3299C14.6427 16.7398 12.3954 19.9674 11.1333 23.6384H4.16667C5.44454 18.5509 8.11366 13.9475 11.8573 10.3745C15.6009 6.80149 20.2619 4.4089 25.2871 3.48066C30.3123 2.55242 35.4908 3.12749 40.208 5.13763C44.9252 7.14777 48.983 10.5086 51.9 14.8212L60 6.4844V27.0692H40L47.0833 19.7787Z" fill="#983030"/>
+</g>
+<defs>
+<clipPath id="clip0_23_4">
+<rect width="60" height="55" fill="white" transform="translate(0 3)"/>
+</clipPath>
+</defs>
+</svg>

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "n8n-nodes-while-loop",
+  "version": "0.1.0",
+  "description": "Simple while-loop control node for n8n with counter or expression conditions",
+  "keywords": [
+    "n8n-community-node-package",
+    "loop",
+    "control",
+    "while"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Custom integration scaffold"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "peerDependencies": {
+    "n8n-core": "*",
+    "n8n-workflow": "*"
+  },
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "nodes": [
+      "dist/nodes/WhileLoop/WhileLoop.node.js"
+    ]
+  }
+}