laravel-webrtc/CHANGELOG.md

# 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

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