feat: initial version

Signed-off-by: Sebastian Krupinski <root@LAPTOP-7DVOR6NC>

lib/Service/Remote/Command/UnseenCriteria.php

@@ -0,0 +1,26 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-FileCopyrightText: Sebastian Krupinski <krupinski01@gmail.com>
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+namespace KTXM\ProviderImapMail\Service\Remote\Command;
+
+use Gricob\IMAP\Protocol\Command\Argument\Search\Criteria;
+
+/**
+ * IMAP UNSEEN search criteria.
+ *
+ * gricob does not include an UNSEEN criteria; this thin class fills the gap.
+ * Used with SearchCommand to count unread messages via SEARCH UNSEEN.
+ */
+final readonly class UnseenCriteria implements Criteria
+{
+    public function __toString(): string
+    {
+        return 'UNSEEN';
+    }
+}