ValidatesRequests mixin

The ValidatesRequests Mixin.

Provides Laravel-style validation capabilities for controllers.

Note: The recommended approach for form validation is to use FormValidator.rules() in Views with WFormInput. This mixin is useful for API-level validation or when you need controller-side validation for other purposes.

Recommended Pattern (View-side validation)

// In View - use FormValidator.rules() with WFormInput
WFormInput(
  controller: _email,
  validator: FormValidator.rules([Required(), Email()], field: 'email'),
)

// In Controller - receive clean, typed data
Future<void> attemptLogin({
  required String email,
  required String password,
}) async {
  // No validation needed - data is pre-validated
  await Auth.attempt(email, password);
}

Alternative: Controller-side validation

For cases where you need controller-side validation:

class AuthController extends MagicController with ValidatesRequests {
  void login(Map<String, dynamic> requestData) {
    try {
      final data = validate(requestData, {
        'email': [Required(), Email()],
        'password': [Required(), Min(8)],
      });
      // Use validated data...
    } on ValidationException catch (_) {
      // Errors in validationErrors, UI auto-rebuilds
    }
  }
}

Server-Side Validation Errors

Populate errors from API 422 responses:

final response = await Http.post('/register', data: data);
if (response.isValidationError) {
  setErrorsFromResponse(response);
  return;
}

Error Display in View

WInput(
  states: controller.hasError('email') ? {'error'} : {},
  className: 'border error:border-red-500',
),
if (controller.hasError('email'))
  WText(controller.getError('email')!, className: 'text-red-500 text-xs'),