laravel-webrtc/CHANGELOG.md

Changelog

All notable changes to blax-software/laravel-webrtc are documented here. This project adheres to Keep a Changelog and Blax Software's backward-compatibility guarantee.

[Unreleased]

Added

• Typed rooms (Rooms\RoomType, derived from the room name prefix like laravel-websockets channels): public, private-* (authorized), presence-* (authorized + member list), open-presence-* (public + member list). Contracts\RoomAuthorizer (+ secure DefaultRoomAuthorizer that denies private/presence) gates the join; presence rooms broadcast the member list + per-member info.
• Full call recording: Contracts\RecordingStore + Recording\FileRecordingStore. The browser streams its mic to the server as binary WS frames; the relay appends them per participant (<room>/<peer>.webm) and finalizes on leave/disconnect. welcome/joined carry a record flag telling the client to stream.
• Call-event log seam: Contracts\CallEventListener (+ NullCallEventListener) receives peer-connected / room-joined / room-left / recording-finalized / peer-disconnected events, so calls can be logged/audited even when not recorded.
• RelaySignalingHandler now takes an authorizer, recorder and event listener; webrtc:serve wires them from config/webrtc.php (recording, authorizer, events).
• Suite grew to 35 / 99 assertions (room types, auth, presence, recording via the in-memory + on-disk stores, events).

Added (earlier)

• Working browser-to-browser (P2P) MVP. Signaling\RelaySignalingHandler (a blax-software/laravel-ws MessageHandler) relays SDP/ICE between browsers so they connect peer-to-peer — no server-side media engine required. Protocol: welcome on connect, join → joined + peer-joined, targeted relay, room broadcast, leave/disconnect → peer-left. Peers tracked in the kernel ConnectionRegistry, membership in RoomManager.
• webrtc:serve now runs this relay over a laravel-ws WebSocketServer, so it is browser-usable out of the box (ws://host:port).
• require blax-software/laravel-ws.
• Tests grew to 26 / 60 assertions, including a real WebSocket welcome round-trip (browser → laravel-ws → relay).

Added (earlier)

• WebRtcServiceProvider + config/webrtc.php + the webrtc:serve command (boots signaling on the shared blax-software/reactphp-kernel).
• Contracts\MediaEngine — the pluggable media backend (offer/addIceCandidate/startRecording/stopRecording/connectPeers/bridge/close).
• Media\NullMediaEngine — signaling-only engine for dev/tests.
• Media\Str0mMediaEngine — seam for the Rust media core (str0m via ext-php-rs); throws until the blax_webrtc extension is built (see rust/).
• Signaling\SignalingHandler — transport-agnostic router from a signaling message to the media engine.
• Server\SignalingServer — a minimal kernel-attached (newline-JSON) signaling transport; browsers ride the laravel-websockets WS transport into the same handler.
• rust/ — the blax_webrtc crate scaffold (str0m + ext-php-rs) documenting the media plan.
• Rooms\Room + Rooms\RoomManager and join/leave signaling for party-to-party / group calls: a new joiner is auto-meshed with everyone already in the room; close also leaves. Empty rooms are dropped.
• SignalingServer::address() — the bound listen address (for integration).
• A real socket round-trip test (offer→answer over a live TCP connection on the kernel loop), plus RoomManager + join/leave coverage. Suite: 17 tests / 42 assertions.