feat: make unit test for checking imap quotas

Author: Sn0wCrack

src/FolderInterface.php

@@ -59,7 +59,7 @@ public function select(bool $force = false): void;
     /**
      * Get the folder's quotas
      * 
-     * @return array{STORAGE: array{usage: int|null, limit: int|null}, MESSAGES: array{usage: int|null, limit: int|null}, usage: int|null, limit: int|null}
+     * @return array{STORAGE: array{usage: int|null, limit: int|null}, MESSAGE: array{usage: int|null, limit: int|null}, usage: int|null, limit: int|null}
      */
     public function quota(): array;
 

src/Testing/FakeFolder.php

@@ -142,7 +142,7 @@ public function expunge(): array
     public function quota(): array
     {
         return [
-            'MESSAGES' => [
+            'MESSAGE' => [
                 'usage' => 0,
                 'limit' => 0,
             ],

tests/Integration/FoldersTest.php

@@ -109,4 +109,5 @@
     expect($folder->quota())
         ->toBeArray()
         ->toHaveKeys(['STORAGE', 'MESSAGE', 'usage', 'limit']);
-});
+})
+->skip(true, 'Greenamil does not properly support IMAP quotas currently.');

tests/Unit/FolderTest.php

@@ -1,5 +1,7 @@
 <?php
 
+use DirectoryTree\ImapEngine\Connection\ImapConnection;
+use DirectoryTree\ImapEngine\Exceptions\ImapCapabilityException;
 use DirectoryTree\ImapEngine\Folder;
 use DirectoryTree\ImapEngine\Mailbox;
 
@@ -50,3 +52,59 @@
     // The name should remain unchanged.
     expect($mixedFolder->name())->toBe($mixedUtf8FolderName);
 });
+
+test('it returns quota data for the mailbox', function () {
+    $mailbox = Mailbox::make([
+        'username' => 'foo',
+        'password' => 'bar',
+    ]);
+
+    $mailbox->connect(ImapConnection::fake([
+        '* OK Welcome to IMAP',
+        'TAG1 OK Logged in',
+        '* LIST (\\HasNoChildren) "/" "INBOX"',
+        'TAG2 OK LIST completed',
+        '* CAPABILITY IMAP4rev1 LITERAL+ UIDPLUS SORT IDLE MOVE QUOTA',
+        'TAG3 OK CAPABILITY completed',
+        '* QUOTA "INBOX" (STORAGE 54 512)',
+        '* QUOTA "INBOX" (MESSAGE 12 1024)',
+        'TAG4 OK GETQUOTAROOT completed',
+    ]));
+
+    expect($mailbox->inbox()->quota())
+        ->toBeArray()
+        ->toHaveKeys(['STORAGE', 'MESSAGE', 'usage', 'limit'])
+        ->toMatchArray([
+            'STORAGE' => [
+                'usage' => 54,
+                'limit' => 512,
+            ],
+            'MESSAGE' => [
+                'usage' => 12,
+                'limit' => 1024,
+            ],
+            'usage' => 54,
+            'limit' => 512,
+        ]);
+});
+
+test('it throws an imap capability exception when inspecting quotas when the imap server does not support quotas', function () {
+    $mailbox = Mailbox::make([
+        'username' => 'foo',
+        'password' => 'bar',
+    ]);
+
+    $mailbox->connect(ImapConnection::fake([
+        '* OK Welcome to IMAP',
+        'TAG1 OK Logged in',
+        '* LIST (\\HasNoChildren) "/" "INBOX"',
+        'TAG2 OK LIST completed',
+        '* CAPABILITY IMAP4rev1 LITERAL+ UIDPLUS SORT IDLE MOVE',
+        'TAG3 OK CAPABILITY completed',
+        '* QUOTA "INBOX" (STORAGE 54 512)',
+        '* QUOTA "INBOX" (MESSAGE 12 1024)',
+        'TAG4 OK GETQUOTAROOT completed',
+    ]));
+
+    $mailbox->inbox()->quota();
+})->throws(ImapCapabilityException::class);