feat(llc): refactor FilterField and SortField to support local filtering

This commit refactors `FilterField` and `SortField` from `extension type` to `class` to enable local, client-side filtering and sorting capabilities.

Key changes:
- `FilterField` and `SortField` in all query files are now classes that hold both a remote string value for the API and a local value accessor function.
- `QueryConfiguration` is now generic over the data type `T` (`QueryConfiguration<T>`) instead of separate `Sort` and `FilterField` types.
- Typedefs for filters (e.g., `ActivitiesFilter = Filter<ActivityData>`) have been added for clarity.
- `FeedData.fid` has been renamed to `FeedData.feed` for consistency.
- Updated various state holders and doc snippets to align with the new generic query and field structures.

Author: xsahil03x

docs/code_snippets/03_02_querying_activities.dart

@@ -5,7 +5,7 @@ late Feed feed;
 
 Future<void> activitySearchAndQueries() async {
   final query = ActivitiesQuery(
-    filter: const Filter.equal(ActivitiesFilterField.type, 'post'),
+    filter: Filter.equal(ActivitiesFilterField.type, 'post'),
     sort: [ActivitiesSort.desc(ActivitiesSortField.createdAt)],
     limit: 10,
   );
@@ -16,7 +16,7 @@ Future<void> activitySearchAndQueries() async {
 
 Future<void> queryActivitiesByText() async {
   // search for activities where the text includes the word 'popularity'.
-  const query = ActivitiesQuery(
+  final query = ActivitiesQuery(
     filter: Filter.equal(ActivitiesFilterField.text, 'popularity'),
   );
 
@@ -38,7 +38,7 @@ Future<void> queryActivitiesBySearchData() async {
   final activities = await activityList.get();
 
   // search for activities where the campaign took place in a mall
-  const query2 = ActivitiesQuery(
+  final query2 = ActivitiesQuery(
     filter: Filter.pathExists(
       ActivitiesFilterField.searchData,
       'campaign.location.mall',

docs/code_snippets/04_01_feeds.dart

@@ -34,8 +34,8 @@ Future<void> readingAFeed() async {
 }
 
 Future<void> readingAFeedMoreOptions() async {
-  const query = FeedQuery(
-    fid: FeedId(group: 'user', id: 'john'),
+  final query = FeedQuery(
+    fid: const FeedId.user('john'),
     // filter activities with filter tag green
     activityFilter: Filter.in_(
       ActivitiesFilterField.filterTags,
@@ -106,7 +106,7 @@ Future<void> filteringExamples() async {
     ],
   );
   // Now read the feed, this will fetch activity 1 and 2
-  const query = FeedQuery(
+  final query = FeedQuery(
     fid: feedId,
     activityFilter: Filter.in_(ActivitiesFilterField.filterTags, ['blue']),
   );
@@ -119,8 +119,8 @@ Future<void> filteringExamples() async {
 
 Future<void> moreComplexFilterExamples() async {
   // Get all the activities where filter tags contain both "green" and "orange"
-  const query = FeedQuery(
-    fid: FeedId(group: 'user', id: 'john'),
+  final query = FeedQuery(
+    fid: const FeedId.user('john'),
     activityFilter: Filter.and([
       Filter.in_(ActivitiesFilterField.filterTags, ['green']),
       Filter.in_(ActivitiesFilterField.filterTags, ['orange']),
@@ -190,7 +190,7 @@ Future<void> memberInvites() async {
 
 Future<void> queryMyFeeds() async {
   final query = FeedsQuery(
-    filter: const Filter.equal(FeedsFilterField.createdById, 'john'),
+    filter: Filter.equal(FeedsFilterField.createdById, 'john'),
     sort: [FeedsSort.desc(FeedsSortField.createdAt)],
     limit: 10,
     watch: true,
@@ -208,15 +208,15 @@ Future<void> queryMyFeeds() async {
 }
 
 Future<void> queryFeedsWhereIAmAMember() async {
-  const query = FeedsQuery(
+  final query = FeedsQuery(
     filter: Filter.contains(FeedsFilterField.members, 'john'),
   );
   final feedList = client.feedList(query);
   final feeds = await feedList.get();
 }
 
 Future<void> queryFeedsByNameOrVisibility() async {
-  const sportsQuery = FeedsQuery(
+  final sportsQuery = FeedsQuery(
     filter: Filter.and([
       Filter.equal(FeedsFilterField.visibility, 'public'),
       Filter.query(FeedsFilterField.name, 'Sports'),
@@ -226,7 +226,7 @@ Future<void> queryFeedsByNameOrVisibility() async {
   final sportsFeedList = client.feedList(sportsQuery);
   final sportsFeeds = await sportsFeedList.get();
 
-  const techQuery = FeedsQuery(
+  final techQuery = FeedsQuery(
     filter: Filter.and([
       Filter.equal(FeedsFilterField.visibility, 'public'),
       Filter.autoComplete(FeedsFilterField.description, 'tech'),
@@ -238,7 +238,7 @@ Future<void> queryFeedsByNameOrVisibility() async {
 }
 
 Future<void> queryFeedsByCreatorName() async {
-  const query = FeedsQuery(
+  final query = FeedsQuery(
     filter: Filter.and([
       Filter.equal(FeedsFilterField.visibility, 'public'),
       Filter.query(FeedsFilterField.createdByName, 'Thompson'),

docs/code_snippets/04_03_follows.dart

@@ -22,7 +22,7 @@ Future<void> followsAndUnfollows() async {
 Future<void> queryFollows() async {
   // Do I follow a list of feeds
   // My feed is timeline:john
-  const followQuery = FollowsQuery(
+  final followQuery = FollowsQuery(
     filter: Filter.and([
       Filter.equal(FollowsFilterField.sourceFeed, 'timeline:john'),
       Filter.in_(FollowsFilterField.targetFeed, ['user:sara', 'user:adam']),
@@ -34,7 +34,7 @@ Future<void> queryFollows() async {
   final page1And2 = followList.state.follows;
   // Paginating through followers for a feed
   // My feed is timeline:john
-  const followerQuery = FollowsQuery(
+  final followerQuery = FollowsQuery(
     filter: Filter.equal(FollowsFilterField.targetFeed, 'timeline:john'),
   );
   final followerList = client.followList(followerQuery);

docs/code_snippets/06_02_bookmarks.dart

@@ -49,14 +49,14 @@ Future<void> queryingBookmarks() async {
   final page2 = await bookmarkList.queryMoreBookmarks(limit: 3);
   // Query by activity ID
   final activityBookmarkList = client.bookmarkList(
-    const BookmarksQuery(
+    BookmarksQuery(
       filter: Filter.equal(BookmarksFilterField.activityId, 'activity_123'),
     ),
   );
   final activityBookmarks = await activityBookmarkList.get();
   // Query by folder ID
   final folderBookmarkList = client.bookmarkList(
-    const BookmarksQuery(
+    BookmarksQuery(
       filter: Filter.equal(BookmarksFilterField.folderId, 'folder_456'),
     ),
   );
@@ -72,8 +72,8 @@ Future<void> queryingBookmarkFolders() async {
   final page2 = await bookmarkFolderList.queryMoreBookmarkFolders(limit: 3);
   // Query by folder name (partial matching)
   final projectFolderList = client.bookmarkFolderList(
-    const BookmarkFoldersQuery(
-      filter: Filter.contains(BookmarkFoldersFilterField.name, 'project'),
+    BookmarkFoldersQuery(
+      filter: Filter.contains(BookmarkFoldersFilterField.folderName, 'project'),
     ),
   );
   final projectFolders = await projectFolderList.get();

docs/code_snippets/06_03_comments.dart

@@ -54,15 +54,15 @@ Future<void> readingComments() async {
 Future<void> queryingComments() async {
   // Search in comment texts
   final list1 = client.commentList(
-    const CommentsQuery(
+    CommentsQuery(
       filter: Filter.query(CommentsFilterField.commentText, 'oat'),
     ),
   );
   final comments1 = await list1.get();
 
   // All comments for an activity
   final list2 = client.commentList(
-    const CommentsQuery(
+    CommentsQuery(
       filter: Filter.and([
         Filter.equal(CommentsFilterField.objectId, 'activity_123'),
         Filter.equal(CommentsFilterField.objectType, 'activity'),
@@ -73,15 +73,15 @@ Future<void> queryingComments() async {
 
   // Replies to a parent activity
   final list3 = client.commentList(
-    const CommentsQuery(
+    CommentsQuery(
       filter: Filter.equal(CommentsFilterField.parentId, 'parent_id'),
     ),
   );
   final comments3 = await list3.get();
 
   // Comments from an user
   final list4 = client.commentList(
-    const CommentsQuery(
+    CommentsQuery(
       filter: Filter.equal(CommentsFilterField.userId, 'jane'),
     ),
   );

docs/code_snippets/09_01_polls.dart

@@ -132,7 +132,7 @@ Future<void> deletePollOption() async {
 Future<void> queryingVotes() async {
   // Retrieve all votes on either option1Id or option2Id
   final pollVoteList = client.pollVoteList(
-    const PollVotesQuery(
+    PollVotesQuery(
       pollId: 'poll_456',
       filter: Filter.in_(
         PollVotesFilterField.optionId,
@@ -148,7 +148,7 @@ Future<void> queryingVotes() async {
 Future<void> queryingPolls() async {
   // Retrieve all polls that are closed for voting sorted by created_at
   final pollList = client.pollList(
-    const PollsQuery(
+    PollsQuery(
       filter: Filter.equal(PollsFilterField.isClosed, true),
     ),
   );

packages/stream_feeds/lib/src/models/feed_data.dart

@@ -19,7 +19,7 @@ class FeedData with _$FeedData {
     required this.createdBy,
     this.deletedAt,
     required this.description,
-    required this.fid,
+    required this.feed,
     this.filterTags = const [],
     required this.followerCount,
     required this.followingCount,
@@ -52,7 +52,7 @@ class FeedData with _$FeedData {
 
   /// The unique identifier for the feed.
   @override
-  final FeedId fid;
+  final FeedId feed;
 
   /// A list of tags used to filter the feed.
   @override
@@ -115,7 +115,7 @@ extension FeedResponseMapper on FeedResponse {
       createdBy: createdBy.toModel(),
       deletedAt: deletedAt,
       description: description,
-      fid: FeedId.fromRawValue(feed),
+      feed: FeedId.fromRawValue(feed),
       filterTags: [...?filterTags],
       followerCount: followerCount,
       followingCount: followingCount,

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

@@ -72,8 +72,8 @@ class FollowData with _$FollowData {
   /// and the creation timestamp.
   /// Used for simpler identification of follow relationships.
   String get id {
-    final sourceFid = sourceFeed.fid;
-    final targetFid = targetFeed.fid;
+    final sourceFid = sourceFeed.feed;
+    final targetFid = targetFeed.feed;
     final createdAt = this.createdAt.millisecondsSinceEpoch;
     return '$sourceFid-$targetFid-$createdAt';
   }
@@ -92,14 +92,14 @@ class FollowData with _$FollowData {
   /// - Parameters:
   ///   - fid: The feed ID to check against.
   /// - Returns: true if this is an accepted follow relationship where the target feed matches the given ID.
-  bool isFollowerOf(FeedId fid) => isFollower && targetFeed.fid == fid;
+  bool isFollowerOf(FeedId feed) => isFollower && targetFeed.feed == feed;
 
   /// Checks if this follow relationship represents following the specified feed.
   ///
   /// - Parameters:
   ///   - fid: The feed ID to check against.
   /// - Returns: true if this is an accepted follow relationship where the source feed matches the given ID.
-  bool isFollowingFeed(FeedId fid) => isFollowing && sourceFeed.fid == fid;
+  bool isFollowingFeed(FeedId fid) => isFollowing && sourceFeed.feed == fid;
 }
 
 /// Extension type representing the status of a follow relationship.

packages/stream_feeds/lib/src/models/follow_data.dart

@@ -43,8 +43,7 @@ class GetOrCreateFeedData with _$GetOrCreateFeedData {
 
   /// The configuration used to query activities.
   @override
-  final QueryConfiguration<ActivitiesSort, ActivitiesFilterField>
-      activitiesQueryConfig;
+  final QueryConfiguration<ActivityData> activitiesQueryConfig;
 
   /// The feed data associated with the feed.
   @override