feat(mapper): remove the need for CastWith and SerializeWith when using SerializeAs

Author: innocenzi

packages/database/src/Builder/ModelInspector.php

@@ -12,6 +12,7 @@
 use Tempest\Database\Relation;
 use Tempest\Database\Table;
 use Tempest\Database\Virtual;
+use Tempest\Mapper\SerializeAs;
 use Tempest\Mapper\SerializeWith;
 use Tempest\Reflection\ClassReflector;
 use Tempest\Reflection\PropertyReflector;
@@ -153,6 +154,10 @@ public function getBelongsTo(string $name): ?BelongsTo
             return null;
         }
 
+        if ($property->getType()->asClass()->hasAttribute(SerializeAs::class)) {
+            return null;
+        }
+
         if ($property->hasAttribute(HasOne::class)) {
             return null;
         }

packages/mapper/src/CasterFactory.php

@@ -5,6 +5,7 @@
 namespace Tempest\Mapper;
 
 use Closure;
+use Tempest\Mapper\Casters\DtoCaster;
 use Tempest\Reflection\PropertyReflector;
 
 use function Tempest\get;
@@ -36,6 +37,10 @@ public function forProperty(PropertyReflector $property): ?Caster
         // Get CastWith from the property's type if there's no property-defined CastWith
         if ($castWith === null && $type->isClass()) {
             $castWith = $type->asClass()->getAttribute(CastWith::class, recursive: true);
+
+            if ($castWith === null && $type->asClass()->getAttribute(SerializeAs::class)) {
+                $castWith = new CastWith(DtoCaster::class);
+            }
         }
 
         // Return the caster if defined with CastWith

packages/mapper/src/SerializeAs.php

@@ -6,6 +6,7 @@
 
 /**
  * Defines the name to use when serializing this class, instead of its fully qualified class name.
+ * Using this attribute removes the need to specify a `DtoCaster` and `DtoSerializer`.
  */
 #[Attribute(Attribute::TARGET_CLASS)]
 final readonly class SerializeAs

packages/mapper/src/SerializerFactory.php

@@ -5,6 +5,7 @@
 namespace Tempest\Mapper;
 
 use Closure;
+use Tempest\Mapper\Serializers\DtoSerializer;
 use Tempest\Reflection\ClassReflector;
 use Tempest\Reflection\PropertyReflector;
 use Tempest\Reflection\TypeReflector;
@@ -73,6 +74,10 @@ public function forProperty(PropertyReflector $property): ?Serializer
         // Get SerializerWith from the property's type if there's no property-defined SerializerWith
         if ($serializeWith === null && $type->isClass()) {
             $serializeWith = $type->asClass()->getAttribute(SerializeWith::class, recursive: true);
+
+            if ($serializeWith === null && $type->asClass()->getAttribute(SerializeAs::class)) {
+                $serializeWith = new SerializeWith(DtoSerializer::class);
+            }
         }
 
         // Return the serializer if defined with SerializerWith

tests/Integration/Database/DtoSerializationTest.php

@@ -27,6 +27,7 @@ public function up(): QueryStatement
             {
                 return new CreateTableStatement('model_with_settings')
                     ->primary()
+                    ->text('title')
                     ->json('settings');
             }
 
@@ -37,13 +38,14 @@ public function down(): null
         });
 
         query(ModelWithSettings::class)
-            ->insert(new ModelWithSettings(new Settings(Theme::DARK)))
+            ->insert(new ModelWithSettings('model', new Settings(Theme::DARK)))
             ->execute();
 
         $model = query(ModelWithSettings::class)
             ->select()
             ->first();
 
+        $this->assertSame('model', $model->title);
         $this->assertSame(Theme::DARK, $model->settings->theme);
     }
 }
@@ -57,12 +59,11 @@ enum Theme: string
 final class ModelWithSettings
 {
     public function __construct(
+        public string $title,
         public Settings $settings,
     ) {}
 }
 
-#[CastWith(DtoCaster::class)]
-#[SerializeWith(DtoSerializer::class)]
 #[SerializeAs('settings')]
 final class Settings
 {