digitalcz / digisign

src/Endpoint/FilesEndpoint.php

<?php

declare(strict_types=1);

namespace DigitalCz\DigiSign\Endpoint;

use DigitalCz\DigiSign\DigiSign;
use DigitalCz\DigiSign\Endpoint\Traits\GetEndpointTrait;
use DigitalCz\DigiSign\Endpoint\Traits\ListEndpointTrait;
use DigitalCz\DigiSign\Resource\File;
use DigitalCz\DigiSign\Stream\FileResponse;
use DigitalCz\DigiSign\Stream\FileStream;

/**
 * @extends ResourceEndpoint<File>
 * @method File get(string $id)
 */
final class FilesEndpoint extends ResourceEndpoint
{
    /** @use ListEndpointTrait<File> */
    use ListEndpointTrait;
    use GetEndpointTrait;

    public function __construct(DigiSign $parent)
    {
        parent::__construct($parent, '/api/files', File::class);
    }

    public function upload(FileStream $file): File
    {
        return $this->makeResource($this->postRequest('', ['multipart' => ['file' => $file]]));

The expression return $this->makeResource($this->postRequest('', array('multipart' => array('file' => $file)))) returns the type DigitalCz\DigiSign\Resource\ResourceInterface which includes types incompatible with the type-hinted return DigitalCz\DigiSign\Resource\File.

    }

    public function content(string $id): FileResponse
    {
        return $this->stream(self::METHOD_GET, '/{id}/content', ['id' => $id]);
    }
}