Response.php

<?php

declare(strict_types=1);

namespace Flasher\Symfony\Http;

use Flasher\Prime\Http\ResponseInterface;
use Symfony\Component\HttpFoundation\JsonResponse;
use Symfony\Component\HttpFoundation\Response as SymfonyResponse;

/**
 * Response - Adapter for Symfony's HTTP response.
 *
 * This class implements PHPFlasher's ResponseInterface for Symfony's HTTP response,
 * providing a consistent interface for response manipulation regardless of the framework.
 * It allows PHPFlasher to work with Symfony responses in a framework-agnostic way.
 *
 * Design patterns:
 * - Adapter Pattern: Adapts framework-specific response to PHPFlasher's interface
 * - Decorator Pattern: Adds PHPFlasher-specific functionality to response objects
 * - Composition: Uses composition to delegate to the underlying response object
 */
final readonly class Response implements ResponseInterface
{
    /**
     * Creates a new Response adapter.
     *
     * @param SymfonyResponse $response The underlying Symfony response object
     */
    public function __construct(private SymfonyResponse $response)
    {
    }

    public function isRedirection(): bool
    {
        return $this->response->isRedirection();
    }

    public function isJson(): bool
    {
        return $this->response instanceof JsonResponse;
    }

    public function isHtml(): bool
    {
        $contentType = $this->response->headers->get('Content-Type');

        if (!\is_string($contentType)) {
            return false;
        }

        return false !== stripos($contentType, 'html');
    }

    public function isAttachment(): bool
    {
        $contentDisposition = $this->response->headers->get('Content-Disposition', '');

        if (!$contentDisposition) {
            return false;
        }

        return false !== stripos($contentDisposition, 'attachment;');
    }

    public function isSuccessful(): bool
    {
        return $this->response->isSuccessful();
    }

    public function getContent(): string
    {
        return $this->response->getContent() ?: '';
    }

    public function setContent(string $content): void
    {
        $this->response->setContent($content);
    }

    public function hasHeader(string $key): bool
    {
        return $this->response->headers->has($key);
    }

    public function getHeader(string $key): ?string
    {
        return $this->response->headers->get($key);
    }

    public function setHeader(string $key, array|string|null $values): void
    {
        $this->response->headers->set($key, $values);
    }

    public function removeHeader(string $key): void
    {
        $this->response->headers->remove($key);
    }
}