refactor: docs

Signed-off-by: Sebastian Krupinski <krupinski01@gmail.com>

shared/lib/Mail/Service/ServiceEntityMutableInterface.php

@@ -16,10 +16,9 @@ use KTXF\Resource\Identifier\CollectionIdentifier;
 use KTXF\Resource\Identifier\EntityIdentifier;
 
 /**
- * Mail Service Entity Mutable Interface
+ * Service Entity Mutable Interface
  * 
- * Optional interface for services that support entity CRUD operations.
- * Provides entity creation, modification, deletion, copying, moving, and flag management.
+ * Optional interface for services that support entity CRUD operations
  * 
  * @since 2025.05.01
  */
@@ -66,6 +65,20 @@ interface ServiceEntityMutableInterface {
      */
     public function entityModify(EntityIdentifier $target, MessagePropertiesMutableInterface $properties): EntityBaseInterface;
 
+    /**
+     * Patches an existing entity(ies) with partial data
+     *
+     * @since 2025.05.01
+     *
+     * @param MessagePropertiesMutableInterface $properties Partial entity properties
+     * @param EntityIdentifier ...$targets Source entities to patch
+     *
+     * @return array<string, array{
+     *     disposition: 'patched'|'error'
+     * }> Results keyed by source entity identifier
+     */
+    public function entityPatch(MessagePropertiesMutableInterface $properties, EntityIdentifier ...$targets): array;
+
     /**
      * Deletes entities
      *
@@ -81,20 +94,6 @@ interface ServiceEntityMutableInterface {
      */
     public function entityDelete(EntityIdentifier ...$targets): array;
 
-    /**
-     * Patches an existing entity(ies) with partial data
-     *
-     * @since 2025.05.01
-     *
-     * @param MessagePropertiesMutableInterface $properties Partial entity properties
-     * @param EntityIdentifier ...$targets Source entities to patch
-     *
-     * @return array<string, array{
-     *     disposition: 'patched'|'error'
-     * }> Results keyed by source entity identifier
-     */
-    public function entityPatch(MessagePropertiesMutableInterface $properties, EntityIdentifier ...$targets): array;
-
     /**
      * Moves entities to another collection
      *