-spec join(pid(), binary(), map()) -> ok | {error, term()}.

Join carrying an opaque join context from the client. asobi does not interpret it; it reaches the game module's join/3 if it exports one.

-spec listing_info(map()) -> map().

Projection of get_info/1 for callers who are not in the match.

Mirrors asobi_world_server:listing_info/1. get_info/1 carries the full players roster and the server-side listed flag; neither reaches a browsing client. joinable does: a client browsing for a match to join has to be able to tell a match that will take it from one that has closed, and without it the only way to find out is to attempt the join and be refused.

-spec set_joinable(pid(), boolean()) -> ok.

Open or close the match to new joins.

A closed match keeps running and keeps its roster; it answers every further join with match_locked. This is the runtime half of joinability - listed decides whether a match is advertised by asobi_match_lobby, and an unlisted match is still joinable by id, so hiding a match is not closing it.

Asynchronous because the caller is usually the match's own Lua VM (game.match.set_joinable), which runs inside this process. An Erlang game module is in the same position - its callbacks run here too - so it closes its own match with set_joinable(self(), false) from tick/1, join/2 or any other callback.