# Changelog

All notable changes to `blax-software/laravel-webrtc` are documented here. This
project adheres to [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and
Blax Software's backward-compatibility guarantee.

## [Unreleased]

### Added

- **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.