#import "BTUIThemedView.h"

typedef NS_OPTIONS(NSUInteger, BTUICardFormOptionalFields) {
    BTUICardFormOptionalFieldsNone       = 0,
    BTUICardFormOptionalFieldsCvv        = 1 << 0,
    BTUICardFormOptionalFieldsPostalCode = 1 << 1,
    BTUICardFormOptionalFieldsAll        = BTUICardFormOptionalFieldsCvv | BTUICardFormOptionalFieldsPostalCode
};

typedef NS_ENUM(NSUInteger, BTUICardFormField) {
    BTUICardFormFieldNumber = 0,
    BTUICardFormFieldExpiration,
    BTUICardFormFieldCvv,
    BTUICardFormFieldPostalCode
};

@protocol BTUICardFormViewDelegate;

@interface BTUICardFormView : BTUIThemedView

@property (nonatomic, weak) IBOutlet id<BTUICardFormViewDelegate> delegate;

@property (nonatomic, assign, readonly) BOOL valid;

/// The card number.
///
/// If you set a card number longer than is allowed by the card type,
/// it will not be set.
@property (nonatomic, copy) NSString *number;

/// The card CVV
///
/// @note this field is only visible when specified in `optionalFields`
@property (nonatomic, copy) NSString *cvv;

/// The card billing address postal code for AVS verifications
///
/// @note this field is only visible when specified in `optionalFields`
@property (nonatomic, copy) NSString *postalCode;

@property (nonatomic, copy, readonly) NSString *expirationMonth;
@property (nonatomic, copy, readonly) NSString *expirationYear;

/// Sets the card form view's expiration date
///
/// @param expirationDate The expiration date. Passing in `nil` will clear the
/// card form's expiry field.
- (void)setExpirationDate:(NSDate *)expirationDate;

/// Immediately present a top level error message to the user.
///
/// @param field Field to mark invalid.
- (void)showTopLevelError:(NSString *)message;

/// Immediately present a field-level error to the user.
///
/// @note We do not support field-level error descriptions. This method highlights the field to indicate invalidity.
/// @param field The invalid field
- (void)showErrorForField:(BTUICardFormField)field;

/// Configure whether to support complete alphanumeric postal codes.
///
/// If NO, allows only digit entry.
///
/// Defaults to YES
@property (nonatomic, assign) BOOL alphaNumericPostalCode;

/// Which fields should be included.
///
/// Defaults to BTUICardFormOptionalFieldsAll
@property (nonatomic, assign) BTUICardFormOptionalFields optionalFields;

/// Whether to provide feedback to the user via vibration
///
/// Defaults to YES
@property (nonatomic, assign) BOOL vibrate;


@end

/// Delegate protocol for receiving updates about the card form
@protocol BTUICardFormViewDelegate <NSObject>

/// The card form data has updated.
- (void)cardFormViewDidChange:(BTUICardFormView *)cardFormView;

@optional

- (void)cardFormViewDidBeginEditing:(BTUICardFormView *)cardFormView;


@end