feature: aadded overrideCallback in byField

CHANGELOG.md

@@ -1,3 +1,7 @@
+## 1.2.3
+
+* Added overrideCallback in byField 
+
 ## 1.2.2
 
 * Added validCPFOrCNPJ

lib/src/lucid_validator.dart

@@ -40,19 +40,36 @@ abstract class LucidValidator<E> {
   /// Example:
   /// ```dart
   ///
-  /// void callback(errors) {}
-  ///
   /// final validator = UserValidation();
-  /// final emailValidator = validator.byField(user, 'email', callback);
+  /// final emailValidator = validator.byField(user, 'email');
   /// String? validationResult = emailValidator('[email protected]');
   /// ```
-  String? Function([String?]) byField(E entity, String key, [Function(List<ValidationException>)? callback]) {
+  ///
+  /// or
+  /// ```dart
+  ///
+  /// void callback (errors) {}
+  ///
+  /// final validator = UserValidation();
+  /// final emailValidator = validator.byField(user, 'email', overrideCallback: callback);
+  /// emailValidator('[email protected]'); // return null when overrideCallback is not null
+  /// ```
+  String? Function([String?]) byField(
+    E entity,
+    String key, {
+    Function(List<ValidationException>)? overrideCallback,
+  }) {
     if (key.contains('.')) {
       final keys = key.split('.');
 
       final firstKey = keys.removeAt(0);
       final builder = _getBuilderByKey(firstKey);
       if (builder == null) {
+        if (overrideCallback != null) {
+          overrideCallback.call([]);
+          return ([_]) => null;
+        }
+
         return ([_]) => null;
       }
 
@@ -61,15 +78,25 @@ abstract class LucidValidator<E> {
       final builder = _getBuilderByKey(key);
 
       if (builder == null) {
+        if (overrideCallback != null) {
+          overrideCallback.call([]);
+          return ([_]) => null;
+        }
+
         return ([_]) => null;
       }
 
       return ([_]) {
         final errors = builder.executeRules(entity);
         if (errors.isNotEmpty) {
-          callback?.call(errors);
+          if (overrideCallback != null) {
+            overrideCallback.call(errors);
+          }
           return errors.first.message;
         }
+        if (overrideCallback != null) {
+          overrideCallback.call([]);
+        }
         return null;
       };
     }

pubspec.yaml

@@ -3,7 +3,7 @@ description: "A Dart/Flutter package for building strongly typed validation rule
 repository: https://github.com/Flutterando/lucid_validation
 homepage: https://pub.dev/documentation/lucid_validation/latest/
 
-version: 1.2.2
+version: 1.2.3
 
 environment:
   sdk: ">=3.0.0 <4.0.0"

test/lucid_validation_test.dart

@@ -141,13 +141,13 @@ void main() {
     expect(codes[1], 'validEmail');
   });
 
-  test('byField with callback', () {
+  test('byField with override callback', () {
     var user = UserModel();
 
     final validator = UserValidator();
     List<String> codes = [];
 
-    validator.byField(user, 'email', (exceptions) {
+    validator.byField(user, 'email', overrideCallback: (exceptions) {
       codes = exceptions.map((exception) => exception.code).toList();
     })();