기본 사용법

public enum Species {
    case dog  // 강아지 코무늬 촬영
    case cat  // 고양이 얼굴 촬영
}

public enum CameraPurpose {
    case forRegisterFromProfile  // 프로필 등록용
    case appendNose              // 기존 프로필에 비문 추가 (추후 지원 예정)
    case forSearch               // 검색/식별용
    case forWitness              // 제보/검증용
}

public struct LicenseInfo {
    let apiKey: String      // Petnow API 키
    let isDebugMode: Bool   // deprecated: 항상 false
}

.back   // 후면 카메라 (권장)
.front  // 전면 카메라

let captureSessionId: UUID  // 서버 API로 생성된 세션 ID

typealias CameraResultCallback = (_ result: CameraResult) -> Void

// Fail 시 재시도/종료 처리 예시
private func showRetryOrCancelAlert() {
    // SwiftUI Alert 또는 UIKit AlertController
    // "재시도" → cameraViewModel.startDetection()
    // "종료"  → dismiss()
}

public enum CameraResult {
    case success(
        fingerprintImages: [URL],  // 코무늬/지문 이미지 (파일 URL)
        appearanceImages: [URL]    // 외형 이미지 (파일 URL)
    )
    case fail  // 촬영 실패
}

// 이미지를 UIImage로 변환
if let image = UIImage(contentsOfFile: fingerprintImages[0].path) {
    imageView.image = image
}

// Data로 변환하여 서버에 업로드
if let imageData = try? Data(contentsOf: fingerprintImages[0]) {
    await uploadToServer(imageData)
}

private func initializeCamera() async {
    do {
        try await cameraViewModel.initializeCamera( /* ... */ ) { /* ... */ }
    } catch PetnowUIError.invalidLicense(let underlyingError) {
        // 라이선스 검증 실패
        showError("유효하지 않은 API 키입니다.\n\(underlyingError.localizedDescription)")
        
    } catch PetnowUIError.permissionDenied(let message) {
        // 카메라 권한 거부
        showError("카메라 권한이 필요합니다.\n설정에서 권한을 허용해주세요.")
        showSettingsAlert()
        
    } catch {
        // 기타 에러
        showError("카메라 초기화 실패: \(error.localizedDescription)")
    }
    
    showCamera = false
}

private func showError(_ message: String) {
    // 에러 메시지 표시 로직
    print("❌ \(message)")
}

private func showSettingsAlert() {
    // 설정 앱으로 이동하는 Alert 표시
    if let url = URL(string: UIApplication.openSettingsURLString) {
        UIApplication.shared.open(url)
    }
}

public enum PetnowUIError: Error {
    case invalidLicense(underlyingError: Error)  // API 키 오류
    case permissionDenied(message: String)       // 권한 거부
}

// 탐지 상태 (1초마다 업데이트)
@Published public var detectionStatus: DetectionStatus

// 진행률 (0-100)
@Published public var currentDetectionProgress: Int

// 카메라 권한 상태
@Published public var cameraPermissionStatus: AVAuthorizationStatus

// 탐지된 영역 (정규화된 좌표 0.0-1.0)
@Published public var detectedObjectNormalizedRect: CGRect?

// 현재 카메라 방향(전면, 후면)
@Published public var currentCameraPosition: AVCaptureDevice.Position

// 카메라 전환 버튼 활성화 여부
@Published public var isSwitchButtonEnabled: Bool

public enum DetectionStatus {
    case noObject                           // 대상 미탐지
    case processing                         // 탐지 진행 중
    case detected                          // 탐지 완료
    case failed(DetectionFailureReason)    // 실패 (사유 포함)
}

public enum DetectionFailureReason {
    case error                      // 오류
    case tooBright                  // 너무 밝음
    case tooDark                    // 너무 어두움
    case noseNotFound               // 코 탐지 실패
    case notFrontFace               // 정면이 아님
    case notFrontCatFaceHor         // 고양이 얼굴 수평 방향 불일치
    case notFrontCatFaceTop         // 고양이 얼굴이 너무 위로 향함
    case notFrontCatFaceBottom      // 고양이 얼굴이 너무 아래로 향함
    case tooFarAway                 // 너무 멀음
    case tooClose                   // 너무 가까움
    case notFrontNoseTop            // 코가 너무 위로 향함
    case tooBlurred                 // 흔들림
    case shadowDetected             // 그림자 감지
    case glareDetected              // 빛 반사 감지
    case motionBlurDetected         // 움직임 흔들림 감지
    case defocusedBlurDetected      // 초점 불일치 감지
    case notFrontNose               // 코가 정면이 아님
    case furDetected                // 털 감지
    case humanFaceDetected          // 사람 얼굴 감지
    case fakeDetected               // 가짜 사진 감지 (예: 모니터 화면)
    case unexpected                 // 예상치 못한 오류
}

// 나쁜 예: 코드에 하드코딩
let apiKey = "sk_live_abc123..."

// 좋은 예: Info.plist 또는 환경변수 사용
extension Bundle {
    var petnowAPIKey: String {
        guard let key = infoDictionary?["PETNOW_API_KEY"] as? String,
              !key.isEmpty else {
            fatalError("PETNOW_API_KEY not configured in Info.plist")
        }
        return key
    }
}

// 사용
LicenseInfo(apiKey: Bundle.main.petnowAPIKey, isDebugMode: false)

// SwiftUI
struct PetCameraView: View {
    @StateObject private var cameraViewModel: CameraViewModel
    
    var body: some View {
        CameraView(viewModel: cameraViewModel)
            .onDisappear {
                // 화면이 사라질 때 리소스 정리
                cameraViewModel.stopDetection()
            }
    }
}

// UIKit
deinit {
    cameraViewModel?.stopDetection()
}

import AVFoundation

func checkCameraPermission() async -> Bool {
    let status = AVCaptureDevice.authorizationStatus(for: .video)
    
    switch status {
    case .authorized:
        return true
        
    case .notDetermined:
        // 권한 요청
        return await AVCaptureDevice.requestAccess(for: .video)
        
    case .denied, .restricted:
        // 설정 앱으로 안내
        showPermissionAlert()
        return false
        
    @unknown default:
        return false
    }
}

// 카메라 표시 전에 확인
if await checkCameraPermission() {
    showCamera = true
} else {
    showError("카메라 권한이 필요합니다")
}

case .success(let fingerprintImages, let appearanceImages):
    // 이미지 읽기
    if let firstImage = UIImage(contentsOfFile: fingerprintImages[0].path) {
        // 이미지 사용
    }
    
    // 또는 Data로 변환
    if let imageData = try? Data(contentsOf: fingerprintImages[0]) {
        // Data 사용 (서버 업로드 등)
    }