<?php

declare(strict_types=1);

namespace App\Models;

use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;

/**
 * Story — editorial content replacing the legacy Interviews module.
 *
 * @property int              $id
 * @property string           $slug
 * @property string           $title
 * @property string|null      $excerpt
 * @property string|null      $content
 * @property string|null      $cover_image
 * @property int|null         $author_id
 * @property int              $views
 * @property bool             $featured
 * @property string           $status   draft|published
 * @property \Carbon\Carbon|null $published_at
 * @property int|null         $legacy_interview_id
 */
class Story extends Model
{
    use HasFactory;

    protected $table = 'stories';

    protected $fillable = [
        'slug',
        'title',
        'excerpt',
        'content',
        'cover_image',
        'author_id',
        'views',
        'featured',
        'status',
        'published_at',
        'legacy_interview_id',
    ];

    protected $casts = [
        'featured'     => 'boolean',
        'published_at' => 'datetime',
        'views'        => 'integer',
    ];

    // ── Relations ────────────────────────────────────────────────────────

    public function author()
    {
        return $this->belongsTo(StoryAuthor::class, 'author_id');
    }

    public function tags()
    {
        return $this->belongsToMany(StoryTag::class, 'stories_tag_relation', 'story_id', 'tag_id');
    }

    // ── Scopes ───────────────────────────────────────────────────────────

    public function scopePublished($query)
    {
        return $query->where('status', 'published')
                     ->where(fn ($q) => $q->whereNull('published_at')->orWhere('published_at', '<=', now()));
    }

    public function scopeFeatured($query)
    {
        return $query->where('featured', true);
    }

    // ── Accessors ────────────────────────────────────────────────────────

    public function getUrlAttribute(): string
    {
        return url('/stories/' . $this->slug);
    }

    public function getCoverUrlAttribute(): ?string
    {
        if (! $this->cover_image) {
            return null;
        }

        return str_starts_with($this->cover_image, 'http') ? $this->cover_image : asset($this->cover_image);
    }

    /**
     * Estimated reading time in minutes based on word count.
     */
    public function getReadingTimeAttribute(): int
    {
        $wordCount = str_word_count(strip_tags((string) $this->content));

        return max(1, (int) ceil($wordCount / 200));
    }

    /**
     * Short excerpt for meta descriptions / cards.
     * Strips HTML, truncates to ~160 characters.
     */
    public function getMetaExcerptAttribute(): string
    {
        $text = $this->excerpt ?: strip_tags((string) $this->content);

        return \Illuminate\Support\Str::limit($text, 160);
    }
}