jooservices/laravel-notifications

jooservices/laravel-notifications

JOOservices Laravel Notifications is a send-only Laravel notification transport for Telegram, Slack, and email. The application owns templates, queueing, debounce, and logging. This package transports pre-rendered subject/body strings through channel adapters and returns a structured SendReport.

Composer package: jooservices/laravel-notifications — current line: v1.0.1.

Features

• Telegram Bot API (sendMessage) via jooservices/client
• Slack incoming webhooks via jooservices/client
• Mail via Laravel Mailer (raw / HTML send) — no package Mailables or Blade views
• Immutable Message DTO (jooservices/dto) with optional HTML body, scalar context, and recipients
• Per-channel SendResult and aggregate SendReport
• Missing credentials → skip (fail-open); HTTP/API errors → failed; other channels continue
• Context-aware exceptions (jooservices/exceptions)
• Auto-discovered service provider and Notification facade

Non-goals

• Queue / ShouldQueue helpers
• Templates / Blade / package Mailables / markdown mail
• Log / Discord / SMS channels
• Debounce / rate-limit

Requirements

• PHP ^8.5
• Laravel / Illuminate ^12|^13
• Extensions: curl (for Telegram/Slack HTTP)

Installation

composer require jooservices/laravel-notifications:^1.0

Publish config

php artisan vendor:publish --provider="JOOservices\LaravelNotifications\LaravelNotificationsServiceProvider" --tag="config"

Environment

Quick start

use JOOservices\LaravelNotifications\Facades\Notification;
use JOOservices\LaravelNotifications\Message;

$body = view('ops.crawl_alert', $data)->render(); // app owns templates

$report = Notification::send(
    Message::make(subject: 'Source unhealthy: javdb', body: $body)
        ->html($htmlBody) // optional; mail only
        ->withContext(['source_slug' => 'javdb']),
    channels: ['telegram', 'slack', 'mail'],
);

if ($report->hasFailures()) {
    // app may log from SendReport — package does not
}

Omit channels to use NOTIFICATION_DEFAULT_CHANNELS / config default_channels.

Local development

make build
make install
make lint
make test

All PHP tooling runs in Docker (php:8.5-cli-bookworm). See WORKFLOWS.md for CI.

Documentation

• docs/README.md — documentation map
• CHANGELOG.md
• CONTRIBUTING.md
• SECURITY.md

License

MIT — see LICENSE.