<?php

namespace App\Reports;

use App\Reports\Contracts\Report;
use Illuminate\Contracts\Pagination\LengthAwarePaginator;
use Illuminate\Database\Eloquent\Builder as EloquentBuilder;
use Illuminate\Database\Query\Builder as QueryBuilder;
use Illuminate\Http\Request;

abstract class BaseEloquentReport implements Report
{
    public function description(): ?string
    {
        return null;
    }

    public function authorize(Request $request): void
    {
        // Default: no extra checks. Controllers can gate via middleware.
    }

    /**
     * @param  array<string, mixed>  $filters
     */
    public function paginate(array $filters, int $perPage = 25): LengthAwarePaginator
    {
        /** @var EloquentBuilder|QueryBuilder $query */
        $query = $this->query($filters);

        return $query->paginate($perPage);
    }
}