<?php

namespace App\Models;

use ApiPlatform\Laravel\Eloquent\Filter\EqualsFilter;
use ApiPlatform\Metadata\ApiProperty;
use ApiPlatform\Metadata\ApiResource;
use ApiPlatform\Metadata\QueryParameter;
use App\Enums\LibraryEntryCompletionStatus;
use App\Enums\LibraryEntryStatus;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;

#[ApiResource(
    shortName: 'LibraryEntry',
    description: "A user's entry in their game library, representing their interaction with a specific game."
)]
#[ApiProperty(description: 'The unique identifier of the game associated with this library entry.', property: 'game_id')]
#[ApiProperty(description: 'The unique identifier of the user who owns this library entry.', types: 'integer', property: 'user_id')]
#[QueryParameter('current_user', filter: EqualsFilter::class, description: 'Filter library entries by the current authenticated user')]
#[QueryParameter('user_id', filter: EqualsFilter::class, description: 'Filter library entries by the associated user ID')]
#[QueryParameter('game_id', filter: EqualsFilter::class, description: 'Filter library entries by the associated game ID')]
class LibraryEntry extends Model
{
    protected $fillable = [
        'user_id',
        'game_id',
        'status',
        'completion_status',
        'owned',
        'edition_id',
        'platforms_ids',
        'start_date',
        'end_date',
        'played_time',
        'rating',
        'rating_details',
        'review',
    ];

    protected function casts(): array
    {
        return [
            'owned' => 'boolean',
            'platforms_ids' => 'array',
            'start_date' => 'date',
            'end_date' => 'date',
            'played_time' => 'timestamp',
            'rating' => 'float',
            'rating_details' => 'array',
            'status' => LibraryEntryStatus::class,
            'completion_status' => LibraryEntryCompletionStatus::class,
            'game_id' => 'int',
            'user_id' => 'integer'
        ];
    }

    public function user(): BelongsTo
    {
        return $this->belongsTo(User::class);
    }
}