<?php

namespace App\Http\Controllers\Api;

use App\Http\Controllers\Controller;
use App\Support\AnalyticsSummary;
use Illuminate\Http\Request;
use Illuminate\Routing\Controllers\HasMiddleware;
use Illuminate\Routing\Controllers\Middleware;
use Laravel\Passport\Http\Middleware\CheckToken;
use OpenApi\Attributes as OA;

class AnalyticsController extends Controller implements HasMiddleware
{
    public static function middleware(): array
    {
        return [new Middleware(CheckToken::using('users:read'))];
    }

    #[OA\Get(
        path: '/analytics/summary',
        summary: 'Métricas de uso: logins por día, por app, usuarios más activos y actividad reciente',
        description: 'Requiere el permiso users.view (o un token client_credentials, que actúa como servicio de confianza).',
        security: [['oauth2' => ['users:read']]],
        tags: ['Analytics'],
        parameters: [
            new OA\Parameter(name: 'days', in: 'query', required: false, description: 'Ventana en días (7-90, default 30)', schema: new OA\Schema(type: 'integer')),
        ],
        responses: [
            new OA\Response(response: 200, description: 'Resumen de analíticas'),
            new OA\Response(response: 403, description: 'Sin permiso users.view'),
        ]
    )]
    public function summary(Request $request)
    {
        $actor = $request->user('api');
        abort_if($actor && ! $actor->can('users.view'), 403);

        $days = min(max((int) $request->integer('days', 30), 7), 90);

        return response()->json(AnalyticsSummary::build($days));
    }
}