pippa/notification-sdk-laravel

Notification Service SDK for Laravel — Guzzle, ServiceProvider, Facade

1.0.0 2026-05-06 11:17 UTC

Requires

• php: ^8.1
• guzzlehttp/guzzle: ^7.0
• illuminate/contracts: ^10.0|^11.0|^12.0
• illuminate/support: ^10.0|^11.0|^12.0

Requires (Dev)

• orchestra/testbench: ^8.0|^9.0
• phpunit/phpunit: ^10.0|^11.0

MIT

• Rajoni

• email
• sms
• sdk
• notification
• laravel
• inapp

README

Laravel SDK for the Notification Service API.
Requires Guzzle — includes ServiceProvider, Facade, and DI support.

Installation

composer require pippa/notification-sdk-laravel

Laravel will auto-discover the service provider and facade.

Configuration

Publish config:

php artisan vendor:publish --tag=notification-config

Add to .env:

NOTIFICATION_API_KEY=your_api_key
NOTIFICATION_SECRET_KEY=your_secret_key

Usage — Facade

use Pippa\NotificationSdkLaravel\Facades\NotificationService;

// Send Email
$response = NotificationService::sendEmail(
    email:    '[e-mail]',
    template: 'welcome_email',
    data:     ['name' => 'Rahim']
);

// Send SMS
$response = NotificationService::sendSms(
    phone:    '[phone]',
    template: 'otp_sms',
    data:     ['otp' => '1234']
);

// Send In-App
$response = NotificationService::sendInApp(
    userId:   'user_123',
    template: 'order_update',
    data:     ['order_id' => 'ORD-456', 'status' => 'Shipped']
);

Multi-channel (Courier-style)

use Pippa\NotificationSdkLaravel\Facades\NotificationService;
use Pippa\NotificationSdkLaravel\Requests\SendMessageRequest;
use Pippa\NotificationSdkLaravel\DTOs\TemplateMessage;
use Pippa\NotificationSdkLaravel\DTOs\Recipient;

$response = NotificationService::send(
    new SendMessageRequest([
        'message' => new TemplateMessage([
            'to' => [
                Recipient::email('[e-mail]'),
                Recipient::phone('[phone]'),
                Recipient::userId('user_123'),
            ],
            'template' => 'welcome_notification',
            'data'     => ['name' => 'Rahim'],
        ]),
    ])
);

echo $response->getRequestId();

Restrict a recipient to specific channels

Recipient::make([
    'email'   => '[e-mail]',
    'phone'   => '[phone]',
    'user_id' => 'user_123',
])->only(['email', 'sms'])

Usage — Dependency Injection

use Pippa\NotificationSdkLaravel\NotificationClient;

class OrderService
{
    public function __construct(protected NotificationClient $notification) {}

    public function notifyShipped(string $email, string $orderId): void
    {
        $this->notification->sendEmail(
            email:    $email,
            template: 'order_shipped',
            data:     ['order_id' => $orderId]
        );
    }
}

Exception Handling

use Pippa\NotificationSdkLaravel\Exceptions\NotificationException;

try {
    NotificationService::sendEmail('[e-mail]', 'my_template');
} catch (NotificationException $e) {
    $e->getMessage();
    $e->getCode();
    $e->getErrors();
}

Available Methods

Method	Description
send(SendMessageRequest)	Full control
sendEmail($email, $template, $data)	Send email via template
sendSms($phone, $template, $data)	Send SMS via template
sendInApp($userId, $template, $data)	Send in-app notification
sendMulti($recipients[], $template, $data)	Multi-channel, multi-recipient

Recipient Helpers

use Pippa\NotificationSdkLaravel\DTOs\Recipient;

Recipient::email('[e-mail]')
Recipient::phone('[phone]')
Recipient::userId('user_123')
Recipient::make(['email' => '...', 'phone' => '...', 'user_id' => '...'])
Recipient::make([...])->only(['email', 'sms'])

License

MIT