<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Attributes\Fillable;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsToMany;

/**
 * Versioned legal document (Terms of Use, Privacy Policy, Cookie Policy).
 *
 * Bodies are stored per language so that the UI can render the version
 * matching the user's selected locale at acceptance time.
 */
#[Fillable(['type', 'version', 'title', 'body', 'is_current', 'published_at'])]
class LegalDocument extends Model
{
    /**
     * Document type: Terms of Use.
     *
     * @var string
     */
    public const TYPE_TERMS = 'terms';

    /**
     * Document type: Privacy Policy (LGPD).
     *
     * @var string
     */
    public const TYPE_PRIVACY = 'privacy';

    /**
     * Document type: Cookie Policy.
     *
     * @var string
     */
    public const TYPE_COOKIES = 'cookies';

    /**
     * Attributes that should be cast to native types.
     *
     * @return array<string, string>
     */
    protected function casts(): array
    {
        return [
            'title' => 'array',
            'body' => 'array',
            'is_current' => 'boolean',
            'published_at' => 'datetime',
        ];
    }

    /**
     * Users that accepted this document version.
     *
     * @return BelongsToMany<User, $this>
     */
    public function users(): BelongsToMany
    {
        return $this->belongsToMany(User::class, 'user_consents')
            ->withPivot(['accepted_at', 'ip_address', 'user_agent', 'source'])
            ->withTimestamps();
    }
}