Release v5.0.0

Button.framework/Versions/A/Headers/BTNAppAction.h

@@ -9,30 +9,31 @@
 /**
  An App Action represents a button (i.e. “preview”) and inventory typically rendered as a “commerce card”.
  */
+
 @interface BTNAppAction : BTNModelObject
 
 /// App action metadata (id, source token, expiry, etc).
-@property (nonatomic, copy, readonly) BTNAppActionMeta *meta;
+@property (nullable, nonatomic, copy, readonly) BTNAppActionMeta *meta;
 
 
 /// The button preview data.
-@property (nonatomic, copy, readonly) BTNPreview *preview;
+@property (nullable, nonatomic, copy, readonly) BTNPreview *preview;
 
 
 /// Heading information for the inventory.
-@property (nonatomic, strong, readonly) BTNHeader *header;
+@property (nullable, nonatomic, strong, readonly) BTNHeader *header;
 
 
 /// Grouped inventory (note: one of `groups` or `product` will be non-nil).
-@property (nonatomic, strong, readonly) NSArray<BTNGroup *> *groups;
+@property (nullable, nonatomic, strong, readonly) NSArray<BTNGroup *> *groups;
 
 
 /// A single product representation (note: one of `groups` or `product` will be non-nil).
-@property (nonatomic, strong, readonly) BTNProduct *product;
+@property (nullable, nonatomic, strong, readonly) BTNProduct *product;
 
 
 /// Footer information for the inventory and default action.
-@property (nonatomic, strong, readonly) BTNFooter *footer;
+@property (nullable, nonatomic, strong, readonly) BTNFooter *footer;
 
 
 
@@ -61,7 +62,7 @@
  @note Users will be sent to the destination application or through the
  Attended Install flow if the destination application is not installed.
  */
-- (void)invokeActionForListItem:(BTNListItem *)listItem;
+- (void)invokeActionForListItem:(nonnull BTNListItem *)listItem;
 
 
 /**
@@ -86,6 +87,6 @@
  @param completionHandler A block to be executed once the image data has loaded.
  @note The completionHandler takes one argument, a UIImage or nil if an error occurred.
  */
-- (void)fetchPreviewIconImageWithCompletion:(void(^)(UIImage *image))completionHandler;
+- (void)fetchPreviewIconImageWithCompletion:(nonnull void(^)(UIImage * __nullable image))completionHandler;
 
 @end

Button.framework/Versions/A/Headers/BTNAppActionMeta.h

@@ -4,30 +4,31 @@
  App action metadata objects contain information about the referrer, 
  destination app, and expiration of an app action.
  */
+
 @interface BTNAppActionMeta : BTNModelObject
 
 /// The app action identifier.
-@property (nonatomic, copy, readonly) NSString *appActionId;
+@property (nullable, nonatomic, copy, readonly) NSString *appActionId;
 
 
 /// The store id of the app represented by an app action.
-@property (nonatomic, copy, readonly) NSString *storeId;
+@property (nullable, nonatomic, copy, readonly) NSString *storeId;
 
 
 /// The source/referrer token associated with an app action.
-@property (nonatomic, copy, readonly) NSString *sourceToken;
+@property (nullable, nonatomic, copy, readonly) NSString *sourceToken;
 
 
 /// The maximum age in seconds an app action is valid.
-@property (nonatomic, copy, readonly) NSNumber *maxAgeSeconds;
+@property (nullable, nonatomic, copy, readonly) NSNumber *maxAgeSeconds;
 
 
 /// The deep link scheme for enabling attended install.
-@property (nonatomic, copy, readonly) NSURL *deepLinkScheme;
+@property (nullable, nonatomic, copy, readonly) NSURL *deepLinkScheme;
 
 
 /// The name of the app represented by an app action.
-@property (nonatomic, copy, readonly) NSString *appDisplayName;
+@property (nullable, nonatomic, copy, readonly) NSString *appDisplayName;
 
 
 /**

Button.framework/Versions/A/Headers/BTNBackground.h

@@ -4,8 +4,9 @@
 /**
  BTNBackground objects specify how to fill a background.
  */
+
 @interface BTNBackground : BTNModelObject
 
-@property (nonatomic, copy, readonly) NSString *color;
+@property (nullable, nonatomic, copy, readonly) NSString *color;
 
 @end

Button.framework/Versions/A/Headers/BTNBaseEntity.h

@@ -4,6 +4,9 @@
 /**
  All fields are optional and should be populated only if known.
  */
+
+NS_ASSUME_NONNULL_BEGIN
+
 @interface BTNBaseEntity : BTNModelObject <BTNSubscriptable>
 
 /**
@@ -66,3 +69,4 @@ extern NSString * const BTNIDProviderYelp;
 
 extern NSString * const BTNIDProviderSelfProvided;
 
+NS_ASSUME_NONNULL_END

Button.framework/Versions/A/Headers/BTNContext.h

@@ -10,6 +10,9 @@
  All fields are optional and should be populated only if known.
  @see `BTNBaseEntity` for inherited configuration options.
  */
+
+NS_ASSUME_NONNULL_BEGIN
+
 @interface BTNContext : BTNBaseEntity
 
 ///--------------------
@@ -172,3 +175,5 @@
 - (void)addCustomValue:(id)obj forContextKey:(NSString *)key;
 
 @end
+
+NS_ASSUME_NONNULL_END

Button.framework/Versions/A/Headers/BTNDropinButton.h

@@ -2,11 +2,10 @@
 #import "BTNDropinButtonAppearanceProtocol.h"
 #import "BTNContext.h"
 
-
 @interface BTNDropinButton : UIControl <BTNDropinButtonAppearance>
 
-/// The identifier for this button instance (e.g. venue_page).
-@property (nonatomic, copy) IBInspectable NSString *buttonId;
+/// The identifier for this button instance (e.g. btn-xxxxxxxxxx).
+@property (nullable, nonatomic, copy) IBInspectable NSString *buttonId;
 
 
 /**
@@ -19,8 +18,8 @@
  based on the value of `isDisplayable`. For example, you may want to remove a cell 
  from your tableView if the button is not displayable.
  */
-- (void)prepareWithContext:(BTNContext *)context
-                completion:(void(^)(BOOL isDisplayable))completionHandler;
+- (void)prepareWithContext:(nonnull BTNContext *)context
+                completion:(nullable void(^)(BOOL isDisplayable))completionHandler;
 
 
 /**
@@ -30,7 +29,7 @@
  @note The button will not be ready for display until -prepareWithContext:completion: completes.
  @see -prepareWithContext:completion:
  */
-- (instancetype)initWithButtonId:(NSString *)buttonId;
+- (nonnull instancetype)initWithButtonId:(nonnull NSString *)buttonId;
 
 
 ///-----------------

Button.framework/Versions/A/Headers/BTNDropinButtonAppearanceProtocol.h

@@ -27,7 +27,7 @@
 
 
 /// Defines the color of the dropin button border.
-@property (nonatomic, strong) UIColor *borderColor UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIColor *borderColor UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the size of the icon view in the dropin button (applied to height and width).
@@ -39,15 +39,15 @@
 
 
 /// Defines the font used in the dropin button.
-@property (nonatomic, strong) UIFont *font UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIFont *font UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the font used on the title label in the dropin button.
-@property (nonatomic, strong) UIFont *titleFont UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIFont *titleFont UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the font used on the subtitle label in the dropin button.
-@property (nonatomic, strong) UIFont *subtitleFont UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIFont *subtitleFont UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the string case of all dropin button text.
@@ -63,39 +63,34 @@
 
 
 /// Defines the color of the dropin text.
-@property (nonatomic, strong) UIColor *tintColor UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIColor *tintColor UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the highlighted tint color of the dropin button, text.
-@property (nonatomic, strong) UIColor *highlightedTintColor UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIColor *highlightedTintColor UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the color of the dropin button title text (supersedes tintColor).
-@property (nonatomic, strong) UIColor *titleTextColor UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIColor *titleTextColor UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the color of the dropin button subtitle text (supersedes tintColor).
-@property (nonatomic, strong) UIColor *subtitleTextColor UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIColor *subtitleTextColor UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the color of all dropin button text (supersedes tintColor).
-@property (nonatomic, strong) UIColor *textColor UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIColor *textColor UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the highlighted color of all dropin button text (supersedes highlightedTintColor).
-@property (nonatomic, strong) UIColor *highlightedTextColor UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIColor *highlightedTextColor UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the normal background color for the button.
-@property (nonatomic, strong) UIColor *normalBackgroundColor UI_APPEARANCE_SELECTOR;
+@property (nullable, nonatomic, strong) UIColor *normalBackgroundColor UI_APPEARANCE_SELECTOR;
 
 
 /// Defines the highlighted background color for the button.
-@property (nonatomic, strong) UIColor *highlightedBackgroundColor UI_APPEARANCE_SELECTOR;
-
-
-@property (nonatomic, strong) UIColor *iconColor DEPRECATED_ATTRIBUTE;
-@property (nonatomic, strong) UIColor *highlightedIconColor DEPRECATED_ATTRIBUTE;
-
+@property (nullable, nonatomic, strong) UIColor *highlightedBackgroundColor UI_APPEARANCE_SELECTOR;
 
 @end

Button.framework/Versions/A/Headers/BTNDropinButtonCell.h

@@ -8,11 +8,11 @@
 @interface BTNDropinButtonCell : UITableViewCell <BTNDropinButtonAppearance>
 
 /// The ID of the button this cell represents.
-@property (nonatomic, copy) IBInspectable NSString *buttonId;
+@property (nullable, nonatomic, copy) IBInspectable NSString *buttonId;
 
 
 /// The dropin button that displays the use case action (e.g. Get a ride).
-@property (nonatomic, strong) IBOutlet BTNDropinButton *dropinButton;
+@property (nullable, nonatomic, strong) IBOutlet BTNDropinButton *dropinButton;
 
 
 /**
@@ -25,8 +25,8 @@
  after completion. For example, you may want to remove this cell from your tableView
  if the button is not displayable.
  */
-- (void)prepareWithContext:(BTNContext *)context
-                completion:(void(^)(BOOL isDisplayable))completionHandler;
+- (void)prepareWithContext:(nonnull BTNContext *)context
+                completion:(nullable void(^)(BOOL isDisplayable))completionHandler;
 
 
 ///-----------------

Button.framework/Versions/A/Headers/BTNEvent.h

@@ -5,6 +5,9 @@
  All fields are optional and should be populated only if known.
  @see `BTNBaseEntity` for inherited configuration options.
  */
+
+NS_ASSUME_NONNULL_BEGIN
+
 @interface BTNEvent : BTNBaseEntity
 
 /**
@@ -30,3 +33,5 @@
 - (void)setEndTime:(NSDate *)endTime;
 
 @end
+
+NS_ASSUME_NONNULL_END

Button.framework/Versions/A/Headers/BTNFooter.h

@@ -9,14 +9,14 @@
 @interface BTNFooter : BTNModelObject
 
 /// The footer text.
-@property (nonatomic, copy, readonly) BTNText *labelText;
+@property (nullable, nonatomic, copy, readonly) BTNText *labelText;
 
 
 /// An icon image.
-@property (nonatomic, copy, readonly) BTNImage *iconImage;
+@property (nullable, nonatomic, copy, readonly) BTNImage *iconImage;
 
 
 /// The footer background.
-@property (nonatomic, copy, readonly) BTNBackground *background;
+@property (nullable, nonatomic, copy, readonly) BTNBackground *background;
 
 @end

Button.framework/Versions/A/Headers/BTNGroup.h

@@ -8,9 +8,9 @@
 @interface BTNGroup : BTNModelObject
 
 /// The title of the group.
-@property (nonatomic, copy, readonly) BTNText *titleText;
+@property (nullable, nonatomic, copy, readonly) BTNText *titleText;
 
 /// An array of items in the group.
-@property (nonatomic, copy, readonly) NSArray <BTNListItem *> *items;
+@property (nullable, nonatomic, copy, readonly) NSArray <BTNListItem *> *items;
 
 @end

Button.framework/Versions/A/Headers/BTNHeader.h

@@ -8,14 +8,14 @@
 @interface BTNHeader : BTNModelObject
 
 /// The main heading text.
-@property (nonatomic, copy, readonly) BTNText *titleText;
+@property (nullable, nonatomic, copy, readonly) BTNText *titleText;
 
 
 /// An optional smaller subheading text.
-@property (nonatomic, copy, readonly) BTNText *subtitleText;
+@property (nullable, nonatomic, copy, readonly) BTNText *subtitleText;
 
 
 /// The header background.
-@property (nonatomic, copy, readonly) BTNBackground *background;
+@property (nullable, nonatomic, copy, readonly) BTNBackground *background;
 
 @end

Button.framework/Versions/A/Headers/BTNImage.h

@@ -8,14 +8,14 @@
 @interface BTNImage : BTNModelObject
 
 /// The URL of an image to be retrieved.
-@property (nonatomic, copy, readonly) NSURL *URL;
+@property (nullable, nonatomic, copy, readonly) NSURL *URL;
 
 
 /// The fill mode of an image (aspect fit or aspect fill).
 @property (nonatomic, assign, readonly) UIViewContentMode fillMode;
 
 
 /// Alternative text for the image.
-@property (nonatomic, copy, readonly) BTNText *altText;
+@property (nullable, nonatomic, copy, readonly) BTNText *altText;
 
 @end

Button.framework/Versions/A/Headers/BTNItem.h

@@ -4,6 +4,9 @@
  All fields are optional and should be populated only if known.
  @see `BTNBaseEntity` for inherited configuration options.
  */
+
+NS_ASSUME_NONNULL_BEGIN
+
 @interface BTNItem : BTNBaseEntity
 
 /**
@@ -46,3 +49,5 @@
 - (void)setUPC:(NSString *)UPC;
 
 @end
+
+NS_ASSUME_NONNULL_END

Button.framework/Versions/A/Headers/BTNJourney.h

@@ -17,6 +17,9 @@ typedef NS_ENUM(NSInteger, BTNTransportType) {
  All fields are optional and should be populated only if known.
  @see `BTNBaseEntity` for inherited configuration options.
  */
+
+NS_ASSUME_NONNULL_BEGIN
+
 @interface BTNJourney : BTNBaseEntity
 
 /// Sets the starting location of the journey.
@@ -40,3 +43,4 @@ typedef NS_ENUM(NSInteger, BTNTransportType) {
 
 @end
 
+NS_ASSUME_NONNULL_END