feat: allow values that implements Traversable and added the parameter name to messages

Author: andrepimpao

src/Rule/Collection.php

@@ -40,15 +40,16 @@ public function assert(mixed $value, ?string $name = null): void
             throw new UnexpectedValueException($exception->getMessage());
         }
 
-        if (!\is_array($value)) {
-            throw new UnexpectedTypeException('array', get_debug_type($value));
+        if (!\is_iterable($value)) {
+            throw new UnexpectedTypeException('array|\Traversable', get_debug_type($value));
         }
 
         foreach ($this->fields as $field => $validator) {
             if (!isset($value[$field])) {
                 throw new CollectionException(
                     message: $this->missingFieldsMessage,
                     parameters: [
+                        'name' => $name,
                         'field' => $field
                     ]
                 );
@@ -61,6 +62,7 @@ public function assert(mixed $value, ?string $name = null): void
                 throw new CollectionException(
                     message: $this->message,
                     parameters: [
+                        'name' => $name,
                         'field' => $field,
                         'message' => $exception->getMessage()
                     ]
@@ -74,6 +76,7 @@ public function assert(mixed $value, ?string $name = null): void
                     throw new CollectionException(
                         message: $this->extraFieldsMessage,
                         parameters: [
+                            'name' => $name,
                             'field' => $field
                         ]
                     );

tests/CollectionTest.php

@@ -20,7 +20,7 @@ class CollectionTest extends AbstractTest
     public static function provideRuleUnexpectedValueData(): \Generator
     {
         $unexpectedFieldValueMessage = '/At field (.*)\: (.*)\./';
-        $unexpectedTypeMessage = '/Expected value of type "array", "(.*)" given\./';
+        $unexpectedTypeMessage = '/Expected value of type "array\|\\\Traversable", "(.*)" given\./';
 
         yield 'invalid field value' => [
             new Collection(fields: ['field' => 'invalid']),
@@ -67,10 +67,14 @@ public static function provideRuleFailureConditionData(): \Generator
 
     public static function provideRuleSuccessConditionData(): \Generator
     {
-        yield 'field' => [
+        yield 'array' => [
             new Collection(fields: ['field' => Validator::notBlank()]),
             ['field' => 'value'],
         ];
+        yield 'traversable' => [
+            new Collection(fields: ['field' => Validator::notBlank()]),
+            new \ArrayIterator(['field' => 'value'])
+        ];
         yield 'extra fields' => [
             new Collection(
                 fields: ['field' => Validator::notBlank()],