[Add] #35 - Auth Endpoint, Token 관리 로직 및 타입 구현

.gitignore

@@ -132,3 +132,6 @@ iOSInjectionProject/
 **/xcshareddata/WorkspaceSettings.xcsettings
 
 # End of https://www.toptal.com/developers/gitignore/api/macos,swift,xcode
+
+# AppSecret
+*.xcconfig

Neki-iOS/Core/Sources/Network/Sources/Base/BaseResponseDTO.swift

@@ -7,10 +7,23 @@
 
 import Foundation
 
-public struct BaseResponseDTO<T: Decodable>: Decodable {
+public struct BaseSucceededResponseDTO<T: Decodable>: Decodable {
     let status: Int
     let message: String
+    let isSuccess: Bool
     let data: T?
+
+    enum CodingKeys: String, CodingKey {
+        case message, data
+        case status = "resultCode"
+        case isSuccess = "success"
+    }
 }
 
 public struct EmptyData: Decodable {}
+
+public struct BaseFailedResponseDTO: Decodable {
+    let status: Int
+    let message: String
+    let timestamp: String
+}

Neki-iOS/Core/Sources/Network/Sources/Base/Endpoint.swift

@@ -7,84 +7,100 @@
 
 import Foundation
 
-public enum HeaderType {
-    case noneHeader
-    case accessTokenHeader
-    case refreshTokenHeader
+/// 인증 타입
+public enum AuthorizationType {
+    /// 별도의 인증이 필요하지 않은 경우
+    case none
+    /// Authorization-Bearer
+    case bearer
+    /// 토큰 재발급
+    ///
+    /// - Important: 토큰 재발급이라는 특수한 용도를 위한 설정입니다. 일반적인 요청에 사용하는 것은 권장하지 않습니다.
+    /// - Authors: SwainYun
+    case reissue
+}
+
+/// Content-Type 종류
+public enum HTTPContentType {
+    case json
+    case multipart(boundary: String)
+    case raw
 }
 
 public protocol Endpoint {
-    var headerType: HeaderType { get }
+    var authorizationType: AuthorizationType { get }
+    var contentType: HTTPContentType { get }
+    var baseURL: String { get }
     var path: String { get }
     var method: HTTPMethodType { get }
+    var queryParameters: [String: String]? { get }
     var body: Encodable? { get }
-    var query: [URLQueryItem]? { get }
+    var multipartItems: [MultipartItem]? { get }
 
     func asURLRequest() throws -> URLRequest
 }
 
 extension Endpoint {
-    static var defaultEncoder: JSONEncoder {
-        let encoder = JSONEncoder()
-        return encoder
-    }
+    public var queryParameters: [String: String]? { nil }
 
-    var baseURL: String {
-        guard let urlString = Bundle.main.infoDictionary?["BASE_URL"] as? String else {
-            fatalError("🚨Base URL을 찾을 수 없습니다🚨")
-        }
-        return urlString
-    }
+    public var multipartItems: [MultipartItem]? { nil }
+
+    static let defaultEncoder: JSONEncoder = JSONEncoder()
 
     public func asURLRequest() throws -> URLRequest {
-        guard let url = URL(string: baseURL)?.appending(path: path),
-              var components = URLComponents(url: url, resolvingAgainstBaseURL: true) else {
+        let encoder = Self.defaultEncoder
+
+        guard var urlComponents = URLComponents(string: baseURL) else {
             throw NetworkError.invalidURLError
         }
 
-        if let query = query {
-            components.queryItems = query
+        let currentPath = urlComponents.path
+        urlComponents.path = currentPath + path
+
+        if let queryParameters = queryParameters, !queryParameters.isEmpty {
+            urlComponents.queryItems = queryParameters.map { URLQueryItem(name: $0.key, value: $0.value) }
         }
 
-        guard let finalURL = components.url else {
+        guard let url = urlComponents.url else {
             throw NetworkError.invalidURLError
         }
 
-        var request = URLRequest(url: finalURL)
+        var request = URLRequest(url: url)
         request.httpMethod = method.rawValue
 
-        let allHeaders = makeHeaders()
-        request.allHTTPHeaderFields = allHeaders
-
-        if let body = body {
-            do {
-                request.httpBody = try Self.defaultEncoder.encode(body)
-            } catch {
-                throw NetworkError.requestEncodingError
+        switch contentType {
+        case .json:
+            request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+            if let body = body { request.httpBody = try encoder.encode(body) }
+
+        case .multipart(let boundary):
+            request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")
+            var builder = MultipartItemBuilder(boundary: boundary)
+
+            if let items = multipartItems {
+                for item in items { try item.append(to: &builder) }
+            }
+
+            if let body = body {
+                let data = try encoder.encode(body)
+                guard let dict = try JSONSerialization.jsonObject(with: data) as? [String: Any] else {
+                    throw MultipartError.invalidBody
+                }
+
+                for (key, value) in dict {
+                    let field = MultipartFormField(name: key, value: value)
+                    try field.append(to: &builder)
+                }
             }
+
+            request.httpBody = try builder.finalize()
+
+        case .raw:
+            request.setValue("application/octet-stream", forHTTPHeaderField: "Content-Type")
+            guard let body = body as? Data else { throw MultipartError.invalidBody }
+            request.httpBody = body
         }
 
         return request
     }
-
-
-    // TODO: - "Content-Type"외 다양한 헤더를 추가할 수 있도록 하기
-    func makeHeaders() -> [String: String] {
-        var headers: [String: String] = [
-            "Content-Type": "application/json"
-        ]
-
-        switch headerType {
-        case .noneHeader:
-            break
-        case .accessTokenHeader:
-            // TODO: - 여기에 토큰 가져오는 로직 추가 (토큰매니저나 키체인매니저 등)
-            break
-        case .refreshTokenHeader:
-            // TODO: - 리프레시 토큰 로직 추가
-            break
-        }
-
-        return headers
-    }
 }

Neki-iOS/Core/Sources/Network/Sources/Base/Multipart.swift

@@ -0,0 +1,90 @@
+//
+//  Multipart.swift
+//  Neki-iOS
+//
+//  Created by SwainYun on 1/14/26.
+//
+
+import Foundation
+
+fileprivate extension Data {
+    mutating func append(_ string: String) throws {
+        guard let data = string.data(using: .utf8) else { throw MultipartError.unsupportedValueType }
+        append(data)
+    }
+}
+
+public protocol MultipartItem {
+    func append(to builder: inout MultipartItemBuilder) throws
+}
+
+public enum MultipartError: Error {
+    case unsupportedValueType
+    case invalidBody
+}
+
+/// 단순한 키-값 파라미터 멀티파트 아이템
+public struct MultipartFormField: MultipartItem {
+    let name: String
+    let value: Any
+
+    public func append(to builder: inout MultipartItemBuilder) throws {
+        let stringValue: String
+
+        switch value {
+        case let string as String: stringValue = string
+        case let int as Int: stringValue = String(int)
+        case let bool as Bool: stringValue = bool ? "true" : "false"
+        case let double as Double: stringValue = String(double)
+            // TODO: Date 등 다양한 타입 지원이 필요하면 이곳에 케이스 추가
+        default: throw MultipartError.unsupportedValueType
+        }
+
+        try builder.append(value: stringValue, name: name)
+    }
+}
+
+/// 파일 데이터 멀티파트 아이템
+public struct MultipartFile: MultipartItem {
+    let name: String
+    let data: Data
+    let fileName: String
+    let mimeType: String
+
+    public func append(to builder: inout MultipartItemBuilder) throws {
+        try builder.append(data: data, name: name, fileName: fileName, mimeType: mimeType)
+    }
+}
+
+public struct MultipartItemBuilder {
+    private let boundary: String
+    private var body = Data()
+
+    public init(boundary: String) { self.boundary = boundary }
+
+    /// 일반 텍스트 파라미터 추가
+    public mutating func append(value: String, name: String) throws {
+        try body.append("--\(boundary)\r\n")
+        try body.append("Content-Disposition: form-data; name=\"\(name)\"\r\n")
+        try body.append("\r\n") // 헤더와 본문 사이 공백
+        try body.append(value)
+        try body.append("\r\n")
+    }
+
+    /// 파일 데이터(이미지 등) 추가
+    public mutating func append(data: Data, name: String, fileName: String, mimeType: String) throws {
+        try body.append("--\(boundary)\r\n")
+        try body.append("Content-Disposition: form-data; name=\"\(name)\"; filename=\"\(fileName)\"\r\n")
+        try body.append("Content-Type: \(mimeType)\r\n")
+        try body.append("\r\n") // 헤더와 본문 사이 공백
+        body.append(data)
+        try body.append("\r\n")
+    }
+
+    /// 최종 Body 데이터 생성 (Closing Boundary 추가)
+    public func finalize() throws -> Data {
+        var finalBody = body
+        try finalBody.append("--\(boundary)--\r\n") // 끝을 알리는 -- 추가
+        return finalBody
+    }
+}

Neki-iOS/Core/Sources/Network/Sources/Base/NetworkError.swift

@@ -8,7 +8,7 @@
 import Foundation
 
 public enum NetworkError: LocalizedError {
-    case apiError(message: String)
+    case apiError(BaseFailedResponseDTO)
     case requestEncodingError
     case responseDecodingError
     case responseError
@@ -22,7 +22,7 @@ public enum NetworkError: LocalizedError {
 
     public var errorDescription: String? {
         switch self {
-        case .apiError(let message): return message
+        case .apiError(let dto): return dto.message
         case .requestEncodingError: return "요청 인코딩에 실패했습니다."
         case .responseDecodingError: return "응답 디코딩에 실패했습니다."
         case .responseError: return "응답 오류가 발생했습니다."

Neki-iOS/Core/Sources/Network/Sources/Base/TokenRefresher.swift

@@ -0,0 +1,14 @@
+//
+//  TokenRefresher.swift
+//  Neki-iOS
+//
+//  Created by SwainYun on 1/12/26.
+//
+
+import Foundation
+
+public protocol TokenRefresher: Sendable {
+    var destination: Endpoint { get }
+
+    func refresh(provider: NetworkProvider) async throws(NetworkError) -> AuthTokens
+}

Neki-iOS/Core/Sources/Network/Sources/Base/TokenStorage.swift

@@ -0,0 +1,22 @@
+//
+//  TokenStorage.swift
+//  Neki-iOS
+//
+//  Created by SwainYun on 1/12/26.
+//
+
+import Foundation
+
+public protocol TokenStorage {
+    typealias Query = [String: Any]
+
+    func store(_ tokens: AuthTokens) throws(TokenStorageError)
+    func fetch() throws(TokenStorageError) -> AuthTokens
+    func delete() throws(TokenStorageError)
+}
+
+public enum TokenStorageError: Error {
+    case unknown
+    case notFound
+    case conversionFailed
+}