feat: CoreKeyChainStorage 개발

Author: kdjun97

Projects/Core/CoreKeyChainStorage/Interface/Sources/CoreKeyChainStorageInterface.swift

@@ -0,0 +1,15 @@
+//
+//  CoreKeyChainStorageInterface.swift
+//  CoreKeyChainStorageInterface
+//
+//  Created by 김동준 on 6/29/26
+//
+
+import Foundation
+
+public protocol CoreKeyChainStorageInterface {
+    func save<T: Encodable>(key: String, value: T) throws
+    func read<T: Decodable>(key: String) throws -> T
+    func update<T: Encodable>(key: String, value: T) throws
+    func delete(key: String) throws
+}

Projects/Core/CoreKeyChainStorage/Interface/Sources/KeyChainStorageError.swift

@@ -0,0 +1,38 @@
+//
+//  KeyChainStorageError.swift
+//  CoreKeyChainStorageInterface
+//
+//  Created by 김동준 on 6/29/26
+//
+
+import Foundation
+
+public enum KeyChainStorageError: Error {
+    case unExpectedStatus(OSStatus)
+    case encodingFailed
+    case decodingFailed
+    case noMatchKeyError
+    
+    public var description: String {
+        switch self {
+        case .encodingFailed:
+            """
+            🛑 KeyChainStorageError: Encoding failed
+            """
+        case .decodingFailed:
+            """
+            🛑 KeyChainStorageError: Decoding failed
+            """
+        case .noMatchKeyError:
+            """
+            🛑 KeyChainStorageError: No Match Key Error
+            """
+        case .unExpectedStatus(let status):
+            """
+            🛑 KeyChainStorageError: UnExpectedStatus
+              - 타입: \(type(of: status))
+              - 설명: \(status.description)
+            """
+        }
+    }
+}

Projects/Core/CoreKeyChainStorage/Project.swift

@@ -0,0 +1,7 @@
+import ProjectDescription
+import ProjectDescriptionHelpers
+
+let project = Project.module(
+    moduleType: .MicroFeature(.CoreKeyChainStorage),
+    hasDemo: false
+)

Projects/Core/CoreKeyChainStorage/Sources/CoreKeyChainStorage.swift

@@ -0,0 +1,110 @@
+//
+//  CoreKeyChainStorage.swift
+//  CoreKeyChainStorage
+//
+//  Created by 김동준 on 6/29/26
+//
+
+import Foundation
+import Security
+import CoreKeyChainStorageInterface
+
+public struct CoreKeyChainStorage: CoreKeyChainStorageInterface {
+    public init() {}
+    
+    public func save<T: Encodable>(key: String, value: T) throws {
+        let data: Data
+        do {
+            data = try JSONEncoder().encode(value)
+        } catch {
+            let error = KeyChainStorageError.encodingFailed
+            throw error
+        }
+
+        var query = baseQuery(key)
+        query[kSecValueData as String] = data
+        query[kSecAttrAccessible as String] = kSecAttrAccessibleWhenUnlockedThisDeviceOnly
+
+        let status = SecItemAdd(query as CFDictionary, nil)
+        switch status {
+        case errSecSuccess:
+            return
+        case errSecDuplicateItem:
+            try update(key: key, value: value)
+        default:
+            throw KeyChainStorageError.unExpectedStatus(status)
+        }
+    }
+    
+    public func read<T: Decodable>(key: String) throws -> T {
+        var query = baseQuery(key)
+        query[kSecReturnData as String] = true
+        query[kSecMatchLimit as String] = kSecMatchLimitOne
+        
+        var dataTypeRef: CFTypeRef?
+        let status = SecItemCopyMatching(query as CFDictionary, &dataTypeRef)
+
+        guard status == errSecSuccess else {
+            if status == errSecItemNotFound {
+                let error = KeyChainStorageError.noMatchKeyError
+                throw error
+            }
+            
+            let error = KeyChainStorageError.unExpectedStatus(status)
+            throw error
+        }
+        
+        guard let retrievedData = dataTypeRef as? Data else {
+            let error = KeyChainStorageError.decodingFailed
+            throw error
+        }
+        
+        do {
+            return try JSONDecoder().decode(T.self, from: retrievedData)
+        } catch {
+            let error = KeyChainStorageError.decodingFailed
+            throw error
+        }
+    }
+    
+    public func update<T: Encodable>(key: String, value: T) throws {
+        let data: Data
+        do {
+            data = try JSONEncoder().encode(value)
+        } catch {
+            let error = KeyChainStorageError.encodingFailed
+            throw error
+        }
+        
+        let attributes = [
+            kSecValueData as String: data,
+            kSecAttrAccessible as String: kSecAttrAccessibleWhenUnlockedThisDeviceOnly
+        ] as [String: Any]
+        
+        let status = SecItemUpdate(baseQuery(key) as CFDictionary, attributes as CFDictionary)
+        guard status == errSecSuccess else {
+            throw KeyChainStorageError.unExpectedStatus(status)
+        }
+    }
+    
+    public func delete(key: String) throws {
+        let query = baseQuery(key)
+        let status = SecItemDelete(query as CFDictionary)
+        
+        switch status {
+        case errSecSuccess, errSecItemNotFound:
+            return
+        default:
+            throw KeyChainStorageError.unExpectedStatus(status)
+        }
+    }
+}
+
+private extension CoreKeyChainStorage {
+    func baseQuery(_ key: String) -> [String: Any] {
+        [
+            kSecClass as String: kSecClassGenericPassword,
+            kSecAttrAccount as String: key
+        ]
+    }
+}

Projects/Core/CoreKeyChainStorage/Testing/Sources/DefaultTestingCode.swift

@@ -0,0 +1,5 @@
+import CoreKeyChainStorageInterface
+
+public struct CoreKeyChainStorageTesting {
+    public init() {}
+}

Projects/Core/CoreKeyChainStorage/Tests/Sources/DefaultTestsCode.swift

@@ -0,0 +1,4 @@
+import XCTest
+@testable import CoreKeyChainStorage
+
+final class CoreKeyChainStorageTests: XCTestCase {}

Tuist/ProjectDescriptionHelpers/Dependency/DependencyInfo.swift

@@ -48,7 +48,8 @@ public let dependencyInfo: DependencyInfo = DependencyInfo(
             .module(.MicroFeature(.SignIn)),
             .module(.MicroFeature(.OnBoarding)),
             .module(.MicroFeature(.SignUpDone)),
-            .external(.Swinject)
+            .external(.Swinject),
+            .module(.MicroFeature(.CoreKeyChainStorage))
         ],
         .Root: [
             .microFeature(.Splash),

Tuist/ProjectDescriptionHelpers/Module/Module.swift

@@ -25,6 +25,7 @@ public enum ExternalModule {
 }
 
 public enum MicroFeatureModule {
+    case CoreKeyChainStorage
     case SignUpDone
     case MyPage
     case Challenge
@@ -59,6 +60,7 @@ public enum MicroFeatureModule {
         case .Challenge: "Projects/Feature/Challenge"
         case .MyPage: "Projects/Feature/MyPage"
         case .SignUpDone: "Projects/Feature/SignUpDone"
+        case .CoreKeyChainStorage: "Projects/Core/CoreKeyChainStorage"
         }
     }
 }