Introduce peek

Author: stevebauman

src/Connection/ConnectionInterface.php

@@ -78,12 +78,12 @@ public function uids(int|array $msgns): ResponseCollection;
     /**
      * Fetch message contents.
      */
-    public function contents(int|array $ids): ResponseCollection;
+    public function contents(int|array $ids, bool $peek = true): ResponseCollection;
 
     /**
      * Fetch message headers.
      */
-    public function headers(int|array $ids): ResponseCollection;
+    public function headers(int|array $ids, bool $peek = true): ResponseCollection;
 
     /**
      * Fetch message flags.

src/Connection/ImapConnection.php

@@ -282,17 +282,17 @@ public function uids(int|array $msgns): ResponseCollection
     /**
      * {@inheritDoc}
      */
-    public function contents(int|array $ids): ResponseCollection
+    public function contents(int|array $ids, bool $peek = true): ResponseCollection
     {
-        return $this->fetch(['BODY[TEXT]'], (array) $ids);
+        return $this->fetch([$peek ? 'BODY.PEEK[TEXT]' : 'BODY[TEXT]'], (array) $ids);
     }
 
     /**
      * {@inheritDoc}
      */
-    public function headers(int|array $ids): ResponseCollection
+    public function headers(int|array $ids, bool $peek = true): ResponseCollection
     {
-        return $this->fetch(['BODY[HEADER]'], (array) $ids);
+        return $this->fetch([$peek ? 'BODY.PEEK[HEADER]' : 'BODY[HEADER]'], (array) $ids);
     }
 
     /**