release/v0.1.11: Phase 11 — Convert UI Flow

app/Http/Controllers/DownloadConversionResultController.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+namespace App\Http\Controllers;
+
+use App\Enums\ConversionStatus;
+use App\Models\ConversionJob;
+use Illuminate\Http\Request;
+use Illuminate\Support\Facades\Storage;
+
+final class DownloadConversionResultController extends Controller
+{
+    public function __invoke(Request $request, ConversionJob $conversion)
+    {
+        abort_unless((int) $conversion->user_id === (int) $request->user()->id, 403);
+        abort_unless($conversion->status === ConversionStatus::Completed, 404);
+        abort_unless($conversion->resultFile !== null, 404);
+
+        $file = $conversion->resultFile;
+
+        abort_if($file->isExpired(), 410);
+
+        abort_unless(Storage::disk('local')->exists($file->stored_path), 404);
+
+        return Storage::disk('local')->download(
+            $file->stored_path,
+            $file->original_name,
+            ['Content-Type' => $file->mime_type],
+        );
+    }
+}

app/Livewire/Dashboard/DashboardConverter.php

@@ -2,10 +2,14 @@
 
 namespace App\Livewire\Dashboard;
 
+use App\Actions\Conversions\CreateConversionJobAction;
 use App\Actions\Files\StoreUploadedFileAction;
+use App\Enums\ConversionStatus;
 use App\Exceptions\Files\FileStorageException;
 use App\Exceptions\Files\UnsupportedFileFormatException;
+use App\Models\ConversionJob;
 use App\Models\FileRecord;
+use App\Support\Conversions\Exceptions\UnsupportedConversionException;
 use App\Support\Converters\ConverterRegistry;
 use App\Support\Converters\DTO\ConverterTarget;
 use App\Support\Converters\Exceptions\InvalidConverterOptionsException;
@@ -14,6 +18,7 @@
 use App\ViewModels\TargetFormatCardViewModel;
 use Livewire\Component;
 use Livewire\WithFileUploads;
+use Throwable;
 
 class DashboardConverter extends Component
 {
@@ -48,6 +53,12 @@ class DashboardConverter extends Component
      */
     public array $optionsByTarget = [];
 
+    public ?int $currentConversionJobId = null;
+
+    public int $pollCount = 0;
+
+    public ?string $convertError = null;
+
     public function updatedUpload(): void
     {
         $this->storeUpload(app(StoreUploadedFileAction::class));
@@ -196,11 +207,46 @@ public function continueFromSettings(): void
             return;
         }
 
-        // Phase 8 stops at a convert placeholder. CreateConversionJobAction and
-        // the real conversion flow arrive in Phase 9.
         $this->step = 'convert';
     }
 
+    public function convert(): void
+    {
+        if ($this->step === 'converting' || $this->currentConversionJobId !== null) {
+            return;
+        }
+
+        $file = $this->currentFile;
+
+        if ($file === null || $this->selectedTargetFormat === null) {
+            return;
+        }
+
+        $this->convertError = null;
+
+        try {
+            $job = app(CreateConversionJobAction::class)->handle(
+                user: auth()->user(),
+                sourceFile: $file,
+                targetFormat: $this->selectedTargetFormat,
+                options: $this->options,
+            );
+        } catch (UnsupportedConversionException $e) {
+            $this->convertError = 'This conversion is not supported. Please choose a different format.';
+            $this->step = 'format';
+
+            return;
+        } catch (Throwable) {
+            $this->convertError = 'Something went wrong. Please try again.';
+
+            return;
+        }
+
+        $this->currentConversionJobId = $job->id;
+        $this->pollCount = 0;
+        $this->step = 'converting';
+    }
+
     public function validateSettings(): bool
     {
         $this->resetErrorBag();
@@ -285,6 +331,74 @@ private function resetTargetSelection(): void
         $this->optionsByTarget = [];
     }
 
+    public function getCurrentJobProperty(): ?ConversionJob
+    {
+        if ($this->currentConversionJobId === null) {
+            return null;
+        }
+
+        return ConversionJob::query()
+            ->with(['sourceFile', 'resultFile'])
+            ->where('user_id', auth()->id())
+            ->find($this->currentConversionJobId);
+    }
+
+    public function convertAnother(): void
+    {
+        $this->reset(['upload', 'currentFileId', 'uploadError', 'selectedTargetFormat',
+            'selectedConverterKey', 'targetFormatError', 'optionsSchema', 'options',
+            'optionsByTarget', 'currentConversionJobId']);
+        $this->step = 'upload';
+    }
+
+    public function convertWithDifferentSettings(): void
+    {
+        $this->currentConversionJobId = null;
+        $this->pollCount = 0;
+
+        if ($this->currentFile === null || $this->selectedTargetFormat === null) {
+            $this->step = 'upload';
+
+            return;
+        }
+
+        $this->step = 'settings';
+    }
+
+    public function refreshConversionStatus(): void
+    {
+        if ($this->currentConversionJobId === null) {
+            return;
+        }
+
+        $this->pollCount++;
+
+        if ($this->pollCount > 60) {
+            $this->step = 'failed';
+            $this->convertError = 'Conversion is taking too long. Please try again.';
+
+            return;
+        }
+
+        $job = ConversionJob::query()
+            ->where('user_id', auth()->id())
+            ->find($this->currentConversionJobId);
+
+        if (! $job) {
+            return;
+        }
+
+        if ($job->status === ConversionStatus::Completed) {
+            $this->step = 'completed';
+
+            return;
+        }
+
+        if ($job->status === ConversionStatus::Failed) {
+            $this->step = 'failed';
+        }
+    }
+
     public function getCurrentFileProperty(): ?FileRecord
     {
         return $this->currentFileId

app/Models/FileRecord.php

@@ -40,6 +40,11 @@ protected function casts(): array
         ];
     }
 
+    public function isExpired(): bool
+    {
+        return $this->expires_at !== null && $this->expires_at->isPast();
+    }
+
     public function user(): BelongsTo
     {
         return $this->belongsTo(User::class);

database/factories/ConversionJobFactory.php

@@ -36,4 +36,38 @@ public function definition(): array
             'error_message' => null,
         ];
     }
+
+    public function queued(): static
+    {
+        return $this->state(['status' => ConversionStatus::Queued, 'progress' => 0]);
+    }
+
+    public function processing(): static
+    {
+        return $this->state([
+            'status' => ConversionStatus::Processing,
+            'progress' => 10,
+            'started_at' => now(),
+        ]);
+    }
+
+    public function completed(): static
+    {
+        return $this->state([
+            'status' => ConversionStatus::Completed,
+            'progress' => 100,
+            'started_at' => now()->subSeconds(5),
+            'completed_at' => now(),
+        ]);
+    }
+
+    public function failed(): static
+    {
+        return $this->state([
+            'status' => ConversionStatus::Failed,
+            'error_code' => 'driver_failed',
+            'error_message' => 'Conversion driver encountered an error.',
+            'completed_at' => now(),
+        ]);
+    }
 }

database/factories/FileRecordFactory.php

@@ -14,6 +14,11 @@ class FileRecordFactory extends Factory
 {
     protected $model = FileRecord::class;
 
+    public function expired(): static
+    {
+        return $this->state(['expires_at' => now()->subHour()]);
+    }
+
     public function definition(): array
     {
         $extension = fake()->randomElement(['png', 'jpg', 'webp', 'pdf']);

resources/views/livewire/dashboard/dashboard-converter.blade.php

@@ -180,6 +180,83 @@ class="flex items-center justify-between gap-4 rounded-[var(--ca-radius-md)] bor
             </div>
         @endif
 
+        @if ($step === 'failed')
+            <div class="flex flex-col gap-4">
+                <div class="rounded-[var(--ca-radius-md)] border border-red-200 bg-red-50 px-6 py-8 text-center">
+                    <p class="text-base font-semibold text-red-700">Conversion failed</p>
+                    <p class="mt-1 text-sm text-red-600">We could not convert this file. Try another file or change settings.</p>
+                </div>
+
+                <div class="flex flex-col gap-2">
+                    <x-button wire:click="convertWithDifferentSettings" class="w-full">
+                        Change settings
+                    </x-button>
+
+                    <x-button variant="secondary" wire:click="convertAnother" class="w-full">
+                        Try another file
+                    </x-button>
+                </div>
+            </div>
+        @endif
+
+        @if ($step === 'completed' && $this->currentJob)
+            @php($job = $this->currentJob)
+            <div class="flex flex-col gap-4">
+                @if ($job->resultFile?->isExpired())
+                    <div class="rounded-[var(--ca-radius-md)] border border-[var(--ca-border)] bg-[var(--ca-surface-muted)]/40 px-6 py-8 text-center">
+                        <p class="text-base font-semibold text-[var(--ca-text)]">This result has expired</p>
+                        <p class="mt-1 text-sm text-[var(--ca-muted)]">Upload the original file again to create a new result.</p>
+                    </div>
+
+                    <x-button variant="ghost" wire:click="convertAnother" class="w-full">
+                        Convert another file
+                    </x-button>
+                @else
+                    <div class="rounded-[var(--ca-radius-md)] border border-[var(--ca-border)] bg-[var(--ca-surface-muted)]/40 px-6 py-8 text-center">
+                        <p class="text-base font-semibold text-[var(--ca-text)]">Done! Your file is ready.</p>
+                        @if ($job->resultFile)
+                            <p class="mt-1 text-sm text-[var(--ca-muted)]">{{ $job->resultFile->original_name }}</p>
+                        @endif
+                    </div>
+
+                    <div class="flex flex-col gap-2">
+                        <a
+                            href="{{ route('conversions.download', $job) }}"
+                            class="inline-flex w-full items-center justify-center gap-2 rounded-[var(--ca-radius-md)] px-4 py-2 text-sm font-medium text-white shadow-sm transition hover:brightness-110"
+                            style="background:var(--ca-primary);"
+                        >Download</a>
+
+                        <x-button variant="secondary" wire:click="convertWithDifferentSettings" class="w-full">
+                            Change settings
+                        </x-button>
+
+                        <x-button variant="ghost" wire:click="convertAnother" class="w-full">
+                            Convert another file
+                        </x-button>
+                    </div>
+                @endif
+            </div>
+        @endif
+
+        @if ($step === 'converting')
+            <div wire:poll.2s="refreshConversionStatus">
+                <div class="flex flex-col items-center gap-4 py-8 text-center">
+                    <div class="h-12 w-12 animate-spin rounded-full border-4 border-[var(--ca-border)] border-t-[var(--ca-primary)]"></div>
+
+                    <div>
+                        <p class="text-base font-semibold text-[var(--ca-text)]">Converting your file</p>
+                        @if ($this->currentJob)
+                            <p class="mt-1 text-sm text-[var(--ca-muted)]">
+                                {{ strtoupper($this->currentJob->source_format) }} → {{ strtoupper($this->currentJob->target_format) }}
+                            </p>
+                        @endif
+                    </div>
+
+                    <p class="text-xs text-[var(--ca-muted)]">Please keep this page open while we prepare your file.</p>
+                </div>
+            </div>
+        @endif
+
         @if ($step === 'convert' && $this->currentFile)
             @php($file = $this->currentFile)
             <div class="flex flex-col gap-4">
@@ -191,8 +268,18 @@ class="flex items-center justify-between gap-4 rounded-[var(--ca-radius-md)] bor
                     <p class="text-base font-semibold text-[var(--ca-text)]">
                         Ready to convert {{ strtoupper($file->extension) }} to {{ strtoupper($selectedTargetFormat) }}
                     </p>
-                    <p class="mt-1 text-sm text-[var(--ca-muted)]">Conversion will be available in Phase 9.</p>
                 </div>
+
+                <x-button
+                    wire:click="convert"
+                    wire:loading.attr="disabled"
+                    wire:target="convert"
+                    :disabled="$step === 'converting'"
+                    class="w-full"
+                >
+                    <span wire:loading.remove wire:target="convert">Convert Now</span>
+                    <span wire:loading wire:target="convert">Starting…</span>
+                </x-button>
             </div>
         @endif
     </x-card>

routes/web.php

@@ -1,5 +1,6 @@
 <?php
 
+use App\Http\Controllers\DownloadConversionResultController;
 use App\Http\Controllers\ProfileController;
 use Illuminate\Support\Facades\Route;
 
@@ -14,6 +15,9 @@
 Route::view('/ui-kit', 'ui-kit')->name('ui-kit');
 
 Route::middleware('auth')->group(function () {
+    Route::get('/conversions/{conversion}/download', DownloadConversionResultController::class)
+        ->name('conversions.download');
+
     Route::get('/profile', [ProfileController::class, 'edit'])->name('profile.edit');
     Route::patch('/profile', [ProfileController::class, 'update'])->name('profile.update');
     Route::delete('/profile', [ProfileController::class, 'destroy'])->name('profile.destroy');