Release 5.0

Dockerfile

@@ -1,4 +1,4 @@
-FROM php:8.0-cli-alpine3.13
+FROM php:8.4-cli-alpine3.22
 
 RUN apk update && \
     apk add --no-cache \

composer.json

@@ -28,7 +28,7 @@
     }
   },
   "require": {
-    "php": "^8.0",
+    "php": "^8.4",
     "ext-json": "*",
     "ramsey/uuid": "^4.2"
   },

src/Domain/Model/ValueObject/CollectionValueObject.php

@@ -52,6 +52,11 @@ public function walk(callable $func): void
         \array_walk($this->items, $func);
     }
 
+    public function findOne(callable $func)
+    {
+        return \array_find($this->items, $func);
+    }
+
     public function filter(callable $func): static
     {
         return static::from(\array_values(\array_filter($this->items, $func)));

src/Domain/Model/ValueObject/DateTimeValueObject.php

@@ -40,30 +40,26 @@ final public static function createFromFormat(
         string $format,
         string $datetime,
         ?\DateTimeZone $timezone = null
-    ): static|false {
+    ): static {
         $datetime = parent::createFromFormat($format, $datetime, $timezone);
 
         if (false === $datetime) {
-            return false;
+            throw new \InvalidArgumentException('Invalid date format');
         }
 
         $timeZone = new \DateTimeZone(self::TIME_ZONE);
 
         return static::createFromInterface($datetime->setTimezone($timeZone));
     }
 
-    final public static function fromFormat(string $format, string $str): static|false
+    final public static function fromFormat(string $format, string $str): static
     {
         return static::createFromFormat($format, $str, new \DateTimeZone(self::TIME_ZONE));
     }
 
     final public static function createFromTimestamp(float|int $timestamp): static
     {
-        $dateTime = self::fromFormat('U.u', \number_format((float) $timestamp, 6, '.', ''));
-
-        \assert(false !== $dateTime, 'Unexpected error on create date time from timestamp');
-
-        return $dateTime;
+        return self::fromFormat('U.u', \number_format((float) $timestamp, 6, '.', ''));
     }
 
     final public static function fromTimestamp(int|float $timestamp): static

src/Domain/Model/ValueObject/DateValueObject.php

@@ -18,7 +18,7 @@ public static function from(string $str): static
     {
         $timeZone = new \DateTimeZone(self::TIME_ZONE);
 
-        return (new static($str, $timeZone))->setTimezone($timeZone);
+        return (new static($str, $timeZone))->setTimezone($timeZone)->setTime(0, 0, 0, 0);
     }
 
     final public static function now(): static
@@ -40,30 +40,26 @@ final public static function createFromFormat(
         string $format,
         string $datetime,
         ?\DateTimeZone $timezone = null
-    ): static|false {
+    ): static {
         $datetime = parent::createFromFormat($format, $datetime, $timezone);
 
         if (false === $datetime) {
-            return false;
+            throw new \InvalidArgumentException('Invalid date format');
         }
 
         $timeZone = new \DateTimeZone(self::TIME_ZONE);
 
         return static::createFromInterface($datetime->setTimezone($timeZone));
     }
 
-    final public static function fromFormat(string $format, string $str): static|false
+    final public static function fromFormat(string $format, string $str): static
     {
         return static::createFromFormat($format, $str, new \DateTimeZone(self::TIME_ZONE));
     }
 
     final public static function createFromTimestamp(float|int $timestamp): static
     {
-        $dateTime = self::fromFormat('U.u', \number_format((float) $timestamp, 6, '.', ''));
-
-        \assert(false !== $dateTime, 'Unexpected error on create date time from timestamp');
-
-        return $dateTime;
+        return self::fromFormat('U.u', \number_format((float) $timestamp, 6, '.', ''));
     }
 
     final public static function fromTimestamp(int|float $timestamp): static

src/Domain/Model/ValueObject/UniqueId.php

@@ -5,10 +5,30 @@
 
 class UniqueId extends StringValueObject
 {
+    private const VALID_PATTERN = '/^[A-Z0-9]{10}$/';
+
+    public static function from(string $value): static
+    {
+        if (false === self::isValid($value)) {
+            throw new \InvalidArgumentException('Invalid UniqueId.');
+        }
+
+        return parent::from($value);
+    }
+
     public static function create(): static
     {
+        $value = \base_convert(\uniqid(), 16, 36);
+        $value = \str_pad($value, 10, '0', \STR_PAD_LEFT);
+        $value = \substr($value, -10);
+
         return self::from(
-            \strtoupper(\base_convert(\uniqid(), 16, 36)),
+            \strtoupper($value),
         );
     }
+
+    public static function isValid(string $value): bool
+    {
+        return 1 === \preg_match(self::VALID_PATTERN, $value);
+    }
 }

tests/Domain/Model/ValueObject/UniqueIdTest.php

@@ -28,7 +28,7 @@ public function given_uid_class_when_ask_to_generate_an_uid_then_return_uid_inst
     {
         $uid = UniqueId::create();
         $this->assertInstanceOf(UniqueId::class, $uid);
-        $this->assertMatchesRegularExpression('/^[0-9A-Z]{10}$/i', $uid->value());
+        $this->assertTrue(UniqueId::isValid($uid->value()));
     }
 
     /**
@@ -53,4 +53,29 @@ public function given_two_different_uids_when_ask_to_check_equality_then_return_
 
         $this->assertFalse($str->equalTo($other));
     }
+
+    /**
+     * @test
+     */
+    public function given_invalid_uid_value_when_construct_then_fail()
+    {
+        $this->expectException(\InvalidArgumentException::class);
+        UniqueId::from('12345');
+    }
+
+    /**
+     * @test
+     */
+    public function given_invalid_uid_value_when_ask_is_valid_then_return_false()
+    {
+        self::assertFalse(UniqueId::isValid('12345'));
+    }
+
+    /**
+     * @test
+     */
+    public function given_valid_uid_value_when_ask_is_valid_then_return_true()
+    {
+        self::assertTrue(UniqueId::isValid('H7HVQ2U72X'));
+    }
 }