Upload beautify

app/Services/Upload/Contracts/UploadDraftServiceInterface.php

@@ -0,0 +1,51 @@
+<?php
+
+namespace App\Services\Upload\Contracts;
+
+use Illuminate\Http\UploadedFile;
+
+interface UploadDraftServiceInterface
+{
+    /**
+     * Create a new draft and return identifying info.
+     *
+     * @param array $attributes
+     * @return array ['id' => string, 'path' => string, 'meta' => array]
+     */
+    public function createDraft(array $attributes = []): array;
+
+    /**
+     * Store the main uploaded file for the draft.
+     *
+     * @param string $draftId
+     * @param UploadedFile $file
+     * @return array Metadata about stored file (path, size, mime, hash)
+     */
+    public function storeMainFile(string $draftId, UploadedFile $file): array;
+
+    /**
+     * Store a screenshot/preview image for the draft.
+     *
+     * @param string $draftId
+     * @param UploadedFile $file
+     * @return array Metadata about stored screenshot
+     */
+    public function storeScreenshot(string $draftId, UploadedFile $file): array;
+
+    /**
+     * Calculate a content hash for a local file path or storage path.
+     *
+     * @param string $filePath
+     * @return string
+     */
+    public function calculateHash(string $filePath): string;
+
+    /**
+     * Set an expiration timestamp for the draft.
+     *
+     * @param string $draftId
+     * @param \Carbon\Carbon|null $expiresAt
+     * @return bool
+     */
+    public function setExpiration(string $draftId, ?\Carbon\Carbon $expiresAt = null): bool;
+}