팝업 모듈 구현

.swiftformat

@@ -5,3 +5,5 @@
 --funcattributes same-line
 --typeattributes prev-line
 --disable redundantLet
+--extensionacl on-declarations
+--maxwidth 119

SNUTT/Modules/Feature/APIClientInterface/Sources/APIClientError.swift

@@ -0,0 +1,10 @@
+//
+//  APIClientError.swift
+//  SNUTT
+//
+//  Copyright © 2025 wafflestudio.com. All rights reserved.
+//
+
+import OpenAPIRuntime
+
+public typealias APIClientError = ClientError

SNUTT/Modules/Feature/APIClientInterface/Sources/APIClientKey.swift

@@ -23,8 +23,8 @@ public enum APIClientKey: TestDependencyKey {
     )
 }
 
-public extension DependencyValues {
-    var apiClient: any APIProtocol {
+extension DependencyValues {
+    public var apiClient: any APIProtocol {
         get { self[APIClientKey.self] }
         set { self[APIClientKey.self] = newValue }
     }

SNUTT/Modules/Feature/APIClientInterface/Sources/LocalizedErrorCode.swift

@@ -7,7 +7,7 @@
 
 import Foundation
 
-enum LocalizedErrorCode: Int, LocalizedError {
+public enum LocalizedErrorCode: Int, LocalizedError {
     case serverFault = 0x0000
     case noNetwork = 0x0001
     case unknownError = 0x0002
@@ -86,7 +86,7 @@ enum LocalizedErrorCode: Int, LocalizedError {
 
     case excessiveEmailVerificationRequest = 0xA000
 
-    var errorDescription: String? {
+    public var errorDescription: String? {
         switch self {
         case .serverFault:
             APIClientInterfaceStrings.errorDescriptionServerFault
@@ -146,7 +146,9 @@ enum LocalizedErrorCode: Int, LocalizedError {
             APIClientInterfaceStrings.errorDescriptionCustomLecture
         case .userHasNoFCMKey:
             APIClientInterfaceStrings.errorDescriptionNoFCMKey
-        case .tagNotFound, .timetableNotFound, .lectureNotFound, .refLectureNotFound, .userNotFound, .colorlistNotFound, .emailNotFound:
+        case .tagNotFound, .timetableNotFound, .lectureNotFound, .refLectureNotFound, .userNotFound,
+             .colorlistNotFound,
+             .emailNotFound:
             APIClientInterfaceStrings.errorDescriptionNotFound
         case .cantChangeOthersTheme:
             APIClientInterfaceStrings.errorDescriptionCantChangeTheme
@@ -171,7 +173,7 @@ enum LocalizedErrorCode: Int, LocalizedError {
         }
     }
 
-    var failureReason: String? {
+    public var failureReason: String? {
         switch self {
         case .serverFault:
             APIClientInterfaceStrings.errorFailureReasonServerFault
@@ -231,7 +233,9 @@ enum LocalizedErrorCode: Int, LocalizedError {
             APIClientInterfaceStrings.errorFailureReasonCustomLecture
         case .userHasNoFCMKey:
             APIClientInterfaceStrings.errorFailureReasonNoFCMKey
-        case .tagNotFound, .timetableNotFound, .lectureNotFound, .refLectureNotFound, .userNotFound, .colorlistNotFound, .emailNotFound:
+        case .tagNotFound, .timetableNotFound, .lectureNotFound, .refLectureNotFound, .userNotFound,
+             .colorlistNotFound,
+             .emailNotFound:
             APIClientInterfaceStrings.errorFailureReasonNotFound
         case .cantChangeOthersTheme:
             APIClientInterfaceStrings.errorFailureReasonCantChangeTheme
@@ -256,7 +260,7 @@ enum LocalizedErrorCode: Int, LocalizedError {
         }
     }
 
-    var recoverySuggestion: String? {
+    public var recoverySuggestion: String? {
         switch self {
         case .serverFault:
             APIClientInterfaceStrings.errorRecoverySuggestionServerFault
@@ -316,7 +320,9 @@ enum LocalizedErrorCode: Int, LocalizedError {
             APIClientInterfaceStrings.errorRecoverySuggestionCustomLecture
         case .userHasNoFCMKey:
             APIClientInterfaceStrings.errorRecoverySuggestionNoFCMKey
-        case .tagNotFound, .timetableNotFound, .lectureNotFound, .refLectureNotFound, .userNotFound, .colorlistNotFound, .emailNotFound:
+        case .tagNotFound, .timetableNotFound, .lectureNotFound, .refLectureNotFound, .userNotFound,
+             .colorlistNotFound,
+             .emailNotFound:
             APIClientInterfaceStrings.errorRecoverySuggestionNotFound
         case .cantChangeOthersTheme:
             APIClientInterfaceStrings.errorRecoverySuggestionCantChangeTheme

SNUTT/Modules/Feature/AuthInterface/Sources/AuthRepository.swift

@@ -39,8 +39,8 @@ public enum AuthRepositoryKey: TestDependencyKey {
     }()
 }
 
-public extension DependencyValues {
-    var authRepository: any AuthRepository {
+extension DependencyValues {
+    public var authRepository: any AuthRepository {
         get { self[AuthRepositoryKey.self] }
         set { self[AuthRepositoryKey.self] = newValue }
     }

SNUTT/Modules/Feature/AuthInterface/Sources/AuthSecureRepository.swift

@@ -24,8 +24,8 @@ public enum AuthSecureRepositoryKey: TestDependencyKey {
     public static let testValue: any AuthSecureRepository = AuthSecureRepositorySpy()
 }
 
-public extension DependencyValues {
-    var authSecureRepository: any AuthSecureRepository {
+extension DependencyValues {
+    public var authSecureRepository: any AuthSecureRepository {
         get { self[AuthSecureRepositoryKey.self] }
         set { self[AuthSecureRepositoryKey.self] = newValue }
     }

SNUTT/Modules/Feature/AuthInterface/Sources/AuthState.swift

@@ -38,8 +38,8 @@ public enum AuthStateKey: TestDependencyKey {
     }()
 }
 
-public extension DependencyValues {
-    var authState: any AuthState {
+extension DependencyValues {
+    public var authState: any AuthState {
         get { self[AuthStateKey.self] }
         set { self[AuthStateKey.self] = newValue }
     }

SNUTT/Modules/Feature/Popup/Resources/Base.lproj/Localizable.strings

@@ -0,0 +1,25 @@
+/*
+ Localizable.strings
+ This file is used to manage localizable strings for the feature module in English.
+
+ How to use:
+ - Add your localized strings here in the format "key" = "value";
+ - The key is what you will use in your code, and the value is the translated string.
+
+ Examples:
+ "welcome_message" = "Welcome to the app!";
+ "error_message" = "An error has occurred. Please try again.";
+
+ Usage in code with Tuist synthesized strings:
+ let welcomeMessage = PopupStrings.welcomeMessage
+ let errorMessage = PopupStrings.errorMessage
+
+ Note:
+ - Ensure that each key is unique within this file.
+ - Add comments to provide context for translators.
+*/
+
+/* Add your translations below */
+
+"popup.dontShowForWhile" = "당분간 보지 않기";
+"popup.dismiss" = "닫기";

SNUTT/Modules/Feature/Popup/Resources/en.lproj/Localizable.strings

@@ -0,0 +1,25 @@
+/*
+ Localizable.strings
+ This file is used to manage localizable strings for the feature module in English.
+
+ How to use:
+ - Add your localized strings here in the format "key" = "value";
+ - The key is what you will use in your code, and the value is the translated string.
+
+ Examples:
+ "welcome_message" = "Welcome to the app!";
+ "error_message" = "An error has occurred. Please try again.";
+
+ Usage in code with Tuist synthesized strings:
+ let welcomeMessage = PopupStrings.welcomeMessage
+ let errorMessage = PopupStrings.errorMessage
+
+ Note:
+ - Ensure that each key is unique within this file.
+ - Add comments to provide context for translators.
+*/
+
+/* Add your translations below */
+
+"popup.dontShowForWhile" = "Hide for a while";
+"popup.dismiss" = "Dismiss";

SNUTT/Modules/Feature/Popup/Sources/BusinessLogic/Application/PopupLocalRepository.swift

@@ -0,0 +1,11 @@
+//
+//  PopupLocalRepository.swift
+//  SNUTT
+//
+//  Copyright © 2025 wafflestudio.com. All rights reserved.
+//
+
+protocol PopupLocalRepository: Sendable {
+    func fetchPopups() -> [LocalPopup]
+    func storePopups(_ popups: [LocalPopup])
+}

SNUTT/Modules/Feature/Popup/Sources/BusinessLogic/Application/PopupServerRepository.swift

@@ -0,0 +1,13 @@
+//
+//  PopupServerRepository.swift
+//  SNUTT
+//
+//  Copyright © 2025 wafflestudio.com. All rights reserved.
+//
+
+import Spyable
+
+@Spyable
+protocol PopupServerRepository: Sendable {
+    func fetchPopups() async throws -> [ServerPopup]
+}

SNUTT/Modules/Feature/Popup/Sources/BusinessLogic/Application/PopupUseCase.swift

@@ -0,0 +1,48 @@
+//
+//  PopupUseCase.swift
+//  SNUTT
+//
+//  Copyright © 2025 wafflestudio.com. All rights reserved.
+//
+
+import Dependencies
+
+struct PopupUseCase {
+    @Dependency(\.popupLocalRepository) private var localRepository
+    @Dependency(\.popupServerRepository) private var serverRepository
+
+    func fetchRecentPopupList() async throws -> [PopupModel] {
+        let serverPopups = try await serverRepository.fetchPopups()
+        let localPopups = localRepository.fetchPopups()
+        return merge(localPopups: localPopups, into: serverPopups)
+    }
+
+    func storePopupList(_ popups: [PopupModel]) {
+        let localPopups = popups.compactMap { $0.localPopup }
+        localRepository.storePopups(localPopups)
+    }
+
+    private func merge(localPopups: [LocalPopup], into serverPopups: [ServerPopup]) -> [PopupModel] {
+        let localPopupByKey = Dictionary(grouping: localPopups, by: { $0.key })
+        return serverPopups.map { serverPopup in
+            guard let localPopup = localPopupByKey[serverPopup.key]?.first else {
+                return .init(serverPopup: serverPopup)
+            }
+            if serverPopup.hiddenDays != localPopup.dismissInfo.hiddenDays {
+                return .init(serverPopup: serverPopup)
+            }
+            return .init(serverPopup: serverPopup, localPopup: localPopup)
+        }
+    }
+}
+
+struct PopupUseCaseKey: DependencyKey {
+    static let liveValue: PopupUseCase = .init()
+}
+
+extension DependencyValues {
+    var popupUseCase: PopupUseCase {
+        get { self[PopupUseCaseKey.self] }
+        set { self[PopupUseCaseKey.self] = newValue }
+    }
+}

SNUTT/Modules/Feature/Popup/Sources/BusinessLogic/Domain/LocalPopup.swift

@@ -0,0 +1,20 @@
+//
+//  LocalPopup.swift
+//  SNUTT
+//
+//  Copyright © 2025 wafflestudio.com. All rights reserved.
+//
+
+import Foundation
+
+struct LocalPopup: Codable, Identifiable, Sendable {
+    var id: String { key }
+    let key: String
+    let dismissInfo: DismissInfo
+
+    struct DismissInfo: Codable, Sendable {
+        let hiddenDays: Int?
+        let dismissedAt: Date
+        let dontShowForWhile: Bool
+    }
+}

SNUTT/Modules/Feature/Popup/Sources/BusinessLogic/Domain/PopupModel.swift

@@ -0,0 +1,70 @@
+//
+//  PopupModel.swift
+//  SNUTT
+//
+//  Copyright © 2025 wafflestudio.com. All rights reserved.
+//
+
+import Foundation
+import FoundationUtility
+
+struct PopupModel: Sendable, Identifiable {
+    var id: String { key }
+    let key: String
+
+    /// Indicates whether the popup is dismissed by the user in the current session.
+    var isDismissed = false
+
+    init(serverPopup: ServerPopup, localPopup: LocalPopup? = nil) {
+        key = serverPopup.key
+        self.serverPopup = serverPopup
+        self.localPopup = localPopup
+    }
+
+    var imageURL: URL? {
+        URL(string: serverPopup.imageUri)
+    }
+
+    private let serverPopup: ServerPopup
+    var localPopup: LocalPopup?
+
+    var shouldShow: Bool {
+        if isDismissed {
+            // The user dismissed the popup in the current session
+            return false
+        }
+        guard let dismissInfo = localPopup?.dismissInfo else {
+            // The user has never dismissed the popup yet
+            return true
+        }
+        if !dismissInfo.dontShowForWhile {
+            // The user dismissed the popup, but didn't ask to hide it for a while
+            return true
+        }
+        guard let hiddenDays = dismissInfo.hiddenDays else {
+            // If `hiddenDays` is nil, never show the popup again
+            return false
+        }
+        return Date().daysFrom(dismissInfo.dismissedAt) >= hiddenDays
+    }
+
+    mutating func markAsDismissed(dontShowForWhile: Bool) {
+        isDismissed = true
+        if serverPopup.hiddenDays == 0 {
+            // If `hiddenDays` is 0, always show the popup next time
+            localPopup = .init(
+                key: key,
+                dismissInfo: .init(hiddenDays: serverPopup.hiddenDays, dismissedAt: .now, dontShowForWhile: false)
+            )
+            return
+        }
+        localPopup = .init(
+            key: key,
+            dismissInfo: .init(
+                hiddenDays: serverPopup.hiddenDays,
+                dismissedAt: .now,
+                dontShowForWhile: dontShowForWhile
+            )
+        )
+    }
+}

SNUTT/Modules/Feature/Popup/Sources/BusinessLogic/Domain/ServerPopup.swift

@@ -0,0 +1,15 @@
+//
+//  ServerPopup.swift
+//  SNUTT
+//
+//  Copyright © 2025 wafflestudio.com. All rights reserved.
+//
+
+import Foundation
+
+struct ServerPopup: Sendable, Identifiable {
+    var id: String { key }
+    let key: String
+    let imageUri: String
+    let hiddenDays: Int?
+}