ETS-based session storage for DB Sync module.

Stores sync sessions in ETS for fast, ephemeral access. Sessions remain valid as long as the owning LiveView process is alive. When the LiveView terminates (page closed), the session is automatically deleted.

Architecture

This module uses a GenServer to manage an ETS table. The ETS table provides fast reads while the GenServer handles process monitoring and automatic cleanup when LiveView processes terminate.

Future Migration Path

This module is designed to be easily replaced with database persistence if audit logging or sync history is needed. The public API would remain the same, only the storage backend would change.

Session Structure

%{
  code: "A7X9K2M4",
  direction: :send | :receive,
  status: :pending | :connected | :completed | :failed,
  owner_pid: #PID<0.123.0>,     # Session is deleted when this process dies
  created_at: ~U[2025-12-16 12:15:00Z],
  connected_at: nil | ~U[...],
  sender_info: nil | %{...},
  receiver_info: nil | %{...}
}