provider_imap/lib/Client/Command/RenameCommand.php

<?php

declare(strict_types=1);

namespace KTXM\ProviderImap\Client\Command;

use KTXM\ProviderImap\Client\Command\Result\CommandStatusResult;
use KTXM\ProviderImap\Client\ImapException;
use KTXM\ProviderImap\Client\Protocol\RequestFrame;
use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
use KTXM\ProviderImap\Client\Protocol\ResponseStream;
use KTXM\ProviderImap\Client\SessionContext;
use KTXM\ProviderImap\Client\SessionState;

/**
 * @implements CommandInterface<CommandStatusResult>
 */
final class RenameCommand implements CommandInterface
{
    public function __construct(
        private readonly string $fromMailbox,
        private readonly string $toMailbox,
    ) {}

    public function name(): string
    {
        return 'RENAME';
    }

    public function allowedStates(): array
    {
        return [
            SessionState::Authenticated,
            SessionState::Selected,
        ];
    }

    public function encode(string $tag, SessionContext $context): RequestFrame
    {
        unset($tag, $context);

        return new RequestFrame(sprintf(
            'RENAME %s %s',
            $this->quote($this->fromMailbox),
            $this->quote($this->toMailbox),
        ));
    }

    public function handle(ResponseStream $responses, SessionContext $context): CommandStatusResult
    {
        foreach ($responses as $response) {
            if ($response instanceof TaggedResponse) {
                if (!$response->isOk()) {
                    throw new ImapException('RENAME failed: ' . $response->text());
                }

                if ($context->selectedMailbox() === $this->fromMailbox) {
                    $context->setSelectedMailbox($this->toMailbox);
                }

                return new CommandStatusResult($response->status(), $response->text());
            }
        }

        throw new ImapException('RENAME did not receive a tagged completion response.');
    }

    private function quote(string $value): string
    {
        return '"' . addcslashes($value, "\\\"") . '"';
    }
}