Update user functionality. (#39)

* Update user functionality.

* pr updates

Author: davidtruong

Iterable-iOS-SDK/IterableAPI.h

@@ -264,6 +264,20 @@ typedef NS_ENUM(NSInteger, PushServicePlatform) {
  */
 - (void)disableDeviceForAllUsersWithOnSuccess:(OnSuccessHandler)onSuccess onFailure:(OnFailureHandler)onFailure;
 
+/*!
+ @method
+ 
+ @abstract Updates the available user fields
+ 
+ @param dataFields              Data fields to store in the user profile
+ @param mergeNestedObjects      Merge top level objects instead of overwriting
+ @param onSuccess               OnSuccessHandler to invoke if disabling the token is successful
+ @param onFailure               OnFailureHandler to invoke if disabling the token fails
+ 
+ @see OnSuccessHandler
+ @see OnFailureHandler
+ */
+- (void)updateUser:(NSDictionary *)dataFields mergeNestedObjects:(BOOL)mergeNestedObjects onSuccess:(OnSuccessHandler)onSuccess onFailure:(OnFailureHandler)onFailure;
 
 /////////////////////////
 /// @name Tracking events

Iterable-iOS-SDK/IterableAPI.m

@@ -649,6 +649,32 @@ - (void)disableDeviceForAllUsersWithOnSuccess:(OnSuccessHandler)onSuccess onFail
     return [self disableDevice:TRUE onSuccess:onSuccess onFailure:onFailure];
 }
 
+// documented in IterableAPI.h
+- (void)updateUser:(NSDictionary *)dataFields mergeNestedObjects:(BOOL)mergeNestedObjects onSuccess:(OnSuccessHandler)onSuccess onFailure:(OnFailureHandler)onFailure
+{
+    NSDictionary *args;
+    if (dataFields) {
+        NSNumber *mergeNested = [NSNumber numberWithBool:mergeNestedObjects];
+        
+        if (_email != nil) {
+            args = @{
+                     ITBL_KEY_EMAIL: self.email,
+                     ITBL_KEY_DATA_FIELDS: dataFields,
+                     ITBL_KEY_MERGE_NESTED: mergeNested
+                     };
+        } else {
+            args = @{
+                     ITBL_KEY_USER_ID: self.userId,
+                     ITBL_KEY_DATA_FIELDS: dataFields,
+                     ITBL_KEY_MERGE_NESTED: mergeNested
+                     };
+        }
+        
+        NSURLRequest *request = [self createRequestForAction:ENDPOINT_UPDATE_USER withArgs:args];
+        [self sendRequest:request onSuccess:onSuccess onFailure:onFailure];
+    }
+}
+
 // documented in IterableAPI.h
 - (void)track:(NSString *)eventName
 {

Iterable-iOS-SDK/IterableConstants.h

@@ -22,6 +22,7 @@ extern NSString *const ITBL_KEY_DEVICE;
 extern NSString *const ITBL_KEY_EMAIL;
 extern NSString *const ITBL_KEY_EVENT_NAME;
 extern NSString *const ITBL_KEY_ITEMS;
+extern NSString *const ITBL_KEY_MERGE_NESTED;
 extern NSString *const ITBL_KEY_MESSAGE_ID;
 extern NSString *const ITBL_KEY_NEW_EMAIL;
 extern NSString *const ITBL_KEY_PLATFORM;

Iterable-iOS-SDK/IterableConstants.m

@@ -21,6 +21,7 @@ @implementation IterableConstants : NSObject
 NSString *const ITBL_KEY_EMAIL               = @"email";
 NSString *const ITBL_KEY_EVENT_NAME          = @"eventName";
 NSString *const ITBL_KEY_ITEMS               = @"items";
+NSString *const ITBL_KEY_MERGE_NESTED        = @"mergeNestedObjects";
 NSString *const ITBL_KEY_MESSAGE_ID          = @"messageId";
 NSString *const ITBL_KEY_NEW_EMAIL           = @"newEmail";
 NSString *const ITBL_KEY_PLATFORM            = @"platform";