@selligent-marketing-cloud/selligent-react-native 2.2.0 → 2.6.0

package/ios/SelligentReactNative.xcodeproj/project.pbxproj

@@ -7,7 +7,7 @@
 	objects = {
 
 /* Begin PBXBuildFile section */
-		607CB0D425629754007201AB /* libSelligentMobile2.5.a in Frameworks */ = {isa = PBXBuildFile; fileRef = 607CB0D325629754007201AB /* libSelligentMobile2.5.a */; };
+		60A5C5B5261747570002B0A2 /* libSelligentMobile2.5.2.a in Frameworks */ = {isa = PBXBuildFile; fileRef = 60A5C5B4261747570002B0A2 /* libSelligentMobile2.5.2.a */; };
 		B3E7B58A1CC2AC0600A0062D /* RNSelligent.m in Sources */ = {isa = PBXBuildFile; fileRef = B3E7B5891CC2AC0600A0062D /* RNSelligent.m */; };
 		E5002D3320F5002A00F68509 /* ClientSettings.m in Sources */ = {isa = PBXBuildFile; fileRef = E5002D3120F5002A00F68509 /* ClientSettings.m */; };
 		E5002D3620F5004200F68509 /* SMManagerSetting+ClientSettings.m in Sources */ = {isa = PBXBuildFile; fileRef = E5002D3520F5004200F68509 /* SMManagerSetting+ClientSettings.m */; };
@@ -32,7 +32,7 @@
 
 /* Begin PBXFileReference section */
 		134814201AA4EA6300B7C361 /* libRNSelligent.a */ = {isa = PBXFileReference; explicitFileType = archive.ar; includeInIndex = 0; path = libRNSelligent.a; sourceTree = BUILT_PRODUCTS_DIR; };
-		607CB0D325629754007201AB /* libSelligentMobile2.5.a */ = {isa = PBXFileReference; lastKnownFileType = archive.ar; path = libSelligentMobile2.5.a; sourceTree = "<group>"; };
+		60A5C5B4261747570002B0A2 /* libSelligentMobile2.5.2.a */ = {isa = PBXFileReference; lastKnownFileType = archive.ar; path = libSelligentMobile2.5.2.a; sourceTree = "<group>"; };
 		B3E7B5881CC2AC0600A0062D /* RNSelligent.h */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.h; path = RNSelligent.h; sourceTree = "<group>"; };
 		B3E7B5891CC2AC0600A0062D /* RNSelligent.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = RNSelligent.m; sourceTree = "<group>"; };
 		E5002D3120F5002A00F68509 /* ClientSettings.m */ = {isa = PBXFileReference; fileEncoding = 4; lastKnownFileType = sourcecode.c.objc; path = ClientSettings.m; sourceTree = "<group>"; };
@@ -110,7 +110,7 @@
 			isa = PBXFrameworksBuildPhase;
 			buildActionMask = 2147483647;
 			files = (
-				607CB0D425629754007201AB /* libSelligentMobile2.5.a in Frameworks */,
+				60A5C5B5261747570002B0A2 /* libSelligentMobile2.5.2.a in Frameworks */,
 			);
 			runOnlyForDeploymentPostprocessing = 0;
 		};
@@ -128,7 +128,7 @@
 		58B511D21A9E6C8500147676 = {
 			isa = PBXGroup;
 			children = (
-				607CB0D325629754007201AB /* libSelligentMobile2.5.a */,
+				60A5C5B4261747570002B0A2 /* libSelligentMobile2.5.2.a */,
 				E58A8CAC20F32CB4005EA433 /* include */,
 				E5002D3720F500C200F68509 /* SelligentLogger.h */,
 				E5002D3820F500C200F68509 /* SelligentLogger.m */,

package/ios/include/SMBaseMessage.h

@@ -10,39 +10,39 @@
 
 /*!
  *  @discussion This is the Base class for message (push notif, in app message and in app content)
- *  #SMBaseMessage :#
  */
 @interface SMBaseMessage : NSObject
 
 /*!
  *  NSString instance providing the id of the message
  */
-@property (nonatomic) NSString *idMessage;
+@property (readonly, nonatomic) NSString *_Nullable idMessage;
 
 /*!
  *  NSDate instance providing the creation date of the message
- *  @deprecated Deprecated use receptionDate  instead
+ *
+ *  @warning Deprecated - use receptionDate  instead
  */
-@property (nonatomic) NSDate *dateCreation __deprecated __deprecated_msg("Use receptionDate instead");
+@property (readonly, nonatomic) NSDate *_Nullable dateCreation __deprecated __deprecated_msg("Use receptionDate instead");
 
 /*!
  *  NSDate instance providing the reception date on sdk side of the message
 */
-@property (nonatomic) NSDate *receptionDate;
+@property (readonly, nonatomic) NSDate *_Nullable receptionDate;
 
 /*!
  *  NSDate instance providing the expiration date of the message
  */
-@property (nonatomic) NSDate   *expirationDate;
+@property (readonly, nonatomic) NSDate *_Nullable expirationDate;
 
 /*!
  *  NSDate instance providing the creation date of the message
  */
-@property (nonatomic) NSDate   *creationDate;
+@property (readonly, nonatomic) NSDate *_Nullable creationDate;
 
 /*!
  *  bool instance infiorming if the message has already been displayed and viewed by user
  */
-@property (nonatomic) bool    isViewed;
+@property (readonly, nonatomic) bool isViewed;
 
 @end

package/ios/include/SMBlock.h

@@ -12,10 +12,10 @@
  *  @typedef type of block that will be triggered when an event has been succesfully sent
  *  @param success a SMSuccess object
  */
-typedef void(^SMCompletionBlockSuccess)(SMSuccess *success);
+typedef void(^SMCompletionBlockSuccess)(SMSuccess *_Nullable success);
 
 /**
  *  @typedef type of block that will be triggered when an event has failed to be sent
  *  @param failure a SMFailure failure
  */
-typedef void(^SMCompletionBlockFailure)(SMFailure *failure);
+typedef void(^SMCompletionBlockFailure)(SMFailure *_Nullable failure);

package/ios/include/SMClearCache.h

@@ -6,10 +6,8 @@
 //  Copyright (c) 2015 Selligent. All rights reserved.
 //
 
-
 /**
  *  Enumeration used to define how often the SDK's cache should automaticaly clear itself
- *  #SMClearCache :#
  */
 typedef NS_ENUM(NSInteger, SMClearCache) {
     /**

package/ios/include/SMContentAlignment.h

@@ -7,7 +7,7 @@
 //
 
 /**
- *  #SMContentAlignment :#
+ *
  */
 typedef NS_ENUM(NSInteger, SMContentAlignment) {
     /*!
@@ -25,4 +25,3 @@ typedef NS_ENUM(NSInteger, SMContentAlignment) {
      */
     kSMAlignCenter
 };
-

package/ios/include/SMDeviceInfos.h

@@ -9,28 +9,30 @@
 #import <Foundation/Foundation.h>
 
 /*!
- * #SMDeviceInfos :#
  */
 @interface SMDeviceInfos : NSObject
 
 /*!
  *  Any External Id in your possession that you wish to transmit to the back-end
- *  @discussion NSString
+ *
+ *  @discussion NSString representing your external, custom identifier.
  *  By default, it is an empty string
  */
-@property (nonatomic) NSString *externalId;
+@property (nonatomic) NSString* _Nullable externalId;
 
 /*!
  *  Create a generic deviceinfos object
- *  @return a SMDeviceInfos object
+ *
+ *  @return An SMDeviceInfos object
  */
-+ (instancetype)defaultDeviceInfos;
++ (instancetype _Nullable ) defaultDeviceInfos;
 
 /*!
  *  Create a deviceinfos object with an external id property already set with the value provided
- *  @param externalId a string containing the id you want to provide to the back-end
- *  @return a SMDeviceInfos object
+ *
+ *  @param externalId An string containing the id you want to provide to the back-end
+ *  @return An SMDeviceInfos object
  */
-+ (instancetype)deviceInfosWithExternalId:(NSString*) externalId;
++ (instancetype _Nullable ) deviceInfosWithExternalId:(NSString*_Nullable) externalId;
 
 @end

package/ios/include/SMDisplayMode.h

@@ -6,9 +6,8 @@
 //  Copyright © 2016 Selligent. All rights reserved.
 //
 
-
 /*!
- *  #SMDisplayMode :#
+ *
  */
 typedef NS_ENUM(NSInteger, SMDisplayMode) {
     /*!

package/ios/include/SMEvent.h

@@ -11,15 +11,11 @@
 #import "SMFailure.h"
 #import "SMSuccess.h"
 
-
-
 /*!
- * @discussion This is the Base class for all type of events
- * #SMEvent :#
+ * This is the Base class for all type of events
  */
 @interface SMEvent : NSObject
 
-
 /*!
  *  Confirm if the current event should be cached or not
  *  @discussion If the event fail to be delivered to your backend, then by default, it is cached into an internal queue.
@@ -29,36 +25,44 @@
  */
 @property (nonatomic) BOOL shouldCache;
 
-
-
 /*!
  *  Create a generic event object that will be sent to platform
- *  @param dict a Dictionary containing any kind of custom datas that must be stored and managed by platform
- *  @return a SMEvent object
+ *
+ *  @param dict A Dictionary containing any kind of custom datas that must be stored and managed by platform
+ *  @return An SMEvent object
  */
-+ (instancetype _Nonnull)eventWithDictionary:(NSDictionary* _Nullable)dict;
++ (instancetype _Nonnull) eventWithDictionary:(NSDictionary* _Nullable)dict;
 
 /*!
  *  Allow to initialise a success block and/or a failure block that will be triggered after an event is sent to the platform
  *
- *  @param blockSuccess a SMCompletionBlockSuccess block that will be triggered if the send to the platform is successfull
- *  @param blockFailure a SMCompletionBlockFailure block that will be triggered if the send to the platform has failed
+ *  @param blockSuccess An SMCompletionBlockSuccess block that will be triggered if the send to the platform is successfull
+ *  @param blockFailure An SMCompletionBlockFailure block that will be triggered if the send to the platform has failed
  *  @discussion This method may be used as follow:
  *
  *  @code
  *  NSDictionary *dictMyCustomData = @{@"MyKey": @"MyValue"};
+ *
  *  SMEvent *event = [SMEvent eventWithDictionary:dictMyCustomData];
- *  [event applyBlockSuccess:^(SMSuccess *success) { 
- *  //  My code for success} 
- *  BlockFailure:^(SMFailure *failure) { 
+ *
+ *  [event applyBlockSuccess:^(SMSuccess *success) {
+ *
+ *  //  My code for success}
+ *
+ *  BlockFailure:^(SMFailure *failure) {
+ *
  *  //  My code for failure }];
+ *
  *  [[SMManager sharedInstance] sendSMEvent:event];
  *  @endcode
+ *  
  *  This method is optional. Use it only if you need it.
  *  @warning It is developer's responsability to make sure no strong retrain cycles are added to the completion-blocks.
  *  Make sure to read the following [Apple documentation.](https://developer.apple.com/library/ios/documentation/Cocoa/Conceptual/ProgrammingWithObjectiveC/WorkingwithBlocks/WorkingwithBlocks.html#//apple_ref/doc/uid/TP40011210-CH8-SW16)
+ *  @see SMCompletionBlockSuccess
+ *  @see SMCompletionBlockFailure
  */
-- (void)applyBlockSuccess:(SMCompletionBlockSuccess _Nullable)blockSuccess BlockFailure:(SMCompletionBlockFailure _Nullable)blockFailure;
+- (void) applyBlockSuccess:(SMCompletionBlockSuccess _Nullable)blockSuccess BlockFailure:(SMCompletionBlockFailure _Nullable)blockFailure;
 
 @end
 

package/ios/include/SMEventUser.h

@@ -9,7 +9,6 @@
 #import "SMEvent.h"
 
 /*!
- *  @inherits SMEvent
  *  @discussion Class representing all User-eventing
  *  Instances of this class should not be directly created.
  *  Please use children classes instead.

package/ios/include/SMEventUserLogin.h

@@ -9,38 +9,33 @@
 #import "SMEventUser.h"
 
 /*!
- * @class SMEventUserLogin
- * @inherits SMEventUser
- * @discussion user login event class
- * #SMEventUserLogin:#
+ * User login event class
  */
 @interface SMEventUserLogin : SMEventUser
 
-
 /*!
  *  Create a UserLogin event object that will be sent to selligent platform when user logged in
  *
- *  @param mail the e-mail of the user
- *  @return a SMEventUserLogin object
+ *  @param mail The e-mail of the user
+ *  @return An SMEventUserLogin object
  */
-+ (instancetype _Nonnull)eventWithEmail:(NSString*_Null_unspecified)mail;
++ (instancetype _Nonnull) eventWithEmail:(NSString*_Null_unspecified)mail;
 
 /*!
  *  Create a UserLogin event object that will be sent to selligent platform when user logged in
  *
- *  @param mail the e-mail of the user
- *  @param dict a Dictionary containing a string as data that must be stored and managed by platform
+ *  @param mail The e-mail of the user
+ *  @param dict A Dictionary containing a string as data that must be stored and managed by platform
  *  If email is not provided you can use in the dictionary an alternate key/value field to search for the user
- *     example: [SMEventUserLogin eventWithEmail @"" Dictionary: @{@"userID": @"1234"}];
- *  @return a SMEventUserLogin object
+ *  @return An SMEventUserLogin object
  */
-+ (instancetype _Nonnull)eventWithEmail:(NSString*_Null_unspecified)mail Dictionary:(NSDictionary<NSString*,NSString*>*_Nullable)dict;
++ (instancetype _Nonnull) eventWithEmail:(NSString*_Null_unspecified)mail Dictionary:(NSDictionary<NSString*,NSString*>*_Nullable)dict;
 
 /*!
  *  Create a UserLogin event object that will be sent to platform
- *  @param dict a Dictionary containing an alternate key/value field to search for the user
- *     example: [SMEventUserLogin eventWithDictionary: @{@"userID": @"1234"}];
- *  @return a SMEventUserLogin object
+ *
+ *  @param dict A Dictionary containing an alternate key/value field to search for the user
+ *  @return An SMEventUserLogin object
  */
 + (instancetype _Nonnull)eventWithDictionary:(NSDictionary* _Nullable)dict;
 

package/ios/include/SMEventUserLogout.h

@@ -9,38 +9,34 @@
 #import "SMEventUser.h"
 
 /*!
- * @class SMEventUserLogout
- * @inherits SMEventUser
- * @discussion user logout event class
- * #SMEventUserLogout:#
+ * User logout event class
  */
 @interface SMEventUserLogout : SMEventUser
 
 /*!
  *  Create a UserLogout event object that will be sent to selligent platform when user logged out
  *
- *  @param mail the e-mail of the user
- *  @return a SMEventUserLogout object
+ *  @param mail The e-mail of the user
+ *  @return An SMEventUserLogout object
  */
-+ (instancetype _Nonnull)eventWithEmail:(NSString*_Null_unspecified)mail;
++ (instancetype _Nonnull) eventWithEmail:(NSString*_Null_unspecified)mail;
 
 /*!
  *  Create a UserLogout event object that will be sent to selligent platform when user logged out
  *
- *  @param mail the e-mail of the user
- *  @param dict a Dictionary containing a string as data that must be stored and managed by platform
+ *  @param mail The e-mail of the user
+ *  @param dict A Dictionary containing a string as data that must be stored and managed by platform
  *  If email is not provided you can use in the dictionary an alternate key/value field to search for the user
- *     example: [SMEventUserLogout eventWithEmail @"" Dictionary: @{@"userID": @"1234"}];
- *  @return a SMEventUserLogout object
+ *  @return An SMEventUserLogout object
  */
-+ (instancetype _Nonnull)eventWithEmail:(NSString*_Null_unspecified)mail Dictionary:(NSDictionary<NSString*,NSString*>*_Nullable)dict;
++ (instancetype _Nonnull) eventWithEmail:(NSString*_Null_unspecified)mail Dictionary:(NSDictionary<NSString*,NSString*>*_Nullable)dict;
 
 /*!
  *  Create a UserLogout event object that will be sent to platform
- *  @param dict a Dictionary containing an alternate key/value field to search for the user
- *     example: [SMEventUserLogout eventWithDictionary:@{@"userID": @"1234"}];
- *  @return a SMEventUserLogout object
+ *
+ *  @param dict A Dictionary containing an alternate key/value field to search for the user
+ *  @return An SMEventUserLogout object
  */
-+ (instancetype _Nonnull)eventWithDictionary:(NSDictionary* _Nullable)dict;
++ (instancetype _Nonnull) eventWithDictionary:(NSDictionary* _Nullable)dict;
 
 @end

package/ios/include/SMEventUserRegistration.h

@@ -9,39 +9,34 @@
 #import "SMEventUser.h"
 
 /*!
- * @class SMEventUserRegistration
- * @inherits SMEventUser
- * @discussion user registration event class
- * #SMEventUserRegistration:#
+ * User registration event class
  */
 @interface SMEventUserRegistration : SMEventUser
 
-
 /*!
  *  Create a UserRegistration event object that will be sent to selligent platform when user registered
  *
- *  @param mail the e-mail of the user
- *  @return a SMEventUserRegistration object
+ *  @param mail The e-mail of the user
+ *  @return An SMEventUserRegistration object
  */
-+ (instancetype _Nonnull)eventWithEmail:(NSString*_Null_unspecified)mail;
++ (instancetype _Nonnull) eventWithEmail:(NSString*_Null_unspecified)mail;
 
 /*!
  *  Create a UserRegistration event object that will be sent to selligent platform when user registered
  *
- *  @param mail the e-mail of the user
- *  @param dict a Dictionary containing a string as data that must be stored and managed by platform
+ *  @param mail The e-mail of the user
+ *  @param dict A Dictionary containing a string as data that must be stored and managed by platform
  *  If email is not provided you can use in the dictionary an alternate key/value field to search for the user
- *     example: [SMEventUserRegistration eventWithEmail @"" Dictionary: @{@"userID": @"1234"}];
- *  @return a SMEventUserRegistration object
+ *  @return An SMEventUserRegistration object
  */
-+ (instancetype _Nonnull)eventWithEmail:(NSString*_Null_unspecified)mail Dictionary:(NSDictionary<NSString*,NSString*>*_Nullable)dict;
++ (instancetype _Nonnull) eventWithEmail:(NSString*_Null_unspecified)mail Dictionary:(NSDictionary<NSString*,NSString*>*_Nullable)dict;
 
 /*!
  *  Create a UserRegistration event object that will be sent to platform
- *  @param dict a Dictionary containing an alternate key/value field to search for the user
- *     example: [SMEventUserRegistration eventWithDictionary:@{@"userID": @"1234"}];
- *  @return a SMEventUserRegistration object
+ *  
+ *  @param dict A Dictionary containing an alternate key/value field to search for the user
+ *  @return An SMEventUserRegistration object
  */
-+ (instancetype _Nonnull)eventWithDictionary:(NSDictionary* _Nullable)dict;
++ (instancetype _Nonnull) eventWithDictionary:(NSDictionary* _Nullable)dict;
 
 @end

package/ios/include/SMEventUserUnregistration.h

@@ -9,38 +9,34 @@
 #import "SMEventUser.h"
 
 /*!
- * @class SMEventUserUnregistration
- * @inherits SMEventUser
- * @discussion user unregistration event class
- * #SMEventUserUnregistration:#
+ * User unregistration event class
  */
 @interface SMEventUserUnregistration : SMEventUser
 
 /*!
  *  Create a UserUnregistration event object that will be sent to selligent platform when user unregistered
  *
- *  @param mail the e-mail of the user
- *  @return a SMEventUserUnregistration object
+ *  @param mail The e-mail of the user
+ *  @return An SMEventUserUnregistration object
  */
-+ (instancetype _Nonnull)eventWithEmail:(NSString* _Null_unspecified)mail;
++ (instancetype _Nonnull) eventWithEmail:(NSString* _Null_unspecified)mail;
 
 /*!
  *  Create a UserUnregistration event object that will be sent to selligent platform when user unregistered
  *
- *  @param mail the e-mail of the user
- *  @param dict a Dictionary containing a string as data that must be stored and managed by platform
+ *  @param mail The e-mail of the user
+ *  @param dict A Dictionary containing a string as data that must be stored and managed by platform
  *  If email is not provided you can use in the dictionary an alternate key/value field to search for the user
- *     example: [SMEventUserUnregistration eventWithEmail @"" Dictionary: @{@"userID": @"1234"}];
- *  @return a SMEventUserUnregistration object
+ *  @return An SMEventUserUnregistration object
  */
-+ (instancetype _Nonnull)eventWithEmail:(NSString* _Null_unspecified)mail Dictionary:(NSDictionary<NSString*,NSString*>* _Nullable)dict;
++ (instancetype _Nonnull) eventWithEmail:(NSString* _Null_unspecified)mail Dictionary:(NSDictionary<NSString*,NSString*>* _Nullable)dict;
 
 /*!
  *  Create a UserUnregistration event object that will be sent to platform
- *  @param dict a Dictionary containing an alternate key/value field to search for the user
- *     example: [SMEventUserUnregistration eventWithDictionary:@{@"userID": @"1234"}];
- *  @return a SMEventUserUnregistration object
+ *
+ *  @param dict A Dictionary containing an alternate key/value field to search for the user
+ *  @return An SMEventUserUnregistration object
  */
-+ (instancetype _Nonnull)eventWithDictionary:(NSDictionary* _Nullable)dict;
++ (instancetype _Nonnull) eventWithDictionary:(NSDictionary* _Nullable)dict;
 
 @end

package/ios/include/SMFailure.h

@@ -9,15 +9,10 @@
 #import "SMMessage.h"
 
 /*!
- *  @discussion This class is used to return any error
- *  #SMFailure:#
+ *  This class is used to return any error
  */
 @interface SMFailure : SMMessage
 
-
-
-
-
 @end
 
 

package/ios/include/SMHelper.h

@@ -1,17 +1,21 @@
 //
-//  SMHelper.h
+//  SMHelper+Location.h
 //  MobileSDK
 //
-//  Created by Samy Ziat on 29/09/15.
-//  Copyright (c) 2015 Selligent. All rights reserved.
+//  Created by Marc Biosca on 6/29/21.
+//  Copyright © 2021 Selligent. All rights reserved.
 //
 
+#import "SMManager+Location.h"
+#import "SMManagerSetting+Location.h"
 
 #import "SMManagerHelper.h"
 
 #import "SMNSNotification.h"
 #import "SMLink.h"
 #import "SMNotificationButtonData.h"
+#import "SMNotificationAnnotationData.h"
+#import "SMNotificationMessage.h"
 
 #import "SMManagerSetting.h"
 #import "SMManagerSettingIAM.h"
@@ -25,8 +29,12 @@
 #import "SMManager+SilentPush.h"
 #import "SMManager+SMEvent.h"
 #import "SMManager+Log.h"
-#import "SMManager+Location.h"
 #import "SMManager+StyleOptions.h"
+#import "SMManager+ViewController.h"
+#import "SMManager+SMLink.h"
+
+#import "SMManagerInAppMessageDelegate.h"
+#import "SMManagerUniversalLinksDelegate.h"
 
 #import "SMInAppContentImageViewController.h"
 #import "SMInAppContentURLViewController.h"

package/ios/include/SMInAppContentHTMLViewController.h

@@ -10,48 +10,50 @@
 #import "SMInAppContentStyleOptions.h"
 
 /*!
- *  a view controller for HTML In App Content
- *  #SMInAppContentHTMLViewController :#
+ *  A view controller for HTML In App Content
  */
 @interface SMInAppContentHTMLViewController : SMInAppContentViewController
 
-
 /*!
  * This will provide you a custom viewcontroller with all HTML in app content for a specific category
+ *
  * @discussion The viewcontroller will take all available space in screen and will contain a close button if it is presented as it is. Otherwise the app will have to define a UIContainerView which will contain the view controller
  * @param category a NSString of the desired category of In App Content
  * @return a SMInAppContentHTMLViewController
  */
-+ (instancetype) viewControllerForCategory:(NSString*)category ;
++ (instancetype _Nonnull) viewControllerForCategory:(NSString*_Nullable)category ;
 
 /*!
  * This will provide you a custom viewcontroller with all HTML in app content for a specific category
+ *
  * @discussion The viewcontroller will take all available space in screen and will contain a close button if it is presented as it is. Otherwise the app will have to define a UIContainerView which will contain the view controller
  * @param category a NSString of the desired category of In App Content
  * @param options a SMInAppContentStyleOptions object allowing you to customise the in app content
  * @return a SMInAppContentHTMLViewController
+ * @see SMInAppContentStyleOptions
  */
-+ (instancetype) viewControllerForCategory:(NSString*)category AndOptions:(SMInAppContentStyleOptions*)options  ;
++ (instancetype _Nonnull) viewControllerForCategory:(NSString*_Nullable)category AndOptions:(SMInAppContentStyleOptions*_Nullable)options  ;
 
 /*!
  * This will provide you a custom viewcontroller with HTML in app content for a specific category
+ *
  * @discussion The viewcontroller will take all available space in screen and will contain a close button if it is presented as it is. Otherwise the app will have to provide a UIContainerView which will contain the view controller
  * @param category a NSString of the desired category of In App Content
  * @param numberofboxes an int corresponding to the maximum numbers of html boxes that the view controller must contain
  * @return a SMInAppContentHTMLViewController
  */
-+ (instancetype) viewControllerForCategory:(NSString*)category InNumberOfBoxes:(int) numberofboxes ;
-
++ (instancetype _Nonnull) viewControllerForCategory:(NSString*_Nullable)category InNumberOfBoxes:(int) numberofboxes ;
 
 /*!
  * This will provide you a custom viewcontroller with HTML in app content for a specific category
+ *
  * @discussion The viewcontroller will take all available space in screen and will contain a close button if it is presented as it is. Otherwise the app will have to provide a UIContainerView which will contain the view controller
  * @param category a NSString of the desired category of In App Content
  * @param numberofboxes an int corresponding to the maximum numbers of html boxes that the view controller must contain
  * @param options a SMInAppContentStyleOptions object allowing you to customise the in app content
  * @return a SMInAppContentHTMLViewController
+ * @see SMInAppContentStyleOptions
  */
-+ (instancetype) viewControllerForCategory:(NSString*)category InNumberOfBoxes:(int) numberofboxes AndOptions:(SMInAppContentStyleOptions*)options ;
-
++ (instancetype _Nonnull) viewControllerForCategory:(NSString*_Nullable)category InNumberOfBoxes:(int) numberofboxes AndOptions:(SMInAppContentStyleOptions*_Nullable)options ;
 
 @end

package/ios/include/SMInAppContentImageViewController.h

@@ -8,29 +8,30 @@
 
 #import "SMInAppContentViewController.h"
 
-
 /*!
- *  a view controller for Image In App Content
- *  #SMInAppContentImageViewController :#
+ *  A view controller for Image In App Content
  */
 @interface SMInAppContentImageViewController : SMInAppContentViewController
 
 /*!
  * This will provide you a custom viewcontroller with one image view loaded with the url provided by an in app content for a specific category of image type
+ *
  * @discussion The viewcontroller will take all available space in screen and will contain a close button if it is presented as it is. Otherwise the app will have to provide a UIContainerView which will contain the view controller
  * @param category a NSString of the desired category of In App Content
  * @return a SMInAppContentImageViewController
  */
-+ (instancetype) viewControllerForCategory:(NSString*)category;
++ (instancetype _Nonnull) viewControllerForCategory:(NSString*_Nullable)category;
 
 /*!
  * This will provide you a custom viewcontroller with one web view loaded with the url provided by an in app content for a specific category of an Image type
+ *
  * @discussion The viewcontroller will take all available space in screen and will contain a close button if it is presented as it is. Otherwise the app will have to define a UIContainerView which will contain the view controller
  * @param category a NSString of the desired category of In App Content
  * @param options a SMInAppContentStyleOptions object allowing you to customise the in app content
  * @return a SMInAppContentImageViewController
+ * @see SMInAppContentStyleOptions
  */
-+ (instancetype) viewControllerForCategory:(NSString*)category AndOptions:(SMInAppContentStyleOptions*)options  ;
++ (instancetype _Nonnull) viewControllerForCategory:(NSString*_Nullable)category AndOptions:(SMInAppContentStyleOptions*_Nullable)options;
 
 
 @end