feat: support contextual casters and serializers

Author: innocenzi

mago.toml

@@ -1,4 +1,4 @@
-php-version = "8.4.0"
+php-version = "8.5.0"
 
 [source]
 paths = ["src", "packages", "tests"]

packages/container/src/GenericContainer.php

@@ -177,11 +177,7 @@ public function get(string $className, null|string|UnitEnum $tag = null, mixed .
     {
         $this->resolveChain();
 
-        $dependency = $this->resolve(
-            className: $className,
-            tag: $tag,
-            params: $params,
-        );
+        $dependency = $this->resolve($className, $tag, ...$params);
 
         $this->stopChain();
 

packages/database/src/Casters/EncryptedCaster.php

@@ -15,6 +15,11 @@ public function __construct(
         private Encrypter $encrypter,
     ) {}
 
+    public static function for(): false
+    {
+        return false;
+    }
+
     public function cast(mixed $input): ?string
     {
         if ($input === null) {

packages/database/src/Casters/PrimaryKeyCaster.php

@@ -4,11 +4,18 @@
 
 namespace Tempest\Database\Casters;
 
+use Tempest\Core\Priority;
 use Tempest\Database\PrimaryKey;
 use Tempest\Mapper\Caster;
 
+#[Priority(Priority::HIGHEST)]
 final readonly class PrimaryKeyCaster implements Caster
 {
+    public static function for(): string
+    {
+        return PrimaryKey::class;
+    }
+
     public function cast(mixed $input): PrimaryKey
     {
         if ($input instanceof PrimaryKey) {

packages/database/src/DatabaseInitializer.php

@@ -41,9 +41,9 @@ className: Connection::class,
         $connection = $container->get(Connection::class, $tag);
 
         return new GenericDatabase(
-            $connection,
-            new GenericTransactionManager($connection),
-            $container->get(SerializerFactory::class),
+            connection: $connection,
+            transactionManager: new GenericTransactionManager($connection),
+            serializerFactory: new SerializerFactory($container),
         );
     }
 }

packages/database/src/GenericDatabase.php

@@ -12,6 +12,7 @@
 use Tempest\Database\Connection\Connection;
 use Tempest\Database\Exceptions\QueryWasInvalid;
 use Tempest\Database\Transactions\TransactionManager;
+use Tempest\Mapper\Context;
 use Tempest\Mapper\SerializerFactory;
 use Throwable;
 use UnitEnum;
@@ -29,6 +30,14 @@ final class GenericDatabase implements Database
         get => $this->connection->config->tag;
     }
 
+    private string $context {
+        get => match ($this->dialect) {
+            DatabaseDialect::POSTGRESQL => Context::DATABASE_POSTGRESQL,
+            DatabaseDialect::MYSQL => Context::DATABASE_MYSQL,
+            DatabaseDialect::SQLITE => Context::DATABASE_SQLITE,
+        };
+    }
+
     public function __construct(
         private(set) readonly Connection $connection,
         private(set) readonly TransactionManager $transactionManager,
@@ -128,17 +137,9 @@ private function resolveBindings(Query $query): array
         $bindings = [];
 
         foreach ($query->bindings as $key => $value) {
-            // Database handle booleans differently. We might need a database-aware serializer at some point.
-            if (is_bool($value)) {
-                $value = match ($this->dialect) {
-                    DatabaseDialect::POSTGRESQL => $value ? 'true' : 'false',
-                    default => $value ? '1' : '0',
-                };
-            }
-
             if ($value instanceof Query) {
                 $value = $value->execute();
-            } elseif ($serializer = $this->serializerFactory->forValue($value)) {
+            } elseif ($serializer = $this->serializerFactory->forValue($value, $this->context)) {
                 $value = $serializer->serialize($value);
             }
 

packages/database/src/PrimaryKey.php

@@ -5,10 +5,7 @@
 namespace Tempest\Database;
 
 use Stringable;
-use Tempest\Database\Casters\PrimaryKeyCaster;
-use Tempest\Mapper\CastWith;
 
-#[CastWith(PrimaryKeyCaster::class)]
 final readonly class PrimaryKey implements Stringable
 {
     public string|int $value;

packages/database/src/Serializers/EncryptedSerializer.php

@@ -14,6 +14,11 @@ public function __construct(
         private Encrypter $encrypter,
     ) {}
 
+    public static function for(): false
+    {
+        return false;
+    }
+
     public function serialize(mixed $input): array|string
     {
         if (! is_string($input)) {

packages/database/src/Serializers/HashedSerializer.php

@@ -11,6 +11,11 @@ public function __construct(
         private PasswordHasher $passwordHasher,
     ) {}
 
+    public static function for(): false
+    {
+        return false;
+    }
+
     public function serialize(mixed $input): string
     {
         if (! is_string($input)) {

packages/database/src/Serializers/MysqlBooleanSerializer.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Database\Serializers;
+
+use Tempest\Mapper\Context;
+use Tempest\Mapper\Exceptions\ValueCouldNotBeSerialized;
+use Tempest\Mapper\Serializer;
+
+#[Context(Context::DATABASE_MYSQL)]
+final class MysqlBooleanSerializer implements Serializer
+{
+    public static function for(): string
+    {
+        return 'bool';
+    }
+
+    public function serialize(mixed $input): string
+    {
+        if (! is_bool($input)) {
+            throw new ValueCouldNotBeSerialized('boolean');
+        }
+
+        return $input ? '1' : '0';
+    }
+}