refactor: Actor 기반 KeychainManager로 마이그레이션

[Roy-wonji]

🚀 개요

KeychainManager를 class에서 actor로 마이그레이션하여 Swift Concurrency 패턴을 적용했습니다.

✨ 주요 변경사항

• Thread Safety 향상: Actor를 사용한 완전한 thread safety 보장
• Async/Await API 추가: iOS 17+ 타겟에 맞는 모던 API 제공
• Backward Compatibility: nonisolated 메서드로 기존 코드 호환성 유지
• Error Handling 개선: 명확한 KeychainError enum으로 에러 처리 강화
• Performance 향상: Swift Concurrency 활용으로 성능 개선

🔧 기술적 변경점

Before:

public final class KeychainManager: @unchecked Sendable {
    // manual thread safety
}

After:

public actor KeychainManager: KeychainManagingInterface {
    // automatic thread safety with Swift Concurrency
}

📋 API 변화

Legacy (계속 지원):

let token = keychain.accessToken() // 동기

Modern (권장):

let token = await keychain.accessToken() // 비동기

✅ 테스트 계획

• 기존 동기 API 호환성 확인
• 새로운 비동기 API 동작 확인
• Thread safety 검증
• TCA 통합 테스트
• Error handling 테스트

🎯 Breaking Changes

없음 - 기존 API는 deprecated 없이 계속 지원됩니다.

📚 관련 이슈

iOS 17+ Swift Concurrency 적용을 위한 아키텍처 개선