Skip to content

Add Aggregate Query Support to Parse Flutter SDK #1041

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 7 commits into
base: master
Choose a base branch
from
Open

Add Aggregate Query Support to Parse Flutter SDK #1041

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
7 commits
Select commit Hold shift + click to select a range
8ad7e19
no message
mskayali Apr 30, 2025
e65a3f5
packages updated
mskayali Apr 30, 2025
c093ff1
Aggregate done!
mskayali Apr 30, 2025
29d83f5
no message
mskayali May 30, 2025
3a4feb6
Pipeline bug fixed (complex aggregates supported)
mskayali May 31, 2025
bd2b057
no message
mskayali May 31, 2025
7dabdcb
code documentation compleated
mskayali May 31, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 12 additions & 0 deletions packages/dart/example/main.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,22 @@ Future<void> main() async {
..set('Name', 'Ketogenic')
..set('Fat', 65);



var response = await dietPlan.save();

if (response.success) {
dietPlan = response.results?.first;
print("Response received successfully");
}

final res = await ParseAggregate('DietPlan', pipeline: {
r'$match': {'Name': 'Ketogenic'},
r'$group': {
'_id': r'isHungry',
'count': {r'$sum': 1}
},
}).execute();

print(res.result);
}
54 changes: 1 addition & 53 deletions packages/dart/lib/parse_server_sdk.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -29,111 +29,59 @@ export 'src/network/parse_dio_client.dart';
export 'src/network/parse_http_client.dart';

part 'src/base/parse_constants.dart';

part 'src/data/parse_core_data.dart';

part 'src/data/parse_subclass_handler.dart';

part 'src/enums/parse_enum_api_rq.dart';

part 'src/network/options.dart';

part 'src/network/parse_aggregate.dart';
part 'src/network/parse_client.dart';

part 'src/network/parse_connectivity.dart';

part 'src/network/parse_live_query.dart';

part 'src/network/parse_query.dart';

part 'src/objects/parse_acl.dart';

part 'src/objects/parse_array.dart';

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_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_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';

part 'src/objects/parse_operation/parse_increment_operation.dart';

part 'src/objects/parse_operation/parse_operation.dart';

part 'src/objects/parse_operation/parse_remove_operation.dart';

part 'src/objects/parse_operation/parse_remove_relation_operation.dart';

part 'src/objects/parse_relation.dart';

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';

part 'src/objects/response/parse_response_utils.dart';

part 'src/objects/response/parse_success_no_results.dart';

part 'src/storage/core_store.dart';

part 'src/storage/core_store_memory.dart';

part 'src/storage/core_store_sem_impl.dart';

part 'src/storage/xxtea_codec.dart';

part 'src/utils/parse_date_format.dart';

part 'src/utils/parse_decoder.dart';

part 'src/utils/parse_encoder.dart';

part 'src/utils/parse_live_list.dart';

part 'src/utils/parse_logger.dart';

part 'src/utils/parse_login_helpers.dart';

part 'src/utils/parse_utils.dart';

part 'src/utils/valuable.dart';

class Parse {
Expand Down
92 changes: 92 additions & 0 deletions packages/dart/lib/src/network/parse_aggregate.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,92 @@
part of '../../parse_server_sdk.dart';

/// A class that allows aggregation queries on a Parse Server class using a pipeline.
///
/// Example usage:
/// ```dart
/// final aggregate = ParseAggregate('GameScore', pipeline: {
/// '\$group': {
/// '_id': '\$userId',
/// 'totalScore': {'\$sum': '\$score'}
/// }
/// });
/// final response = await aggregate.execute();
/// ```
class ParseAggregate {
/// The name of the Parse class to perform the aggregation on.
final String className;

/// The aggregation pipeline operations.
///
/// Each operation should follow MongoDB-like syntax.
/// Example:
/// ```dart
/// {
/// '\$group': {
/// '_id': '\$userId',
/// 'totalScore': {'\$sum': '\$score'}
/// }
/// }
/// ```
Map<String, dynamic> pipeline;

/// Whether to enable debug mode for this request.
final bool? debug;

/// The custom ParseClient to use for the request (optional).
final ParseClient? client;

/// If true, includes the session ID automatically in the request (optional).
final bool? autoSendSessionId;

/// Optional override for the Parse class name used in response handling.
final String? parseClassName;

/// Creates a new [ParseAggregate] instance to perform aggregation queries.
///
/// [className] is required and specifies the target Parse class.
/// [pipeline] must contain at least one aggregation operation.
ParseAggregate(
this.className, {
required this.pipeline,
this.debug,
this.client,
this.autoSendSessionId,
this.parseClassName,
});

/// Executes the aggregation query using the configured pipeline.
///
/// Returns a [ParseResponse] containing the results of the aggregation.
/// Throws [ArgumentError] if the pipeline is empty.
Future<ParseResponse> execute() async {
Map<String, String> _pipeline = {};

if (pipeline.isEmpty) {
throw ArgumentError(
'pipeline must not be empty. Please add pipeline operations to aggregate data. '
'Example: {"\$group": {"_id": "\$userId", "totalScore": {"\$sum": "\$score"}}}',
);
} else {
_pipeline.addAll({
'pipeline': jsonEncode(pipeline.entries.map((e) => {e.key: e.value}).toList())
});
}

final debugBool = isDebugEnabled(objectLevelDebug: debug);
final result = await ParseObject(className)._client.get(
Uri.parse('${ParseCoreData().serverUrl}$keyEndPointAggregate$className').replace(
queryParameters: {'pipeline': jsonEncode(pipeline.entries.map((e) => {e.key: e.value}).toList())}
).toString(),
);


return handleResponse<ParseObject>(
ParseObject(className),
result,
ParseApiRQ.get,
debugBool,
parseClassName ?? 'ParseBase',
);
}
}
4 changes: 2 additions & 2 deletions packages/dart/lib/src/network/parse_http_client.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,9 +1,8 @@
import 'dart:convert';
import 'package:universal_io/io.dart';

import 'package:http/http.dart' as http;

import 'package:parse_server_sdk/parse_server_sdk.dart';
import 'package:universal_io/io.dart';

import 'http_client_io.dart' if (dart.library.js) 'http_client_js.dart';

Expand Down Expand Up @@ -31,6 +30,7 @@ class ParseHTTPClient extends ParseClient {
ParseNetworkOptions? options,
ProgressCallback? onReceiveProgress,
}) async {

final http.Response response = await _client.get(
Uri.parse(path),
headers: options?.headers,
Expand Down
24 changes: 24 additions & 0 deletions packages/dart/lib/src/utils/url_replace.dart
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
class UrlReplace{
String? scheme;
String? userInfo;
String? host;
int? port;
String? path;
Iterable<String>? pathSegments;
String? query;
Map<String, dynamic>? queryParameters;
String? fragment;

UrlReplace({
this.scheme,
this.userInfo,
this.host,
this.port,
this.path,
this.pathSegments,
this.query,
this.queryParameters,
this.fragment,
});

}
Comment on lines +1 to +24
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🛠️ Refactor suggestion

Add documentation and consider using Dart's Uri class instead.

This class lacks documentation explaining its purpose and usage. Additionally, it appears to duplicate functionality that's already available in Dart's Uri class.

  1. Add class-level and field-level documentation
  2. Add a space after the class name declaration: class UrlReplace {
  3. Consider whether this utility class is necessary or if Dart's Uri class could be used directly
-class UrlReplace{
+/// A container for URL components used for URL manipulation operations.
+/// This class provides a convenient way to store and pass URL components.
+class UrlReplace {
  /// The URL scheme (e.g., 'http', 'https')
  String? scheme;
  /// The user info portion of the URL
  String? userInfo;
  /// The host name
  String? host;
  /// The port number
  int? port;
  /// The path component of the URL
  String? path;
  /// The path segments as an iterable collection
  Iterable<String>? pathSegments;
  /// The query string
  String? query;
  /// The query parameters as a map
  Map<String, dynamic>? queryParameters;
  /// The fragment identifier
  String? fragment;

+  /// Creates a new UrlReplace instance with the specified URL components.
  UrlReplace({
    this.scheme,
    this.userInfo,
    this.host,
    this.port,
    this.path,
    this.pathSegments,
    this.query,
    this.queryParameters,
    this.fragment,
  });

}
🤖 Prompt for AI Agents (early access) 
In packages/dart/lib/src/utils/url_replace.dart lines 1 to 24, add clear class-level documentation explaining the purpose of UrlReplace and field-level comments describing each property. Insert a space after the class name declaration to follow Dart style conventions (change `class UrlReplace{` to `class UrlReplace {`). Finally, review the code to determine if this class is redundant given Dart's built-in Uri class and consider refactoring to use Uri directly if possible.

8 changes: 4 additions & 4 deletions packages/dart/pubspec.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ dependencies:
# Networking
dio: ^5.7.0
http: ^1.2.0
web_socket_channel: ^2.4.3
web_socket_channel: ^3.0.3
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Verification agent

🧩 Analysis chain

Verify compatibility with web_socket_channel major version upgrade

The web_socket_channel dependency has been upgraded from ^2.4.3 to ^3.0.3, which is a major version bump that may include breaking changes.

🌐 Web query:

What are the breaking changes in web_socket_channel v3.0.0?

💡 Result:

Breaking Changes in web_socket_channel v3.0.0

The 3.0.0 release of the Dart web_socket_channel package introduced several breaking changes that impact how developers interact with the API. The main breaking changes are as follows:

  • Removal of WebSocketChannel Constructor
    The direct constructor for WebSocketChannel has been removed. Developers can no longer instantiate the channel using WebSocketChannel() and must now use provided factory methods, such as WebSocketChannel.connect, to create channel instances[1][6].

  • WebSocketChannel Is Now an Abstract Interface
    The WebSocketChannel class has been converted into an abstract interface. This means you cannot instantiate it directly and must instead work with implementations provided by the package, such as via WebSocketChannel.connect[1][6].

  • Change in Exception Thrown by IOWebSocketChannel.ready
    The ready property on IOWebSocketChannel previously threw a WebSocketException on error. In v3.0.0, this now throws a WebSocketChannelException, requiring consumers to update their exception handling logic when awaiting the connection's readiness[1][6].

  • Adapter Around package:web_socket for Web Implementation
    An adapter for the package:web_socket package is now the default implementation for web platform connections made via WebSocketChannel.connect. This may affect the underlying behavior or compatibility for web-based applications[1][6].

Summary Table

Breaking Change Details
Constructor removal No direct WebSocketChannel() instantiation; use factory constructors instead
Abstract interface WebSocketChannel is now abstract; use specific implementations
Exception change in ready Throws WebSocketChannelException (previously WebSocketException)
Default web adapter Uses package:web_socket adapter for web via WebSocketChannel.connect

Developers upgrading to v3.0.0 should adjust their code to accommodate these changes[1][6].

Citations:

Validate Breaking Changes for web_socket_channel v3.0.0

We’ve bumped web_socket_channel from ^2.4.3 to ^3.0.3, which includes these breaking changes:

  • Removal of the direct WebSocketChannel() constructor – you must now use WebSocketChannel.connect(...).
  • WebSocketChannel is now an abstract interface.
  • IOWebSocketChannel.ready throws WebSocketChannelException (instead of WebSocketException).
  • Default web implementation now uses the package:web_socket adapter.

Please audit the Dart code for:

  • Any instantiation of WebSocketChannel() (replace with connect).
  • Direct uses of IOWebSocketChannel and calls to its ready property (update exception handling).
  • Web‐platform socket code relying on the old adapter.

Make the necessary updates or confirm that your code paths already comply with the new API.

🤖 Prompt for AI Agents (early access) 
In packages/dart/pubspec.yaml at line 27, the web_socket_channel dependency has been upgraded from ^2.4.3 to ^3.0.3, which introduces breaking changes. Audit all Dart code that uses web_socket_channel for direct instantiation of WebSocketChannel() and replace these with WebSocketChannel.connect(...) factory methods. Also, update any exception handling around IOWebSocketChannel.ready to catch WebSocketChannelException instead of WebSocketException. Verify web platform socket code to ensure compatibility with the new package:web_socket adapter. Make these code adjustments to align with the new major version API.


#Database
sembast: ^3.6.0
Expand All @@ -34,15 +34,15 @@ dependencies:
uuid: ^4.5.1
meta: ^1.16.0
path: ^1.9.0
mime: ^1.0.0
timezone: ^0.9.4
mime: ^2.0.0
timezone: ^0.10.1
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are these dependency upgrades necessary for this feature?

Copy link
Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

No but your package dependancies are old and I upgrade it to be compatible with new versions

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Coyld you please remove any changes that are not necessary for this PR? You could open another, separate PR for the dependency upgrades, that should only contain the upgrades.

universal_io: ^2.2.2
xxtea: ^2.1.0
collection: ^1.18.0
cross_file: ^0.3.3+8

dev_dependencies:
lints: ^4.0.0
lints: ^5.1.1

# Testing
build_runner: ^2.4.9
Expand Down
2 changes: 2 additions & 0 deletions packages/flutter/example/.gitignore
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,9 +5,11 @@
*.swp
.DS_Store
.atom/
.build/
.buildlog/
.history
.svn/
.swiftpm/
migrate_working_dir/

# IntelliJ related
Expand Down
6 changes: 3 additions & 3 deletions packages/flutter/pubspec.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ dependencies:
flutter:
sdk: flutter

parse_server_sdk: ^6.4.0
parse_server_sdk: ^8.0.0
# Uncomment for local testing
#parse_server_sdk:
# path: ../dart
Expand All @@ -40,14 +40,14 @@ dependencies:

# Utils
path_provider: ^2.1.4
package_info_plus: ^5.0.1
package_info_plus: ^8.3.0
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Verification agent

🧩 Analysis chain

Check for potential issues with package_info_plus upgrade

The package_info_plus dependency has been upgraded from ^5.0.1 to ^8.3.0, which is a significant version jump. Verify that this update is compatible with your app's requirements.

🌐 Web query:

Are there any breaking changes between package_info_plus v5.0.1 and v8.3.0?

💡 Result:

Breaking Changes Between package_info_plus v5.0.1 and v8.3.0

Overview:
Yes, there are breaking changes between package_info_plus v5.0.1 and v8.3.0. The most notable comes in the major release jump to v7.0.0 and subsequent versions.

Major Breaking Change in v7.0.0:

  • The Android implementation for the buildSignature value switched from using its previous hashing method to SHA-256 for improved security.

    "BREAKING FEAT(package_info_plus): Switch to SHA-256 for buildSignature on Android (#2835)"[1].

v5.0.1 Breaking Changes:

  • v5.0.1 itself introduced breaking changes related to handling the versionJsonUrl on web, now allowing for no page extension:

    "BREAKING FIX(package_info_plus): Allow no page extension in versionJsonUrl on web (#2381)"[3].

  • This requires you to adjust your web setup if you had previously relied on an explicit .json extension in URLs.

Other Notable Upgrades Between v5.0.1 → v8.3.0:

  • There are other minor and patch releases with additional fixes, features, and internal improvements, but the main breaking change of note is the SHA-256 switch for Android.
  • There is no mention in the changelogs of breaking API changes to the core PackageInfo API (such as constructor signatures, returned fields, or general usage) for end-users between these versions[1][3][8]. Most common usage patterns (fetching version, build number, etc.) remain stable.

Upgrade Considerations:

  • Android: If your logic depends on the buildSignature value, expect it to be different due to SHA-256.
  • Web: Ensure your Flutter web deployment does not rely on the .json extension for versionJsonUrl; update your deployment/server settings if needed.
  • General: Always clean and rebuild Xcode projects when upgrading, particularly for iOS apps, as incorrect version info may be cached in the build folder[8].

Summary Table of Key Breaking Changes

Version Breaking Change Description
5.0.1 versionJsonUrl can omit .json extension on web[3]
7.0.0 buildSignature uses SHA-256 on Android[1]

If you rely on either buildSignature for Android or serve web builds with a specific versionJsonUrl file extension, carefully review your implementation when upgrading between these versions.

Further Recommendations:

  • Review the full changelog for package_info_plus for all detailed updates between your installed version and the latest[1].
  • Test each platform you support (Android, iOS, Web) after upgrading to catch any behavioral nuances, especially around version/build info retrieval and signature computation.

Citations:

Review Breaking Changes in package_info_plus Upgrade

The jump from ^5.0.1 to ^8.3.0 introduces a couple of breaking changes you should verify:

  • Android (v7.0.0): buildSignature now uses SHA-256 instead of the previous hashing method. If your app logic depends on this value, update or re-test accordingly.
  • Web (v5.0.1): versionJsonUrl no longer requires a .json extension. Ensure your server or deployment doesn’t rely on a fixed .json suffix.

All other core PackageInfo APIs (version, build number, etc.) remain unchanged. Please review your implementation, adjust any dependent logic, and test each platform (Android, iOS, Web) after upgrading.

🤖 Prompt for AI Agents (early access) 
In packages/flutter/pubspec.yaml at line 43, the package_info_plus dependency was upgraded from ^5.0.1 to ^8.3.0, which includes breaking changes. Review your app code for any usage of buildSignature on Android and update or retest it due to the switch to SHA-256 hashing in v7.0.0. Also, verify your web deployment does not rely on a .json extension in versionJsonUrl, adjusting server or deployment settings if necessary. Finally, test all platforms thoroughly to ensure compatibility with the new package version.

path: ^1.8.3

dev_dependencies:
flutter_test:
sdk: flutter

flutter_lints: ^4.0.0
flutter_lints: ^5.0.0
Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Verification agent

🧩 Analysis chain

Updated linting rules

The flutter_lints dev dependency has been updated from ^4.0.0 to ^5.0.0. This may introduce new linting rules or deprecate existing ones.

🌐 Web query:

What are the changes in flutter_lints between version 4.0.0 and 5.0.0?

💡 Result:

Changes in flutter_lints Between Versions 4.0.0 and 5.0.0

Summary Table

Category 4.0.0 5.0.0
package:lints dependency 4.0.0 5.0.0
Minimum SDK Flutter 3.13 / Dart 3.1 Flutter 3.24 / Dart 3.5
Lints Added library_annotations
no_wildcard_variable_uses		 invalid_runtime_check_with_js_interop_types
unnecessary_library_name
Lints Removed package_prefixed_library_names
library_names		 avoid_null_checks_in_equality_operators
prefer_const_constructors
prefer_const_declarations
prefer_const_literals_to_create_immutables

Detailed Changes

Dependency and SDK Updates

  • The internal dependency was updated: package:lints upgraded from version 4.0.0 to 5.0.0.
  • Minimum required Flutter and Dart SDK versions increased to Flutter 3.24 and Dart 3.5[1][2][4].

New Lints Added

  • invalid_runtime_check_with_js_interop_types: Prevents incorrect runtime checks with interop types, improving JavaScript interoperability safety.
  • unnecessary_library_name: Discourages unnecessary library name declarations for cleaner code[1][4].

Lints Removed

  • avoid_null_checks_in_equality_operators: This removal gives developers more control over how null is handled in equality checks[1][4].
  • prefer_const_constructors
  • prefer_const_declarations
  • prefer_const_literals_to_create_immutables

These three "prefer_const_" lints were removed to simplify constant usage recommendations in Flutter projects, as they were sometimes seen as overly restrictive[1][4].

Removed in 4.0.0 (Still Absent in 5.0.0)

  • package_prefixed_library_names
  • library_names

These were already removed in the shift from 3.0.2 to 4.0.0[1].

Added in 4.0.0 (Still Present Unless Otherwise Stated)

  • library_annotations
  • no_wildcard_variable_uses

What This Means for Your Project

  • Upgrading to 5.0.0 may introduce new lint warnings related to JavaScript interop and unnecessary library name usage.
  • Code that previously failed the removed lints (prefer_const_* and avoid_null_checks_in_equality_operators) will no longer be flagged.
  • Projects must now use newer Flutter and Dart SDKs (at least Flutter 3.24 / Dart 3.5)[1][2][4].

Upgrading will keep your project aligned with the latest best practices and Dart ecosystem trends, and may lead to cleaner, more maintainable codebases[4].

Citations:

Update Dart/Flutter SDK Constraints & Address New Lint Rules

Please ensure the upgrade to flutter_lints: ^5.0.0 is fully supported:

• In packages/flutter/pubspec.yaml, bump your environment SDKs to meet the new minimums:

environment:
  sdk: ">=3.5.0 <4.0.0"
  flutter: ">=3.24.0"

• Run

flutter pub upgrade
flutter analyze

to surface the two new lints:

  • invalid_runtime_check_with_js_interop_types
  • unnecessary_library_name

• Review and adjust any code patterns that relied on lints now removed:

  • avoid_null_checks_in_equality_operators
  • prefer_const_constructors
  • prefer_const_declarations
  • prefer_const_literals_to_create_immutables
🤖 Prompt for AI Agents (early access) 
In packages/flutter/pubspec.yaml at line 50, after updating flutter_lints to ^5.0.0, update the environment SDK constraints to sdk: ">=3.5.0 <4.0.0" and flutter: ">=3.24.0" to meet new minimum requirements. Then run flutter pub upgrade and flutter analyze to detect new lint warnings for invalid_runtime_check_with_js_interop_types and unnecessary_library_name. Finally, review and modify code to comply with these new lints and adjust any code relying on removed lints like avoid_null_checks_in_equality_operators and the prefer_const_* rules.

path_provider_platform_interface: ^2.1.2
plugin_platform_interface: ^2.1.8

Expand Down
Loading