feat(database): add UploadCaster class

src/Tempest/Database/src/Casters/UploadCaster.php

@@ -0,0 +1,23 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Tempest\Database\Casters;
+
+use function filesize;
+use Laminas\Diactoros\UploadedFile;
+use Tempest\Http\Upload;
+use Tempest\Mapper\Caster;
+use const UPLOAD_ERR_OK;
+
+final readonly class UploadCaster implements Caster
+{
+    public function cast(mixed $input): Upload
+    {
+        if ($input instanceof Upload) {
+            return $input;
+        }
+
+        return new Upload(new UploadedFile($input, filesize($input), UPLOAD_ERR_OK));
+    }
+}

src/Tempest/Http/src/Upload.php

@@ -6,8 +6,9 @@
 
 use Psr\Http\Message\StreamInterface;
 use Psr\Http\Message\UploadedFileInterface;
+use Stringable;
 
-final readonly class Upload
+final readonly class Upload implements Stringable
 {
     public function __construct(
         private UploadedFileInterface $uploadedFile,
@@ -43,4 +44,9 @@ public function getClientMediaType(): ?string
     {
         return $this->uploadedFile->getClientMediaType();
     }
+
+    public function __toString(): string
+    {
+        return (string) $this->getClientFilename();
+    }
 }