update to v1.0.24

Author: unreal0

.gitignore

@@ -1,6 +1,6 @@
 .DS_Store
 .dart_tool/
-
+.history
 .packages
 .pub/
 pubspec.lock

CHANGELOG.md

@@ -1,4 +1,12 @@
+## 1.0.24
+
+## 1.0.23
+Fixed LiveQuery
+Bug fixes
+
 ## 1.0.22
+Added dirty children
+Added option of sembast or share_preferences 
 
 ## 1.0.21
 LiveQuery fix

README.md

@@ -13,7 +13,7 @@ Want to get involved? Join our Slack channel and help out! (http://flutter-parse
 To install, either add to your pubspec.yaml
 ```yml
 dependencies:  
-    parse_server_sdk: ^1.0.22
+    parse_server_sdk: ^1.0.24
 ```
 or clone this repository and add to your project. As this is an early development with multiple contributors, it is probably best to download/clone and keep updating as an when a new feature is added.
 
@@ -44,9 +44,9 @@ It's possible to add other parameters to work with your instance of Parse Server
         clientKey: keyParseClientKey, // Required for some setups
         debug: true, // When enabled, prints logs to console
         liveQueryUrl: keyLiveQueryUrl, // Required if using LiveQuery 
-        autoSendSessionId: true, // Some confurations require this to be true
+        autoSendSessionId: true, // Required for authentication and ACL
         securityContext: securityContext, // Again, required for some setups
-		coreStore: await CoreStoreSharedPrefsImp.getInstance()); // Will use SharedPreferences instead of Sembast as an internal DB
+	coreStore: await CoreStoreSharedPrefsImp.getInstance()); // Local data storage method. Will use SharedPreferences instead of Sembast as an internal DB
 ```
 
 ## Objects
@@ -133,6 +133,17 @@ and to retrieve it
 var dietPlan = DietPlan().fromPin('OBJECT ID OF OBJECT');
 ```
 
+## Storage
+We now have 2 types of storage, secure and unsecure. We currently rely on 2 third party options:
+
+- SharedPreferences
+- Sembast
+Sembast offers secured storage, whilst SharePreferences wraps NSUserDefaults (on iOS) and SharedPreferences (on Android).
+
+The storage method is defined in the parameter __coreStore__ in  Parse().initialize
+
+Check sample code for options
+
 ## Increment Counter values in objects
 Retrieve it, call
 
@@ -441,13 +452,52 @@ Also, once logged in you can manage sessions tokens. This feature can be called
 ```dart
 user = ParseUser.currentUser();
 ```
+
+To add additional columns to the user:
+```dart
+var user = ParseUser("TestFlutter", "TestPassword123", "[email protected]")
+            ..set("userLocation", "FlutterLand");
+```
+
 Other user features are:-
  * Request Password Reset
  * Verification Email Request
  * Get all users
  * Save
  * Destroy user
  * Queries 
+ 
+ ## Facebook, OAuth and 3rd Party Login/User
+ 
+ Usually, each provider will provide their own library for logins, but the loginWith method on ParseUser accepts a name of provider, then a Map<String, dynamic> with the authentication details required.
+ For Facebook and the example below, we used the library provided at https://pub.dev/packages/flutter_facebook_login
+ 
+ ```
+ Future<void> goToFacebookLogin() async {
+        final FacebookLogin facebookLogin = FacebookLogin();
+        final FacebookLoginResult result = await facebookLogin.logInWithReadPermissions(['email']);
+    
+        switch (result.status) {
+          case FacebookLoginStatus.loggedIn:
+            final ParseResponse response = await ParseUser.loginWith(
+                'facebook',
+                facebook(result.accessToken.token,
+                    result.accessToken.userId,
+                    result.accessToken.expires));
+    
+            if (response.success) {
+              // User is logged in, test with ParseUser.currentUser()
+            }
+            break;
+          case FacebookLoginStatus.cancelledByUser:
+                // User cancelled
+            break;
+          case FacebookLoginStatus.error:
+                // Error
+            break;
+        }
+      }
+```
 
 ## Security for Objects - ParseACL
 For any object, you can specify which users are allowed to read the object, and which users are allowed to modify an object.
@@ -539,6 +589,40 @@ final Map<String, String> params = <String, String>{'plan': 'paid'};
 function.execute(parameters: params);
 ```
 
+## Relation
+
+The SDK supports Relation.
+
+To add relation to object:
+
+```dart
+dietPlan.addRelation('fruits', [ParseObject("Fruits")..set("objectId", "XGadzYxnac")]);
+```
+
+To remove relation to object:
+
+```dart
+dietPlan.removeRelation('fruits', [ParseObject("Fruits")..set("objectId", "XGadzYxnac")]);
+```
+
+To Retrive a relation instance for user, call:
+```dart
+final relation = dietPlan.getRelation('fruits');
+```
+
+and then you can add a relation to the passed in object:
+```
+relation.add(dietPlan);
+final result = await user.save();
+```
+
+To retrieve objects that are members of Relation field of a parent object:
+```dart
+QueryBuilder<ParseObject> query =
+    QueryBuilder<ParseObject>(ParseObject('Fruits'))
+      ..whereRelatedTo('fruits', 'DietPlan', DietPlan.objectId);
+```
+
 ## Other Features of this library
 Main:
 * Installation (View the example application)

example/lib/main.dart

@@ -248,22 +248,22 @@ class _MyAppState extends State<MyApp> with AutomaticKeepAliveClientMixin {
 
   Future<void> runTestQueries() async {
     // Basic repository example
-    await repositoryAddUser();
+    /* await repositoryAddUser();
     await repositoryAddItems();
     await repositoryGetAllItems();
-
+*/
     //Basic usage
-    await createItem();
+    /* await createItem();
     await getAllItems();
     await getAllItemsByName();
     await getSingleItem();
     await getConfigs();
-    await query();
+    await query();*/
     await initUser();
-    await initInstallation();
+    /* await initInstallation();
     await function();
     await functionWithParameters();
-    await test();
+    await test();*/
   }
 
   Future<void> initInstallation() async {
@@ -375,16 +375,19 @@ class _MyAppState extends State<MyApp> with AutomaticKeepAliveClientMixin {
   Future<void> initUser() async {
     // All return type ParseUser except all
     ParseUser user =
-        ParseUser('TestFlutter', 'TestPassword123', 'test.flutter@gmail.com');
+    ParseUser('RE9fU360lishjFKC5dLZS4Zwm', 'password', 'test@facebook.com');
 
     /// Sign-up
-    ParseResponse response = await user.signUp();
+    /*ParseResponse response = await user.signUp();
     if (response.success) {
       user = response.result;
-    }
+    }*/
+
+    ParseUser user1 = await ParseUser.currentUser();
+    user1.authData;
 
     /// Login
-    response = await user.login();
+    ParseResponse response = await user.login();
     if (response.success) {
       user = response.result;
     }

lib/parse_server_sdk.dart

@@ -17,9 +17,11 @@ import 'package:sembast/sembast.dart';
 import 'package:sembast/sembast_io.dart';
 import 'package:shared_preferences/shared_preferences.dart';
 import 'package:uuid/uuid.dart';
-import 'package:web_socket_channel/io.dart';
 import 'package:xxtea/xxtea.dart';
 
+export 'src/network/parse_live_query.dart'
+if (dart.library.js) 'src/network/parse_live_query_web.dart';
+
 part 'package:parse_server_sdk/src/objects/response/parse_error_response.dart';
 
 part 'package:parse_server_sdk/src/objects/response/parse_exception_response.dart';
@@ -46,8 +48,6 @@ part 'src/enums/parse_enum_api_rq.dart';
 
 part 'src/network/parse_http_client.dart';
 
-part 'src/network/parse_live_query.dart';
-
 part 'src/network/parse_query.dart';
 
 part 'src/objects/parse_acl.dart';
@@ -90,6 +90,10 @@ part 'src/utils/parse_logger.dart';
 
 part 'src/utils/parse_utils.dart';
 
+part 'src/utils/parse_login_helpers.dart';
+
+part 'src/objects/parse_merge.dart';
+
 class Parse {
   ParseCoreData data;
   bool _hasBeenInitialized = false;

lib/src/base/parse_constants.dart

@@ -1,7 +1,7 @@
 part of flutter_parse_sdk;
 
 // Library
-const String keySdkVersion = '1.0.22';
+const String keySdkVersion = '1.0.24';
 const String keyLibraryName = 'Flutter Parse SDK';
 
 // End Points
@@ -15,6 +15,7 @@ const String keyEndPointVerificationEmail = '/verificationEmailRequest';
 const String keyEndPointRequestPasswordReset = '/requestPasswordReset';
 const String keyEndPointClasses = '/classes/';
 const String keyEndPointHealth = '/health';
+const String keyEndPointAggregate = '/aggregate/';
 
 // ParseObject variables
 const String keyVarClassName = 'className';
@@ -25,6 +26,7 @@ const String keyVarUsername = 'username';
 const String keyVarEmail = 'email';
 const String keyVarPassword = 'password';
 const String keyVarSessionToken = 'sessionToken';
+const String keyVarAuthData = 'authData';
 const String keyVarAcl = 'ACL';
 const String keyVarName = 'name';
 const String keyVarURL = 'url';

lib/src/enums/parse_enum_api_rq.dart

@@ -5,6 +5,7 @@ enum ParseApiRQ {
   healthCheck,
   get,
   getAll,
+  unset,
   create,
   save,
   query,

lib/src/network/parse_http_client.dart

@@ -6,7 +6,7 @@ class ParseHTTPClient extends BaseClient {
       : _sendSessionId = sendSessionId,
         _client = securityContext != null
             ? IOClient(HttpClient(context: securityContext))
-            : IOClient();
+            : Client();
 
   final Client _client;
   final bool _sendSessionId;
@@ -17,7 +17,9 @@ class ParseHTTPClient extends BaseClient {
   /// Overrides the call method for HTTP Client and adds custom headers
   @override
   Future<StreamedResponse> send(BaseRequest request) {
-    request.headers[keyHeaderUserAgent] = _userAgent;
+    if (!identical(0, 0.0)) {
+      request.headers[keyHeaderUserAgent] = _userAgent;
+    }
     request.headers[keyHeaderApplicationId] = data.applicationId;
     if ((_sendSessionId == true) &&
         (data.sessionId != null) &&

lib/src/network/parse_live_query.dart

@@ -1,4 +1,9 @@
-part of flutter_parse_sdk;
+import 'dart:convert';
+import 'dart:io';
+
+import 'package:web_socket_channel/io.dart';
+
+import '../../parse_server_sdk.dart';
 
 enum LiveQueryEvent { create, enter, update, leave, delete, error }
 
@@ -49,8 +54,9 @@ class LiveQuery {
     }
 
     final String _className = query.object.parseClassName;
+    final List<String> keysToReturn = query.limiters['keys']?.split(',');
     query.limiters.clear(); //Remove limits in LiveQuery
-    final String _where = query._buildQuery().replaceAll('where=', '');
+    final String _where = query.buildQuery().replaceAll('where=', '');
 
     //Convert where condition to Map
     Map<String, dynamic> _whereMap = Map<String, dynamic>();
@@ -90,7 +96,7 @@ class LiveQuery {
             final String className = map['className'];
             if (className == '_User') {
               eventCallbacks[actionData['op']](
-                  ParseUser._getEmptyUser().fromJson(map));
+                  ParseUser(null, null, null).fromJson(map));
             } else {
               eventCallbacks[actionData['op']](
                   ParseObject(className).fromJson(map));
@@ -103,7 +109,7 @@ class LiveQuery {
         if (_debug) {
           print('$_printConstLiveQuery: Done');
         }
-      }, onError: (dynamic error) {
+      }, onError: (Object error) {
         if (_debug) {
           print(
               '$_printConstLiveQuery: Error: ${error.runtimeType.toString()}');
@@ -116,13 +122,17 @@ class LiveQuery {
       //It should be the first message sent from a client after the WebSocket connection is established.
       _connectMessage = <String, String>{
         'op': 'connect',
-        'applicationId': _client.data.applicationId,
-        'clientKey': _client.data.clientKey ?? ''
+        'applicationId': _client.data.applicationId
       };
-      if (_sendSessionId) {
+      if (_sendSessionId && _client.data.sessionId != null) {
         _connectMessage['sessionToken'] = _client.data.sessionId;
       }
 
+      if (_client.data.clientKey != null)
+        _connectMessage['clientKey'] = _client.data.clientKey;
+      if (_client.data.masterKey != null)
+        _connectMessage['masterKey'] = _client.data.masterKey;
+
       if (_debug) {
         print('$_printConstLiveQuery: ConnectMessage: $_connectMessage');
       }
@@ -136,9 +146,11 @@ class LiveQuery {
         'query': <String, dynamic>{
           'className': _className,
           'where': _whereMap,
+          if (keysToReturn != null && keysToReturn.isNotEmpty)
+            'fields': keysToReturn
         }
       };
-      if (_sendSessionId) {
+      if (_sendSessionId && _client.data.sessionId != null) {
         _subscribeMessage['sessionToken'] = _client.data.sessionId;
       }