IBX-8736: Allowed to sent user notification via symfony/notifier

[adamwojs]

🎫 Issue	IBX-8736

Description:

Allowed to sent user notification via symfony/notifier package.

Basic notifications

Usage example:

use Ibexa\Contracts\Notifications\SystemNotification\SystemNotification;
use Ibexa\Contracts\Notifications\Value\Recipent\UserRecipient;

$user = $userService->loadUserByLogin('[email protected]')

$notification = new SystemNotification('Hello John!', ['ibexa']);
$notification->setIcon('bell');
$notification->setContent("It's works!");
$notification->setRoute(new RouteReference('ibexa.content.view', ['contentId' => 52]));

$notifier->send($notification, new UserRecipient($user));

Custom notification

It's possible to customize notification by implementing \Ibexa\Contracts\Notifications\SystemNotification\SystemNotificationInterface:

namespace Ibexa\Contracts\Notifications\SystemNotification;

use Ibexa\Contracts\Notifications\Value\Recipent\UserRecipientInterface;

interface SystemNotificationInterface
{
    public function asSystemNotification(
        UserRecipientInterface $recipient,
        ?string $transport = null
    ): ?SystemMessage;
}

Usage example:

<?php

declare(strict_types=1);

namespace App\Notification;

use Ibexa\Contracts\Notifications\SystemNotification\SystemMessage;
use Ibexa\Contracts\Notifications\SystemNotification\SystemNotificationInterface;
use Ibexa\Contracts\Notifications\Value\Recipent\UserRecipientInterface;
use Symfony\Component\Notifier\Notification\Notification;

final class WelcomeNotification extends Notification implements SystemNotificationInterface
{
    public function asSystemNotification(UserRecipientInterface $recipient, ?string $transport = null): ?SystemMessage
    {
        $message = new SystemMessage($recipient->getUser());
        $message->setType('welcome');
        $message->setContext([
            'subject' => $this->getSubject(),
            'content' => $this->getContent(),
        ]);

        return $message;
    }
}

use Ibexa\Contracts\Notifications\SystemNotification\SystemNotification;
use Ibexa\Contracts\Notifications\Value\Recipent\UserRecipient;

$user = $userService->loadUserByLogin('[email protected]')

$notification = new WelcomeNotification('Hello!', ['ibexa']);
// ...
$notifier->send($notification, new UserRecipient($user));

For QA:

N/A

Documentation:

N/A

[Steveb-p]

This is placed under integration namespace, while in practice this is a unit test. Do we expect contracts to be placed within this namespace?

[adamwojs]

Alternatively we can move it to tests/lib. Introducing dedicated namespace for contract unit tests seems to be overkill for me.

Please let me know what do you think and we will open follow up PR.