115 lines
4.1 KiB
Dart
115 lines
4.1 KiB
Dart
/// 인증 계약 — 제공자 인터페이스와 결과 타입.
|
|
///
|
|
/// 원칙: **"키 미투입"은 예외가 아니라 상태다.** 카카오·네이버는 발주사 사업자 정보로
|
|
/// 개발자 콘솔에 앱을 등록해야 키가 나오고(Q3), Google·Apple 은 Firebase 설정 파일이
|
|
/// 있어야 한다(S1·S2). 둘 다 "아직 준비가 안 됐다"이지 "지원하지 않는다"가 아니므로
|
|
/// 예외를 던지지 않고 [AuthNotConfigured] 로 돌려준다. 화면은 이걸 안내로 보여 준다.
|
|
library;
|
|
|
|
/// 소셜 제공자. **순서와 라벨은 시안 `시안/screens/S-A-LOGIN.html` 의 버튼 그대로다.**
|
|
/// 화면명세 `wireframe/planning/screen-spec/onboard/S-A-LOGIN.md` 도 4종으로 같다.
|
|
enum SocialProvider {
|
|
kakao('카카오로 시작하기'),
|
|
naver('네이버로 시작하기'),
|
|
apple('Apple로 시작하기'),
|
|
google('Google로 시작하기');
|
|
|
|
const SocialProvider(this.label);
|
|
|
|
/// 버튼 라벨. 임의로 바꾸지 마라 — 시안 대조 대상이다.
|
|
final String label;
|
|
}
|
|
|
|
// 이메일 가입에 대하여 — 기능 플래그를 두지 않았다.
|
|
//
|
|
// CD-18(가입 수단) 미확정(2주차_확인요청항목 Q2)이라 이메일 경로는 구현하지 않았다.
|
|
// 플래그 상수를 하나 선언해 두는 방법도 있었지만, 그 값을 읽는 분기가 없으면
|
|
// 「false 라서 닫혀 있다」는 착각만 만든다 — 누군가 true 로 바꿔도 아무 일이 일어나지 않는다.
|
|
// 지금 이메일을 닫고 있는 것은 플래그가 아니라 AuthRepository 의 제공자 목록에
|
|
// 이메일 구현체가 없다는 사실 하나다.
|
|
//
|
|
// Q2 가 「이메일 병행」으로 오면 할 일: [SocialAuthProvider] 를 구현한 이메일 제공자를 만들고
|
|
// AuthRepository._defaultProviders() 에 추가한다. 화면 수·약관 동선도 함께 바뀐다.
|
|
|
|
/// 로그인된 계정.
|
|
class AuthAccount {
|
|
const AuthAccount({
|
|
required this.uid,
|
|
required this.provider,
|
|
this.displayName,
|
|
this.email,
|
|
this.isMock = false,
|
|
});
|
|
|
|
final String uid;
|
|
final SocialProvider? provider;
|
|
final String? displayName;
|
|
final String? email;
|
|
|
|
/// Firebase 미설정 상태에서 만든 임시 세션인지. 실 세션과 절대 섞이면 안 된다.
|
|
final bool isMock;
|
|
}
|
|
|
|
/// 로그인 시도 결과.
|
|
sealed class AuthOutcome {
|
|
const AuthOutcome();
|
|
}
|
|
|
|
final class AuthSucceeded extends AuthOutcome {
|
|
const AuthSucceeded(this.account);
|
|
|
|
final AuthAccount account;
|
|
}
|
|
|
|
/// 사용자가 취소함. 에러로 취급하지 않는다.
|
|
final class AuthCancelled extends AuthOutcome {
|
|
const AuthCancelled();
|
|
}
|
|
|
|
/// 실패. [code] 는 `wireframe/planning/error-catalog.yaml` 의 ID 다(소셜 실패 = E-AUTH-03).
|
|
final class AuthFailed extends AuthOutcome {
|
|
const AuthFailed(this.code, this.message);
|
|
|
|
final String code;
|
|
final String message;
|
|
}
|
|
|
|
/// 아직 쓸 수 없음 — 키·설정 파일 미투입.
|
|
final class AuthNotConfigured extends AuthOutcome {
|
|
const AuthNotConfigured(this.provider, this.missing);
|
|
|
|
final SocialProvider provider;
|
|
|
|
/// 투입해야 하는 것들(파일명·키명). 화면과 README 에 그대로 노출한다.
|
|
final List<String> missing;
|
|
}
|
|
|
|
/// 소셜 로그인 제공자 인터페이스.
|
|
///
|
|
/// 이메일 가입이 확정되면(Q2) 같은 인터페이스로 구현체 하나가 더 붙는 자리다.
|
|
abstract interface class SocialAuthProvider {
|
|
SocialProvider get provider;
|
|
|
|
/// 실 연동 코드 경로를 가지고 있는지. 스텁이면 false.
|
|
bool get isLive;
|
|
|
|
/// 비어 있지 않으면 지금은 로그인할 수 없다. [signIn] 은 [AuthNotConfigured] 를 낸다.
|
|
List<String> get missingConfig;
|
|
|
|
Future<AuthOutcome> signIn();
|
|
|
|
Future<void> signOut();
|
|
}
|
|
|
|
/// 앱 재실행·토큰 만료·다른 기기 로그아웃을 인증 상태에 반영하는 세션 경계.
|
|
///
|
|
/// 저장소는 이 인터페이스만 알며 Firebase SDK 자체는 어댑터 뒤에 둔다. 덕분에
|
|
/// 외부 설정 파일 없이도 세션 복원과 만료 전이를 단위 테스트할 수 있다.
|
|
abstract interface class AuthSession {
|
|
AuthAccount? get currentAccount;
|
|
|
|
Stream<AuthAccount?> get accountChanges;
|
|
|
|
Future<void> signOut();
|
|
}
|