nlink-community-http-request 1.0.0

package/README.md

@@ -0,0 +1,10 @@
+# nLink Community Node: HTTP Request
+
+Provides the ability to execute API Requests over HTTP/HTTPS protocols with common methods (GET, POST, PUT, DELETE, PATCH).
+
+## Identity
+- **Node name**: `nlink-community.httpRequest`
+- **Group**: `community`, `network`
+
+## Installation and Usage
+This package is built specifically for the nLink Workflow Platform. When published to NPM, nLink Core can automatically download and activate this node.

package/definition.json

@@ -0,0 +1,307 @@
+{
+	"name": "nlink-community.httpRequest",
+	"displayName": "HTTP Request (Community)",
+	"version": "1.0.0",
+	"description": "Makes an HTTP request with configurable method and URL",
+	"group": [
+		"community",
+		"network"
+	],
+	"inputs": [
+		"main"
+	],
+	"outputs": [
+		"main"
+	],
+	"icon": "/static/nodes/nlink-community.httpRequest/icon.svg",
+	"credentialTypes": [
+		"nlink-credential.basicAuth",
+		"nlink-credential.headerAuth",
+		"nlink-credential.jwtAuth"
+	],
+	"properties": [
+		{
+			"displayName": "URL",
+			"name": "url",
+			"type": "string",
+			"required": true,
+			"placeholder": "https://api.example.com/data"
+		},
+		{
+			"displayName": "Method",
+			"name": "method",
+			"type": "options",
+			"default": "GET",
+			"options": [
+				{
+					"name": "GET",
+					"displayName": "GET",
+					"value": "GET"
+				},
+				{
+					"name": "POST",
+					"displayName": "POST",
+					"value": "POST"
+				},
+				{
+					"name": "PUT",
+					"displayName": "PUT",
+					"value": "PUT"
+				},
+				{
+					"name": "DELETE",
+					"displayName": "DELETE",
+					"value": "DELETE"
+				},
+				{
+					"name": "PATCH",
+					"displayName": "PATCH",
+					"value": "PATCH"
+				}
+			]
+		},
+		{
+			"displayName": "Send Headers",
+			"name": "sendHeaders",
+			"type": "boolean",
+			"default": false
+		},
+		{
+			"displayName": "Headers Input Type",
+			"name": "headersInputType",
+			"type": "options",
+			"default": "json",
+			"options": [
+				{
+					"name": "json",
+					"displayName": "JSON",
+					"value": "json"
+				},
+				{
+					"name": "params",
+					"displayName": "Params",
+					"value": "params"
+				}
+			],
+			"displayOptions": {
+				"show": {
+					"sendHeaders": [
+						true
+					]
+				}
+			}
+		},
+		{
+			"displayName": "Headers (JSON)",
+			"name": "headersJson",
+			"type": "string",
+			"default": "{}",
+			"placeholder": "{\"Authorization\": \"Bearer token\"}",
+			"description": "HTTP headers as a JSON object",
+			"displayOptions": {
+				"show": {
+					"sendHeaders": [
+						true
+					],
+					"headersInputType": [
+						"json"
+					]
+				}
+			},
+			"typeOptions": {
+				"rows": 2
+			}
+		},
+		{
+			"displayName": "Headers",
+			"name": "headersParams",
+			"type": "collection",
+			"default": [
+				{
+					"key": "",
+					"value": ""
+				}
+			],
+			"description": "HTTP headers as key-value pairs",
+			"typeOptions": {
+				"multipleValues": true
+			},
+			"displayOptions": {
+				"show": {
+					"sendHeaders": [
+						true
+					],
+					"headersInputType": [
+						"params"
+					]
+				}
+			}
+		},
+		{
+			"displayName": "Send Query",
+			"name": "sendQuery",
+			"type": "boolean",
+			"default": false
+		},
+		{
+			"displayName": "Query Input Type",
+			"name": "queryInputType",
+			"type": "options",
+			"default": "params",
+			"options": [
+				{
+					"name": "json",
+					"displayName": "JSON",
+					"value": "json"
+				},
+				{
+					"name": "params",
+					"displayName": "Params",
+					"value": "params"
+				}
+			],
+			"displayOptions": {
+				"show": {
+					"sendQuery": [
+						true
+					]
+				}
+			}
+		},
+		{
+			"displayName": "Query (JSON)",
+			"name": "queryJson",
+			"type": "string",
+			"default": "{}",
+			"placeholder": "{\"page\": \"1\", \"limit\": \"10\"}",
+			"description": "Query parameters as a JSON object",
+			"displayOptions": {
+				"show": {
+					"sendQuery": [
+						true
+					],
+					"queryInputType": [
+						"json"
+					]
+				}
+			},
+			"typeOptions": {
+				"rows": 2
+			}
+		},
+		{
+			"displayName": "Query Parameters",
+			"name": "queryParams",
+			"type": "collection",
+			"default": [
+				{
+					"key": "",
+					"value": ""
+				}
+			],
+			"description": "URL query parameters as key-value pairs",
+			"typeOptions": {
+				"multipleValues": true
+			},
+			"displayOptions": {
+				"show": {
+					"sendQuery": [
+						true
+					],
+					"queryInputType": [
+						"params"
+					]
+				}
+			}
+		},
+		{
+			"displayName": "Send Body",
+			"name": "sendBody",
+			"type": "boolean",
+			"default": false
+		},
+		{
+			"displayName": "Body Input Type",
+			"name": "bodyInputType",
+			"type": "options",
+			"default": "json",
+			"options": [
+				{
+					"name": "json",
+					"displayName": "JSON",
+					"value": "json"
+				},
+				{
+					"name": "params",
+					"displayName": "Params",
+					"value": "params"
+				}
+			],
+			"displayOptions": {
+				"show": {
+					"sendBody": [
+						true
+					]
+				}
+			}
+		},
+		{
+			"displayName": "Body (JSON)",
+			"name": "body",
+			"type": "string",
+			"default": "{}",
+			"placeholder": "{\"key\": \"value\"}",
+			"description": "Request body as a JSON string",
+			"displayOptions": {
+				"show": {
+					"sendBody": [
+						true
+					],
+					"bodyInputType": [
+						"json"
+					]
+				}
+			},
+			"typeOptions": {
+				"rows": 2
+			}
+		},
+		{
+			"displayName": "Body Parameters",
+			"name": "bodyParams",
+			"type": "collection",
+			"default": [
+				{
+					"key": "",
+					"value": ""
+				}
+			],
+			"description": "Request body as key-value pairs",
+			"typeOptions": {
+				"multipleValues": true
+			},
+			"displayOptions": {
+				"show": {
+					"sendBody": [
+						true
+					],
+					"bodyInputType": [
+						"params"
+					]
+				}
+			}
+		},
+		{
+			"displayName": "Disabled",
+			"name": "disabled",
+			"type": "boolean",
+			"default": false
+		},
+		{
+			"displayName": "Execute Once",
+			"name": "executeOnce",
+			"type": "boolean",
+			"default": false
+		}
+	]
+}

package/execution.js

@@ -0,0 +1,118 @@
+var url = params.url;
+if (!url) {
+	throw "URL is required";
+}
+
+var method = params.method || 'GET';
+
+// 1. Query Params
+if (params.sendQuery) {
+	var queryString = [];
+	if (params.queryInputType === 'json') {
+		var qMap = {};
+		if (typeof params.queryJson === 'string' && params.queryJson) {
+			try { qMap = JSON.parse(params.queryJson); } catch (e) { }
+		} else if (typeof params.queryJson === 'object' && params.queryJson) {
+			qMap = params.queryJson;
+		}
+		for (var k in qMap) {
+			queryString.push(encodeURIComponent(k) + '=' + encodeURIComponent(qMap[k]));
+		}
+	} else {
+		if (Array.isArray(params.queryParams)) {
+			for (var i = 0; i < params.queryParams.length; i++) {
+				var item = params.queryParams[i];
+				if (item && item.key) {
+					queryString.push(encodeURIComponent(item.key) + '=' + encodeURIComponent(item.value || ''));
+				}
+			}
+		}
+	}
+	if (queryString.length > 0) {
+		var separator = url.indexOf('?') === -1 ? '?' : '&';
+		url += separator + queryString.join('&');
+	}
+}
+
+// 2. Headers
+var headers = {};
+if (params.sendHeaders) {
+	if (params.headersInputType === 'json') {
+		var hMap = {};
+		if (typeof params.headersJson === 'string' && params.headersJson) {
+			try { hMap = JSON.parse(params.headersJson); } catch (e) { }
+		} else if (typeof params.headersJson === 'object' && params.headersJson) {
+			hMap = params.headersJson;
+		}
+		for (var k in hMap) {
+			headers[k] = hMap[k];
+		}
+	} else {
+		if (Array.isArray(params.headersParams)) {
+			for (var i = 0; i < params.headersParams.length; i++) {
+				var item = params.headersParams[i];
+				if (item && item.key) {
+					headers[item.key] = item.value || '';
+				}
+			}
+		}
+	}
+}
+
+// 3. Body
+var body = null;
+if (params.sendBody) {
+	if (params.bodyInputType === 'params') {
+		var parts = [];
+		if (Array.isArray(params.bodyParams)) {
+			for (var i = 0; i < params.bodyParams.length; i++) {
+				var item = params.bodyParams[i];
+				if (item && item.key) {
+					parts.push(encodeURIComponent(item.key) + '=' + encodeURIComponent(item.value || ''));
+				}
+			}
+		}
+		body = parts.join('&');
+		if (!headers["Content-Type"]) headers["Content-Type"] = "application/x-www-form-urlencoded";
+	} else {
+		if (typeof params.body === 'object' && params.body !== null) {
+			body = JSON.stringify(params.body);
+		} else if (typeof params.body === 'string' && params.body.trim() !== '') {
+			body = params.body;
+		} else {
+			body = "{}";
+		}
+		if (!headers["Content-Type"]) headers["Content-Type"] = "application/json";
+	}
+}
+
+var resp;
+if (http.request) {
+	resp = http.request(method, url, body, headers);
+} else if (method === 'GET' && http.get) {
+	resp = http.get(url);
+} else if (method === 'POST' && http.post) {
+	resp = http.post(url, body, headers);
+} else {
+	throw "http.request helper method is missing on the server. Please rebuild/restart backend.";
+}
+
+var responseBody = resp.body;
+var parsedData = null;
+try {
+	parsedData = JSON.parse(responseBody);
+} catch (e) {
+	parsedData = responseBody;
+}
+
+$output = {
+	status: resp.status,
+	status_code: resp.status_code,
+	headers: resp.headers,
+	body: responseBody,
+	data: parsedData,
+	request: {
+		method: method,
+		url: url
+	}
+};

package/icon.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 170"><path fill="#fcb400" d="M89 4.8 16.2 34.9c-4.1 1.7-4 7.4.1 9.1l73.2 29c6.4 2.6 13.6 2.6 20 0l73.2-29c4.1-1.6 4.1-7.4.1-9.1l-73-30.1C103.2 2 95.7 2 89 4.8"/><path fill="#18bfff" d="M105.9 88.9v72.5c0 3.4 3.5 5.8 6.7 4.5l81.6-31.7c1.9-.7 3.1-2.5 3.1-4.5V57.2c0-3.4-3.5-5.8-6.7-4.5L109 84.3c-1.9.8-3.1 2.6-3.1 4.6"/><path fill="#f82b60" d="m86.9 92.6-24.2 11.7-2.5 1.2L9.1 130c-3.2 1.6-7.4-.8-7.4-4.4V57.5c0-1.3.7-2.4 1.6-3.3q.6-.6 1.2-.9c1.2-.7 3-.9 4.4-.3l77.5 30.7c4 1.5 4.3 7.1.5 8.9"/><path fill="#ba1e45" d="m86.9 92.6-24.2 11.7-59.4-50q.6-.6 1.2-.9c1.2-.7 3-.9 4.4-.3l77.5 30.7c4 1.4 4.3 7 .5 8.8"/></svg>

package/package.json

@@ -0,0 +1,19 @@
+{
+    "name": "nlink-community-http-request",
+    "version": "1.0.0",
+    "description": "HTTP Request community node for nLink Workflow Platform",
+    "keywords": [
+        "nlink",
+        "nlink-nodes",
+        "community-nodes",
+        "http",
+        "workflow"
+    ],
+    "author": "nLink",
+    "license": "MIT",
+    "nlink": {
+        "nodes": [
+            "nlink-community.httpRequest"
+        ]
+    }
+}