@team-supercharge/oasg 18.3.2 → 18.3.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@team-supercharge/oasg",
-  "version": "18.3.2",
+  "version": "18.3.3",
   "description": "Node-based tool to lint OpenAPI documents and generate clients, servers and documentation from them",
   "author": "Supercharge",
   "license": "MIT",

package/targets/dotnet-webapi-system-text-json/README.md

@@ -18,9 +18,11 @@ there are no `I{ApiName}` interfaces in that mode.
 Everything lives in a single `EndpointRouteBuilderExtensions.cs`:
 
 - A **request wrapper** record per operation, bundling every parameter:
-  `AddPetRequest(Pet pet)`, `GetPetByIdRequest(long petId)`,
-  `UploadFileRequest(long petId, string? additionalMetadata, Stream? body)`, …
-  A distinct type per operation, so request/response pairs never collide.
+  `AddPetRequest(Pet Body)`, `GetPetByIdRequest(long PetId)`,
+  `UploadFileRequest(long PetId, string? AdditionalMetadata, Stream? Body)`, …
+  A distinct type per operation, so request/response pairs never collide. The
+  body parameter (if any) is always named `Body`, regardless of its schema
+  name, so it can never collide with the wrapper's own name.
 - **`Map{ApiName}Endpoints(this IEndpointRouteBuilder)`** (one per API, e.g.
   `MapPetApiEndpoints`) — maps that API's operations as minimal-API endpoints
   that invoke the request through Wolverine and return the result
@@ -125,7 +127,7 @@ public class PetHandlers
 {
     // Operation with a response body -> return the response model
     public Task<Pet> Handle(AddPetRequest request)
-        => Task.FromResult(request.Pet);
+        => Task.FromResult(request.Body);
 
     public async Task<Pet> Handle(GetPetByIdRequest request)
         => await _repository.GetAsync(request.PetId)

package/targets/dotnet-webapi-system-text-json/templates/minimalEndpoints.mustache

@@ -41,7 +41,8 @@ namespace {{packageName}}
 {{#operations}}
 {{#operation}}
     /// <summary>Wolverine request for {{classname}}.{{operationId}}, carrying every parameter.</summary>
-    public record {{operationId}}Request({{#allParams}}{{>paramType}} {{#lambda.pascalcase}}{{paramName}}{{/lambda.pascalcase}}{{^-last}}, {{/-last}}{{/allParams}});
+    /// <remarks>The body parameter is always named <c>Body</c>, regardless of its schema name, so it can never collide with the enclosing record's own name (see CS0542).</remarks>
+    public record {{operationId}}Request({{#allParams}}{{>paramType}} {{#isBodyParam}}Body{{/isBodyParam}}{{^isBodyParam}}{{#lambda.pascalcase}}{{paramName}}{{/lambda.pascalcase}}{{/isBodyParam}}{{^-last}}, {{/-last}}{{/allParams}});
 {{/operation}}
 {{/operations}}
 {{/apis}}