<?php

declare(strict_types=1);

namespace App\Support\Health\Checks;

use App\Models\Media;
use App\Support\Health\Check;
use App\Support\Health\Finding;
use App\Support\Health\Severity;

/**
 * Images the site is publishing a URL for that no longer exist.
 *
 * The API keeps serving the path — it has no reason to doubt it — so the
 * result is a broken image on the public site and nothing at all in the panel,
 * where the record still looks complete. A file goes missing when a disk is
 * changed, a deploy wipes storage, or somebody tidies up by hand.
 *
 * Failures recorded by the processor count here too: an image it could not
 * read is one no visitor will see either.
 */
class BrokenImages implements Check
{
    public function key(): string
    {
        return 'broken-images';
    }

    public function permission(): ?string
    {
        return null;
    }

    public function run(): Finding
    {
        $count = 0;
        $samples = [];

        // Only what has been looked at: an image still queued is not broken,
        // it is early, and StalledMediaQueue is the check for that.
        foreach (Media::query()->whereNotNull('processed_at')->get() as $media) {
            if ($media->error !== null || ! $media->exists()) {
                $count++;
                $samples[] = $media->path;
            }
        }

        return Finding::problem($this->key(), $count, Severity::Error, samples: $samples);
    }
}