Return a Response<T> object instead of <T>

Author: ns-vasilev

Sources/NetworkLayer/Classes/Core/Services/RequestProcessor/RequestProcessor.swift

@@ -156,9 +156,8 @@ extension RequestProcessor: IRequestProcessor {
         strategy: RetryPolicyStrategy? = nil,
         delegate: URLSessionDelegate? = nil,
         configure: ((inout URLRequest) throws -> Void)? = nil
-    ) async throws -> M {
+    ) async throws -> Response<M> {
         let response = try await performRequest(request, strategy: strategy, delegate: delegate, configure: configure)
-        let item = try configuration.jsonDecoder.decode(M.self, from: response.data)
-        return item
+        return try response.map { data in try self.configuration.jsonDecoder.decode(M.self, from: data) }
     }
 }

Sources/NetworkLayer/Classes/Extensions/Response+Map.swift

@@ -0,0 +1,13 @@
+//
+// network-layer
+// Copyright © 2023 Space Code. All rights reserved.
+//
+
+import Foundation
+import NetworkLayerInterfaces
+
+extension Response {
+    func map<U>(_ closure: @escaping (T) throws -> U) rethrows -> Response<U> {
+        try Response<U>(data: closure(data), response: response, task: task)
+    }
+}

Sources/NetworkLayerInterfaces/Classes/Core/Models/Response.swift

@@ -5,12 +5,26 @@
 
 import Foundation
 
+/// A generic struct representing an HTTP response.
 public struct Response<T> {
+    /// The data associated with the response.
     public let data: T
+
+    /// The URL response received.
     public let response: URLResponse
+
+    /// The URLSessionTask associated with the response.
     public let task: URLSessionTask
+
+    /// The HTTP status code of the response, if available.
     public let statusCode: Int?
 
+    /// Initializes a new instance of `Response`.
+    ///
+    /// - Parameters:
+    ///   - data: The data associated with the response.
+    ///   - response: The URL response received.
+    ///   - task: The URLSessionTask associated with the response.
     public init(data: T, response: URLResponse, task: URLSessionTask) {
         self.data = data
         self.response = response

Sources/NetworkLayerInterfaces/Classes/Core/Services/IRequestProcessor.swift

@@ -23,7 +23,7 @@ public protocol IRequestProcessor {
         strategy: RetryPolicyStrategy?,
         delegate: URLSessionDelegate?,
         configure: ((inout URLRequest) throws -> Void)?
-    ) async throws -> M
+    ) async throws -> Response<M>
 }
 
 extension IRequestProcessor {
@@ -34,7 +34,7 @@ extension IRequestProcessor {
     func send<T: IRequest, M: Decodable>(
         _ request: T,
         strategy: RetryPolicyStrategy?
-    ) async throws -> M {
+    ) async throws -> Response<M> {
         try await send(request, strategy: strategy, delegate: nil, configure: nil)
     }
 }

Tests/NetworkLayerTests/UnitTests/RequestProcessorTests.swift

@@ -70,7 +70,7 @@ final class RequestProcessorTests: XCTestCase {
 
         // when
         do {
-            let _ = try await sut.send(request) as Int
+            let _ = try await sut.send(request) as Response<Int>
         } catch {}
 
         // then
@@ -88,7 +88,7 @@ final class RequestProcessorTests: XCTestCase {
 
         // when
         do {
-            let _ = try await sut.send(request) as Int
+            let _ = try await sut.send(request) as Response<Int>
         } catch {}
 
         // then
@@ -107,7 +107,7 @@ final class RequestProcessorTests: XCTestCase {
 
         // when
         do {
-            let _ = try await sut.send(request) as Int
+            let _ = try await sut.send(request) as Response<Int>
         } catch {}
 
         // then
@@ -125,7 +125,7 @@ final class RequestProcessorTests: XCTestCase {
 
         // when
         do {
-            let _ = try await sut.send(request) as Int
+            let _ = try await sut.send(request) as Response<Int>
         } catch {}
 
         // then