Add typed docblocks and asserts.

Author: skie

src/Dto/DtoManager.php

@@ -62,9 +62,10 @@ public static function serialize(array|object $data): array
     /**
      * Hydrate queue data back into a DTO instance.
      *
+     * @template T of object
      * @param array<string, mixed> $data Serialized data.
-     * @param class-string $dtoClass DTO class name.
-     * @return object Hydrated DTO instance.
+     * @param class-string<T> $dtoClass DTO class name.
+     * @return T Hydrated DTO instance.
      * @throws \InvalidArgumentException When the DTO class does not exist.
      */
     public static function deserialize(array $data, string $dtoClass): object
@@ -73,7 +74,10 @@ public static function deserialize(array $data, string $dtoClass): object
             throw new InvalidArgumentException(sprintf('DTO class `%s` does not exist.', $dtoClass));
         }
 
-        return (new ResultSetFactory())->hydrateDto($data, $dtoClass);
+        $dto = (new ResultSetFactory())->hydrateDto($data, $dtoClass);
+        assert($dto instanceof $dtoClass);
+
+        return $dto;
     }
 
     /**

src/Job/Message.php

@@ -186,17 +186,22 @@ public function getDtoClass(): ?string
     public function getDto(string $dtoClass): object
     {
         if ($this->dto !== null && $this->dtoHydratedAs === $dtoClass) {
+            assert($this->dto instanceof $dtoClass);
+
             return $this->dto;
         }
 
         if (!class_exists($dtoClass)) {
             throw new InvalidArgumentException(sprintf('DTO class `%s` does not exist.', $dtoClass));
         }
 
-        $this->dto = DtoManager::deserialize($this->getArgument(), $dtoClass);
+        $dto = DtoManager::deserialize($this->getArgument(), $dtoClass);
+        assert($dto instanceof $dtoClass);
+
+        $this->dto = $dto;
         $this->dtoHydratedAs = $dtoClass;
 
-        return $this->dto;
+        return $dto;
     }
 
     /**