Merge pull request #145 from DirectoryTree/larger-smaller-support

Add message larger/smaller query support

Author: stevebauman

src/Connection/ImapQueryBuilder.php

@@ -235,6 +235,22 @@ public function uid(int|string|array $from, int|float|null $to = null): static
         return $this->where(ImapSearchKey::Uid, new RawQueryValue(Str::set($from, $to)));
     }
 
+    /**
+     * Add a where "LARGER" clause to the query.
+     */
+    public function larger(int $bytes): static
+    {
+        return $this->where(ImapSearchKey::Larger, new RawQueryValue($bytes));
+    }
+
+    /**
+     * Add a where "SMALLER" clause to the query.
+     */
+    public function smaller(int $bytes): static
+    {
+        return $this->where(ImapSearchKey::Smaller, new RawQueryValue($bytes));
+    }
+
     /**
      * Add a "where" condition.
      */

src/Enums/ImapSearchKey.php

@@ -22,10 +22,12 @@ enum ImapSearchKey: string
     case Unseen = 'UNSEEN';
     case Before = 'BEFORE';
     case Header = 'HEADER';
+    case Larger = 'LARGER';
     case Deleted = 'DELETED';
     case Flagged = 'FLAGGED';
     case Keyword = 'KEYWORD';
     case Subject = 'SUBJECT';
+    case Smaller = 'SMALLER';
     case Answered = 'ANSWERED';
     case Undeleted = 'UNDELETED';
     case Unflagged = 'UNFLAGGED';

tests/Unit/Connection/ImapQueryBuilderTest.php

@@ -284,3 +284,19 @@ function (ImapQueryBuilder $q) {
 
     expect($builder->toImap())->toBe('UID 2');
 });
+
+test('compiles LARGER condition without quotes', function () {
+    expect((new ImapQueryBuilder)->larger(5242880)->toImap())->toBe('LARGER 5242880');
+});
+
+test('compiles SMALLER condition without quotes', function () {
+    expect((new ImapQueryBuilder)->smaller(10240)->toImap())->toBe('SMALLER 10240');
+});
+
+test('compiles LARGER and SMALLER conditions together', function () {
+    $builder = new ImapQueryBuilder;
+
+    $builder->larger(1024)->smaller(1048576);
+
+    expect($builder->toImap())->toBe('LARGER 1024 SMALLER 1048576');
+});