<?php

namespace App\Http\Controllers\Api\V1;

use App\Http\Requests\V1\CityListRequest;
use App\Http\Resources\V1\CityResource;
use App\Http\Resources\V1\CityCollection;
use App\Services\CityDataService;
use App\Http\Controllers\Api\V1\ApiController;
use App\Libs\Api\ParsedListParams;

class CityController extends ApiController
{

    /**
     * Class constructor
     *
     * @param CityDataService $cityDataService
     * @return void
     */
    public function __construct(CityDataService $cityDataService)
    {
        $this->dataService = $cityDataService;
    }

    /**
     * Gets the list of cities
     * GET api/v1/cities
     * 
     * @return App\Http\Resources\V1\CityCollection
     */
    public function index(CityListRequest $request): CityCollection
    {

        $data              = $request->validated();
        $parsedListParams  = new ParsedListParams($data);
        $paginatedItems    = $this->dataService->list($parsedListParams);
        return new CityCollection($paginatedItems);
    }


    /**
     * Show entity for the given id
     * GET api/v1/cities/{id}
     * 
     * @param integer $id
     * 
     * @return App\Http\Resources\V1\CityResource
     */
    public function show(int $id): CityResource
    {
        $city = $this->dataService->find($id);
        return new CityResource($city);
    }
}