Returns a specification to start this module under a supervisor.

See Supervisor.

@spec create_session(ip_address()) :: {:ok, session_id()} | {:error, atom()}

Creates a new session for the given IP address. Returns {:ok, session_id} or {:error, reason}.

@spec register_session(session_id(), ip_address()) ::
  {:ok, session_id()} | {:error, atom()}

Registers a session with a pre-generated session_id. Used when the LiveView creates the session_id before channel join. Returns {:ok, session_id} or {:error, reason}.

@spec remove_session(session_id()) :: :ok

Removes a session.

@spec session_count() :: non_neg_integer()

Returns current session count.

@spec sessions_for_ip(ip_address()) :: non_neg_integer()

Returns session count for an IP.

Starts the session manager.

@spec touch_session(session_id()) :: :ok

Refreshes session timeout (called on activity).

@spec validate_session(session_id(), ip_address()) ::
  {:ok, session_id()} | {:error, atom()}

Checks if a session exists and belongs to the given IP. Returns {:ok, session_id} or {:error, reason}.