forge/app/Models/Mod.php

<?php

namespace App\Models;

use App\Http\Filters\V1\QueryFilter;
use App\Models\Scopes\DisabledScope;
use App\Models\Scopes\PublishedScope;
use Illuminate\Database\Eloquent\Builder;
use Illuminate\Database\Eloquent\Casts\Attribute;
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;
use Illuminate\Database\Eloquent\Relations\HasMany;
use Illuminate\Database\Eloquent\Relations\HasOne;
use Illuminate\Database\Eloquent\SoftDeletes;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Str;
use Laravel\Scout\Searchable;

/**
 * @property int $id
 * @property string $name
 * @property string $slug
 */
class Mod extends Model
{
    use HasFactory, Searchable, SoftDeletes;

    /**
     * Post boot method to configure the model.
     */
    protected static function booted(): void
    {
        // Apply the global scope to exclude disabled mods.
        static::addGlobalScope(new DisabledScope);

        // Apply the global scope to exclude non-published mods.
        static::addGlobalScope(new PublishedScope);
    }

    /**
     * The relationship between a mod and its users.
     */
    public function users(): BelongsToMany
    {
        return $this->belongsToMany(User::class);
    }

    /**
     * The relationship between a mod and its license.
     */
    public function license(): BelongsTo
    {
        return $this->belongsTo(License::class);
    }

    /**
     * The relationship between a mod and its versions.
     */
    public function versions(): HasMany
    {
        return $this->hasMany(ModVersion::class)
            ->whereHas('sptVersions')
            ->orderByDesc('version');
    }

    /**
     * Scope a query to include the total number of downloads for a mod.
     */
    public function scopeWithTotalDownloads($query)
    {
        return $query->addSelect([
            'total_downloads' => ModVersion::selectRaw('SUM(downloads) AS total_downloads')
                ->whereColumn('mod_id', 'mods.id'),
        ]);
    }

    /**
     * The relationship between a mod and its last updated version.
     */
    public function lastUpdatedVersion(): HasOne
    {
        return $this->hasOne(ModVersion::class)
            ->whereHas('sptVersions')
            ->orderByDesc('updated_at');
    }

    /**
     * The data that is searchable by Scout.
     */
    public function toSearchableArray(): array
    {
        return [
            'id' => $this->id,
            'name' => $this->name,
            'slug' => $this->slug,
            'description' => $this->description,
            'thumbnail' => $this->thumbnail,
            'featured' => $this->featured,
            'created_at' => strtotime($this->created_at),
            'updated_at' => strtotime($this->updated_at),
            'published_at' => strtotime($this->published_at),
            'latestVersion' => $this->latestVersion()?->first()?->latestSptVersion()?->first()?->version_formatted,
            'latestVersionColorClass' => $this->latestVersion()?->first()?->latestSptVersion()?->first()?->color_class,
        ];
    }

    /**
     * The relationship to the latest mod version, dictated by the mod version number.
     */
    public function latestVersion(): HasOne
    {
        return $this->hasOne(ModVersion::class)
            ->whereHas('sptVersions')
            ->orderByDesc('version')
            ->orderByDesc('updated_at')
            ->take(1);
    }

    /**
     * Determine if the model instance should be searchable.
     */
    public function shouldBeSearchable(): bool
    {
        // Ensure the mod is not disabled.
        if ($this->disabled) {
            return false;
        }

        // Ensure the mod has a publish date.
        if (is_null($this->published_at)) {
            return false;
        }

        // Fetch the latest version instance.
        $latestVersion = $this->latestVersion()?->first();

        // Ensure the mod has a latest version.
        if (is_null($latestVersion)) {
            return false;
        }

        // Ensure the latest version has a latest SPT version.
        if ($latestVersion->latestSptVersion()->doesntExist()) {
            return false;
        }

        // All conditions are met; the mod should be searchable.
        return true;
    }

    /**
     * Build the URL to the mod's thumbnail.
     */
    public function thumbnailUrl(): Attribute
    {
        return Attribute::get(function (): string {
            return $this->thumbnail
                ? Storage::disk($this->thumbnailDisk())->url($this->thumbnail)
                : '';
        });
    }

    /**
     * Get the disk where the thumbnail is stored based on the current environment.
     */
    protected function thumbnailDisk(): string
    {
        return match (config('app.env')) {
            'production' => 'r2', // Cloudflare R2 Storage
            default => 'public', // Local
        };
    }

    /**
     * Scope a query by applying QueryFilter filters.
     */
    public function scopeFilter(Builder $builder, QueryFilter $filters): Builder
    {
        return $filters->apply($builder);
    }

    /**
     * Build the URL to the mod's detail page.
     */
    public function detailUrl(): string
    {
        return route('mod.show', [$this->id, $this->slug]);
    }

    /**
     * The attributes that should be cast to native types.
     */
    protected function casts(): array
    {
        return [
            'featured' => 'boolean',
            'contains_ai_content' => 'boolean',
            'contains_ads' => 'boolean',
            'disabled' => 'boolean',
        ];
    }

    /**
     * Mutate the slug attribute to always be lower case on get and slugified on set.
     */
    protected function slug(): Attribute
    {
        return Attribute::make(
            get: fn (string $value) => Str::lower($value),
            set: fn (string $value) => Str::slug($value),
        );
    }
}