feat: added EachKey rule

Author: andrepimpao

src/ChainedValidatorInterface.php

@@ -23,6 +23,11 @@ public function country(
         string $message = 'The "{{ name }}" value is not a valid "{{ code }}" country code, "{{ value }}" given.'
     ): ChainedValidatorInterface&Validator;
 
+    public function eachKey(
+        Validator $validator,
+        string $message = '{{ message }}'
+    ): ChainedValidatorInterface&Validator;
+
     public function eachValue(
         Validator $validator,
         string $message = 'At key "{{ key }}": {{ message }}'

src/Exception/EachKeyException.php

@@ -0,0 +1,5 @@
+<?php
+
+namespace ProgrammatorDev\YetAnotherPhpValidator\Exception;
+
+class EachKeyException extends ValidationException {}

src/Rule/EachKey.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace ProgrammatorDev\YetAnotherPhpValidator\Rule;
+
+use ProgrammatorDev\YetAnotherPhpValidator\Exception\EachKeyException;
+use ProgrammatorDev\YetAnotherPhpValidator\Exception\UnexpectedValueException;
+use ProgrammatorDev\YetAnotherPhpValidator\Exception\ValidationException;
+use ProgrammatorDev\YetAnotherPhpValidator\Validator;
+
+class EachKey extends AbstractRule implements RuleInterface
+{
+    public function __construct(
+        private readonly Validator $validator,
+        private readonly string $message = '{{ message }}'
+    ) {}
+
+    public function assert(mixed $value, string $name): void
+    {
+        if (!\is_iterable($value)) {
+            throw new UnexpectedValueException(
+                \sprintf('Expected value of type "array|\Traversable", "%s" given.', get_debug_type($value))
+            );
+        }
+
+        try {
+            foreach ($value as $key => $element) {
+                $this->validator->assert($key, $name);
+            }
+        }
+        catch (ValidationException $exception) {
+            throw new EachKeyException(
+                message: $this->message,
+                parameters: [
+                    'value' => $value,
+                    'name' => $name,
+                    'key' => $key,
+                    'element' => $element,
+                    // Replaces string "value" with string "key" to get a more intuitive error message
+                    'message' => \preg_replace(
+                        \sprintf('/"(%s)" value/', $name),
+                        '"$1" key',
+                        $exception->getMessage()
+                    )
+                ]
+            );
+        }
+    }
+}

src/StaticValidatorInterface.php

@@ -22,6 +22,11 @@ public static function country(
         string $message = 'The "{{ name }}" value is not a valid "{{ code }}" country code, "{{ value }}" given.'
     ): ChainedValidatorInterface&Validator;
 
+    public static function eachKey(
+        Validator $validator,
+        string $message = '{{ message }}'
+    ): ChainedValidatorInterface&Validator;
+
     public static function eachValue(
         Validator $validator,
         string $message = 'At key "{{ key }}": {{ message }}'