Create Bruno Request

Previous value: -"multipart/form-data parts, for body.type \"form-data\" or \"multipart-form\"."New value: +"Key/value parts, and the only field here that carries them: multipart/form-data parts for body.type \"form-data\" or \"multipart-form\", and the pairs of a \"form-urlencoded\" body, which read_request returns under formUrlEncoded rather than here (a form-urlencoded body can also be given as an encoded string in `content`). The per-entry type and contentType describe a multipart part and are rejected on a form-urlencoded body, where every pair is text and neither field is stored: pass type \"file\" or a contentType there and the call fails rather than writing a request that drops them."

Previous value: -"Inline scripts to persist with the request. Keys: pre-request, post-response, tests (aliases before-request/after-response accepted). Avoids a separate add_test_script call. IMPORTANT for tests/post-response: only assertions inside a test() block are reported. Write test(\"status is 200\", function() { expect(res.getStatus()).to.equal(200); }); — a bare expect() at the top level still runs, but a passing one records nothing, so run_collection reports \"tests\": [] and the request looks green with no assertions. Available in scripts: res.getStatus()/getStatusText()/getHeader(name)/getHeaders()/getBody()/getResponseTime(), bru.setVar(name, value)/getVar(name), and expect(actual) with .to.equal/.contain/.include, .to.have.property/.lengthOf, .to.be.a/.an, .to.be.above/.below/.at.least/.at.most (aliases .gt/.lt/.gte/.lte/.greaterThan/.lessThan), .to.be.within(min, max), .to.be.oneOf([...]), .to.match(/re/), .to.startWith/.endWith, .to.be.true/.false/.null/.undefined/.empty/.json,and .to.not.* negations. RETURN TYPE: res.getBody() returns the response already parsed into a JS object/array when the Content-Type is application/json or a +json type (raw text otherwise). Access fields directly — res.getBody().field — and do NOT JSON.parse() it, which throws SyntaxError: \"[object Object]\" is not valid JSON."New value: +"Inline scripts to persist with the request. Keys: pre-request, post-response, tests (aliases before-request/after-response accepted). Avoids a separate add_test_script call. IMPORTANT for tests/post-response: only assertions inside a test() block are reported. Write test(\"status is 200\", function() { expect(res.getStatus()).to.equal(200); }); — a bare expect() at the top level still runs, but a passing one records nothing, so run_collection reports \"tests\": [] and the request looks green with no assertions. Available in scripts: res.getStatus()/getStatusText()/getHeader(name)/getHeaders()/getBody()/getResponseTime(), res.getStopReason()/getCloseCode()/getSessionTruncated() on a websocket request, which report the same session outcome the result does (all null or false on an HTTP response, which has no session), bru.setVar(name, value)/getVar(name)/getEnvVar(name)/hasEnvVar(name), and expect(actual) with .to.equal/.contain/.include, .to.have.property/.lengthOf, .to.be.a/.an, .to.be.above/.below/.at.least/.at.most (aliases .gt/.lt/.gte/.lte/.greaterThan/.lessThan), .to.be.within(min, max), .to.be.oneOf([...]), .to.match(/re/), .to.startWith/.endWith, .to.be.true/.false/.null/.undefined/.empty/.json,and .to.not.* negations. VARIABLES: bru.getVar(name) resolves environment and collection variables as well as anything a script set, so an environment variable needs no shadow copy to be readable. bru.getEnvVar(name) is narrower on purpose: it reads the environment layer only, so a runtime variable of the same name does not shadow it. There is no setEnvVar — nothing here writes an environment file. RETURN TYPE: res.getBody() returns the response already parsed into a JS object/array when the Content-Type is application/json or a +json type (raw text otherwise). Access fields directly — res.getBody().field — and do NOT JSON.parse() it, which throws SyntaxError: \"[object Object]\" is not valid JSON."

Added value: +{
+  "description": "WebSocket requests only: milliseconds between the pings Bruno sends to hold the connection open, where 0 means never. A .yml WebSocket request always carries the key and records an unset value as 0, so this is how you change it; on .bru it is written only when you supply it. It is read back by read_request either way. This server's own runner sends no periodic pings of its own — it answers a ping the peer sends and records both frames — so the value is carried for Bruno rather than acted on here.",
+  "minimum": 0,
+  "type": "integer"
+}

Previous value: -"Milliseconds, capping two separate things. The HTTP request itself, which defaults to 30000ms when unset. And the per-script budget shared by pre-request, post-response and tests code, including time spent in bru.sleep, setTimeout and setInterval, which defaults to 5000ms when unset — a script that waits longer than its budget is aborted, and setting this is the only way to lift that 5000ms cap. 0 means no timeout at all."New value: +"Milliseconds, capping two separate things — and 0 does not mean the same to both. The request itself: 0 means no deadline at all, and the 30000ms default is reached only by a request whose file carries no timeout key, which a .yml request written here never does (that dialect always writes a fully resolved settings block, and an unset timeout is written as 0). So pass a positive value if you want a deadline on a .yml request. And the per-script budget shared by pre-request, post-response and tests code, including time spent in bru.sleep, setTimeout and setInterval: that one cannot be switched off, so 0 and an unset timeout both leave it at its 5000ms default, and a positive value is the only way to raise it. A script that waits longer than its budget is aborted."

Previous value: -"Whether the message is sent. Defaults to true, and is always written, because a .yml message without it is one Bruno will not send. A false is refused in a .bru collection, which cannot record it."New value: +"Whether the message is sent. Defaults to true, and is written for every message that is sent, because a message without it is one Bruno will not send. A false is written as such in .yml; .bru can only record it by omitting the flag, which reads back as absent rather than false."

Added value: +{
+  "additionalProperties": false,
+  "description": "gRPC-only fields. Applies to kind \"grpc\" and is refused otherwise. Headers given for a gRPC request are written as metadata, which is that transport's only header surface.",
+  "properties": {
+    "messages": {
+      "description": "Request messages. A unary call uses the first.",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "content": {
+            "description": "The payload as JSON text. Empty content is written as {}, as Bruno writes it.",
+            "type": "string"
+          },
+          "title": {
+            "description": "Name of the message. Defaults to \"message N\" by position, as Bruno does.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "content"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "method": {
+      "description": "The fully qualified RPC method, e.g. \"/greet.Greeter/SayHello\". Not an HTTP verb, which is why it is here and not in the top-level method argument.",
+      "type": "string"
+    },
+    "methodType": {
+      "description": "The RPC shape. All four are written, because Bruno writes all four; note that this server can only run \"unary\" today, so the others author a request Bruno can send and run_collection will refuse.",
+      "enum": [
+        "unary",
+        "client-streaming",
+        "server-streaming",
+        "bidi-streaming"
+      ],
+      "type": "string"
+    },
+    "protoPath": {
+      "description": "The .proto file describing the service, relative to the collection. Must already exist inside the collection: a path resolving outside it is refused, symlinks included, as is one whose imports leave it however many hops in. Stored relative to the collection whichever spelling is given, so the request survives being cloned elsewhere.",
+      "type": "string"
+    }
+  },
+  "type": "object"
+}

Added value: +{
+  "description": "Transport. Defaults to \"http\". \"websocket\" and \"grpc\" take no method and no body; their payloads are websocket.messages and grpc.messages.",
+  "enum": [
+    "http",
+    "websocket",
+    "grpc"
+  ],
+  "type": "string"
+}

Added value: +"Required for kind \"http\", refused for \"websocket\" and \"grpc\", which have no HTTP method. A gRPC request names its RPC method in grpc.method."

Added value: +{
+  "additionalProperties": false,
+  "description": "WebSocket-only fields. Applies to kind \"websocket\" and is refused otherwise.",
+  "properties": {
+    "messages": {
+      "description": "Messages sent in order once the socket is open.",
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "content": {
+            "description": "The payload, sent verbatim after variable substitution.",
+            "type": "string"
+          },
+          "selected": {
+            "description": "Whether the message is sent. Defaults to true, and is always written, because a .yml message without it is one Bruno will not send. A false is refused in a .bru collection, which cannot record it.",
+            "type": "boolean"
+          },
+          "title": {
+            "description": "Name of the message. Defaults to \"message N\" by position, as Bruno does.",
+            "type": "string"
+          },
+          "type": {
+            "description": "How Bruno's editor should treat the payload: text, json or xml. Nothing validates it, and every frame is sent as text — there is no binary send path.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "content"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "type": "object"
+}

Previous value: -[
-  "collectionPath",
-  "name",
-  "method",
-  "url"
-]New value: +[
+  "collectionPath",
+  "name",
+  "url"
+]