Merge pull request 'fix: comments' (#7) from fix/comments into main

Reviewed-on: #7

lib/Controllers/DefaultController.php

@@ -45,19 +45,6 @@ class DefaultController extends ControllerAbstract {
 		private readonly LoggerInterface $logger,
 	) {}
 
-	/**
-     * Main API endpoint for mail operations
-     * 
-     * Single operation:
-     *   {
-     *     "version": 1,
-     *     "transaction": "tx-1",
-     *     "operation": "entity.create",
-     *     "data": {...}
-     *   }
-     * 
-     * @return JsonResponse
-     */
 	#[AuthenticatedRoute('/v1', name: 'chrono.manager.v1', methods: ['POST'])]
     public function index(
         int $version,
@@ -184,7 +171,6 @@ class DefaultController extends ControllerAbstract {
 
     }
 
-
     // ==================== Service Operations =====================
 
     private function serviceList(string $tenantId, string $userId, array $data): mixed {

lib/Manager.php

@@ -587,21 +587,21 @@ class Manager {
         return $service->collectionDelete($collectionId, $force, $recursive);
     }
 
-    // ==================== Message Operations ====================
+    // ==================== Entity Operations ====================
 
     /**
-     * List messages in a collection
+     * List entities in a collection
      *
      * @since 2025.05.01
      *
      * @param string $tenantId Tenant identifier
      * @param string $userId User identifier
-     * @param SourceSelector $sources Message sources with collection identifiers
-     * @param array|null $filter Message filter
-     * @param array|null $sort Message sort
-     * @param array|null $range Message range/pagination
+     * @param SourceSelector $sources Entity sources with collection identifiers
+     * @param array|null $filter Entity filter
+     * @param array|null $sort Entity sort
+     * @param array|null $range Entity range/pagination
      *
-     * @return array<string, array<string|int, array<string|int, array<string|int, IMessageBase>>>> Messages grouped by provider/service/collection
+     * @return array<string, array<string|int, array<string|int, array<string|int, IEntityBase>>>> Entities grouped by provider/service/collection
      */
     public function entityList(string $tenantId, string $userId, SourceSelector $sources, array|null $filter = null, array|null $sort = null, array|null $range = null): array {
         // retrieve providers