refactor: feeds client

Author: xsahil03x

.cursor/rules/patterns/documentation-style.mdc

@@ -115,6 +115,26 @@ class Box {
 #### PREFER brevity
 Be clear and precise, but also terse. Avoid verbose explanations.
 
+#### DO separate return documentation with a blank line
+Always place return documentation on a separate line with a blank line before it for better readability and consistency.
+
+```dart
+/// Creates a new activity.
+///
+/// Creates a new activity using the provided [request] data.
+///
+/// Returns a [Result] containing the created [ActivityData] or an error.
+Future<Result<ActivityData>> addActivity(AddActivityRequest request) async { ... }
+
+/// Deletes an activity.
+///
+/// Removes the activity with the specified [activityId]. When [hardDelete]
+/// is true, permanently deletes the activity; otherwise marks it as deleted.
+///
+/// Returns a [Result] containing void or an error.
+Future<Result<void>> deleteActivity(String activityId, {bool hardDelete = false}) { ... }
+```
+
 ### Common Anti-Patterns to Avoid
 
 ```dart
@@ -720,6 +740,7 @@ When documenting SDK components, ensure:
 - [ ] Avoided redundancy with surrounding context
 - [ ] Used "this" instead of "the" for member's instance
 - [ ] Maintained brevity while being precise
+- [ ] Separated return documentation with a blank line
 
 ### SDK-Specific Patterns
 - [ ] Used appropriate class documentation pattern (Feed vs List vs State vs Notifier)

analysis_options.yaml

@@ -26,6 +26,9 @@ linter:
 
     always_put_control_body_on_new_line: false
 
+    # Not always necessary, especially for interfaces.
+    one_member_abstracts: false
+
     # Does not always make code more readable.
     cascade_invocations: false
 

melos.yaml

@@ -21,6 +21,7 @@ command:
       auto_route: ^10.0.0
       cached_network_image: ^3.4.1
       collection: ^1.18.0
+      dio: ^5.9.0
       equatable: ^2.0.5
       flutter_state_notifier: ^1.0.0
       freezed_annotation: ^3.0.0
@@ -29,6 +30,7 @@ command:
       intl: ">=0.18.1 <=0.21.0"
       json_annotation: ^4.9.0
       meta: ^1.9.1
+      retrofit: ^4.6.0
       rxdart: ^0.28.0
       shared_preferences: ^2.5.3
       state_notifier: ^1.0.0
@@ -44,6 +46,7 @@ command:
       freezed: ^3.0.0
       json_serializable: ^6.9.5
       mocktail: ^1.0.4
+      retrofit_generator: ^9.6.0
       test: ^1.26.3
 
 scripts:

packages/stream_feeds/build.yaml

@@ -11,4 +11,12 @@ targets:
           when: false
           equal: true
           copy_with: true
-          to_string_override: true
+          to_string_override: true
+
+global_options:
+  freezed:
+    runs_before:
+      - json_serializable
+  json_serializable:
+    runs_before:
+      - retrofit_generator