GenServer managing a single collaboration room session.

Started on-demand via DynamicSupervisor when the first user joins (see PhiaUi.Collab.RoomManager.join_or_create_room/2). Auto-terminates after an idle timeout (default 30 minutes) when all users have left.

Behaviour Callbacks

Implement the behaviour in your own module to persist room state:

defmodule MyApp.CollabRoom do
  @behaviour PhiaUi.Collab.CollabRoom

  @impl true
  def on_join(room_id, user), do: {:ok, %{}}

  @impl true
  def on_leave(room_id, user), do: :ok

  @impl true
  def load_room_state(room_id), do: {:ok, %{}}

  @impl true
  def save_room_state(room_id, state), do: :ok
end

State Structure

The GenServer state is a %PhiaUi.Collab.CollabRoom{} struct containing:

• :room_id — unique identifier for this room
• :callback_module — optional module implementing this behaviour
• :users — map of user_id => user_entry for all joined users
• :custom_state — arbitrary map managed via update_state/2
• :created_at / :last_activity_at — UTC timestamps
• :idle_timeout — milliseconds before an empty room shuts down