Add exceptions in normalizer/denormalizer interfaces

Author: Kirill Nesmeyanov

src/DenormalizerInterface.php

@@ -5,7 +5,9 @@
 namespace TypeLang\Mapper;
 
 use JetBrains\PhpStorm\Language;
+use TypeLang\Mapper\Exception\Definition\DefinitionException;
 use TypeLang\Mapper\Exception\Definition\TypeNotFoundException;
+use TypeLang\Mapper\Exception\Mapping\RuntimeException;
 
 interface DenormalizerInterface
 {
@@ -23,14 +25,17 @@ interface DenormalizerInterface
      * ```
      *
      * @param non-empty-string $type
+     * @throws RuntimeException in case of runtime mapping exception occurs
+     * @throws DefinitionException in case of type building exception occurs
+     * @throws \Throwable in case of any internal error occurs
      */
     public function denormalize(mixed $value, #[Language('PHP')] string $type): mixed;
 
     /**
      * Returns {@see true} if the value can be denormalized for the given type.
      *
      * @param non-empty-string $type
-     * @throws TypeNotFoundException in case of type not found
+     * @throws DefinitionException in case of type building exception occurs
      * @throws \Throwable in case of any internal error occurs
      */
     public function isDenormalizable(mixed $value, #[Language('PHP')] string $type): bool;

src/NormalizerInterface.php

@@ -5,7 +5,9 @@
 namespace TypeLang\Mapper;
 
 use JetBrains\PhpStorm\Language;
+use TypeLang\Mapper\Exception\Definition\DefinitionException;
 use TypeLang\Mapper\Exception\Definition\TypeNotFoundException;
+use TypeLang\Mapper\Exception\Mapping\RuntimeException;
 
 interface NormalizerInterface
 {
@@ -26,6 +28,9 @@ interface NormalizerInterface
      * ```
      *
      * @param non-empty-string|null $type
+     * @throws RuntimeException in case of runtime mapping exception occurs
+     * @throws DefinitionException in case of type building exception occurs
+     * @throws \Throwable in case of any internal error occurs
      */
     public function normalize(mixed $value, #[Language('PHP')] ?string $type = null): mixed;
 
@@ -36,7 +41,7 @@ public function normalize(mixed $value, #[Language('PHP')] ?string $type = null)
      * inferred from the passed value.
      *
      * @param non-empty-string|null $type
-     * @throws TypeNotFoundException in case of type not found
+     * @throws DefinitionException in case of type building exception occurs
      * @throws \Throwable in case of any internal error occurs
      */
     public function isNormalizable(mixed $value, #[Language('PHP')] ?string $type = null): bool;