refactor: re-organize files

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>

lib/Client/Client.php

@@ -4,11 +4,14 @@ declare(strict_types=1);
 
 namespace KTXM\ProviderImap\Client;
 
-use KTXM\ProviderImap\Client\Command\CapabilityCommand;
-use KTXM\ProviderImap\Client\Command\CommandInterface;
-use KTXM\ProviderImap\Client\FetchTarget;
-use KTXM\ProviderImap\Client\Command\LoginCommand;
-use KTXM\ProviderImap\Client\Command\StartTlsCommand;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
+
+use KTXM\ProviderImap\Client\Protocol\Command\CapabilityCommand;
+use KTXM\ProviderImap\Client\Protocol\Command\CommandInterface;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
+use KTXM\ProviderImap\Client\Protocol\Command\LoginCommand;
+use KTXM\ProviderImap\Client\Protocol\Command\StartTlsCommand;
 use KTXM\ProviderImap\Client\Protocol\CommandExecutor;
 use KTXM\ProviderImap\Client\Protocol\ProtocolReader;
 use KTXM\ProviderImap\Client\Protocol\ProtocolWriter;
@@ -87,7 +90,7 @@ final class Client implements ClientInterface
         return $this->executor->perform($command, $this->session);
     }
 
-    public function download(FetchTarget $target, string $section, int $chunkSize = 8192): \Generator
+    public function download(MessageTarget $target, string $section, int $chunkSize = 8192): \Generator
     {
         if ($this->session === null || $this->executor === null) {
             throw new ImapException('IMAP client is not connected.');

lib/Client/ClientInterface.php

@@ -4,8 +4,8 @@ declare(strict_types=1);
 
 namespace KTXM\ProviderImap\Client;
 
-use KTXM\ProviderImap\Client\Command\CommandInterface;
-use KTXM\ProviderImap\Client\FetchTarget;
+use KTXM\ProviderImap\Client\Protocol\Command\CommandInterface;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
 
 interface ClientInterface
 {
@@ -28,5 +28,5 @@ interface ClientInterface
      *
      * @return \Generator<string>  raw (transfer-encoded) bytes from the socket
      */
-    public function download(FetchTarget $target, string $section, int $chunkSize = 8192): \Generator;
+    public function download(MessageTarget $target, string $section, int $chunkSize = 8192): \Generator;
 }

lib/Client/IdentifierMode.php

@@ -1,16 +0,0 @@
-<?php
-
-declare(strict_types=1);
-
-namespace KTXM\ProviderImap\Client;
-
-enum IdentifierMode
-{
-    case Sequence;
-    case Uid;
-
-    public function toCommand(): string
-    {
-        return $this === self::Uid ? 'UID FETCH' : 'FETCH';
-    }
-}

lib/Client/Mailbox.php

@@ -4,7 +4,7 @@ declare(strict_types=1);
 
 namespace KTXM\ProviderImap\Client;
 
-use KTXM\ProviderImap\Client\Command\Result\StatusResult;
+use KTXM\ProviderImap\Client\Result\StatusResult;
 
 final class Mailbox
 {

lib/Client/Protocol/Command/AppendCommand.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\Response\ContinuationResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * APPEND a raw RFC822 message to a mailbox (RFC 3501 §6.3.11).

lib/Client/Protocol/Command/Argument/FetchOptions.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client;
+namespace KTXM\ProviderImap\Client\Protocol\Command\Argument;
 
 final class FetchOptions
 {

lib/Client/Protocol/Command/Argument/ListReturnOptions.php

@@ -2,7 +2,9 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client;
+namespace KTXM\ProviderImap\Client\Protocol\Command\Argument;
+
+use KTXM\ProviderImap\Client\ImapException;
 
 final class ListReturnOptions
 {

lib/Client/Protocol/Command/Argument/ListSelectionOptions.php

@@ -2,7 +2,9 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client;
+namespace KTXM\ProviderImap\Client\Protocol\Command\Argument;
+
+use KTXM\ProviderImap\Client\ImapException;
 
 final class ListSelectionOptions
 {

lib/Client/Protocol/Command/Argument/MessageTarget.php

@@ -2,9 +2,12 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client;
+namespace KTXM\ProviderImap\Client\Protocol\Command\Argument;
 
-final class FetchTarget
+use KTXM\ProviderImap\Client\Protocol\SequenceSet;
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
+
+final class MessageTarget
 {
     private function __construct(
         private readonly SequenceSet $sequenceSet,
@@ -36,11 +39,6 @@ final class FetchTarget
         return $this->identifierMode;
     }
 
-    public function toCommand(): string
-    {
-        return $this->identifierMode->toCommand();
-    }
-
     private static function coerceSequenceSet(int|string|SequenceSet $target): SequenceSet
     {
         return match (true) {

lib/Client/Protocol/Command/Argument/SearchCriteriaBuilder.php

@@ -2,7 +2,9 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client;
+namespace KTXM\ProviderImap\Client\Protocol\Command\Argument;
+
+use KTXM\ProviderImap\Client\Protocol\SequenceSet;
 
 use DateTimeInterface;
 use InvalidArgumentException;

lib/Client/Protocol/Command/CapabilityCommand.php

@@ -2,16 +2,16 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\CapabilityResult;
+use KTXM\ProviderImap\Client\Result\CapabilityResult;
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<CapabilityResult>

lib/Client/Protocol/Command/CommandInterface.php

@@ -2,12 +2,12 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @template TResult

lib/Client/Protocol/Command/CopyCommand.php

@@ -2,14 +2,14 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\MessageTransferResult;
-use KTXM\ProviderImap\Client\FetchTarget;
+use KTXM\ProviderImap\Client\Result\MessageTransferResult;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SequenceSet;
-use KTXM\ProviderImap\Client\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SequenceSet;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
 
 /**
  * @implements CommandInterface<MessageTransferResult>
@@ -19,7 +19,7 @@ final class CopyCommand implements CommandInterface
     private readonly MessageTransferCommand $command;
 
     public function __construct(
-        FetchTarget|string|SequenceSet|null $target = null,
+        MessageTarget|string|SequenceSet|null $target = null,
         string $destinationMailbox = '',
     ) {
         $this->command = new MessageTransferCommand('COPY', $target, $destinationMailbox);

lib/Client/Protocol/Command/CreateCommand.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\CommandStatusResult;
+use KTXM\ProviderImap\Client\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;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<CommandStatusResult>

lib/Client/Protocol/Command/DeleteCommand.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\CommandStatusResult;
+use KTXM\ProviderImap\Client\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;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<CommandStatusResult>

lib/Client/Protocol/Command/ExpungeCommand.php

@@ -2,18 +2,18 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\FetchTarget;
-use KTXM\ProviderImap\Client\IdentifierMode;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SequenceSet;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SequenceSet;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<list<int>>
@@ -22,7 +22,7 @@ final class ExpungeCommand implements CommandInterface
 {
     private readonly ?SequenceSet $sequenceSet;
 
-    public function __construct(FetchTarget|string|SequenceSet|null $target = null)
+    public function __construct(MessageTarget|string|SequenceSet|null $target = null)
     {
         if ($target === null) {
             $this->sequenceSet = null;
@@ -31,9 +31,9 @@ final class ExpungeCommand implements CommandInterface
         }
 
         $resolvedTarget = match (true) {
-            $target instanceof FetchTarget => $target,
-            $target instanceof SequenceSet => FetchTarget::sequence($target),
-            is_string($target) => FetchTarget::sequence($target),
+            $target instanceof MessageTarget => $target,
+            $target instanceof SequenceSet => MessageTarget::sequence($target),
+            is_string($target) => MessageTarget::sequence($target),
             default => null,
         };
 

lib/Client/Protocol/Command/FetchManyCommand.php

@@ -2,34 +2,37 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
+
+use KTXM\ProviderImap\Client\Protocol\Parser\FetchResponseParser;
 use Generator;
-use KTXM\ProviderImap\Client\FetchTarget;
-use KTXM\ProviderImap\Client\FetchOptions;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\FetchOptions;
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Message;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SequenceSet;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SequenceSet;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<Generator<int, Message>>
  */
 final class FetchManyCommand implements CommandInterface
 {
-    private readonly FetchTarget $target;
+    private readonly MessageTarget $target;
     private readonly FetchOptions $options;
 
-    public function __construct(FetchTarget|string|SequenceSet|null $target = null, ?FetchOptions $options = null)
+    public function __construct(MessageTarget|string|SequenceSet|null $target = null, ?FetchOptions $options = null)
     {
         $this->target = match (true) {
-            $target instanceof FetchTarget => $target,
-            $target instanceof SequenceSet => FetchTarget::sequence($target),
-            is_string($target) => FetchTarget::sequence($target),
-            default => FetchTarget::all(),
+            $target instanceof MessageTarget => $target,
+            $target instanceof SequenceSet => MessageTarget::sequence($target),
+            is_string($target) => MessageTarget::sequence($target),
+            default => MessageTarget::all(),
         };
         $this->options = $options ?? FetchOptions::default();
     }
@@ -50,7 +53,7 @@ final class FetchManyCommand implements CommandInterface
 
         return new RequestFrame(sprintf(
             '%s %s (%s)',
-            $this->target->toCommand(),
+            $this->target->identifierMode() === IdentifierMode::Uid ? 'UID FETCH' : 'FETCH',
             $this->target->sequenceSet()->toCommand(),
             $this->options->toCommand(),
         ));

lib/Client/Protocol/Command/FetchOneCommand.php

@@ -2,30 +2,33 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\FetchTarget;
-use KTXM\ProviderImap\Client\FetchOptions;
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
+
+use KTXM\ProviderImap\Client\Protocol\Parser\FetchResponseParser;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\FetchOptions;
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Message;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<Message>
  */
 final class FetchOneCommand implements CommandInterface
 {
-    private readonly FetchTarget $target;
+    private readonly MessageTarget $target;
     private readonly FetchOptions $options;
 
-    public function __construct(FetchTarget|int|string $target, ?FetchOptions $options = null)
+    public function __construct(MessageTarget|int|string $target, ?FetchOptions $options = null)
     {
-        $this->target = $target instanceof FetchTarget
+        $this->target = $target instanceof MessageTarget
             ? $target
-            : FetchTarget::sequence($target);
+            : MessageTarget::sequence($target);
         $this->options = $options ?? FetchOptions::default();
     }
 
@@ -45,7 +48,7 @@ final class FetchOneCommand implements CommandInterface
 
         return new RequestFrame(sprintf(
             '%s %s (%s)',
-            $this->target->toCommand(),
+            $this->target->identifierMode() === IdentifierMode::Uid ? 'UID FETCH' : 'FETCH',
             $this->target->sequenceSet()->toCommand(),
             $this->options->toCommand(),
         ));

lib/Client/Protocol/Command/ListCommand.php

@@ -2,19 +2,20 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
+use KTXM\ProviderImap\Client\Protocol\Parser\StatusResponseParser;
 use Generator;
 use KTXM\ProviderImap\Client\ImapException;
-use KTXM\ProviderImap\Client\ListReturnOptions;
-use KTXM\ProviderImap\Client\ListSelectionOptions;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\ListReturnOptions;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\ListSelectionOptions;
 use KTXM\ProviderImap\Client\Mailbox;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<Generator<int, Mailbox>>

lib/Client/Protocol/Command/LoginCommand.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\CommandStatusResult;
+use KTXM\ProviderImap\Client\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;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<CommandStatusResult>

lib/Client/Protocol/Command/LogoutCommand.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\CommandStatusResult;
+use KTXM\ProviderImap\Client\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;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<CommandStatusResult>

lib/Client/Protocol/Command/MessageTransferCommand.php

@@ -2,19 +2,19 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\MessageTransferResult;
-use KTXM\ProviderImap\Client\FetchTarget;
-use KTXM\ProviderImap\Client\IdentifierMode;
+use KTXM\ProviderImap\Client\Result\MessageTransferResult;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SequenceSet;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SequenceSet;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<MessageTransferResult>
@@ -27,14 +27,14 @@ final class MessageTransferCommand implements CommandInterface
 
     public function __construct(
         string $operation,
-        FetchTarget|string|SequenceSet|null $target = null,
+        MessageTarget|string|SequenceSet|null $target = null,
         private readonly string $destinationMailbox = '',
     ) {
         $resolvedTarget = match (true) {
-            $target instanceof FetchTarget => $target,
-            $target instanceof SequenceSet => FetchTarget::sequence($target),
-            is_string($target) => FetchTarget::sequence($target),
-            default => FetchTarget::all(),
+            $target instanceof MessageTarget => $target,
+            $target instanceof SequenceSet => MessageTarget::sequence($target),
+            is_string($target) => MessageTarget::sequence($target),
+            default => MessageTarget::all(),
         };
 
         $this->operation = strtoupper(trim($operation));

lib/Client/Protocol/Command/MoveCommand.php

@@ -2,14 +2,14 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\MessageTransferResult;
-use KTXM\ProviderImap\Client\FetchTarget;
+use KTXM\ProviderImap\Client\Result\MessageTransferResult;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SequenceSet;
-use KTXM\ProviderImap\Client\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SequenceSet;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
 
 /**
  * @implements CommandInterface<MessageTransferResult>
@@ -19,7 +19,7 @@ final class MoveCommand implements CommandInterface
     private readonly MessageTransferCommand $command;
 
     public function __construct(
-        FetchTarget|string|SequenceSet|null $target = null,
+        MessageTarget|string|SequenceSet|null $target = null,
         string $destinationMailbox = '',
     ) {
         $this->command = new MessageTransferCommand('MOVE', $target, $destinationMailbox);

lib/Client/Protocol/Command/NoopCommand.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\CommandStatusResult;
+use KTXM\ProviderImap\Client\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;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<CommandStatusResult>

lib/Client/Protocol/Command/RenameCommand.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\CommandStatusResult;
+use KTXM\ProviderImap\Client\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;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<CommandStatusResult>

lib/Client/Protocol/Command/SearchCommand.php

@@ -2,18 +2,18 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\SearchResult;
-use KTXM\ProviderImap\Client\IdentifierMode;
+use KTXM\ProviderImap\Client\Result\SearchResult;
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
 use KTXM\ProviderImap\Client\ImapException;
-use KTXM\ProviderImap\Client\SearchCriteriaBuilder;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\SearchCriteriaBuilder;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<SearchResult>

lib/Client/Protocol/Command/SelectCommand.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Mailbox;
@@ -10,8 +10,8 @@ use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<Mailbox>

lib/Client/Protocol/Command/SortCommand.php

@@ -2,18 +2,18 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\SortResult;
-use KTXM\ProviderImap\Client\IdentifierMode;
+use KTXM\ProviderImap\Client\Result\SortResult;
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SearchCriteriaBuilder;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\SearchCriteriaBuilder;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<SortResult>

lib/Client/Protocol/Command/StartTlsCommand.php

@@ -2,15 +2,15 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\CommandStatusResult;
+use KTXM\ProviderImap\Client\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;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<CommandStatusResult>

lib/Client/Protocol/Command/StatusCommand.php

@@ -2,16 +2,17 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\StatusResult;
+use KTXM\ProviderImap\Client\Protocol\Parser\StatusResponseParser;
+use KTXM\ProviderImap\Client\Result\StatusResult;
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<StatusResult>

lib/Client/Protocol/Command/StoreCommand.php

@@ -2,18 +2,18 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Command;
 
-use KTXM\ProviderImap\Client\Command\Result\CommandStatusResult;
-use KTXM\ProviderImap\Client\FetchTarget;
-use KTXM\ProviderImap\Client\IdentifierMode;
+use KTXM\ProviderImap\Client\Result\CommandStatusResult;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
 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\SequenceSet;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SequenceSet;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 
 /**
  * @implements CommandInterface<CommandStatusResult>
@@ -27,16 +27,16 @@ final class StoreCommand implements CommandInterface
      * @param list<string> $flags
      */
     public function __construct(
-        FetchTarget|string|SequenceSet|null $target = null,
+        MessageTarget|string|SequenceSet|null $target = null,
         private array $flags = [],
         private string $action = '',
         private bool $silent = true,
     ) {
         $resolvedTarget = match (true) {
-            $target instanceof FetchTarget => $target,
-            $target instanceof SequenceSet => FetchTarget::sequence($target),
-            is_string($target) => FetchTarget::sequence($target),
-            default => FetchTarget::all(),
+            $target instanceof MessageTarget => $target,
+            $target instanceof SequenceSet => MessageTarget::sequence($target),
+            is_string($target) => MessageTarget::sequence($target),
+            default => MessageTarget::all(),
         };
 
         $normalizedAction = trim($this->action);

lib/Client/Protocol/CommandExecutor.php

@@ -5,14 +5,14 @@ declare(strict_types=1);
 namespace KTXM\ProviderImap\Client\Protocol;
 
 use Generator;
-use KTXM\ProviderImap\Client\Command\CommandInterface;
-use KTXM\ProviderImap\Client\FetchTarget;
+use KTXM\ProviderImap\Client\Protocol\Command\CommandInterface;
+use KTXM\ProviderImap\Client\Protocol\Command\Argument\MessageTarget;
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\RequestFrame;
-use KTXM\ProviderImap\Client\SessionContext;
-use KTXM\ProviderImap\Client\SessionState;
+use KTXM\ProviderImap\Client\Protocol\SessionContext;
+use KTXM\ProviderImap\Client\Protocol\SessionState;
 use Psr\Log\LoggerInterface;
 
 final class CommandExecutor
@@ -62,7 +62,7 @@ final class CommandExecutor
      *
      * @return \Generator<string>  raw (transfer-encoded) bytes from the socket
      */
-    public function download(FetchTarget $target, string $section, int $chunkSize, SessionContext $context): \Generator
+    public function download(MessageTarget $target, string $section, int $chunkSize, SessionContext $context): \Generator
     {
         $this->assertState([SessionState::Selected], $context->state(), 'FETCH (download)');
 

lib/Client/Protocol/IdentifierMode.php

@@ -0,0 +1,11 @@
+<?php
+
+declare(strict_types=1);
+
+namespace KTXM\ProviderImap\Client\Protocol;
+
+enum IdentifierMode
+{
+    case Sequence;
+    case Uid;
+}

lib/Client/Protocol/Parser/FetchResponseParser.php

@@ -2,12 +2,12 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Parser;
 
 use Generator;
 use KTXM\ProviderImap\Client\ImapException;
 use KTXM\ProviderImap\Client\Message;
-use KTXM\ProviderImap\Client\MessageParser;
+use KTXM\ProviderImap\Client\Protocol\Parser\MessageParser;
 use KTXM\ProviderImap\Client\Protocol\Response\TaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\Response\UntaggedResponse;
 use KTXM\ProviderImap\Client\Protocol\ResponseStream;

lib/Client/Protocol/Parser/MessageParser.php

@@ -2,8 +2,12 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client;
+namespace KTXM\ProviderImap\Client\Protocol\Parser;
 
+use KTXM\ProviderImap\Client\ImapException;
+use KTXM\ProviderImap\Client\Message;
+use KTXM\ProviderImap\Client\MessageAddress;
+use KTXM\ProviderImap\Client\MessagePart;
 use DateTimeInterface;
 
 final class MessageParser

lib/Client/Protocol/Parser/StatusResponseParser.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command;
+namespace KTXM\ProviderImap\Client\Protocol\Parser;
 
 use KTXM\ProviderImap\Client\ImapException;
 

lib/Client/Protocol/SequenceSet.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client;
+namespace KTXM\ProviderImap\Client\Protocol;
 
 use InvalidArgumentException;
 

lib/Client/Protocol/SessionContext.php

@@ -2,7 +2,9 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client;
+namespace KTXM\ProviderImap\Client\Protocol;
+
+use KTXM\ProviderImap\Client\ConnectionConfig;
 
 use KTXM\ProviderImap\Client\Protocol\Response\GreetingResponse;
 use KTXM\ProviderImap\Client\Transport\ConnectionInterface;

lib/Client/Protocol/SessionState.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client;
+namespace KTXM\ProviderImap\Client\Protocol;
 
 enum SessionState: string
 {

lib/Client/Result/CapabilityResult.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command\Result;
+namespace KTXM\ProviderImap\Client\Result;
 
 final class CapabilityResult
 {

lib/Client/Result/CommandStatusResult.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command\Result;
+namespace KTXM\ProviderImap\Client\Result;
 
 final class CommandStatusResult
 {

lib/Client/Result/MessageTransferResult.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command\Result;
+namespace KTXM\ProviderImap\Client\Result;
 
 final class MessageTransferResult
 {

lib/Client/Result/SearchResult.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command\Result;
+namespace KTXM\ProviderImap\Client\Result;
 
-use KTXM\ProviderImap\Client\IdentifierMode;
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
 
 final class SearchResult
 {

lib/Client/Result/SortResult.php

@@ -2,9 +2,9 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command\Result;
+namespace KTXM\ProviderImap\Client\Result;
 
-use KTXM\ProviderImap\Client\IdentifierMode;
+use KTXM\ProviderImap\Client\Protocol\IdentifierMode;
 
 final class SortResult
 {

lib/Client/Result/StatusResult.php

@@ -2,7 +2,7 @@
 
 declare(strict_types=1);
 
-namespace KTXM\ProviderImap\Client\Command\Result;
+namespace KTXM\ProviderImap\Client\Result;
 
 final class StatusResult
 {