<?php

namespace Modules\Api\Http\Controllers;

use App\Http\Controllers\Controller;
use App\Http\Controllers\Traits\AmiConnectionTrait;
use App\Http\Controllers\Traits\ParsingUtilitiesTrait;
use App\Http\Controllers\Traits\ChannelManagementTrait;
use App\Http\Controllers\Traits\QueueManagementTrait;
use App\Http\Controllers\Traits\AgentManagementTrait;
use App\Http\Controllers\Traits\DashboardTrait;
use Modules\Api\Traits\CompanyTrait;
use Modules\Api\Traits\RespondTrait;
use Modules\Platform\Core\Helper\SettingsHelper;
use Modules\Platform\Core\Helper\UserHelper;

/**
 * Dashboard API Controller
 *
 * Mobile/external counterpart of the web dashboard (AstmanController).
 *
 * It reuses the exact same trait implementations as the web controller, so
 * user access permissions and data restrictions are enforced identically on
 * both interfaces:
 *  - route middleware: auth:api + permission:reporting.browse (same gate as
 *    the web dashboard's AJAX endpoint, api/webform/ccDashboard), and
 *  - DashboardTrait::buildDashboardResponse() performs the same authorization
 *    and scoping (accessible queues via accessibleQueueIds(), the
 *    admin/company_manager/reporting.settings/reporting.browse gate for
 *    realtime data, access_to_all_entity user filtering, and the
 *    reporting.outbound.details gate for the outbound summary).
 *
 * Do not duplicate AMI/dashboard logic here - extend the shared traits in
 * app/Http/Controllers/Traits/ instead.
 *
 * @package Modules\Api\Http\Controllers
 */
class DashboardApiController extends Controller
{
    use RespondTrait, CompanyTrait;
    use AmiConnectionTrait;
    use ParsingUtilitiesTrait;
    use ChannelManagementTrait;
    use QueueManagementTrait;
    use AgentManagementTrait;
    use DashboardTrait;

    /**
     * Declared by DashboardTrait's dependencies; the AMI connection state
     * ($_urlraw, $_usermanager, $_secretmanager, $_authtype, $_debug,
     * $_result, ...) is provided by AmiConnectionTrait / ParsingUtilitiesTrait,
     * exactly as in AstmanController.
     */
    private $SettingsHelper;
    private $UserHelper;
    private $coreShowChannelsCache = null;

    public function __construct()
    {
        $this->SettingsHelper = new SettingsHelper();
        $this->UserHelper = new UserHelper();
        $this->middleware('jwt.auth')->except('login');
    }

    /**
     * Dashboard payload for API clients.
     *
     * The payload is built by the shared DashboardTrait::buildDashboardResponse()
     * - the same code path the web dashboard uses - so the API can never
     * return more (or other) data than the web interface shows to the same
     * user. The response keeps the standard API envelope.
     */
    public function dashboardAjax()
    {
        $user = auth()->user();

        if (!$user) {
            return $this->respond(false, [], [], 'User not authenticated', 401);
        }

        return $this->respond(
            true,
            $this->buildDashboardResponse(),
            [],
            'Dashboard data retrieved successfully'
        );
    }
}