feat(attachments): refactor attachment management to use attachable pivot table and update related models and tests

app/Domains/Attachable/Models/AttachableAttachment.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace App\Domains\Attachable\Models;
+
+use Illuminate\Database\Eloquent\Attributes\Fillable;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\MorphTo;
+
+#[Fillable([
+    'attachable_type',
+    'attachable_id',
+    'attachment_id',
+])]
+class AttachableAttachment extends Model
+{
+    protected $table = 'attachable_attachments';
+
+    public $timestamps = false;
+
+    protected function casts(): array
+    {
+        return [
+            'attachable_id' => 'integer',
+            'attachment_id' => 'integer',
+        ];
+    }
+
+    /**
+     * @return MorphTo<Model, $this>
+     */
+    public function attachable(): MorphTo
+    {
+        return $this->morphTo();
+    }
+
+    /**
+     * @return BelongsTo<Attachment, $this>
+     */
+    public function attachment(): BelongsTo
+    {
+        return $this->belongsTo(Attachment::class, 'attachment_id');
+    }
+}

app/Domains/Attachable/Models/Attachment.php

@@ -6,12 +6,10 @@ use App\Domains\Attachable\Enums\AttachmentType;
 use Illuminate\Database\Eloquent\Attributes\Fillable;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\MorphTo;
+use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Support\Str;
 
 #[Fillable([
-    'attachable_type',
-    'attachable_id',
     'key',
     'path',
     'filename',
@@ -38,17 +36,16 @@ class Attachment extends Model
     protected function casts(): array
     {
         return [
-            'attachable_id' => 'integer',
             'type' => AttachmentType::class,
             'size' => 'integer',
         ];
     }
 
     /**
-     * @return MorphTo<Model, $this>
+     * @return HasMany<AttachableAttachment, $this>
      */
-    public function attachable(): MorphTo
+    public function attachables(): HasMany
     {
-        return $this->morphTo();
+        return $this->hasMany(AttachableAttachment::class, 'attachment_id');
     }
 }

app/Domains/Attachable/Models/Concerns/HasAttachments.php

@@ -4,15 +4,21 @@ namespace App\Domains\Attachable\Models\Concerns;
 
 use App\Domains\Attachable\Models\Attachment;
 use Illuminate\Database\Eloquent\Model;
-use Illuminate\Database\Eloquent\Relations\MorphMany;
+use Illuminate\Database\Eloquent\Relations\MorphToMany;
 
 trait HasAttachments
 {
     /**
-     * @return MorphMany<Attachment, Model>
+     * @return MorphToMany<Attachment, Model, $this>
      */
-    public function attachments(): MorphMany
+    public function attachments(): MorphToMany
     {
-        return $this->morphMany(Attachment::class, 'attachable');
+        return $this->morphToMany(
+            Attachment::class,
+            'attachable',
+            'attachable_attachments',
+            'attachable_id',
+            'attachment_id',
+        );
     }
 }

app/Domains/Attachable/Services/AttachmentService.php

@@ -5,7 +5,6 @@ namespace App\Domains\Attachable\Services;
 use App\Domains\Attachable\Enums\AttachmentType;
 use App\Domains\Attachable\Exceptions\AttachmentStorageException;
 use App\Domains\Attachable\Models\Attachment;
-use Illuminate\Database\Eloquent\Model;
 use Illuminate\Http\UploadedFile;
 use Illuminate\Support\Facades\Storage;
 use Illuminate\Support\Str;
@@ -14,13 +13,9 @@ use Throwable;
 class AttachmentService
 {
     public function store(
-        Model $attachable,
         UploadedFile $file,
         string $path,
-        AttachmentType $type,
     ): Attachment {
-        $this->ensureAttachableExists($attachable);
-
         $normalizedPath = $this->normalizePath($path);
 
         if ($normalizedPath === '') {
@@ -46,11 +41,11 @@ class AttachmentService
 
         try {
             /** @var Attachment $attachment */
-            $attachment = $attachable->attachments()->create([
+            $attachment = Attachment::query()->create([
                 'key' => $key,
                 'path' => $storedPath,
                 'filename' => $filename,
-                'type' => $type,
+                'type' => $this->resolveAttachmentType($file),
                 'mime_type' => $file->getClientMimeType() ?? $file->getMimeType() ?? 'application/octet-stream',
                 'extension' => $file->extension(),
                 'size' => $file->getSize() ?? 0,
@@ -75,13 +70,6 @@ class AttachmentService
         $attachment->delete();
     }
 
-    protected function ensureAttachableExists(Model $attachable): void
-    {
-        if (! $attachable->exists) {
-            throw new AttachmentStorageException('Cannot manage attachments for an unsaved model.');
-        }
-    }
-
     protected function normalizePath(string $path): string
     {
         return trim($path, '/');
@@ -97,4 +85,39 @@ class AttachmentService
 
         return trim($directory, '/');
     }
+
+    protected function resolveAttachmentType(UploadedFile $file): AttachmentType
+    {
+        $mimeType = strtolower($file->getClientMimeType() ?? $file->getMimeType() ?? '');
+
+        if (str_starts_with($mimeType, 'image/')) {
+            return AttachmentType::Image;
+        }
+
+        if (str_starts_with($mimeType, 'video/')) {
+            return AttachmentType::Video;
+        }
+
+        if ($mimeType === 'application/pdf') {
+            return AttachmentType::Pdf;
+        }
+
+        if (str_starts_with($mimeType, 'audio/')) {
+            return AttachmentType::Audio;
+        }
+
+        if (
+            str_starts_with($mimeType, 'text/')
+            || str_contains($mimeType, 'document')
+            || str_contains($mimeType, 'word')
+            || str_contains($mimeType, 'excel')
+            || str_contains($mimeType, 'spreadsheet')
+            || str_contains($mimeType, 'presentation')
+            || str_contains($mimeType, 'officedocument')
+        ) {
+            return AttachmentType::Document;
+        }
+
+        return AttachmentType::Other;
+    }
 }

app/Domains/StorageTest/Controllers/S3TestController.php

@@ -2,6 +2,7 @@
 
 namespace App\Domains\StorageTest\Controllers;
 
+use App\Domains\Attachable\Services\AttachmentService;
 use App\Domains\StorageTest\Requests\GenerateS3TemporaryUrlRequest;
 use App\Domains\StorageTest\Requests\StoreS3TestFileRequest;
 use App\Domains\StorageTest\Services\S3TestService;
@@ -11,18 +12,36 @@ use Illuminate\Http\JsonResponse;
 class S3TestController extends Controller
 {
     public function __construct(
+        protected AttachmentService $attachmentService,
         protected S3TestService $s3TestService,
     ) {
     }
 
     public function store(StoreS3TestFileRequest $request): JsonResponse
     {
+        $attachment = $this->attachmentService->store(
+            $request->file('file'),
+            $request->validated('path'),
+        );
+
+        $temporaryUrl = $this->s3TestService->generateTemporaryUrl(
+            $attachment->path,
+            (int) $request->validated('expires_in_minutes', 10),
+        );
+
         return response()->json(
-            $this->s3TestService->storeTestFile(
-                $request->file('file'),
-                $request->validated('directory'),
-                (int) $request->validated('expires_in_minutes', 10),
-            ),
+            [
+                'id' => $attachment->id,
+                'key' => $attachment->key,
+                'path' => $attachment->path,
+                'filename' => $attachment->filename,
+                'type' => $attachment->type->value,
+                'mime_type' => $attachment->mime_type,
+                'extension' => $attachment->extension,
+                'size' => $attachment->size,
+                'temporary_url' => $temporaryUrl['temporary_url'],
+                'temporary_url_expires_at' => $temporaryUrl['temporary_url_expires_at'],
+            ],
             201,
         );
     }

app/Domains/StorageTest/Requests/StoreS3TestFileRequest.php

@@ -18,7 +18,7 @@ class StoreS3TestFileRequest extends FormRequest
     {
         return [
             'file' => ['required', 'file', 'max:10240'],
-            'directory' => ['nullable', 'string', 'max:255'],
+            'path' => ['required', 'string', 'max:2048'],
             'expires_in_minutes' => ['nullable', 'integer', 'min:1', 'max:1440'],
         ];
     }