[Feature] Firestore Link CRUD 구현

Mark-In/Sources/Data/DTOs/LinkDTO.swift

@@ -0,0 +1,43 @@
+//
+//  LinkDTO.swift
+//  Mark-In
+//
+//  Created by 이정동 on 4/20/25.
+//
+
+import Foundation
+
+struct LinkDTO: Codable {
+  var id: String
+  var url: String
+  var title: String?
+  var thumbnailUrl: String?
+  var faviconUrl: String?
+  var createdBy: Date
+  var lastAccessedAt: Date?
+  var folderId: String?
+
+  init(_ link: Link) {
+    self.id = link.id
+    self.url = link.url
+    self.title = link.title
+    self.thumbnailUrl = link.thumbnailUrl
+    self.faviconUrl = link.faviconUrl
+    self.createdBy = link.createdBy
+    self.lastAccessedAt = link.lastAccessedAt
+    self.folderId = link.folderId
+  }
+
+  func toEntity() -> Link {
+    Link(
+      id: self.id,
+      url: self.url,
+      title: self.title,
+      thumbnailUrl: self.thumbnailUrl,
+      faviconUrl: self.faviconUrl,
+      createdBy: self.createdBy,
+      lastAccessedAt: self.lastAccessedAt,
+      folderId: self.folderId
+    )
+  }
+}

Mark-In/Sources/Data/Repositories/LinkRepositoryImpl.swift

@@ -0,0 +1,86 @@
+//
+//  LinkRepositoryImpl.swift
+//  Mark-In
+//
+//  Created by 이정동 on 4/21/25.
+//
+
+import Foundation
+
+import FirebaseFirestore
+
+struct LinkRepositoryImpl: LinkRepository {
+
+  typealias VoidCheckedContinuation = CheckedContinuation<Void, any Error>
+
+  private let db = Firestore.firestore()
+
+  func createLink(_ link: Link) async throws -> Link {
+    /// 1. Link 문서 참조 생성
+    // TODO: 후에 testUser를 실제 로그인 된 유저로 변경 예정
+    let linkDocRef = db.collection("users/testUser/links").document()
+
+    /// 2. Entity를 DTO로 변환 및 새로 생성된 문서 ID를 프로퍼티에 저장
+    var linkDTO = LinkDTO(link)
+    linkDTO.id = linkDocRef.documentID
+
+    /// 3. Firestore에 추가
+    try await withCheckedThrowingContinuation { (continuation: VoidCheckedContinuation) in
+      do {
+        try linkDocRef.setData(from: linkDTO) { error in
+          if let error { continuation.resume(throwing: error) }
+          else { continuation.resume(returning: ()) }
+        }
+      } catch {
+        continuation.resume(throwing: error)
+      }
+    }
+
+    /// 4. DocumentID 업데이트 된 LinkEntity로 리턴
+    return linkDTO.toEntity()
+  }
+
+  func fetchAllLinks() async throws -> [Link] {
+    /// 1. Links 컬렉션 참조 생성
+    // TODO: 후에 testUser를 실제 로그인 된 유저로 변경 예정
+    let linkColRef = db.collection("users/testUser/links")
+
+    /// 2. 컬렉션의 모든 문서 가져오기
+    let snapshot = try await linkColRef.getDocuments()
+
+    /// 3. 문서를 DTO로 변환 후 다시 Entity로 변환
+    return snapshot.documents.compactMap {
+      try? $0.data(as: LinkDTO.self).toEntity()
+    }
+  }
+
+  func updateLink(_ link: Link) async throws {
+    /// 1. Link 문서 참조 생성
+    // TODO: 후에 testUser를 실제 로그인 된 유저로 변경 예정
+    let linkDocRef = db.document("users/testUser/links/\(link.id)")
+
+    /// 2. Entity를 DTO로 변환
+    let linkDTO = LinkDTO(link)
+
+    /// 3. 업데이트
+    try await withCheckedThrowingContinuation { (continuation: VoidCheckedContinuation) in
+      do {
+        try linkDocRef.setData(from: linkDTO) { error in
+          if let error { continuation.resume(throwing: error) }
+          else { continuation.resume(returning: ()) }
+        }
+      } catch {
+        continuation.resume(throwing: error)
+      }
+    }
+  }
+
+  func deleteLink(_ link: Link) async throws {
+    /// 1. Link 문서 참조 생성
+    // TODO: 후에 testUser를 실제 로그인 된 유저로 변경 예정
+    let linkDocRef = db.document("users/testUser/links/\(link.id)")
+
+    /// 2. Link 삭제
+    try await linkDocRef.delete()
+  }
+}

Mark-In/Sources/Domain/Entities/Link.swift

@@ -0,0 +1,19 @@
+//
+//  Link.swift
+//  Mark-In
+//
+//  Created by 이정동 on 4/20/25.
+//
+
+import Foundation
+
+struct Link {
+  var id: String = ""
+  var url: String
+  var title: String?
+  var thumbnailUrl: String?
+  var faviconUrl: String?
+  var createdBy: Date = .now
+  var lastAccessedAt: Date?
+  var folderId: String?
+}

Mark-In/Sources/Domain/Interfaces/LinkRepository.swift

@@ -0,0 +1,15 @@
+//
+//  LinkRepository.swift
+//  Mark-In
+//
+//  Created by 이정동 on 4/20/25.
+//
+
+import Foundation
+
+protocol LinkRepository {
+  func createLink(_ link: Link) async throws -> Link
+  func fetchAllLinks() async throws -> [Link]
+  func updateLink(_ link: Link) async throws
+  func deleteLink(_ link: Link) async throws
+}