@selligent-marketing-cloud/selligent-react-native 2.4.0 → 2.8.0

package/ios/include/SMManager.h

@@ -8,14 +8,12 @@
 
 #import <UIKit/UIKit.h>
 
-@class SMManagerSetting;
-
-
 #import "SMManagerHelper.h"
 
+@class SMManagerSetting;
 
 /*!
- *  #Start Library :#
+ *  ##Start Library
  *  In order to start the library, please follow the steps bellow (will mainly happen in your UIApplication's delegate):
  *
  *  -   Use startWithLaunchOptions:Setting: in your application:didFinishLaunchingWithOptions:
@@ -26,29 +24,20 @@
  *  Don't forget to call registerForRemoteNotification according to your application's need.
  *
  *  From there, your application is ready to handle all incoming remote-notifications.
- *
- *  #SMManager Singleton :#
- *  @discussion This manager is the main interface third party developers will be using.
- *
  */
 @interface SMManager : NSObject
 
-
 /**
  *  The current version of the library
  */
-@property (nonatomic) NSString *_Nonnull versionLib ;
+@property (readonly, nonatomic) NSString *_Nonnull versionLib;
 
 /*!
  * Singleton for SellMobileSDK Class which allow to access public SellMobileSDK methods and properties
  *
- * @return SMManager : singleton instance of SMManager class
+ * @return SMManager: singleton instance of SMManager class
  */
-+ (instancetype _Nonnull) sharedInstance ;
-
-
-
-
++ (instancetype _Nonnull) sharedInstance;
 
 /*!
  *  Mandatory method which allows sdk initialisation. To be included in application:didFinishLaunchingWithOptions: 
@@ -56,23 +45,25 @@
  *
  *  @param launchOptions NSDictionary instance indicating the reason the app was launched (if any). This dictionary is provided by application:didFinishLaunchingWithOptions
  *  @param setting  mandatory SMManagerSetting instance to start-up the library
- *  @see  SMManagerSetting
- *  @discussion This method is mandatory in order to start / initialise the library and should be called in application:didFinishLaunchingWithOptions:
+ *  @see SMManagerSetting
+ *  @discussion This method is mandatory in order to start / initialize the library and should be called in application:didFinishLaunchingWithOptions:
  */
-- (void)startWithLaunchOptions:(NSDictionary* _Nullable)launchOptions Setting:(SMManagerSetting* _Null_unspecified)setting;
-
-
-
+- (void) startWithLaunchOptions:(NSDictionary* _Nullable)launchOptions Setting:(SMManagerSetting* _Null_unspecified)setting;
 
 /*!
  *  Optional + used for testing only. This method will re-configure the SMManager with the newly provided information
+ *
  *  @discussion This is a handy API in case you would like to switch between two backend environements without rebuilding your target.
  *  @param setting  mandatory SMManagerSetting instance to start-up the library
  *  @warning This API is provided for testing purposes only. Never use it in production.
  *  Make sure to re-enable any service after calling this API.
+ *  @see SMManagerSetting
  */
-- (void)reloadSetting:(SMManagerSetting* _Null_unspecified)setting;
-
+- (void) reloadSetting:(SMManagerSetting* _Null_unspecified)setting;
 
+/*!
+ *  Device id  used by the sdk
+ */
+- (NSString*_Nullable) deviceID;
 
  @end

package/ios/include/SMManagerInAppMessageDelegate.h

@@ -0,0 +1,24 @@
+//
+//  SMManagerDelegate.h
+//  MobileSDK
+//
+//  Created by Gilbert Schakal on 25/5/2021.
+//  Copyright © 2021 Selligent. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "SMInAppMessage.h"
+
+/**
+ *  This protocol will help you intercept the in-app messages and allow you to display them your own way or store them somewhere to be shown later.
+ */
+@protocol SMManagerInAppMessageDelegate <NSObject>
+@optional
+
+/*!
+ * @abstract Invoked when an in-app message linked to a remote notification is received by sdk.
+ * @param inAppMessage The inAppMessage object containing all necessary datas for you to display content of the message
+ */
+- (void) displayInAppMessage:(SMInAppMessage*_Nonnull)inAppMessage;
+
+@end

package/ios/include/SMManagerSetting+Location.h

@@ -0,0 +1,27 @@
+//
+//  SMManagerSetting+Location.h
+//  MobileSDK
+//
+//  Created by Marc Biosca on 6/28/21.
+//  Copyright © 2021 Selligent. All rights reserved.
+//
+
+#import "SMManagerSetting.h"
+
+/**
+ *  This category will help you to enable the geolocation service.
+ */
+@interface SMManagerSetting (Location)
+
+/**
+ *  Optional API to enable location services.
+ *
+ *  @discussion This call is useless if the sdk version is not the one associated to the plotproject framework
+ *  However in the case you are using the sdk version associated to plotproject framework, it is the first step to enable Location service.
+ *  It is the first step to inform the sdk that geo location services are going to be used by the
+ *
+ *  @warning To use location service you will mandatory need to have PlotProject.framework in your app and the correct version of the selligent sdk library
+ */
+- (void) configureLocationService;
+
+@end

package/ios/include/SMManagerSetting.h

@@ -7,22 +7,21 @@
 //
 
 #import <Foundation/Foundation.h>
-
 #import "SMClearCache.h"
+#import "SMRemoteMessageDisplayType.h"
 
 @class SMManagerSettingIAM;
 @class SMManagerSettingIAC;
-@class SMManagerSettingLocation;
-
 
 /**
- *  #Note about the SMManagerSetting object :#
+ *  This class allow you to configure the SMManager.
+ *  Such instance must be created before starting the library.
  *  Creating an SMManagerSetting's instance is pretty straightforward as there's only [one constructor for doing so](settingWithUrl:ClientID:PrivateKey:).
  *  This sole constructor is sufficent to get you started. 
  *
  *  Additional parameters described in this header will provide you with additional control and ***are all optional***.
  *
- *  #Being user-friendly :#
+ *  ##Being user-friendly
  *  When the application is in foreground and receive a remote-notification, by default, the library will display it on the current visible UIViewController. This behaviour might be unwanted and may disturb the user if he appears to navigate in a different context. Should you want to prevent that behaviour and display the remote-notification shortly after (when the user will be in a more appropriate context), please follow these steps :
  *
  *  *   Create an SMManagerSetting with the default constructor as usual.
@@ -40,21 +39,16 @@
  *
  *  *   Display the last known remote notification by calling : [SMManager(RemoteNotification) displayLastReceivedRemotePushNotification]
  *
- *  #IAM :#
+ *  ##IAM
  *  In-Application-Message-service is configurable using SMManagerSettingIAM which you'll inject using the API configureInAppMessageServiceWithSetting:
  *  A dedicated topic regarding this topic can be found in SMManager(InAppMessage)
  *
- *  #IAC :#
+ *  ##IAC
  *  In-Application-Content-service is configurable using SMManagerSettingIAC which you'll inject using the API configureInAppContentServiceWithSetting:
  *  A dedicated topic regarding this topic can be found in SMManager(InAppContent)
- *
- *  #SMManagerSetting :#
- *  This class allow you to configure the SMManager.
- *  Such instance must be created before starting the library.
  */
 @interface SMManagerSetting : NSObject
 
-
 /**
  *  Once a new remote-notification is displayed, the badge is automaticly reseted.
  *  Should you want to handle this property yourself, you can set this property to FALSE before starting the library
@@ -63,17 +57,28 @@
 @property (nonatomic) BOOL shouldClearBadge;
 
 /**
- *  Used to configure the remote-notification-display
- *  @discussion  When the app is active, once a new remote-notification is received, it is automatically diplayed on the device
+ *  @discussion This setting will enable or disable the display of inapp-messages linked to a remote-notification by the SDK.
+ *  In iOS 10+ after tapping a notification, the inapp will be displayed (if any).
+ *  In iOS 9-, and when the app is in foreground, once a new remote-notification is received, the linked inapp-notification will be displayed (if any).
  *  Should you want to prevent that behaviour, you can set this property to FALSE before starting the library.
  *  Default value is set to TRUE.
- *  @warning This property does not have an impact when app is open from a notification selected by user in the notification center or when [SMManager(RemoteNotification) displayNotificationID:] or  [SMManager(RemoteNotification) displayLastReceivedRemotePushNotification] are called.
- *   Once you set this value to TRUE, the application becomes responsable about displaying the remote-notification. (Make sure to read the header file of SMManagerSetting before doing so).
+ *  @warning This property does not have an impact when [SMManager(RemoteNotification) displayNotificationID:] or  [SMManager(RemoteNotification) displayLastReceivedRemotePushNotification] are called.
+ *  Once you set this value to TRUE, the application becomes responsable about displaying the inapp-notification linked to the received remote-notification.
  */
 @property (nonatomic) BOOL shouldDisplayRemoteNotification;
 
+/**
+ *  Used to add the in-app message associated to a remote notification to the in-app message list
+ *
+ *  @discussion Once a new remote-notification is received, if it contains in the payload  datas for an in-app message, this setting will add the in-app message to the in app messages list . You will need to listen to  kSMNotification_Event_DidReceiveInAppMessage NSNotification  to be informed  that an in-app message is available and you can then retrieve it with [SMManager(InAppMessages) getInAppMessages]  helper method and use in an inbox for example
+ *  by default the in app message will be displayed if you wish to display it by yourself you will need to provide a class by calling [SMManager(InAppMessage) inAppMessageDelegate:] . This class will conform to SMManagerInAppMessageDelegate protocol and implement [SMManagerInAppMessageDelegate displayInAppMessage:] method
+ *  Default value is set to FALSE
+ */
+@property (nonatomic) BOOL shouldAddInAppMessageFromPushToInAppMessageList;
+
 /**
  *  This value tells how often the SDK's cache mechanism should clear itself.
+ *
  *  @discussion Internally, each notification-messages has a life-span.
  *  Clearing the cache stands for deleting notification-messages with an expired life-span.
  *  In other words, only old notification-messages are deletesd from the cache.
@@ -92,16 +97,47 @@
  *  @warning As soon as IAM-service is enabled, the SDK will consider kSMClearCache_Weekly as being the default value. Except if you explicitly overide the property.
  *  In 99% of the cases, you should not overide this property as the SDK is smart enough to handle the cache mechanism by itself.
  *  Keep also in mind that this behavior  is only applicable for notification and IAM that doesn't have a n expiration date set
+ *  @see SMClearCache
  */
 @property (nonatomic) SMClearCache clearCacheIntervalValue;
 
 /**
-*  This value provides to the sdk  the app group id that you have previously defined in your apple developer portal.
-*  @discussion it is used to allow the sdk to share data between the main app and the notifications extensions (service and/or content)
-*  The deviceid provided by selligent mobile platform is stored encrypted in this container
+ * This value provides to the sdk  the app group id that you have previously defined in your apple developer portal.
+ *
+ * @discussion it is used to allow the sdk to share data between the main app and the notifications extensions (service and/or content)
+ * The deviceid provided by selligent mobile platform is stored encrypted in this container
 */
-@property (nonatomic, strong) NSString *appGroupId;
+@property (nonatomic, strong) NSString *_Nullable appGroupId;
 
+/**
+ * This value defines the behaviour that the SDK will adopt when a remote-notification is received when in Foreground.
+ *
+ * @discussion The behaviour will be as:
+ *
+ * iOS 10+:
+ *
+ *  *  kSMRemoteMessageDisplayType_None: nothing will be displayed.
+ *  *  kSMRemoteMessageDisplayType_Notification: a Push Notification will be displayed.
+ *  *  kSMRemoteMessageDisplayType_Automatic:<br/>
+ *      "Push + in-app notifications":<br/>
+ *          1) With "Message Action": a Push Notification will be displayed (UNNotificationPresentationOptionAlert and UNNotificationPresentationOptionBanner | UNNotificationPresentationOptionList for iOS 14+).<br/>
+ *          2) With "Push Notification Buttons": a Push Notification will be displayed (UNNotificationPresentationOptionAlert and UNNotificationPresentationOptionBanner | UNNotificationPresentationOptionList for iOS 14+).<br/>
+ *          3) With "Rich Push Content": a Push Notification will be displayed (UNNotificationPresentationOptionAlert and UNNotificationPresentationOptionBanner | UNNotificationPresentationOptionList for iOS 14+).<br/>
+ *          4) Others: an in-app message will be displayed (UNNotificationPresentationOptionNone).<br/><br/>
+ *      "Mobile push": a Push Notification will be displayed (UNNotificationPresentationOptionAlert and UNNotificationPresentationOptionBanner | UNNotificationPresentationOptionList for iOS 14+).
+ *
+ * iOS 9-:
+ *
+ *  *  kSMRemoteMessageDisplayType_None: nothing will be displayed.
+ *  *  kSMRemoteMessageDisplayType_Notification: nothing will be displayed.
+ *  *  kSMRemoteMessageDisplayType_Automatic:<br/>
+ *      "Push + in-app notifications": an in-app message will be displayed.<br/>
+ *      "Mobile push": the "Message Action" will be executed<br/>
+ * @warning For iOS 10+, the SDK will only take this setting into account when the UNNotificationPresentationOptions delegate is provided (see SMManager(UserNotification) for more information).
+ * @warning If not set, the default value (kSMRemoteMessageDisplayType_Unknown) will use kSMRemoteMessageDisplayType_Notification for iOS 10+ and kSMRemoteMessageDisplayType_Automatic for iOS 9-.
+ * @see SMRemoteMessageDisplayType
+*/
+@property (nonatomic) SMRemoteMessageDisplayType remoteMessageDisplayType;
 
 /*!
  *  Default-mandatory constructor to start the SMManager shared-instance
@@ -115,7 +151,7 @@
  *
  *  @return SMManagerSetting new instance. SMFailure in case of error
  */
-+ (instancetype)settingWithUrl:(NSString*)urlName ClientID:(NSString*)clientID PrivateKey:(NSString*)privateKey;
++ (instancetype _Nonnull) settingWithUrl:(NSString*_Nullable)urlName ClientID:(NSString*_Nullable)clientID PrivateKey:(NSString*_Nullable)privateKey;
 
 /**
  *  @discussion This call is optional. It is not needed to successfully start the SDK.
@@ -125,9 +161,9 @@
  *  @param settingIAM The SMManagerSettingIAM instance containing the IAM desired configuration.
  *  @warning An invalid or nil setting is considered as an error and will not startUp the IAM-service.
  *  Don't forget to enable In App message according to application need by calling [SMManager(InAppMessage) enableInAppMessage:]
+ *  @see SMManagerSettingIAM
  */
-- (void)configureInAppMessageServiceWithSetting:(SMManagerSettingIAM*)settingIAM;
-
+- (void) configureInAppMessageServiceWithSetting:(SMManagerSettingIAM*_Nullable)settingIAM;
 
 /**
  *  @discussion This call is optional. It is not needed to successfully start the SDK.
@@ -137,16 +173,8 @@
  *  @param settingIAC The SMManagerSettingIAC instance containing the IAC desired configuration.
  *  @warning An invalid or nil setting is considered as an error and will not startUp the IAC-service.
  *  Don't forget to enable In App content according to application need by calling [SMManager(InAppContent) enableInAppContent:]
+ *  @see SMManagerSettingIAC
  */
-- (void)configureInAppContentServiceWithSetting:(SMManagerSettingIAC*)settingIAC;
-
-/**
- *  @discussion This call is optional. It is not needed to successfully start the SDK.
- *  However, it is the first step to enable Location service.
- *  It is the first step to inform the sdk that geo location services are going to be used by the 
- *
- *  @warning To use location service you will need to have PlotProject.framework in your app.
- */
-- (void)configureLocationService;
+- (void) configureInAppContentServiceWithSetting:(SMManagerSettingIAC*_Nullable)settingIAC;
 
 @end

package/ios/include/SMManagerSettingIAC.h

@@ -6,7 +6,6 @@
 //  Copyright © 2016 Selligent. All rights reserved.
 //
 
-
 #import <Foundation/Foundation.h>
 #import "SMInAppRefreshType.h"
 
@@ -16,9 +15,6 @@
  */
 @interface SMManagerSettingIAC : NSObject
 
-
-
-
 /**
  *  Constructor to be used in order to create the SMManagerSettingIAC instance
  *  @discussion use this constructor to enable background-mode only.
@@ -26,9 +22,7 @@
  *  @warning If background-fetch is not enabled in Application's Capabilities, the IAC-service will not start.
  *  See SMManager(InAppContent) for additional information.
  */
-+ (instancetype)settingWithBackgroundFetchOnly;
-
-
++ (instancetype _Nonnull) settingWithBackgroundFetchOnly;
 
 /**
  *  Constructor to be used in order to create the SMManagerSettingIAC instance
@@ -36,24 +30,19 @@
  *  @param refreshType The type of refresh to consider when the application is in foreground
  *  @discussion Use this constructor should you want to perform periodic refresh when the application is in foreground-state only.
  *  For enabling backgroundState, use settingWithRefreshType:ShouldPerformBackgroundFetch: instead
+ *  @see SMInAppRefreshType
  */
-+ (instancetype)settingWithRefreshType:(SMInAppRefreshType)refreshType;
-
-
-
++ (instancetype _Nonnull) settingWithRefreshType:(SMInAppRefreshType)refreshType;
 
 /**
  *  Constructor to be used in order to create the SMManagerSettingIAC instance
  *
- *  @param refreshType                  The type of refresh to consider when the application is in foreground
+ *  @param refreshType  The type of refresh to consider when the application is in foreground
  *  @param shouldPerformBackgroundFetch If set to TRUE, it will activate UIApplication-BackGround-Fetch-mode automaticly
  *  @discussion This constructor provides you with more control on foreground / background fetch.
  *  Should you want to restrict to only one fetch-mode, feel free to use other constructors.
+ *  @see SMInAppRefreshType
  */
-+ (instancetype)settingWithRefreshType:(SMInAppRefreshType)refreshType ShouldPerformBackgroundFetch:(BOOL)shouldPerformBackgroundFetch;
-
-
-
-
++ (instancetype _Nonnull) settingWithRefreshType:(SMInAppRefreshType)refreshType ShouldPerformBackgroundFetch:(BOOL)shouldPerformBackgroundFetch;
 
 @end

package/ios/include/SMManagerSettingIAM.h

@@ -15,19 +15,15 @@
  */
 @interface SMManagerSettingIAM : NSObject
 
-
-
-
 /**
  *  Constructor to be used in order to create the SMManagerSettingIAM instance
+ *
  *  @discussion use this constructor to enable background-mode only. 
  *  The OS will refresh automaticly the IAM based on how often the user interacts with the application
  *  @warning If background-fetch is not enabled in Application's Capabilities, the IAM-service will not start.
  *  See SMManager(InAppMessage) for additional information.
  */
-+ (instancetype)settingWithBackgroundFetchOnly;
-
-
++ (instancetype _Nonnull) settingWithBackgroundFetchOnly;
 
 /**
  *  Constructor to be used in order to create the SMManagerSettingIAM instance
@@ -35,24 +31,19 @@
  *  @param refreshType The type of refresh to consider when the application is in foreground
  *  @discussion Use this constructor should you want to perform periodic refresh when the application is in foreground-state only.
  *  For enabling backgroundState, use settingWithRefreshType:ShouldPerformBackgroundFetch: instead
+ *  @see SMInAppRefreshType
  */
-+ (instancetype)settingWithRefreshType:(SMInAppRefreshType)refreshType;
-
-
-
++ (instancetype _Nonnull) settingWithRefreshType:(SMInAppRefreshType)refreshType;
 
 /**
  *  Constructor to be used in order to create the SMManagerSettingIAM instance
  *
- *  @param refreshType                  The type of refresh to consider when the application is in foreground
+ *  @param refreshType The type of refresh to consider when the application is in foreground
  *  @param shouldPerformBackgroundFetch If set to TRUE, it will activate UIApplication-BackGround-Fetch-mode automaticly
  *  @discussion This constructor provides you with more control on foreground / background fetch.
  *  Should you want to restrict to only one fetch-mode, feel free to use other constructors.
+ *  @see SMInAppRefreshType
  */
-+ (instancetype)settingWithRefreshType:(SMInAppRefreshType)refreshType ShouldPerformBackgroundFetch:(BOOL)shouldPerformBackgroundFetch;
-
-
-
-
++ (instancetype _Nonnull) settingWithRefreshType:(SMInAppRefreshType)refreshType ShouldPerformBackgroundFetch:(BOOL)shouldPerformBackgroundFetch;
 
 @end

package/ios/include/SMManagerUniversalLinksDelegate.h

@@ -0,0 +1,23 @@
+//
+//  SMManagerUniversalLinksDelegate.h
+//  MobileSDK
+//
+//  Created by Marc Biosca on 7/12/21.
+//  Copyright © 2021 Selligent. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+
+/**
+ *  This protocol will give you the possibility to manage the behaviour when clicking a "deeplink" button type containing an universal link.
+ */
+@protocol SMManagerUniversalLinksDelegate <NSObject>
+@optional
+
+/*!
+ * @abstract Invoked when a "deeplink" button type, whose URL scheme is HTTP or HTTPS, is clicked
+ * @param url The NSURL introduced as value of the button that has been clicked
+ */
+- (void) executeLinkAction:(NSURL*_Nonnull)url;
+
+@end

package/ios/include/SMMessage.h

@@ -8,7 +8,6 @@
 
 #import <Foundation/Foundation.h>
 
-
 /**
  *  This Class is provided as a root Class and should not be used.
  */
@@ -17,7 +16,6 @@
 /*!
  *  NSString instance providing a brief description of the message
  */
-@property(nonatomic, strong) NSString *messageSM;
-
+@property(readonly, nonatomic) NSString *_Nullable messageSM;
 
 @end

package/ios/include/SMNSNotification.h

@@ -1,12 +1,7 @@
-
-
-
-
-
 /**
  *  NSString representing a notification name you can listen to.
  *  An NSNotification with this name is broadcasted when the user interacts with a remote-notification
- *  Usefull to retrieve user's actions on a received remote-notification, developers may listen to kSMNotification_Event_ButtonClicked from NSNotificationCenter.
+ *  Useful to retrieve user's actions on a received remote-notification, developers may listen to kSMNotification_Event_ButtonClicked from NSNotificationCenter.
  */
 extern NSString* kSMNotification_Event_ButtonClicked;
 
@@ -21,7 +16,7 @@ extern NSString* kSMNotification_Event_WillDisplayNotification;
 /**
  *  NSString representing a notification name you can listen to.
  *  An NSNotification with this name is broadcasted shortly before Dismissing the current remote-notification
- *  Primary-application may use this notification to resume any paused work. (see kSMNotification_Event_WillDisplayNotification)
+ *  Primary-application may use this notification to resume any paused work (see kSMNotification_Event_WillDisplayNotification).
  */
 extern NSString* kSMNotification_Event_WillDismissNotification;
 
@@ -35,16 +30,24 @@ extern NSString* kSMNotification_Event_DidReceiveRemoteNotification;
 
 /**
  *  NSString representing a notification name you can listen to.
- *  An NSNotification with this name is broadcasted shortly after receiving InApp messages
- *  Primary-application may use this notification to manage the received InApp messages */
+ *  An NSNotification with this name is broadcasted shortly after receiving in-app messages
+ *  Primary-application may use this notification to manage the received in-app messages
+ */
 extern NSString* kSMNotification_Event_DidReceiveInAppMessage;
 
 /**
  *  NSString representing a notification name you can listen to.
- *  An NSNotification with this name is broadcasted shortly after receiving InApp content
- *  Primary-application may use this notification to manage the received InApp content */
+ *  An NSNotification with this name is broadcasted shortly after receiving in-app content
+ *  Primary-application may use this notification to manage the received in-app content
+ */
 extern NSString* kSMNotification_Event_DidReceiveInAppContent;
 
+/**
+ *  NSString representing a notification name you can listen to.
+ *  An NSNotification with this name is broadcasted shortly after receiving device id from mobile platform
+ *  Primary-application may use this notification to manage the received device id
+ */
+extern NSString* kSMNotification_Event_DidReceiveDeviceId;
 
 
 /**
@@ -53,7 +56,6 @@ extern NSString* kSMNotification_Event_DidReceiveInAppContent;
  */
 extern NSString* kSMNotification_Data_ButtonData;
 
-
 /**
  *  NSString representing a key to retrieve an object inside NSNotification
  *  Use the key kSMNotification_Data_RemoteNotification to retrieve an NSDictionary instance with push ID and name
@@ -70,4 +72,10 @@ extern NSString* kSMNotification_Data_InAppMessage;
  *  NSString representing a key to retrieve an object inside NSNotification
  *  Use the key kSMNotification_Data_InAppContent to retrieve an NSDictionary instance with an array of  in app contents categories as key and number of in app contents for the category as value
  */
-extern NSString* kSMNotification_Data_InAppContent;
+extern NSString* kSMNotification_Data_InAppContent;
+
+/**
+ *  NSString representing a key to retrieve a string  inside NSNotification
+ *  Use the key kSMNotification_Data_DeviceId to retrieve an NString instance with device id value
+ */
+extern NSString* kSMNotification_Data_DeviceId;

package/ios/include/SMNotificationAnnotationData.h

@@ -8,30 +8,26 @@
 
 #import <Foundation/Foundation.h>
 
-/*!
- *
- *  #SMNotificationAnnotationData :#
- */
 @interface SMNotificationAnnotationData : NSObject
 
 /*!
  *  NSString instance providing the title of the annotation
  */
-@property (nonatomic, strong) NSString *titleAnnotation;
+@property (readonly, nonatomic) NSString *_Nullable titleAnnotation;
 
 /*!
  *  NSString instance providing the description of the annotation
  */
-@property (nonatomic, strong) NSString *descriptionAnnotation;
+@property (readonly, nonatomic) NSString *_Nullable descriptionAnnotation;
 
 /*!
  *  NSString instance providing the latitude of the annotation
  */
-@property (nonatomic) float latitude;
+@property (readonly, nonatomic) float latitude;
 
 /*!
  *  NSString instance providing the longitude of the message
  */
-@property (nonatomic) float longitude;
+@property (readonly, nonatomic) float longitude;
 
 @end

package/ios/include/SMNotificationButtonData.h

@@ -10,16 +10,11 @@
 
 #import "SMLink.h"
 
-
-
-
 /*!
- *  @brief SMNotificationButtonData
- *  @discussion This class is used to wrap informations about a notification button.
+ *  This class is used to wrap informations about a notification button.
  *
  *  Additional information provided in [SMManager](SMManager)
  */
 @interface SMNotificationButtonData : SMLink
 
-
 @end

package/ios/include/SMNotificationButtonType.h

@@ -6,9 +6,8 @@
 //  Copyright (c) 2015 Selligent. All rights reserved.
 //
 
-
 /*!
- *  This enumeration declares all known buttun-type
+ *  This enumeration declares all known button-type
 */
 typedef NS_ENUM(NSInteger, SMNotificationButtonType) {
     /*!
@@ -89,15 +88,3 @@ typedef NS_ENUM(NSInteger, SMNotificationButtonType) {
      */
     kSMNotificationButtonType_DeepLink                    = 13
 };
-
-
-
-
-
-
-
-
-
-
-
-

package/ios/include/SMNotificationMessage.h

@@ -0,0 +1,31 @@
+//
+//  SMNotificationMessage.h
+//  MobileSDK
+//
+//  Created by Walter Tricknot on 17/01/2017.
+//  Copyright © 2017 Selligent. All rights reserved.
+//
+
+#import <Foundation/Foundation.h>
+#import "SMInAppMessage.h"
+#import "SMNotificationButtonData.h"
+
+@interface SMNotificationMessage : SMInAppMessage
+
+/*!
+ *  NSString instance providing url of the Rich media attached to the remote-notification
+ */
+@property (readonly, nonatomic) NSString*_Nullable mediaUrl;
+
+/*!
+ *  SMNotificationButtonData instance providing the main action behind the remote-notification banner
+ *  @see SMNotificationButtonData
+ */
+@property (readonly, nonatomic) SMNotificationButtonData*_Nullable mainAction;
+
+/*!
+ *  NSArray of SMLink objects from the remote-notification
+ */
+@property (readonly, nonatomic) NSArray*_Nullable notificationButtons;
+
+@end