[Repo Assist] refactor: return HttpResponseMessage from CallAsync and align generated response handling (#385)

* fix: expose HTTP response headers via LastResponseHeaders (closes #179)

- Change CallAsync to return Task<HttpResponseMessage> instead of Task<HttpContent>
- Add mutable LastResponseHeaders property to ProvidedApiClientBase so callers
  can inspect response headers after each operation call
- Add collectResponseHeaders helper to RuntimeHelpers
- Update OperationCompiler quotations to use response.Content where content was previously used directly
- Add 4 new unit tests for LastResponseHeaders behaviour

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* ci: trigger checks

* fix: remove LastResponseHeaders and keep CallAsync response return

Agent-Logs-Url: https://github.com/fsprojects/SwaggerProvider/sessions/7b6606ed-f420-4df8-9e59-bbfd17333974

Co-authored-by: sergey-tihon <1197905+sergey-tihon@users.noreply.github.com>

* Update tests/SwaggerProvider.Tests/RuntimeHelpersTests.fs

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: sergey-tihon <1197905+sergey-tihon@users.noreply.github.com>
Co-authored-by: Sergey Tihon <sergey.tihon@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: 5 people

src/SwaggerProvider.DesignTime/OperationCompiler.fs

@@ -432,7 +432,7 @@ type OperationCompiler(schema: OpenApiDocument, defCompiler: DefinitionCompiler,
 
                                 task {
                                     let! response = x
-                                    let! content = RuntimeHelpers.readContentAsString response ct
+                                    let! content = RuntimeHelpers.readContentAsString response.Content ct
                                     return (%this).Deserialize(content, innerReturnType)
                                 }
                             @>
@@ -444,7 +444,7 @@ type OperationCompiler(schema: OpenApiDocument, defCompiler: DefinitionCompiler,
 
                                 task {
                                     let! response = x
-                                    let! data = RuntimeHelpers.readContentAsStream response ct
+                                    let! data = RuntimeHelpers.readContentAsStream response.Content ct
                                     return data
                                 }
                             @>
@@ -456,7 +456,7 @@ type OperationCompiler(schema: OpenApiDocument, defCompiler: DefinitionCompiler,
 
                                 task {
                                     let! response = x
-                                    let! data = RuntimeHelpers.readContentAsString response ct
+                                    let! data = RuntimeHelpers.readContentAsString response.Content ct
                                     return data
                                 }
                             @>

src/SwaggerProvider.Runtime/ProvidedApiClientBase.fs

@@ -46,12 +46,12 @@ type ProvidedApiClientBase(httpClient: HttpClient, options: JsonSerializerOption
 
     member this.CallAsync
         (request: HttpRequestMessage, errorCodes: string[], errorDescriptions: string[], cancellationToken: System.Threading.CancellationToken)
-        : Task<HttpContent> =
+        : Task<HttpResponseMessage> =
         task {
             let! response = this.HttpClient.SendAsync(request, cancellationToken)
 
             if response.IsSuccessStatusCode then
-                return response.Content
+                return response
             else
                 let code = response.StatusCode |> int
                 let codeStr = code |> string

tests/SwaggerProvider.Tests/RuntimeHelpersTests.fs

@@ -563,8 +563,8 @@ module OpenApiExceptionTests =
             use handler = new StubHttpMessageHandler(HttpStatusCode.OK, "result")
             let client = makeClient handler
             use request = new HttpRequestMessage(HttpMethod.Get, "http://stub/pets/1")
-            let! content = client.CallAsync(request, [||], [||], CancellationToken.None)
-            let! body = content.ReadAsStringAsync()
+            use! response = client.CallAsync(request, [||], [||], CancellationToken.None)
+            let! body = response.Content.ReadAsStringAsync()
             body |> shouldEqual "result"
         }
 
@@ -588,7 +588,6 @@ module OpenApiExceptionTests =
             ()
         }
 
-
 /// Test types for formatObject tests — must be plain .NET classes with declared public properties.
 type FmtSingle(name: string) =
     member _.Name = name