format files

Author: jacobaraujo7

Diff for: CHANGELOG.md

@@ -1,3 +1,6 @@
+## 1.3.0
+* ADDED: Global Observer Command State Listener
+
 ## 1.2.0
 * ADDEd: when operator
 

Diff for: README.md

@@ -130,6 +130,24 @@ These getters allow you to write cleaner and more intuitive code when interactin
 
 ---
 
+## Observer
+  
+Sets the default observer listener for all commands.
+This listener is called whenever the state of any command changes. 
+This can be useful for logging, debugging, or global state management.
+
+
+```dart
+main(){
+
+  Command.setObserverListener((state) {
+    print(state);
+  });
+
+  runApp(MainApp());
+}
+```
+
 ## Examples
 
 ### Example 1: Simple Command with No Arguments

Diff for: example/lib/main.dart

@@ -63,7 +63,9 @@ class MyHomePage extends StatelessWidget {
         valueListenable: incrementCommand,
         builder: (context, state, snapshot) {
           return FloatingActionButton(
-            onPressed: incrementCommand.isRunning ? null : () => incrementCommand.execute(),
+            onPressed: incrementCommand.isRunning
+                ? null
+                : () => incrementCommand.execute(),
             tooltip: 'Increment',
             child: const Icon(Icons.add),
           );

Diff for: example/pubspec.lock

@@ -37,10 +37,10 @@ packages:
     dependency: transitive
     description:
       name: collection
-      sha256: ee67cb0715911d28db6bf4af1026078bd6f0128b07a5f66fb2ed94ec6783c09a
+      sha256: a1ace0a119f20aabc852d165077c036cd864315bd99b7eaa10a60100341941bf
       url: "https://pub.dev"
     source: hosted
-    version: "1.18.0"
+    version: "1.19.0"
   cupertino_icons:
     dependency: "direct main"
     description:
@@ -79,18 +79,18 @@ packages:
     dependency: transitive
     description:
       name: leak_tracker
-      sha256: "3f87a60e8c63aecc975dda1ceedbc8f24de75f09e4856ea27daf8958f2f0ce05"
+      sha256: "7bb2830ebd849694d1ec25bf1f44582d6ac531a57a365a803a6034ff751d2d06"
       url: "https://pub.dev"
     source: hosted
-    version: "10.0.5"
+    version: "10.0.7"
   leak_tracker_flutter_testing:
     dependency: transitive
     description:
       name: leak_tracker_flutter_testing
-      sha256: "932549fb305594d82d7183ecd9fa93463e9914e1b67cacc34bc40906594a1806"
+      sha256: "9491a714cca3667b60b5c420da8217e6de0d1ba7a5ec322fab01758f6998f379"
       url: "https://pub.dev"
     source: hosted
-    version: "3.0.5"
+    version: "3.0.8"
   leak_tracker_testing:
     dependency: transitive
     description:
@@ -145,7 +145,7 @@ packages:
       path: ".."
       relative: true
     source: path
-    version: "1.1.0"
+    version: "1.2.0"
   result_dart:
     dependency: "direct main"
     description:
@@ -158,7 +158,7 @@ packages:
     dependency: transitive
     description: flutter
     source: sdk
-    version: "0.0.99"
+    version: "0.0.0"
   source_span:
     dependency: transitive
     description:
@@ -171,10 +171,10 @@ packages:
     dependency: transitive
     description:
       name: stack_trace
-      sha256: "73713990125a6d93122541237550ee3352a2d84baad52d375a4cad2eb9b7ce0b"
+      sha256: "9f47fd3630d76be3ab26f0ee06d213679aa425996925ff3feffdec504931c377"
       url: "https://pub.dev"
     source: hosted
-    version: "1.11.1"
+    version: "1.12.0"
   stream_channel:
     dependency: transitive
     description:
@@ -187,10 +187,10 @@ packages:
     dependency: transitive
     description:
       name: string_scanner
-      sha256: "556692adab6cfa87322a115640c11f13cb77b3f076ddcc5d6ae3c20242bedcde"
+      sha256: "688af5ed3402a4bde5b3a6c15fd768dbf2621a614950b17f04626c431ab3c4c3"
       url: "https://pub.dev"
     source: hosted
-    version: "1.2.0"
+    version: "1.3.0"
   term_glyph:
     dependency: transitive
     description:
@@ -203,10 +203,10 @@ packages:
     dependency: transitive
     description:
       name: test_api
-      sha256: "5b8a98dafc4d5c4c9c72d8b31ab2b23fc13422348d2997120294d3bac86b4ddb"
+      sha256: "664d3a9a64782fcdeb83ce9c6b39e78fd2971d4e37827b9b06c3aa1edc5e760c"
       url: "https://pub.dev"
     source: hosted
-    version: "0.7.2"
+    version: "0.7.3"
   vector_math:
     dependency: transitive
     description:
@@ -219,10 +219,10 @@ packages:
     dependency: transitive
     description:
       name: vm_service
-      sha256: "5c5f338a667b4c644744b661f309fb8080bb94b18a7e91ef1dbd343bed00ed6d"
+      sha256: f6be3ed8bd01289b34d679c2b62226f63c0e69f9fd2e50a6b3c1c729a961041b
       url: "https://pub.dev"
     source: hosted
-    version: "14.2.5"
+    version: "14.3.0"
 sdks:
   dart: ">=3.5.4 <4.0.0"
   flutter: ">=3.18.0-18.0.pre.54"

Diff for: lib/src/command.dart

@@ -9,6 +9,8 @@ part 'implementations.dart';
 part 'states.dart';
 part 'types.dart';
 
+void Function(CommandState state)? _defaultObserverListener;
+
 /// Represents a generic command with lifecycle and execution.
 ///
 /// This class supports state management, notifications, and execution
@@ -24,6 +26,13 @@ abstract class Command<T extends Object> extends ChangeNotifier
     _setValue(IdleCommand<T>(), metadata: {'reason': 'Command created'});
   }
 
+  /// Sets the default observer listener for all commands.
+  /// This listener is called whenever the state of any command changes.
+  /// This can be useful for logging, debugging, or global state management.
+  static void setObserverListener(void Function(CommandState state) listener) {
+    _defaultObserverListener = listener;
+  }
+
   /// The current state of the command.
   CommandState<T> _value = IdleCommand<T>();
 
@@ -121,6 +130,7 @@ abstract class Command<T extends Object> extends ChangeNotifier
       return;
     }
     _value = newValue;
+    _defaultObserverListener?.call(newValue);
     addHistoryEntry(CommandHistoryEntry(state: newValue, metadata: metadata));
     notifyListeners(); // Notify listeners using ChangeNotifier.
   }

Diff for: test/src/command_test.dart

@@ -476,5 +476,34 @@ void main() {
 
       expect(result, 'default value');
     });
+
+    test('Global Observable', () {
+      final command1 = Command0<String>(() async => const Success('success 1'));
+      final command2 = Command0<String>(
+          () async => const Failure(AppException('success 2')));
+
+      final expectedValues = [
+        isA<RunningCommand<String>>(),
+        isA<SuccessCommand<String>>(),
+        isA<RunningCommand<String>>(),
+        isA<FailureCommand<String>>(),
+      ];
+      var index = 0;
+
+      Command.setObserverListener(expectAsync1(
+        max: expectedValues.length,
+        (value) {
+          expect(value, expectedValues[index++]);
+        },
+      ));
+
+      command1.execute().then((_) => command2.execute());
+    });
   });
 }
+
+class AppException implements Exception {
+  final String message;
+
+  const AppException(this.message);
+}