refactor(llc): Type-safe filter fields in queries

This commit introduces type-safe filter fields across various query types by parameterizing the `Filter` class with specific `FilterField` extension types.

Key changes:

- **Parameterized `Filter`:** The `Filter` class is now generic `Filter<T extends FilterField>`, ensuring that filters are constructed with valid fields for the specific query type.
- **`FilterField` interface:** A new `FilterField` extension type acts as a base for all specific filter field types (e.g., `ActivitiesFilterField`, `FeedsFilterField`).
- **Updated Query Classes:** All query classes (e.g., `ActivitiesQuery`, `FeedsQuery`, `CommentsQuery`, etc.) now use the parameterized `Filter` with their respective `FilterField` types. This provides compile-time safety for filter field names.
- **Filter Field Extension Types:** Existing string-based filter field constants are now extension types implementing `FilterField`. This maintains compatibility while enabling type safety.
- **`FilterRequestExtension`:** The `toRequest()` method in `FilterRequestExtension` now returns `Map<String, Object?>` to reflect that filter values can be null.
- **Code Snippet Updates:** Documentation code snippets have been updated to reflect the new type-safe filter field usage.
- **Dependency Update:** `stream_core` dependency has been updated to `280b104`.

This refactoring enhances code maintainability and reduces the likelihood of runtime errors caused by incorrect filter field names.

Author: xsahil03x

docs_code_snippets/03_02_querying_activities.dart

@@ -1,4 +1,4 @@
-// ignore_for_file: unused_local_variable, file_names
+// ignore_for_file: unused_local_variable, file_names, avoid_redundant_argument_values
 
 import 'package:stream_feeds/stream_feeds.dart';
 
@@ -7,7 +7,7 @@ late Feed feed;
 
 Future<void> activitySearchAndQueries() async {
   final query = ActivitiesQuery(
-    filter: Filter.equal(ActivitiesFilterField.type, 'post'),
+    filter: const Filter.equal(ActivitiesFilterField.type, 'post'),
     sort: [ActivitiesSort.desc(ActivitiesSortField.createdAt)],
     limit: 10,
   );
@@ -18,7 +18,7 @@ Future<void> activitySearchAndQueries() async {
 
 Future<void> queryActivitiesByText() async {
   // search for activities where the text includes the word 'popularity'.
-  final query = ActivitiesQuery(
+  const query = ActivitiesQuery(
     filter: Filter.equal(ActivitiesFilterField.text, 'popularity'),
   );
 
@@ -28,7 +28,10 @@ Future<void> queryActivitiesByText() async {
 
 Future<void> queryActivitiesBySearchData() async {
   // search for activities associated with the campaign ID 'spring-sale-2025'
-  final searchValue = {'campaign': {'id': 'spring-sale-2025'}};
+  final searchValue = {
+    'campaign': {'id': 'spring-sale-2025'},
+  };
+
   final query = ActivitiesQuery(
     filter: Filter.contains(ActivitiesFilterField.searchData, searchValue),
   );
@@ -37,8 +40,11 @@ Future<void> queryActivitiesBySearchData() async {
   final activities = await activityList.get();
 
   // search for activities where the campaign took place in a mall
-  final query2 = ActivitiesQuery(
-    filter: Filter.pathExists(ActivitiesFilterField.searchData, 'campaign.location.mall'),
+  const query2 = ActivitiesQuery(
+    filter: Filter.pathExists(
+      ActivitiesFilterField.searchData,
+      'campaign.location.mall',
+    ),
   );
 
   final activityList2 = client.activityList(query2);

docs_code_snippets/04_01_feeds.dart

@@ -36,12 +36,12 @@ Future<void> readingAFeed() async {
 }
 
 Future<void> readingAFeedMoreOptions() async {
-  final query = FeedQuery(
-    fid: const FeedId(group: 'user', id: 'john'),
+  const query = FeedQuery(
+    fid: FeedId(group: 'user', id: 'john'),
     // filter activities with filter tag green
     activityFilter: Filter.in_(
       ActivitiesFilterField.filterTags,
-      const ['green'],
+      ['green'],
     ),
     activityLimit: 10,
     // additional data used for ranking
@@ -108,11 +108,9 @@ Future<void> filteringExamples() async {
     ],
   );
   // Now read the feed, this will fetch activity 1 and 2
-  final query = FeedQuery(
+  const query = FeedQuery(
     fid: feedId,
-    activityFilter: Filter.in_(ActivitiesFilterField.filterTags, const [
-      'blue',
-    ]),
+    activityFilter: Filter.in_(ActivitiesFilterField.filterTags, ['blue']),
   );
 
   final feed = client.feedFromQuery(query);
@@ -123,20 +121,21 @@ Future<void> filteringExamples() async {
 
 Future<void> moreComplexFilterExamples() async {
   // Get all the activities where tags contain "green" and type is "post" or tag contains "orange" and type is "activity"
-  final query = FeedQuery(
-    fid: const FeedId(group: 'user', id: 'john'),
+  const query = FeedQuery(
+    fid: FeedId(group: 'user', id: 'john'),
     activityFilter: Filter.or([
       Filter.and([
-        Filter.in_(ActivitiesFilterField.filterTags, const ['green']),
+        Filter.in_(ActivitiesFilterField.filterTags, ['green']),
         Filter.equal(ActivitiesFilterField.type, 'post'),
       ]),
       Filter.and([
-        Filter.in_(ActivitiesFilterField.filterTags, const ['orange']),
+        Filter.in_(ActivitiesFilterField.filterTags, ['orange']),
         Filter.equal(ActivitiesFilterField.type, 'activity'),
       ]),
     ]),
   );
 
+  final feed = client.feedFromQuery(query);
   await feed.getOrCreate();
   final activities = feed.state.activities;
 }
@@ -199,7 +198,7 @@ Future<void> memberInvites() async {
 
 Future<void> queryMyFeeds() async {
   final query = FeedsQuery(
-    filter: Filter.equal(FeedsFilterField.createdById, 'john'),
+    filter: const Filter.equal(FeedsFilterField.createdById, 'john'),
     sort: [FeedsSort.desc(FeedsSortField.createdAt)],
     limit: 10,
     watch: true,
@@ -217,15 +216,15 @@ Future<void> queryMyFeeds() async {
 }
 
 Future<void> queryFeedsWhereIAmAMember() async {
-  final query = FeedsQuery(
+  const query = FeedsQuery(
     filter: Filter.contains(FeedsFilterField.members, 'john'),
   );
   final feedList = client.feedList(query);
   final feeds = await feedList.get();
 }
 
 Future<void> queryFeedsByNameOrVisibility() async {
-  final sportsQuery = FeedsQuery(
+  const sportsQuery = FeedsQuery(
     filter: Filter.and([
       Filter.equal(FeedsFilterField.visibility, 'public'),
       Filter.query(FeedsFilterField.name, 'Sports'),
@@ -235,7 +234,7 @@ Future<void> queryFeedsByNameOrVisibility() async {
   final sportsFeedList = client.feedList(sportsQuery);
   final sportsFeeds = await sportsFeedList.get();
 
-  final techQuery = FeedsQuery(
+  const techQuery = FeedsQuery(
     filter: Filter.and([
       Filter.equal(FeedsFilterField.visibility, 'public'),
       Filter.autoComplete(FeedsFilterField.description, 'tech'),
@@ -247,7 +246,7 @@ Future<void> queryFeedsByNameOrVisibility() async {
 }
 
 Future<void> queryFeedsByCreatorName() async {
-  final query = FeedsQuery(
+  const query = FeedsQuery(
     filter: Filter.and([
       Filter.equal(FeedsFilterField.visibility, 'public'),
       Filter.query(FeedsFilterField.createdByName, 'Thompson'),

melos.yaml

@@ -46,7 +46,7 @@ command:
       stream_core:
         git:
           url: https://github.com/GetStream/stream-core-flutter.git
-          ref: 5acdcb8e378548372f7dbb6326c518edcf832d10
+          ref: 280b1045e39388668fd060439259831611b51b5a
           path: packages/stream_core
 
     # List of all the dev_dependencies used in the project.

packages/stream_feeds/lib/src/models/query_configuration.freezed.dart

@@ -109,7 +109,7 @@ class ActivitiesRepository {
 
   /// Deletes multiple activities.
   ///
-  /// Deletes the provided [deleteActivitiesRequest.ids] in a single batch operation.
+  /// Deletes the provided [deleteActivitiesRequest] in a single batch operation.
   ///
   /// Returns a [Result] containing the list of deleted activity ids or an error.
   Future<Result<api.DeleteActivitiesResponse>> deleteActivities({

packages/stream_feeds/lib/src/repository/activities_repository.dart

@@ -35,7 +35,7 @@ class ActivitiesQuery with _$ActivitiesQuery {
   ///
   /// Use [ActivitiesFilterField] for type-safe field references.
   @override
-  final Filter? filter;
+  final Filter<ActivitiesFilterField>? filter;
 
   /// The sorting criteria for this query.
   @override
@@ -57,7 +57,7 @@ class ActivitiesQuery with _$ActivitiesQuery {
 // region Filter
 
 /// Represents a field that can be used in activities filtering.
-extension type const ActivitiesFilterField(String field) implements String {
+extension type const ActivitiesFilterField(String _) implements FilterField {
   /// Filter by the creation timestamp of the activity.
   ///
   /// **Supported operators:** `.equal`, `.greaterThan`, `.lessThan`, `.greaterThanOrEqual`, `.lessThanOrEqual`
@@ -134,7 +134,7 @@ class ActivitiesSort extends Sort<ActivityData> {
 /// This extension type provides specific fields for sorting activity data.
 /// Each field corresponds to a property of the ActivityData model, allowing for flexible
 /// sorting options when querying activities.
-extension type const ActivitiesSortField(SortField<ActivityData> field)
+extension type const ActivitiesSortField(SortField<ActivityData> _)
     implements SortField<ActivityData> {
   /// Sort by the creation timestamp of the activity.
   /// This field allows sorting activities by when they were created (newest/oldest first).

packages/stream_feeds/lib/src/state/query/activities_query.dart

@@ -45,7 +45,7 @@ class ActivityReactionsQuery with _$ActivityReactionsQuery {
   ///
   /// Use [ActivityReactionsFilterField] for type-safe field references.
   @override
-  final Filter? filter;
+  final Filter<ActivityReactionsFilterField>? filter;
 
   /// Array of sorting criteria for this query.
   ///
@@ -80,8 +80,8 @@ class ActivityReactionsQuery with _$ActivityReactionsQuery {
 ///
 /// This extension type provides a type-safe way to specify which field should be used
 /// when creating filters for activity reactions queries.
-extension type const ActivityReactionsFilterField(String field)
-    implements String {
+extension type const ActivityReactionsFilterField(String _)
+    implements FilterField {
   /// Filter by the reaction type (e.g., "like", "love", "angry").
   ///
   /// **Supported operators:** `.equal`, `.in`
@@ -124,8 +124,7 @@ class ActivityReactionsSort extends Sort<FeedsReactionData> {
 /// Defines the fields by which activity reactions can be sorted.
 ///
 /// This extension type provides specific fields for sorting activity reaction data.
-extension type const ActivityReactionsSortField(
-        SortField<FeedsReactionData> field)
+extension type const ActivityReactionsSortField(SortField<FeedsReactionData> _)
     implements SortField<FeedsReactionData> {
   /// Sort by the creation timestamp of the reaction.
   /// This field allows sorting reactions by when they were created (newest/oldest first).

packages/stream_feeds/lib/src/state/query/activities_query.freezed.dart

@@ -39,7 +39,7 @@ class BookmarkFoldersQuery with _$BookmarkFoldersQuery {
   ///
   /// Use [BookmarkFoldersFilterField] for type-safe field references.
   @override
-  final Filter? filter;
+  final Filter<BookmarkFoldersFilterField>? filter;
 
   /// Array of sorting criteria for this query.
   ///
@@ -69,8 +69,8 @@ class BookmarkFoldersQuery with _$BookmarkFoldersQuery {
 ///
 /// This extension type provides a type-safe way to specify which field should be used
 /// when creating filters for bookmark folders queries.
-extension type const BookmarkFoldersFilterField(String field)
-    implements String {
+extension type const BookmarkFoldersFilterField(String _)
+    implements FilterField {
   /// Filter by the unique identifier of the bookmark folder.
   ///
   /// **Supported operators:** `.equal`, `.in`
@@ -123,8 +123,7 @@ class BookmarkFoldersSort extends Sort<BookmarkFolderData> {
 /// Defines the fields by which bookmark folders can be sorted.
 ///
 /// This extension type provides specific fields for sorting bookmark folder data.
-extension type const BookmarkFoldersSortField(
-        SortField<BookmarkFolderData> field)
+extension type const BookmarkFoldersSortField(SortField<BookmarkFolderData> _)
     implements SortField<BookmarkFolderData> {
   /// Sort by the creation timestamp of the bookmark folder.
   /// This field allows sorting bookmark folders by when they were created (newest/oldest first).