Common objects

public struct PaymentResult {
  let payment: Payment?
  let paymentMethodData: PrimerPaymentMethodTokenData?
}

public struct PrimerError {
  let errorId: String
  let errorDescription: String?
  let diagnosticsId: String?
}

public struct PrimerSettings {
  public init(
    paymentHandling: PrimerPaymentHandling = .auto,
    uiOptions: PrimerUIOptions? = nil,
    paymentMethodOptions: PrimerPaymentMethodOptions? = nil
  )
}

public enum PrimerPaymentHandling {
  case auto    // Primer handles the full payment flow
  case manual  // Primer returns a token for server-side processing
}

public enum PrimerCheckoutState {
  case initializing
  case ready(totalAmount: Int, currencyCode: String)
  case success(PaymentResult)
  case dismissed
  case failure(PrimerError)
}

public enum PresentationContext {
  case direct               // Show cancel button
  case fromPaymentSelection // Show back button
}

public enum DismissalMechanism {
  case gestures    // Swipe-down dismissal
  case closeButton // Close/cancel button
}

public struct CheckoutPaymentMethod {
  let id: String
  let type: String                  // e.g., "PAYMENT_CARD", "PAYPAL"
  let name: String                  // Display name
  let icon: UIImage?
  let metadata: [String: Any]?
  let surcharge: Int?               // Minor units
  let hasUnknownSurcharge: Bool
  let formattedSurcharge: String?
  let backgroundColor: UIColor?
}

public struct FieldError: Equatable, Identifiable {
  let id: UUID
  let fieldType: PrimerInputElementType
  let message: String
  let errorCode: String?
}

public struct CardFormConfiguration: Equatable {
  let cardFields: [PrimerInputElementType]
  let billingFields: [PrimerInputElementType]
  let requiresBillingAddress: Bool
  var allFields: [PrimerInputElementType]
}

public struct FormData: Equatable {
  subscript(fieldType: PrimerInputElementType) -> String { get set }
  var dictionary: [PrimerInputElementType: String]
}

public struct FieldValidationStates: Equatable {
  // Card fields
  public var cardNumber: Bool
  public var cvv: Bool
  public var expiry: Bool
  public var cardholderName: Bool

  // Billing address fields
  public var postalCode: Bool
  public var countryCode: Bool
  public var city: Bool
  public var state: Bool
  public var addressLine1: Bool
  public var addressLine2: Bool
  public var firstName: Bool
  public var lastName: Bool
  public var email: Bool
  public var phoneNumber: Bool
}

let cardScope = checkoutScope.getPaymentMethodScope(DefaultCardFormScope.self)

// Report validation from your custom component
cardScope?.updateValidationState(\.cvv, isValid: true)
cardScope?.updateValidationState(\.cardNumber, isValid: false)

public struct FormFieldState: Equatable, Identifiable {
  public enum FieldType: String, Equatable, Sendable {
    case otpCode       // BLIK 6-digit code
    case phoneNumber   // MBWay phone number
  }

  public enum KeyboardType: Equatable, Sendable {
    case numberPad
    case phonePad
    case `default`
  }

  var id: String { fieldType.rawValue }
  let fieldType: FieldType
  var value: String
  var isValid: Bool
  var errorMessage: String?
  let placeholder: String
  let label: String
  let helperText: String?
  let keyboardType: KeyboardType
  let maxLength: Int?
  var countryCodePrefix: String?
  var dialCode: String?
}

@available(iOS 15.0, *)
public final class PrimerCheckoutPresenter {
  public static let shared: PrimerCheckoutPresenter
  public weak var delegate: PrimerCheckoutPresenterDelegate?
  public static var isAvailable: Bool
  public static var isPresenting: Bool

  public static func presentCheckout(
    clientToken: String,
    from viewController: UIViewController,
    primerSettings: PrimerSettings,
    primerTheme: PrimerCheckoutTheme,
    scope: ((PrimerCheckoutScope) -> Void)? = nil,
    completion: (() -> Void)? = nil
  )

  public static func dismiss(animated: Bool = true, completion: (() -> Void)? = nil)
}

public protocol PrimerCheckoutPresenterDelegate: AnyObject {
  // Required
  func primerCheckoutPresenterDidCompleteWithSuccess(_ result: PaymentResult)
  func primerCheckoutPresenterDidFailWithError(_ error: PrimerError)
  func primerCheckoutPresenterDidDismiss()

  // Optional (3DS)
  func primerCheckoutPresenterWillPresent3DSChallenge(_ paymentMethodTokenData: PrimerPaymentMethodTokenData)
  func primerCheckoutPresenterDidDismiss3DSChallenge()
  func primerCheckoutPresenterDidComplete3DSChallenge(success: Bool, resumeToken: String?, error: Error?)
}