Updated to 3.1.0

Author: Priyanka Mistry

BuiltIOBackend.podspec

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
 s.name             = 'BuiltIOBackend'
-s.version          = '3.0.0'
+s.version          = '3.1.0'
 s.summary          = 'The BuiltIO Backend helps you to create apps quickly and effortlessly, taking care of all the backend requirements.'
 
 s.description      = <<-DESC

SDK/iOS/BuiltIO.framework/BuiltIO

@@ -21,6 +21,8 @@
 @class BuiltQuery;
 @class BuiltACL;
 @class BuiltKeyStore;
+@class BuiltUserRoleMapper;
+
 
 BUILT_ASSUME_NONNULL_BEGIN
 /**
@@ -446,6 +448,49 @@ Class for updating installation and for subscribing/unsubscribing for push notif
 - (BuiltInstallation *)installationWithUID:(NSString*)installationUID;
 #endif
 
+/**---------------------------------------------------------------------------------------
+ * @name BuiltUserRoleMapper Instance
+ *  ---------------------------------------------------------------------------------------
+ */
+
+/**
+ Represents a new role mapper to create on Built.io Backend.
+ 
+     //'blt5d4sample2633b' is a dummy Application API key
+ 
+     //Obj-C
+     BuiltApplication *builtApplication = [Built applicationWithAPIKey:@"blt5d4sample2633b"];
+     BuiltUserRoleMapper *mapperObject = [builtApplication userRoleMapper];
+ 
+     //Swift
+     var builtApplication:BuiltApplication = Built.applicationWithAPIKey("blt5d4sample2633b")
+     var mapperObject:BuiltUserRoleMapper = builtApplication.userRoleMapper()
+ 
+ 
+ @return Returns an instance of BuiltUserRoleMapper.
+ */
+
+- (BuiltUserRoleMapper *)userRoleMapper;
+
+/**
+ Represents a role mapper on Built.io Backend
+ 
+     //'blt5d4sample2633b' is a dummy Application API key
+     //'blt9a1sample5584k' is a dummy mapperUID
+ 
+     //Obj-C
+     BuiltApplication *builtApplication = [Built applicationWithAPIKey:@"blt5d4sample2633b"];
+     BuiltUserRoleMapper *mapperObject = [builtApplication userRoleMapperWithUID:@"blt9a1sample5564k"];
+ 
+     //Swift
+     var builtApplication:BuiltApplication = Built.applicationWithAPIKey("blt5d4sample2633b")
+     var mapperObject:BuiltUserRoleMapper = builtApplication.userRoleMapperWithUID("blt9a1sample5584k")
+ 
+ @param mapperUID uid of BuiltUserRoleMapper.
+ @return Returns an instance of BuiltUserRoleMapper.
+ */
+- (BuiltUserRoleMapper *)userRoleMapperWithUID:(NSString*)mapperUID;
+
 /**---------------------------------------------------------------------------------------
  * @name BuiltRole Instance
  *  ---------------------------------------------------------------------------------------
@@ -686,10 +731,7 @@ Asynchronously fetches the application info.
      
      }
  
- 
-@param successBlock invoked when request processed sucessfully.
-@param errorBlock   invoked when request process fails. error parameter contains the error info.
-@param finallyBlock invoked when request is finished. Will get invoked after sucess or failure.
+ @param completionBlock Completion block with params responseType (cache or network), dictionary of application information and error object in any.
  */
 - (void)fetchApplicationInfo:(void (^)(BuiltResponseType responseType, NSDictionary * BUILT_NULLABLE_P info, NSError * BUILT_NULLABLE_P error))completionBlock;
 

SDK/iOS/BuiltIO.framework/Headers/BuiltApplication.h

@@ -11,6 +11,7 @@
 
 @class BuiltObject;
 @class BuiltQuery;
+@class BuiltUserRoleMapper;
 
 BUILT_ASSUME_NONNULL_BEGIN
 /**

SDK/iOS/BuiltIO.framework/Headers/BuiltClass.h

@@ -164,7 +164,6 @@ Removes GroupMultiple to this object
  */
 - (void)removeGroupMultiple:(BuiltGroupMultiple*)group;
 
-
 //MARK: - set values for reference fields
 
 /**---------------------------------------------------------------------------------------
@@ -173,73 +172,73 @@ Removes GroupMultiple to this object
  */
 
 /**
-Assigns a set references to a reference field of an object.
+ Assigns a set references to a reference field of an object.
  
-     //Obj-C
-     BuiltGroup *detailGroup  = [BuiltGroup groupWithFieldName:@"details"];
-     // setting the project reference
-     [detailGroup setReference:@"bltb6202sample73a1" forKey:@"project"];
-     
-     //Swift
-     var detailGroup:BuiltGroup = BuiltGroup(fieldName:"details")
-     // setting the project reference
-     detailGroup.setReference("bltb6202sample73a1", forKey:"project")
-
-
-@param reference This can either be a UID of a referenced object or array of UIDs of a referenced objects.
-@param key       The uid of the reference field
+ //Obj-C
+ BuiltGroup *detailGroup  = [BuiltGroup groupWithFieldName:@"details"];
+ // setting the project reference
+ [detailGroup setReference:@"bltb6202sample73a1" forKey:@"project"];
+ 
+ //Swift
+ var detailGroup:BuiltGroup = BuiltGroup(fieldName:"details")
+ // setting the project reference
+ detailGroup.setReference("bltb6202sample73a1", forKey:"project")
+ 
+ 
+ @param reference This can either be a UID of a referenced object or array of UIDs of a referenced objects.
+ @param key       The uid of the reference field
  */
 - (void)setReference:(id)reference forKey:(NSString *)key;
 
 /**
-Fires a query on Built.io Backend and all the objects which pass the query condition are being assigned to the reference field.
-
-     //Obj-C
-     BuiltGroup *detailGroup  = [BuiltGroup groupWithFieldName:@"details"];
-     // setting the project reference
-     [detailGroup setReferenceWhere:@{@"name":@"Super Project #41!"} forKey:@"project"];
+ Fires a query on Built.io Backend and all the objects which pass the query condition are being assigned to the reference field.
  
-     //Swift
-     var detailGroup:BuiltGroup = BuiltGroup(fieldName:"details")
-     // setting the project reference
-     detailGroup.setReferenceWhere(["name":"Super Project #41!"], forKey:"project")
+ //Obj-C
+ BuiltGroup *detailGroup  = [BuiltGroup groupWithFieldName:@"details"];
+ // setting the project reference
+ [detailGroup setReferenceWhere:@{@"name":@"Super Project #41!"} forKey:@"project"];
  
-@param dictionary Object specifying the conditions
-@param key        The uid of the reference field
+ //Swift
+ var detailGroup:BuiltGroup = BuiltGroup(fieldName:"details")
+ // setting the project reference
+ detailGroup.setReferenceWhere(["name":"Super Project #41!"], forKey:"project")
+ 
+ @param dictionary Object specifying the conditions
+ @param key        The uid of the reference field
  */
 - (void)setReferenceWhere:(NSDictionary *)dictionary forKey:(NSString *)key;
 
 /**
-Assigns a set references to a reference field of an object.
+ Assigns a set references to a reference field of an object.
  
-     //Obj-C
-     BuiltApplication *builtApplication = [Built applicationWithAPIKey:@"blt5d4sample2633b"];
-     BuiltClass *projectClass = [builtApplication classWithUID:@"project"];
-     BuiltObject *projectObject  = [projectClass object];
-     projectObject[@"name"] = @"Super Project #41!";
-     
-     BuiltGroup *detailGroup  = [BuiltGroup groupWithFieldName:@"details"];
-     // setting the project reference
-     [detailGroup setReferenceWithObject:projectObject forKey:@"project"];
-     
-     
-     //Swift
-     var builtApplication:BuiltApplication = Built.applicationWithAPIKey("blt5d4sample2633b")
-     var projectClass:BuiltClass = builtApplication.classWithUID("project")
-     var projectObject:BuiltObject = projectClass.object()
-     projectObject["name"] = "Super Project #41!"
-     
-     var detailGroup:BuiltGroup = BuiltGroup(fieldName:"details")
-     // setting the project reference
-     detailGroup.setReferenceWithObject(projectObject, forKey:"project")
+ //Obj-C
+ BuiltApplication *builtApplication = [Built applicationWithAPIKey:@"blt5d4sample2633b"];
+ BuiltClass *projectClass = [builtApplication classWithUID:@"project"];
+ BuiltObject *projectObject  = [projectClass object];
+ projectObject[@"name"] = @"Super Project #41!";
+ 
+ BuiltGroup *detailGroup  = [BuiltGroup groupWithFieldName:@"details"];
+ // setting the project reference
+ [detailGroup setReferenceWithObject:projectObject forKey:@"project"];
+ 
+ 
+ //Swift
+ var builtApplication:BuiltApplication = Built.applicationWithAPIKey("blt5d4sample2633b")
+ var projectClass:BuiltClass = builtApplication.classWithUID("project")
+ var projectObject:BuiltObject = projectClass.object()
+ projectObject["name"] = "Super Project #41!"
+ 
+ var detailGroup:BuiltGroup = BuiltGroup(fieldName:"details")
+ // setting the project reference
+ detailGroup.setReferenceWithObject(projectObject, forKey:"project")
  
-@param referenceObject This can either an instance of BuiltObject or array of BuiltObject instance.
-@param key             The uid of the reference field
+ @param referenceObject This can either an instance of BuiltObject or array of BuiltObject instance.
+ @param key             The uid of the reference field
  */
 - (void)setReferenceWithObject:(id)referenceObject forKey:(NSString *)key;
 
 /**
-Use this method only when the values of the fields inside referenced object are to be changed while creating a new object.
+Use this method only when the values of the fields inside referenced object is to be changed while creating a new object.
  
      //ObjC
      BuiltGroup *detailGroup = [BuiltGroup groupWithFieldName:@"details"];
@@ -256,8 +255,30 @@ Use this method only when the values of the fields inside referenced object are
 @param conditionDictionary A check will be performed, whether any object has the key value pair(s) supplied in the dictionary in the reference field
 @param replaceDictionary   New key value pairs for the fields inside the referenced object
  */
+
 - (void)addUpsertForReferenceField:(NSString *)referenceField condition:(NSDictionary *)conditionDictionary replaceWith:(NSDictionary *)replaceDictionary;
 
+/**
+ Use this method only when the values of the fields inside referenced objects are to be changed while creating a new object.
+ 
+     //ObjC
+     BuiltGroup *detailGroup = [BuiltGroup groupWithFieldName:@"details"];
+ 
+     [detailGroup addUpsertForMultipleReferenceField:@"project" condition:@{@"name":@"Super Project #41"} replaceWith:@{@"name":@"Super Project A", @"description":@"New project"}];
+ 
+     //Swift
+     var detailGroup:BuiltGroup = BuiltGroup(fieldName:"details")
+ 
+     detailGroup.addUpsertForMultipleReferenceField("project", condition:["name":"Super Project #41"], replaceWith:["name":"Super Project A", "description":"New project"])
+ 
+ 
+ @param referenceField      Reference uid on which UPSERT is to be performed
+ @param conditionDictionary A check will be performed, whether any object has the key value pair(s) supplied in the dictionary in the reference field
+ @param replaceDictionary   New key value pairs for the fields inside the referenced object
+ */
+
+- (void)addUpsertForMultipleReferenceField:(NSString *)referenceField condition:(NSDictionary *)conditionDictionary replaceWith:(NSDictionary *)replaceDictionary;
+
 
 //MARK: - operations on fields of multiple type
 

SDK/iOS/BuiltIO.framework/Headers/BuiltGroup.h

@@ -6,8 +6,8 @@
 //  Copyright (c) 2013 raweng. All rights reserved.
 //
 
-//  sdk-version: 3.0.0
-//  api-version: 3.0
+//  sdk-version: 3.1.0
+//  api-version: 3.1
 
 #import <Foundation/Foundation.h>
 
@@ -28,6 +28,7 @@ FOUNDATION_EXPORT const unsigned char Built_IOVersionString[];
 #import <BuiltIO/BuiltLocation.h>
 #import <BuiltIO/BuiltRole.h>
 #import <BuiltIO/BuiltUser.h>
+#import <BuiltIO/BuiltUserRoleMapper.h>
 #import <BuiltIO/BuiltUpload.h>
 #import <BuiltIO/BuiltACL.h>
 #import <BuiltIO/BuiltObject.h>

SDK/iOS/BuiltIO.framework/Headers/BuiltIO.h

@@ -446,4 +446,4 @@ Disable installation
 
 BUILT_ASSUME_NONNULL_END
 
-#endif
+#endif

SDK/iOS/BuiltIO.framework/Headers/BuiltInstallation.h

@@ -93,8 +93,7 @@ Gets the current location and returns as in `BuiltLocation` object.
          var longitude:Double = BuiltLocation.longitude
      }
  
-@param successBlock will have the `BuiltLocation` object with current longitude and latitude.
-@param errorBlock will have an `NSError` object in case the current location was not available.
+@param completionBlock Completion block with params current location and error object in any.
  */
 + (void)currentLocationOnCompletion:(void (^) (BuiltLocation * BUILT_NULLABLE_P currentLocation, NSError * BUILT_NULLABLE_P error))completionBlock;