Improved type information with psalm annotations on query and command buses

[butschster]

In this Pull Request, we have enriched the type information of query and command buses by integrating Psalm annotations. This enhancement facilitates developers by offering precise return type definitions for commands and queries.

Here's a snapshot of what has been done:

1. For commands, you can now clearly define the return type. Here is an example utilizing @implements CommandInterface<...> annotation:

use Spiral\Cqrs\CommandInterface;

/**
 * @implements CommandInterface<StoreUserResult>
 */
final readonly class StoreUserCommand implements CommandInterface
{
    public function __construct(
        public string $username,
        public string $email,
    ) {
    }
}

2. Similarly, for queries, the return type can be defined as shown in the UserListQuery class example below:

use Spiral\Cqrs\QueryInterface;

/**
 * @implements QueryInterface<UserListResult>
 */
final readonly class UserListQuery implements QueryInterface
{

}

With these annotations in place, your IDE will now provide suggestive autocomplete options, making the code interaction more intuitive and error-prone.

Here are examples showing how IDE suggestions would appear post this update:

$bus->ask(new UserListQuery())->...;

$bus->dispatch(new StoreUserCommand(...))->...;

This update aims to streamline the development process by providing clearer, type-informed interactions within the codebase.

[iGrog]

When do you plan it to merge to the master branch?

[butschster]

When do you plan it to merge to the master branch?

Done! Thx!