feat: initial version

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

lib/Service/Remote/Command/StoreCommand.php

@@ -0,0 +1,39 @@
+<?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\Command;
+use Gricob\IMAP\Protocol\Command\Argument\SequenceSet;
+use Gricob\IMAP\Protocol\Command\Argument\Store\Flags;
+
+/**
+ * Bulk UID STORE command for flag mutations.
+ *
+ * A thin ergonomic wrapper around gricob's FetchCommand that accepts an array
+ * of UIDs and a pre-built Flags argument so callers don't have to construct
+ * SequenceSet directly.
+ *
+ * Example:  UID STORE 1,3,7 +FLAGS.SILENT (\Seen)
+ */
+final readonly class StoreCommand extends Command
+{
+    /**
+     * @param int[]  $uids    UIDs to operate on
+     * @param Flags  $flags   e.g. new Flags(['\Seen'], '+')
+     */
+    public function __construct(array $uids, Flags $flags)
+    {
+        parent::__construct(
+            'UID STORE',
+            new SequenceSet(...$uids),
+            $flags,
+        );
+    }
+}