room

type Announcer interface {
	// Announce sends the given Status to an external service for reporting.
	// The [context.Context] may be used to control the deadline and cancellation
	// of announcement. An error may be returned, if the Status could not be announced.
	Announce(ctx context.Context, status Status) error

	Close() error
}

type Connection struct {
	ConnectionType uint32 `json:"ConnectionType"`
	HostIPAddress  string `json:"HostIpAddress"`
	HostPort       uint16 `json:"HostPort"`
	NetherNetID    uint64 `json:"NetherNetId"`
	RakNetGUID     string `json:"RakNetGUID,omitempty"`
}

type ListenConfig struct {
	// Announcer announces the Status of Listener. It is called from [Listener.ServerStatus] to report the status
	// to external services like Xbox Live and LAN discovery. If nil, the Wrap method will panic.
	Announcer Announcer

	// StatusProvider provides the Status for announcing using the Announcer. It will be called by [Listener.ServerStatus]
	// at some intervals. If nil, a default StatusProvider reporting DefaultStatus will be set.
	StatusProvider StatusProvider

	// DisableServerStatusOverride indicates that fields of the Status provided by the StatusProvider should be modified
	// to sync with the [minecraft.ServerStatus] reported from [minecraft.Listener]. It includes fields like [Status.MemberCount],
	// [Status.MaxMemberCount], [Status.WorldName], and [Status.HostName].
	DisableServerStatusOverride bool // TODO: Find a good name

	// Log is used for logging messages at various log levels. If nil, the default [slog.Logger]
	// will be set from [slog.Default].
	Log *slog.Logger
}

type Listener struct {
	// contains filtered or unexported fields
}

type Status struct {
	Joinability             string       `json:"Joinability,omitempty"`
	HostName                string       `json:"hostName,omitempty"`
	OwnerID                 string       `json:"ownerId,omitempty"`
	RakNetGUID              string       `json:"rakNetGUID"`
	Version                 string       `json:"version"`
	LevelID                 string       `json:"levelId"`
	WorldName               string       `json:"worldName"`
	WorldType               string       `json:"worldType"`
	Protocol                int32        `json:"protocol"`
	MemberCount             int          `json:"MemberCount"`
	MaxMemberCount          int          `json:"MaxMemberCount"`
	BroadcastSetting        int32        `json:"BroadcastSetting"`
	LanGame                 bool         `json:"LanGame"`
	IsEditorWorld           bool         `json:"isEditorWorld"`
	TransportLayer          int32        `json:"TransportLayer"`
	OnlineCrossPlatformGame bool         `json:"OnlineCrossPlatformGame"`
	CrossPlayDisabled       bool         `json:"CrossPlayDisabled"`
	TitleID                 int64        `json:"TitleId"`
	SupportedConnections    []Connection `json:"SupportedConnections"`
}

type StatusProvider interface {
	RoomStatus() Status
}

type XBLAnnouncer struct {
	// TokenSource provides the [xsapi.Token] required to publish a session when the Session is nil.
	TokenSource xsapi.TokenSource

	// SessionReference specifies the internal ID of the session being published when the Session is nil.
	SessionReference mpsd.SessionReference

	// PublishConfig specifies custom configuration for publishing a session when the Session is nil.
	PublishConfig mpsd.PublishConfig

	// Session is the session where the Status will be committed. If nil, a [mpsd.Session] will be published
	// using the PublishConfig.
	Session *mpsd.Session

	// Mutex ensures atomic read/write access to the fields.
	sync.Mutex
	// contains filtered or unexported fields
}