TenantAtlas/app/Filament/Widgets/Tenant/TenantReviewPackCard.php

<?php

declare(strict_types=1);

namespace App\Filament\Widgets\Tenant;

use App\Models\OperationRun;
use App\Models\ReviewPack;
use App\Models\Tenant;
use App\Models\User;
use App\Services\ReviewPackService;
use App\Support\Auth\Capabilities;
use App\Support\OperationRunLinks;
use App\Support\OperationRunType;
use App\Support\OpsUx\OperationUxPresenter;
use App\Support\OpsUx\OpsUxBrowserEvents;
use App\Support\ReviewPackStatus;
use Filament\Actions\Action;
use Filament\Facades\Filament;
use Filament\Widgets\Widget;

class TenantReviewPackCard extends Widget
{
    private const string ACTIVE_POLLING_INTERVAL = '10s';

    protected static bool $isLazy = false;

    protected string $view = 'filament.widgets.tenant.tenant-review-pack-card';

    public ?Tenant $record = null;

    private function resolveTenant(): ?Tenant
    {
        $tenant = Filament::getTenant();

        if ($tenant instanceof Tenant) {
            return $tenant;
        }

        return $this->record instanceof Tenant ? $this->record : null;
    }

    public function generatePack(bool $includePii = true, bool $includeOperations = true): void
    {
        $user = auth()->user();

        if (! $user instanceof User) {
            abort(403);
        }

        $tenant = $this->resolveTenant();

        if (! $tenant instanceof Tenant) {
            abort(404);
        }

        if (! $user->canAccessTenant($tenant)) {
            abort(404);
        }

        if (! $user->can(Capabilities::REVIEW_PACK_MANAGE, $tenant)) {
            abort(403);
        }

        /** @var ReviewPackService $service */
        $service = app(ReviewPackService::class);

        $activeRun = $service->checkActiveRun($tenant)
            ? OperationRun::query()
                ->where('tenant_id', (int) $tenant->getKey())
                ->where('type', OperationRunType::ReviewPackGenerate->value)
                ->active()
                ->orderByDesc('id')
                ->first()
            : null;

        if ($activeRun) {
            OpsUxBrowserEvents::dispatchRunEnqueued($this);

            OperationUxPresenter::alreadyQueuedToast((string) $activeRun->type)
                ->body('A review pack is already queued or running for this tenant.')
                ->actions([
                    Action::make('view_run')
                        ->label('Open operation')
                        ->url(OperationRunLinks::tenantlessView($activeRun)),
                ])
                ->send();

            return;
        }

        $reviewPack = $service->generate($tenant, $user, [
            'include_pii' => $includePii,
            'include_operations' => $includeOperations,
        ]);

        $runUrl = $reviewPack->operationRun
            ? OperationRunLinks::tenantlessView($reviewPack->operationRun)
            : null;

        OpsUxBrowserEvents::dispatchRunEnqueued($this);

        $toast = OperationUxPresenter::queuedToast(OperationRunType::ReviewPackGenerate->value)
            ->body('The pack will be generated in the background. You will be notified when it is ready.');

        if ($runUrl !== null) {
            $toast->actions([
                Action::make('view_run')
                    ->label('Open operation')
                    ->url($runUrl),
            ]);
        }

        $toast->send();
    }

    /**
     * @return array<string, mixed>
     */
    protected function getViewData(): array
    {
        $tenant = $this->resolveTenant();

        if (! $tenant instanceof Tenant) {
            return $this->emptyState();
        }

        $user = auth()->user();
        $isTenantMember = $user instanceof User && $user->canAccessTenant($tenant);
        $canView = $isTenantMember && $user->can(Capabilities::REVIEW_PACK_VIEW, $tenant);
        $canManage = $isTenantMember && $user->can(Capabilities::REVIEW_PACK_MANAGE, $tenant);

        $latestPack = ReviewPack::query()
            ->with('tenantReview')
            ->where('tenant_id', (int) $tenant->getKey())
            ->orderByDesc('created_at')
            ->orderByDesc('id')
            ->first();

        if (! $latestPack instanceof ReviewPack) {
            return [
                'tenant' => $tenant,
                'pack' => null,
                'statusEnum' => null,
                'pollingInterval' => null,
                'canView' => $canView,
                'canManage' => $canManage,
                'downloadUrl' => null,
                'failedReason' => null,
                'reviewUrl' => null,
            ];
        }

        $statusEnum = ReviewPackStatus::tryFrom((string) $latestPack->status);

        $downloadUrl = null;
        if ($statusEnum === ReviewPackStatus::Ready && $canView) {
            /** @var ReviewPackService $service */
            $service = app(ReviewPackService::class);
            $downloadUrl = $service->generateDownloadUrl($latestPack);
        }

        $reviewUrl = null;
        if ($latestPack->tenantReview && $canView) {
            $reviewUrl = \App\Filament\Resources\TenantReviewResource::tenantScopedUrl('view', ['record' => $latestPack->tenantReview], $tenant);
        }

        $failedReason = null;
        if ($statusEnum === ReviewPackStatus::Failed && $latestPack->operationRun) {
            $opContext = is_array($latestPack->operationRun->context) ? $latestPack->operationRun->context : [];
            $failedReason = (string) ($opContext['reason_code'] ?? 'Unknown error');
        }

        return [
            'tenant' => $tenant,
            'pack' => $latestPack,
            'statusEnum' => $statusEnum,
            'pollingInterval' => self::resolvePollingInterval($latestPack),
            'canView' => $canView,
            'canManage' => $canManage,
            'downloadUrl' => $downloadUrl,
            'failedReason' => $failedReason,
            'reviewUrl' => $reviewUrl,
        ];
    }

    public static function resolvePollingInterval(?ReviewPack $pack): ?string
    {
        $status = ReviewPackStatus::tryFrom((string) $pack?->status);

        return match ($status) {
            ReviewPackStatus::Queued, ReviewPackStatus::Generating => self::ACTIVE_POLLING_INTERVAL,
            default => null,
        };
    }

    /**
     * @return array<string, mixed>
     */
    private function emptyState(): array
    {
        return [
            'tenant' => null,
            'pack' => null,
            'statusEnum' => null,
            'pollingInterval' => null,
            'canView' => false,
            'canManage' => false,
            'downloadUrl' => null,
            'failedReason' => null,
            'reviewUrl' => null,
        ];
    }
}