Merge pull request 'chore: standardize protocol' (#22) from chore/standardize-protocol into main

Reviewed-on: #22
This commit was merged in pull request #22.
This commit is contained in:
2026-02-14 16:54:35 +00:00

View File

@@ -23,8 +23,8 @@ use KTXF\Mail\Collection\CollectionMutableInterface;
interface ServiceCollectionMutableInterface extends ServiceBaseInterface { interface ServiceCollectionMutableInterface extends ServiceBaseInterface {
public const CAPABILITY_COLLECTION_CREATE = 'CollectionCreate'; public const CAPABILITY_COLLECTION_CREATE = 'CollectionCreate';
public const CAPABILITY_COLLECTION_MODIFY = 'CollectionModify'; public const CAPABILITY_COLLECTION_UPDATE = 'CollectionUpdate';
public const CAPABILITY_COLLECTION_DESTROY = 'CollectionDestroy'; public const CAPABILITY_COLLECTION_DELETE = 'CollectionDelete';
public const CAPABILITY_COLLECTION_MOVE = 'CollectionMove'; public const CAPABILITY_COLLECTION_MOVE = 'CollectionMove';
/** /**
@@ -50,29 +50,29 @@ interface ServiceCollectionMutableInterface extends ServiceBaseInterface {
public function collectionCreate(string|int|null $location, CollectionMutableInterface $collection, array $options = []): CollectionBaseInterface; public function collectionCreate(string|int|null $location, CollectionMutableInterface $collection, array $options = []): CollectionBaseInterface;
/** /**
* Modifies an existing collection * Updates an existing collection
* *
* @since 2025.05.01 * @since 2025.05.01
* *
* @param string|int $identifier Collection ID * @param string|int $identifier Collection ID
* @param CollectionMutableInterface $collection Updated collection data * @param CollectionMutableInterface $collection Updated collection data
* *
* @return CollectionBaseInterface Modified collection * @return CollectionBaseInterface Updated collection
*/ */
public function collectionModify(string|int $identifier, CollectionMutableInterface $collection): CollectionBaseInterface; public function collectionUpdate(string|int $identifier, CollectionMutableInterface $collection): CollectionBaseInterface;
/** /**
* Destroys a collection * Deletes a collection
* *
* @since 2025.05.01 * @since 2025.05.01
* *
* @param string|int $identifier Collection ID * @param string|int $identifier Collection ID
* @param bool $force Force destruction even if not empty * @param bool $force Force deletion even if not empty
* @param bool $recursive Recursively destroy contents * @param bool $recursive Recursively delete contents
* *
* @return bool True if destroyed * @return bool True if deleted
*/ */
public function collectionDestroy(string|int $identifier, bool $force = false, bool $recursive = false): bool; public function collectionDelete(string|int $identifier, bool $force = false, bool $recursive = false): bool;
/** /**
* Moves a collection to a new parent * Moves a collection to a new parent