67 lines
3.6 KiB
Markdown
67 lines
3.6 KiB
Markdown
# 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.
|