Merge remote-tracking branch 'upstream/master'

Author: mtrezza

.github/workflows/ci.yml

@@ -3,7 +3,6 @@ on:
   push:
     branches:
       - "master"
-      - "development"
     paths-ignore:
       - "**/README.md"
   pull_request:
@@ -16,31 +15,31 @@ jobs:
       matrix:
         include:
           # Dart framework may contain breaking changes in minor version releases, not following semver.
-          - name: Dart 3.0, Ubuntu
+          # The latest Dart framework (below) is tested on all architectures (Ubuntu, macOS, Windows).
+          - name: Dart 3.1, Ubuntu
             os: ubuntu-latest
-            sdk: 3.0.0
-          - name: Dart 3.0, macOS
+            sdk: 3.1.2
+          - name: Dart 3.1, macOS
             os: macos-latest
-            sdk: 3.0.0
-          - name: Dart 3.0, Windows
+            sdk: 3.1.2
+          - name: Dart 3.1, Windows
             os: windows-latest
-            sdk: 3.0.0
-          # Only the latest Dart framework version (above) is tested with all architectures. Previous
-          # Dart framework versions (below) are only tested with Ubuntu to reduce CI resource usage.
+            sdk: 3.1.2
+          # Older Dart framework versions (below) are only tested with Ubuntu to reduce CI resource usage.
+          - name: Dart 3.0
+            os: ubuntu-latest
+            sdk: 3.0.7
           - name: Dart 2.19
             os: ubuntu-latest
             sdk: 2.19.6
-          - name: Dart 2.18
-            os: ubuntu-latest
-            sdk: 2.18.7
           - name: Dart beta
             os: ubuntu-latest
             sdk: beta
       fail-fast: false
     name: Test ${{ matrix.name }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup dart
         uses: dart-lang/setup-dart@v1.5.0
         with:
@@ -77,31 +76,31 @@ jobs:
       matrix:
         include:
           # Flutter framework may contain breaking changes in minor version releases, not following semver.
-          - name: Flutter 3.10, Ubuntu
+          # The latest Flutter framework (below) is tested on all architectures (Ubuntu, macOS, Windows).
+          - name: Flutter 3.13, Ubuntu
             os: ubuntu-latest
-            sdk: 3.10.x
-          - name: Flutter 3.10, macOS
+            sdk: 3.13.6
+          - name: Flutter 3.13, macOS
             os: macos-latest
-            sdk: 3.10.x
-          - name: Flutter 3.10, Windows
+            sdk: 3.13.6
+          - name: Flutter 3.13, Windows
             os: windows-latest
-            sdk: 3.10.x
-          # Only the latest Flutter framework version (above) is tested with all architectures. Previous
-          # Flutter framework versions (below) are only tested with Ubuntu to reduce CI resource usage.
-          - name: Flutter 3.7
+            sdk: 3.13.6
+          # Older Flutter framework versions (below) are only tested with Ubuntu to reduce CI resource usage.
+          - name: Flutter 3.10
             os: ubuntu-latest
-            sdk: 3.7.x
-          - name: Flutter 3.3
+            sdk: 3.10.6
+          - name: Flutter 3.7
             os: ubuntu-latest
-            sdk: 3.3.x
+            sdk: 3.7.12
           - name: Flutter beta
             os: ubuntu-latest
             sdk: beta
       fail-fast: false
     name: Test ${{ matrix.name }}
     steps:
       - name: Checkout code
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
       - name: Setup flutter (beta)
         if: ${{ matrix.sdk == 'beta' }}
         uses: subosito/flutter-action@v2
@@ -116,14 +115,10 @@ jobs:
           cache: true
       - name: Install dependencies on Ubuntu and MacOS
         if: matrix.os == 'ubuntu-latest' || matrix.os == 'macos-latest'
-        run: |
-          (cd packages/dart && flutter pub get)
-          (cd packages/flutter && flutter pub get)
+        run: (cd packages/flutter && flutter pub get)
       - name: Install dependencies on Windows
         if: matrix.os == 'windows-latest'
-        run: |
-          cmd /c "cd packages\dart && flutter pub get"
-          cmd /c "cd packages\flutter && flutter pub get"
+        run: cmd /c "cd packages\flutter && flutter pub get"
       - name: Analyze code
         run: flutter analyze packages/flutter --fatal-infos
       - name: Lint

packages/dart/CHANGELOG.md

@@ -1,3 +1,37 @@
+## [6.4.0](https://github.com/parse-community/Parse-SDK-Flutter/compare/dart-6.3.0...dart-6.4.0) (2024-03-30)
+
+### Features
+
+* Add `ParseXFile` for cross-platform `XFile` support ([#990](https://github.com/parse-community/Parse-SDK-Flutter/pull/990))
+
+## [6.3.0](https://github.com/parse-community/Parse-SDK-Flutter/compare/dart-6.2.0...dart-6.3.0) (2023-11-11)
+
+### Features
+
+* Add `installationId` in LiveQuery `connect` ([#976](https://github.com/parse-community/Parse-SDK-Flutter/pull/976))
+
+## [6.2.0](https://github.com/parse-community/Parse-SDK-Flutter/compare/dart-6.1.0...dart-6.2.0) (2023-10-18)
+
+### Features
+
+* Added `saveEventually` and `deleteEventually` in `ParseObject` ([#911](https://github.com/parse-community/Parse-SDK-Flutter/pull/911))
+
+## [6.1.0](https://github.com/parse-community/Parse-SDK-Flutter/compare/dart-6.0.0...dart-6.1.0) (2023-10-17)
+
+### Features
+
+* Add `context` in `ParseObject` ([#970](https://github.com/parse-community/Parse-SDK-Flutter/pull/970))
+
+## [6.0.0](https://github.com/parse-community/Parse-SDK-Flutter/compare/dart-5.1.3...dart-6.0.0) (2023-10-16)
+
+### BREAKING CHANGES
+
+* This release removes support for Dart 2.18 ([#969](https://github.com/parse-community/Parse-SDK-Flutter/pull/969))
+
+### Features
+
+* Add support for Dart 3.1, remove support for Dart 2.18 ([#969](https://github.com/parse-community/Parse-SDK-Flutter/pull/969))
+
 ## [5.1.3](https://github.com/parse-community/Parse-SDK-Flutter/compare/dart-5.1.2...dart-5.1.3) (2023-07-18)
 
 ### Bug Fixes

packages/dart/README.md

@@ -28,14 +28,13 @@ This library gives you access to the powerful Parse Server backend from your Dar
 
 ## Compatibility
 
-The Parse Dart SDK is continuously tested with the most recent release of the Dart framework to ensure compatibility. To give developers time to upgrade their app to the newest Dart framework, previous Dart framework releases are supported for at least 1 year after their [release date](https://dart.dev/get-dart/archive).
+The Parse Dart SDK is continuously tested with the most recent release of the Dart framework to ensure compatibility. To give developers time to upgrade their app to a newer Dart framework, previous Dart framework releases are supported for at least 1 year after the [release date](https://dart.dev/get-dart/archive) of the next higher significant version.
 
-| Version   | Latest Version | End of Support | Compatible                                   |
-|-----------|----------------|----------------|----------------------------------------------|
-| Dart 3.0  | 3.0.0          | May 2024       | ✅ Yes                                        |
-| Dart 2.19 | 2.19.6         | Mar 2024       | ✅ Yes                                        |
-| Dart 2.18 | 2.18.7         | Jan 2024       | ✅ Yes                                        |
-| Dart 2.17 | 2.17.7         | Aug 2023       | ❌ No (Parse Dart SDK requires Dart >=2.18.0) |
+| Version   | Latest Version | End of Support | Compatible |
+|-----------|----------------|----------------|------------|
+| Dart 3.1  | 3.1.2          | Sep 2024       | ✅ Yes      |
+| Dart 3.0  | 3.0.7          | May 2024       | ✅ Yes      |
+| Dart 2.19 | 2.19.6         | Mar 2024       | ✅ Yes      |
 
 ## Getting Started
 
@@ -51,3 +50,4 @@ We want to make contributing to this project as easy and transparent as possible
 
 [guide]: https://docs.parseplatform.org/dart/guide/
 [open-collective-link]: https://opencollective.com/parse-server
+

packages/dart/example/pubspec.yaml

@@ -5,7 +5,7 @@ publish_to: 'none'
 version: 1.0.0
 
 environment:
-  sdk: ">=2.18.0 <4.0.0"
+  sdk: ">=2.19.6 <4.0.0"
 
 dependencies:
   parse_server_sdk:

packages/dart/lib/parse_server_sdk.dart

@@ -6,9 +6,10 @@ import 'dart:math';
 import 'dart:typed_data';
 
 import 'package:collection/collection.dart';
+import 'package:cross_file/cross_file.dart';
 import 'package:dio/dio.dart';
 import 'package:meta/meta.dart';
-import 'package:mime_type/mime_type.dart';
+import 'package:mime/mime.dart';
 import 'package:path/path.dart' as path;
 import 'package:sembast/sembast.dart';
 import 'package:sembast/sembast_io.dart';
@@ -41,15 +42,15 @@ part 'src/objects/parse_base.dart';
 part 'src/objects/parse_cloneable.dart';
 part 'src/objects/parse_config.dart';
 part 'src/objects/parse_error.dart';
+part 'src/objects/parse_exception.dart';
 part 'src/objects/parse_file.dart';
-part 'src/objects/parse_number.dart';
 part 'src/objects/parse_file_base.dart';
 part 'src/objects/parse_file_web.dart';
 part 'src/objects/parse_function.dart';
 part 'src/objects/parse_geo_point.dart';
 part 'src/objects/parse_installation.dart';
+part 'src/objects/parse_number.dart';
 part 'src/objects/parse_object.dart';
-part 'src/objects/parse_exception.dart';
 part 'src/objects/parse_operation/parse_add_operation.dart';
 part 'src/objects/parse_operation/parse_add_relation_operation.dart';
 part 'src/objects/parse_operation/parse_add_unique_operation.dart';
@@ -62,6 +63,7 @@ part 'src/objects/parse_response.dart';
 part 'src/objects/parse_save_state_aware_child.dart';
 part 'src/objects/parse_session.dart';
 part 'src/objects/parse_user.dart';
+part 'src/objects/parse_x_file.dart';
 part 'src/objects/response/parse_error_response.dart';
 part 'src/objects/response/parse_exception_response.dart';
 part 'src/objects/response/parse_response_builder.dart';
@@ -83,6 +85,8 @@ part 'src/utils/valuable.dart';
 class Parse {
   bool _hasBeenInitialized = false;
 
+  static bool objectsExistForEventually = false;
+
   /// To initialize Parse Server in your application
   ///
   /// This should be initialized in MyApp() creation
@@ -148,6 +152,12 @@ class Parse {
 
     _hasBeenInitialized = true;
 
+    objectsExistForEventually = await checkObjectsExistForEventually();
+
+    if (objectsExistForEventually) {
+      ParseObject.submitEventually();
+    }
+
     return this;
   }
 

packages/dart/lib/src/base/parse_constants.dart

@@ -1,7 +1,7 @@
 part of flutter_parse_sdk;
 
 // Library
-const String keySdkVersion = '5.1.3';
+const String keySdkVersion = '6.4.0';
 const String keyLibraryName = 'Flutter Parse SDK';
 
 // End Points
@@ -44,6 +44,7 @@ const String keyFileClassname = 'ParseFile';
 // Headers
 const String keyHeaderSessionToken = 'X-Parse-Session-Token';
 const String keyHeaderRevocableSession = 'X-Parse-Revocable-Session';
+const String keyHeaderCloudContext = 'X-Parse-Cloud-Context';
 const String keyHeaderUserAgent = 'user-agent';
 const String keyHeaderApplicationId = 'X-Parse-Application-Id';
 const String keyHeaderContentType = 'content-type';
@@ -58,6 +59,8 @@ const String keyParamSessionToken = 'sessionToken';
 // Storage
 const String keyParseStoreBase = 'flutter_parse_sdk_';
 const String keyParseStoreUser = '${keyParseStoreBase}user';
+const String keyParseStoreObjects = '${keyParseStoreBase}objects';
+const String keyParseStoreDeletes = '${keyParseStoreBase}deletes';
 const String keyParseStoreInstallation = '${keyParseStoreBase}installation';
 
 // Installation
@@ -81,5 +84,6 @@ const String keyVarInstallationId = 'installationId';
 // Error
 const String keyError = 'error';
 const String keyCode = 'code';
+const String keyNetworkError = 'NetworkError';
 
 const bool parseIsWeb = identical(0, 0.0);

packages/dart/lib/src/network/parse_dio_client.dart

@@ -229,6 +229,8 @@ class _ParseDioClient with dio.DioMixin implements dio.Dio {
       _logCUrl(options, data, path);
     }
 
+    checkForSubmitEventually();
+
     return super.request(
       path,
       data: data,

packages/dart/lib/src/network/parse_http_client.dart

@@ -158,6 +158,8 @@ class _ParseHTTPClient extends http.BaseClient {
       _logCUrl(request);
     }
 
+    checkForSubmitEventually();
+
     return _client.send(request);
   }
 

packages/dart/lib/src/network/parse_live_query.dart

@@ -22,6 +22,7 @@ class Subscription<T extends ParseObject> {
     'error'
   ];
   Map<String, Function> eventCallbacks = <String, Function>{};
+
   void on(LiveQueryEvent op, Function callback) {
     eventCallbacks[_liveQueryEvent[op.index]] = callback;
   }
@@ -140,8 +141,10 @@ class LiveQueryClient {
     reconnectingController = LiveQueryReconnectingController(
         () => reconnect(userInitialized: false), getClientEventStream, _debug);
   }
+
   static LiveQueryClient get instance => _getInstance();
   static LiveQueryClient? _instance;
+
   static LiveQueryClient _getInstance({bool? debug, bool? autoSendSessionId}) {
     String? liveQueryURL = ParseCoreData().liveQueryURL;
     if (liveQueryURL == null) {
@@ -174,13 +177,14 @@ class LiveQueryClient {
   bool _connecting = false;
   late StreamController<LiveQueryClientEvent> _clientEventStreamController;
   late Stream<LiveQueryClientEvent> _clientEventStream;
+  StreamController<String>? chanelStream;
   late LiveQueryReconnectingController reconnectingController;
 
   final Map<int, Subscription> _requestSubscription = <int, Subscription>{};
 
   Future<void> reconnect({bool userInitialized = false}) async {
     await _connect(userInitialized: userInitialized);
-    _connectLiveQuery();
+    await _connectLiveQuery();
   }
 
   int readyState() {
@@ -286,6 +290,8 @@ class LiveQueryClient {
       _channel = channel;
       channel.stream.listen((dynamic message) {
         _handleMessage(message);
+
+        chanelStream?.sink.add(message);
       }, onDone: () {
         _clientEventStreamController.sink
             .add(LiveQueryClientEvent.disconnected);
@@ -315,7 +321,7 @@ class LiveQueryClient {
     }
   }
 
-  void _connectLiveQuery() {
+  Future<void> _connectLiveQuery() async {
     WebSocketChannel? channel = _channel;
     if (channel == null) {
       return;
@@ -333,10 +339,22 @@ class LiveQueryClient {
         connectMessage['sessionToken'] = sessionId;
       }
     }
+
     String? clientKey = ParseCoreData().clientKey;
+    if (clientKey != null) {
+      connectMessage['clientKey'] = clientKey;
+    }
+
     String? masterKey = ParseCoreData().masterKey;
-    if (clientKey != null) connectMessage['clientKey'] = clientKey;
-    if (masterKey != null) connectMessage['masterKey'] = masterKey;
+    if (masterKey != null) {
+      connectMessage['masterKey'] = masterKey;
+    }
+
+    String? parseInstallation =
+        (await ParseInstallation.currentInstallation()).installationId;
+    if (parseInstallation != null) {
+      connectMessage['installationId'] = parseInstallation;
+    }
 
     if (_debug) {
       print('$_printConstLiveQuery: ConnectMessage: $connectMessage');

packages/dart/lib/src/objects/parse_file.dart

@@ -82,7 +82,7 @@ class ParseFile extends ParseFileBase {
 
     final Map<String, String> headers = <String, String>{
       HttpHeaders.contentTypeHeader:
-          mime(file!.path) ?? 'application/octet-stream',
+          lookupMimeType(file!.path) ?? 'application/octet-stream',
       HttpHeaders.contentLengthHeader: '${file!.lengthSync()}',
     };