feat(trait): Adds maxLength argument to nullOrString() (#57)

Co-authored-by: Oskar Stark <[email protected]>

Author: KristianH

src/Util/ValueObjectTrait.php

@@ -365,12 +365,17 @@ final protected static function nullOrMultiLink(array $values, string $key): ?Mu
      * @param array<mixed>     $values
      * @param non-empty-string $key
      */
-    final protected static function nullOrString(array $values, string $key): ?string
+    final protected static function nullOrString(array $values, string $key, ?int $maxLength = null): ?string
     {
         if (!\array_key_exists($key, $values)) {
             return null;
         }
 
+        if (null !== $maxLength) {
+            Assert::greaterThan($maxLength, 0);
+            Assert::maxLength($values[$key], $maxLength);
+        }
+
         try {
             return TrimmedNonEmptyString::from($values[$key])->toString();
         } catch (\InvalidArgumentException) {

tests/Unit/Util/ValueObjectTraitTest.php

@@ -1081,6 +1081,38 @@ public function nullOrStringReturnsNullWhenValueIsEmpty(): void
         self::assertNull($result);
     }
 
+    #[Test]
+    public function nullOrStringThrowsExceptionWhenMaxLengthExceeded(): void
+    {
+        $class = new class() {
+            use ValueObjectTrait {
+                ValueObjectTrait::nullOrString as public;
+            }
+        };
+
+        $this->expectException(\InvalidArgumentException::class);
+
+        $values = ['key' => str_repeat('a', 11)];
+
+        $class::nullOrString($values, 'key', 10);
+    }
+
+    #[Test]
+    public function nullOrStringThrowsExceptionWhenMaxLengthIsLessThenOne(): void
+    {
+        $class = new class() {
+            use ValueObjectTrait {
+                ValueObjectTrait::nullOrString as public;
+            }
+        };
+
+        $this->expectException(\InvalidArgumentException::class);
+
+        $values = ['key' => ''];
+
+        $class::nullOrString($values, 'key', 0);
+    }
+
     #[Test]
     public function string(): void
     {