client

type Creator interface {
	Cache(c cache.Store) Creator
	Logger(log golog.Logger) Creator
	EnableAutoSharding() Creator
	ShardCount(c uint16) Creator
	Shards(c uint16, s ...uint16) Creator
	Concurrency(c int) Creator
	Intents(i ws.GatewayIntent) Creator
	Build(token string) (Session, error)
}

type Session interface {
	api.Client

	API() api.Client
	Events() events.SessionDispatcher
	Cache() cache.Store
	Log() golog.Logger
	ShardID(guild snowflake.ID) uint16

	Get(id uint16) Shard
	Ping() int
	Shards() []uint16
	ShardCount() uint16
	// Alive checks if shard is connected to the Discord Gateway. It is good to check when you want to make sure the cache is up-to-date.
	//
	// If no shard id is provided, then all shards of current Session instance are checked. It is not recommended in most cases.
	//
	// If gateway reach the max reconnection limit, it will wait 5 minutes before next try. Of course, you won't receive any new events you have to handle but if you have the interval jobs (or dashboard), you should be sure the specific shard is connected.
	Alive(shard ...uint16) bool
	// Unavailable checks if guild is not available due to outage or has not been loaded from lazy GUILD_CREATE events yet.
	Unavailable(id snowflake.ID) bool
	UnavailableCount() int
	FetchMembers(ctx context.Context, params ws.RequestGuildMembersParams) ([]discord.MemberWithUser, []discord.Presence, error)

	PermissionsIn(guild, channel, member snowflake.ID) (discord.Permission, error)
	SortedMemberRoles(guild, member snowflake.ID) ([]discord.Role, error)

	Shutdown()
	Start()
}

type Shard interface {
	ws.Gateway

	Ping() int
	History() []int
	ID() uint16
	Unavailable() utils.SimpleMap[snowflake.ID, ws.UnavailableGuild]
}