feat: enhance http_request_send and rest_control_respond proto files for improved parameter clarity and naming consistency

Author: nicosammito

definitions/draco_rest/runtime_functions/rest_control_respond.proto.json

@@ -2,23 +2,59 @@
   "runtimeName": "rest::control::respond",
   "runtimeParameterDefinitions": [
     {
-      "runtimeName": "http_response",
+      "runtimeName": "http_status_code",
+      "defaultValue": null,
       "name": [
         {
           "code": "en-US",
-          "content": "Http Response"
+          "content": "HTTP Status Code"
         }
       ],
       "description": [
         {
           "code": "en-US",
-          "content": "Takes an HTTP response object and transmits it to the requesting client. This parameter represents the final output of the server, including headers, status code, and body content."
+          "content": "An HTTP status code is a three-digit number (100–599) indicating the result of a request (e.g., 200, 404, 500)."
+        }
+      ],
+      "documentation": []
+    },
+    {
+      "runtimeName": "headers",
+      "defaultValue": null,
+      "name": [
+        {
+          "code": "en-US",
+          "content": "HTTP response headers"
+        }
+      ],
+      "description": [
+        {
+          "code": "en-US",
+          "content": "A collection of key-value pairs containing additional response metadata."
+        }
+      ],
+      "documentation": []
+    },
+    {
+      "runtimeName": "payload",
+      "defaultValue": null,
+      "name": [
+        {
+          "code": "en-US",
+          "content": "Response Payload"
+        }
+      ],
+      "description": [
+        {
+          "code": "en-US",
+          "content": "Contains the response payload, such as JSON, XML, form data, or binary content, depending on the Content-Type header."
         }
       ],
       "documentation": []
     }
   ],
   "deprecationMessage": [],
+  "throwsError": false,
   "name": [
     {
       "code": "en-US",
@@ -41,11 +77,13 @@
   "displayMessage": [
     {
       "code": "en-US",
-      "content": "Sends ${http_response} as a Response"
+      "content": "Sends response with status ${http_status_code} and payload ${payload}"
     }
   ],
-  "throwsError": false,
   "displayIcon": "tabler:cube-sent",
-  "linkedDataTypeIdentifiers": ["HTTP_RESPONSE"],
-  "signature": "<T>(http_response: HTTP_RESPONSE<T>): void"
+  "signature": "<T>(http_status_code: HTTP_STATUS_CODE, headers: OBJECT<{}>, payload: T): void",
+  "linkedDataTypeIdentifiers": [
+    "HTTP_STATUS_CODE",
+    "OBJECT"
+  ]
 }

definitions/taurus/http/runtime_functions/http_request_create.proto.json

@@ -2,18 +2,69 @@
   "runtimeName": "http::request::send",
   "runtimeParameterDefinitions": [
     {
-      "runtimeName": "http_request",
+      "runtimeName": "http_method",
       "defaultValue": null,
       "name": [
         {
           "code": "en-US",
-          "content": "HTTP request object"
+          "content": "HTTP Method"
         }
       ],
       "description": [
         {
           "code": "en-US",
-          "content": "Takes an HTTP request object, which includes the HTTP method, url, headers, and payload, and sends it to the specified endpoint."
+          "content": "Defines the HTTP method to be used, such as GET, POST, PUT, or DELETE."
+        }
+      ],
+      "documentation": []
+    },
+    {
+      "runtimeName": "headers",
+      "defaultValue": null,
+      "name": [
+        {
+          "code": "en-US",
+          "content": "HTTP Headers"
+        }
+      ],
+      "description": [
+        {
+          "code": "en-US",
+          "content": "A collection of key-value pairs containing additional request metadata."
+        }
+      ],
+      "documentation": []
+    },
+    {
+      "runtimeName": "url",
+      "defaultValue": null,
+      "name": [
+        {
+          "code": "en-US",
+          "content": "Request URL"
+        }
+      ],
+      "description": [
+        {
+          "code": "en-US",
+          "content": "Specifies the endpoint address, including protocol, host, path, and query parameters, where the request is directed."
+        }
+      ],
+      "documentation": []
+    },
+    {
+      "runtimeName": "payload",
+      "defaultValue": null,
+      "name": [
+        {
+          "code": "en-US",
+          "content": "Request Payload"
+        }
+      ],
+      "description": [
+        {
+          "code": "en-US",
+          "content": "Contains the request payload, such as JSON, XML, form data, or binary content, depending on the Content-Type header."
         }
       ],
       "documentation": []
@@ -42,14 +93,16 @@
   "displayMessage": [
     {
       "code": "en-US",
-      "content": "Send request with ${http_request}"
+      "content": "Send request to ${url} with ${payload}"
     }
   ],
   "deprecationMessage": [],
   "displayIcon": "tabler:world-www",
-  "signature": "<T>(http_request: HTTP_REQUEST<T>): HTTP_RESPONSE<any>",
+  "signature": "<T>(http_method: HTTP_METHOD, headers: OBJECT<{}>, url: HTTP_URL, payload: T): HTTP_RESPONSE<any>",
   "linkedDataTypeIdentifiers": [
-    "HTTP_RESPONSE",
-    "HTTP_REQUEST"
+    "HTTP_METHOD",
+    "OBJECT",
+    "HTTP_URL",
+    "HTTP_RESPONSE"
   ]
 }