kinetis/broadcasting

Real-time broadcasting for Kinetis over the Pusher Channels protocol (Soketi, Laravel Reverb, or Pusher itself) - attribute-based private/presence channel authorization and a non-blocking driver over kinetis/revolt-http-client.

v1.1.1 2026-08-24 08:29 UTC

Requires

• php: ^8.4
• kinetis/framework: ^1.1.0
• kinetis/revolt-http-client: ^1.0.0
• psr/http-message: ^2.0

Requires (Dev)

• infection/infection: ^0.35.0
• phpstan/phpstan: ^2.2.8
• phpunit/phpunit: ^12.5.33
• vimeo/psalm: ^6.16.1

MIT

• Alon Noy

Published on Packagist.org on 2026-08-24 08:29 UTC

README

kinetis/broadcasting
Real-time broadcasting for Kinetis over the Pusher Channels protocol

One driver, speaking the wire protocol Soketi, Laravel Reverb, and Pusher's own hosted service all implement identically — non-blocking, over kinetis/revolt-http-client.

use Kinetis\Broadcasting\Broadcaster;

final readonly class OrderUpdated implements \Kinetis\Broadcasting\ShouldBroadcast
{
    public function __construct(private string $orderId, private string $status) {}

    public function broadcastOn(): array { return ["private-orders.{$this->orderId}"]; }
    public function broadcastAs(): string { return 'order.updated'; }
    public function broadcastWith(): array { return ['status' => $this->status]; }
}

// From a controller or a #[Listener] method, both constructor-inject Broadcaster:
$broadcaster->event(new OrderUpdated($orderId, 'shipped'));

A private or presence channel authorizes through one attribute:

use Kinetis\Broadcasting\Attributes\BroadcastChannel;
use Kinetis\Http\CurrentUserInterface;

final class OrderChannels
{
    #[BroadcastChannel('orders.{orderId}')]
    public function authorize(CurrentUserInterface $user, string $orderId): bool
    {
        return $this->orders->belongsTo($orderId, $user->id());
    }
}

POST /broadcasting/auth — the endpoint a Pusher-protocol client library calls automatically before subscribing — is discovered and wired with zero registration.

Provides

Installing this package auto-registers, via extra.kinetis:

• A container binding for Kinetis\Broadcasting\BroadcasterInterface, selected by BROADCAST_DRIVER ("null", the default — a silent no-op; or "pusher", requiring BROADCAST_APP_ID/BROADCAST_KEY/ BROADCAST_SECRET). Validated and built at worker boot, not lazily — a misconfigured BROADCAST_DRIVER=pusher fails before the first request, not on whichever one happens to broadcast first.
• Kinetis\Broadcasting\BroadcastChannelRegistry, discovering every #[BroadcastChannel]-attributed method anywhere under your own PSR-4 roots.
• POST /broadcasting/auth, a real Kinetis route (Kinetis\Broadcasting\Http\BroadcastAuthController), discovered the same way any Kinetis\Http\Routing\RouteDiscovery-found controller is.

Nothing else — Kinetis\Broadcasting\Broadcaster (the service your own code constructor-injects) autowires from the bound BroadcasterInterface with no binding of its own.

Configuration

BROADCAST_DRIVER=pusher
BROADCAST_APP_ID=your-app-id
BROADCAST_KEY=your-key
BROADCAST_SECRET=your-secret
BROADCAST_HOST=soketi.example.com
BROADCAST_PORT=6001
BROADCAST_TLS=false

Key	Default	Purpose
BROADCAST_DRIVER	null	null or pusher.
BROADCAST_APP_ID	(required for pusher)	The app id both sides agree on.
BROADCAST_KEY	(required for pusher)	The public key.
BROADCAST_SECRET	(required for pusher)	Never sent to a browser.
BROADCAST_HOST	api.pusherapp.com	The broker's host.
BROADCAST_PORT	443	The broker's port.
BROADCAST_TLS	true	Whether to connect over TLS.

Scoped — BROADCAST_KEY + notifications → BROADCAST_NOTIFICATIONS_KEY. Full reference: kinetis.dev/docs/config.html.

Installation

composer require kinetis/broadcasting

Requires PHP 8.4+, kinetis/framework, and kinetis/revolt-http-client. Full documentation: kinetis.dev/docs/broadcasting.html.

License

MIT — see LICENSE.