🔀 ProductInfo에 필요한 네트워크 관련 작업 (#44)

* 📦️ ProductInfoAPI Package 디렉토리 추가

* ✨ ProductInfoEndPoint 추가 및 구현

* 🌱 ProductInfoPriceResponse DTO 구현

* 🌱 Mock 데이터 추가 및 패키지 설정

* 🌱 ProductInfoURLProtocol 구현

* 🌱 ProductPrice Entity 추가

* ✨ ProductInfoService 구현

* 🎨 SwiftFormat 형식으로 코드 컨벤션 정리

* 🌱 Product.init(dto:) private 해제 및 파일 이동

* 🌱 요청 사항 수정

- ProductDetailResponse DTO 추가
- 같은 모듈내에서 참조하는 것을 방지

* 🌱 요청 사항 수정 및 날짜 변환 코드 추가

- init(decoder:) 제거
- ProductPrice init(dto:) 날짜 변환 코드 추가

* 🌱 요청 사항 수정

- ProductPrice, yearMonth으로 변수 네이밍 변경
- 불필요한 접근 제어 제거
- 불필요한 코드 간략화
- ProductDetail, Entity 추가 및 적용
- ResponseDTO 날짜 값 iso8601으로 변경

* 🌱 요청 사항 수정

- 이니셜라이저에 불필요한 코드 제거

* 🌱 요청 사항 수정

- 불필요한 접근제어 삭제

Author: eung7

APIService/Package.swift

@@ -14,6 +14,14 @@ let package = Package(
       name: "HomeAPISupport",
       targets: ["HomeAPISupport"]
     ),
+    .library(
+      name: "ProductInfoAPI",
+      targets: ["ProductInfoAPI"]
+    ),
+    .library(
+      name: "ProductInfoAPISupport",
+      targets: ["ProductInfoAPISupport"]
+    ),
   ],
   dependencies: [
     .package(path: "../Core"),
@@ -34,5 +42,19 @@ let package = Package(
       ],
       resources: [.process("Mocks")]
     ),
+    .target(
+      name: "ProductInfoAPI",
+      dependencies: [
+        .product(name: "Network", package: "Core"),
+        .product(name: "Entity", package: "Entity"),
+      ]
+    ),
+    .target(
+      name: "ProductInfoAPISupport",
+      dependencies: [
+        "ProductInfoAPI",
+      ],
+      resources: [.process("Mocks")]
+    ),
   ]
 )

APIService/Sources/HomeAPI/Responses/ProductResponse.swift

@@ -8,6 +8,8 @@
 import Entity
 import Foundation
 
+// MARK: - ProductResponse
+
 struct ProductResponse: Decodable {
   let id: Int
   let imageURL: URL

APIService/Sources/ProductInfoAPI/ProductInfoEndPoint.swift

@@ -0,0 +1,41 @@
+//
+//  ProductInfoEndPoint.swift
+//
+//
+//  Created by 김응철 on 2/5/24.
+//
+
+import Foundation
+import Network
+
+// MARK: - ProductInfoEndPoint
+
+public enum ProductInfoEndPoint {
+  case fetchProduct(Int)
+  case fetchPrices(Int)
+}
+
+// MARK: EndPoint
+
+extension ProductInfoEndPoint: EndPoint {
+  public var method: HTTPMethod {
+    .get
+  }
+
+  public var path: String {
+    switch self {
+    case let .fetchProduct(productID):
+      "/v2/products/\(productID)"
+    case let .fetchPrices(productID):
+      "/v2/products/\(productID)/price-history"
+    }
+  }
+
+  public var parameters: HTTPParameter {
+    .plain
+  }
+
+  public var headers: [String: String] {
+    ["Content-Type": "application/json"]
+  }
+}

APIService/Sources/ProductInfoAPI/ProductInfoService.swift

@@ -0,0 +1,62 @@
+//
+//  ProductInfoService.swift
+//
+//
+//  Created by 김응철 on 2/5/24.
+//
+
+import Entity
+import Foundation
+import Network
+
+// MARK: - ProductInfoServiceRepresentable
+
+public protocol ProductInfoServiceRepresentable {
+  func fetchProduct(productID: Int) async throws -> ProductDetail
+  func fetchProductPrice(productID: Int) async throws -> [ProductPrice]
+}
+
+// MARK: - ProductInfoService
+
+public struct ProductInfoService {
+  private let network: Networking
+
+  public init(network: Networking) {
+    self.network = network
+  }
+}
+
+// MARK: ProductInfoServiceRepresentable
+
+extension ProductInfoService: ProductInfoServiceRepresentable {
+  public func fetchProduct(productID _: Int) async throws -> ProductDetail {
+    let productResponse: ProductDetailResponse = try await network.request(with: ProductInfoEndPoint.fetchProduct(0))
+    return ProductDetail(dto: productResponse)
+  }
+
+  public func fetchProductPrice(productID _: Int) async throws -> [ProductPrice] {
+    let productPrice: [ProductPriceResponse] = try await network.request(
+      with: ProductInfoEndPoint.fetchPrices(0)
+    )
+    return productPrice.map(ProductPrice.init)
+  }
+}
+
+private extension ProductPrice {
+  init(dto: ProductPriceResponse) {
+    self.init(date: dto.date, price: dto.price)
+  }
+}
+
+private extension ProductDetail {
+  init(dto: ProductDetailResponse) {
+    self.init(
+      id: dto.id,
+      imageURL: dto.imageURL,
+      price: dto.price,
+      name: dto.name,
+      promotion: dto.promotion,
+      convenienceStore: dto.convenienceStore
+    )
+  }
+}

APIService/Sources/ProductInfoAPI/Responses/ProductDetailResponse.swift

@@ -0,0 +1,27 @@
+//
+//  ProductDetailResponse.swift
+//
+//
+//  Created by 김응철 on 2/5/24.
+//
+
+import Entity
+import Foundation
+
+struct ProductDetailResponse: Decodable {
+  let id: Int
+  let imageURL: URL
+  let price: Int
+  let name: String
+  let promotion: Promotion
+  let convenienceStore: ConvenienceStore
+
+  enum CodingKeys: String, CodingKey {
+    case id
+    case imageURL = "image_url"
+    case price
+    case name
+    case promotion
+    case convenienceStore
+  }
+}

APIService/Sources/ProductInfoAPI/Responses/ProductPriceResponse.swift

@@ -0,0 +1,13 @@
+//
+//  ProductPriceResponse.swift
+//
+//
+//  Created by 김응철 on 2/5/24.
+//
+
+import Foundation
+
+struct ProductPriceResponse: Decodable {
+  let date: Date
+  let price: Int
+}

APIService/Sources/ProductInfoAPISupport/Mocks/ProductPriceResponse.json

@@ -0,0 +1,14 @@
+[
+ {
+  "date": "2023-12-06T00:42:21Z"
+  "price": 1100
+},
+{
+  "date": "2024-01-06T00:42:21Z"
+  "price": 1200
+},
+{
+  "date": "2024-02-06T00:42:21Z"
+  "price": 1250
+}
+ ]

APIService/Sources/ProductInfoAPISupport/ProductInfoURLProtocol.swift

@@ -0,0 +1,46 @@
+//
+//  ProductInfoURLProtocol.swift
+//
+//
+//  Created by 김응철 on 2/5/24.
+//
+
+import Foundation
+import Network
+import ProductInfoAPI
+
+public final class ProductInfoURLProtocol: URLProtocol {
+  private lazy var mockData: [String: Data?] = [
+    ProductInfoEndPoint.fetchProduct(0).path: loadMockData(fileName: "HomeProductResponse"),
+    ProductInfoEndPoint.fetchPrices(0).path: loadMockData(fileName: "ProductPriceResponse"),
+  ]
+
+  override public class func canInit(with _: URLRequest) -> Bool {
+    true
+  }
+
+  override public class func canonicalRequest(for request: URLRequest) -> URLRequest {
+    request
+  }
+
+  override public func startLoading() {
+    defer { client?.urlProtocolDidFinishLoading(self) }
+    if let url = request.url,
+       let mockData = mockData[url.path(percentEncoded: true)],
+       let data = mockData,
+       let response = HTTPURLResponse(url: url, statusCode: 200, httpVersion: nil, headerFields: nil) {
+      client?.urlProtocol(self, didReceive: response, cacheStoragePolicy: .notAllowed)
+      client?.urlProtocol(self, didLoad: data)
+    } else {
+      client?.urlProtocol(self, didFailWithError: NetworkError.urlError)
+    }
+  }
+
+  private func loadMockData(fileName: String) -> Data? {
+    guard let url = Bundle.module.url(forResource: fileName, withExtension: "json")
+    else {
+      return nil
+    }
+    return try? Data(contentsOf: url)
+  }
+}

Entity/Sources/Entity/Product.swift

@@ -7,7 +7,7 @@
 
 import Foundation
 
-/// 편의점 행사 제품에 대한 Entity Model입니다.
+/// 편의점 행사 제품 리스트에 대한 Entity Model입니다.
 public struct Product: Identifiable {
   /// 제품 고유 Identifier
   public let id: Int

Entity/Sources/Entity/ProductDetail.swift

@@ -0,0 +1,47 @@
+//
+//  ProductDetail.swift
+//
+//
+//  Created by 김응철 on 2/6/24.
+//
+
+import Foundation
+
+/// 편의점 행사 제품에 대한 Entity Model입니다.
+public struct ProductDetail: Identifiable {
+  /// 제품 고유 Identifier
+  public let id: Int
+
+  /// 이미지 URL
+  public let imageURL: URL
+
+  /// 제품 가격
+  public let price: Int
+
+  /// 제품명
+  public let name: String
+
+  /// 행사 정보
+  public let promotion: Promotion
+
+  /// 편의점
+  public let convenienceStore: ConvenienceStore
+
+  // TODO: 카테고리 상수 추가하기
+
+  public init(
+    id: Int,
+    imageURL: URL,
+    price: Int,
+    name: String,
+    promotion: Promotion,
+    convenienceStore: ConvenienceStore
+  ) {
+    self.id = id
+    self.imageURL = imageURL
+    self.price = price
+    self.name = name
+    self.promotion = promotion
+    self.convenienceStore = convenienceStore
+  }
+}