dependencies: [
    .package(url: "https://github.com/Definex-Mobile/iOS-BiometricAuth-SDK.git", from: "1.0.0")
]

import DefXBiometric

// Check which biometric type is available
let biometricType = DefXBiometricAuth.shared.availableBiometricType()

switch biometricType {
case .faceID:
    print("✅ Face ID is available")
case .touchID:
    print("✅ Touch ID is available")
case .none:
    print("❌ No biometric authentication available")
}

// Check if biometric can be used right now
if DefXBiometricAuth.shared.isBiometricAvailable() {
    print("✅ Biometric authentication is ready")
}

DefXBiometricAuth.shared.authenticate(
    reason: "Authenticate to access your account"
) { result in
    switch result {
    case .success:
        print("✅ Authentication successful")
        // Navigate to authenticated screen
        
    case .failure(let error):
        switch error {
        case .cancelled:
            // User cancelled - handle gracefully
            break
            
        case .notAvailable, .notEnrolled:
            // Show alternative authentication
            showPasswordLogin()
            
        case .lockout:
            // Too many attempts - user must unlock device
            showLockoutAlert()
            
        case .systemError(let message):
            print("System error: \(message)")
            showPasswordLogin()
            
        default:
            showPasswordLogin()
        }
    }
}

// Shared singleton instance
public static let shared: DefXBiometricAuth

// Get available biometric type
public func availableBiometricType() -> BiometricType

// Check if biometric is available
public func isBiometricAvailable() -> Bool

// Authenticate user
public func authenticate(
    reason: String = "Authenticate to continue",
    fallbackTitle: String? = nil,  // Ignored (biometrics-only mode)
    completion: @escaping (Result<Void, BiometricError>) -> Void
)

public enum BiometricType {
    case faceID    // Face ID available
    case touchID   // Touch ID available
    case none      // No biometric available
}

public enum BiometricError: Error {
    case notAvailable        // Biometric not available
    case notEnrolled         // No biometric enrolled
    case lockout             // Too many failed attempts
    case cancelled           // User cancelled
    case fallback            // User chose fallback
    case systemError(String) // System error
    case unknown             // Unknown error
    
    // Stable identifier for localization
    public var identifier: String
}

// Uses default reason: "Authenticate to continue"
DefXBiometricAuth.shared.authenticate { result in
    // Handle result
}

// Custom reason (recommended)
DefXBiometricAuth.shared.authenticate(
    reason: "Login to your account"
) { result in
    // Handle result
}

switch error {
case .cancelled:
    // User cancelled - don't show error
    break
    
case .notAvailable, .notEnrolled:
    // Biometric not usable - show password
    showPasswordLogin()
    
case .lockout:
    // Guide user to unlock device
    showAlert("Too many attempts. Please unlock your device.")
    
case .systemError(let message):
    print("System error: \(message)")
    showPasswordLogin()
    
default:
    showPasswordLogin()
}

guard DefXBiometricAuth.shared.isBiometricAvailable() else {
    showPasswordLogin()
    return
}

DefXBiometricAuth.shared.authenticate(reason: "Login") { result in
    // Handle result
}

// ❌ BAD
authenticate(reason: "Authenticate")

// ✅ GOOD
authenticate(reason: "Authenticate to view your balance")
authenticate(reason: "Confirm payment of $50.00")