cache

type Cache[T any] interface {
	// Get returns a copy of the entity with the given snowflake and a bool whether it was found or not.
	Get(id snowflake.ID) (T, bool)

	// Put stores the given entity with the given snowflake as key. If the entity is already present, it will be overwritten.
	Put(id snowflake.ID, entity T)

	// Remove removes the entity with the given snowflake as key and returns a copy of the entity and a bool whether it was removed or not.
	Remove(id snowflake.ID) (T, bool)

	// RemoveIf removes all entities that pass the given FilterFunc
	RemoveIf(filterFunc FilterFunc[T])

	// Len returns the number of entities in the cache.
	Len() int

	// All returns an [iter.Seq] of all entities in the cache.
	All() iter.Seq[T]
}

type Caches interface {
	SelfUserCache
	GuildCache
	ChannelCache
	GuildScheduledEventCache
	RoleCache
	MemberCache
	PresenceCache
	VoiceStateCache
	MessageCache
	EmojiCache
	StickerCache

	// CacheFlags returns the current configured FLags of the caches.
	CacheFlags() Flags

	// MemberPermissions returns the calculated permissions of the given member.
	// This requires the FlagRoles to be set.
	MemberPermissions(member fluxer.Member) fluxer.Permissions

	// MemberPermissionsInChannel returns the calculated permissions of the given member in the given channel.
	// This requires the FlagRoles and FlagChannels to be set.
	MemberPermissionsInChannel(channel fluxer.GuildChannel, member fluxer.Member) fluxer.Permissions

	// MemberRoles returns all roles of the given member.
	// This requires the FlagRoles to be set.
	MemberRoles(member fluxer.Member) []fluxer.Role

	// AudioChannelMembers returns all members which are in the given audio channel.
	// This requires the FlagVoiceStates to be set.
	AudioChannelMembers(channel fluxer.GuildAudioChannel) []fluxer.Member

	// SelfMember returns the current bot member from the given guildID.
	// This is only available after we received the gateway.EventTypeGuildCreate event for the given guildID.
	SelfMember(guildID snowflake.ID) (fluxer.Member, bool)

	// GuildMessageChannel returns a fluxer.GuildMessageChannel from the ChannelCache and a bool indicating if it exists.
	GuildMessageChannel(channelID snowflake.ID) (fluxer.GuildMessageChannel, bool)

	// GuildAudioChannel returns a fluxer.GetGuildAudioChannel from the ChannelCache and a bool indicating if it exists.
	GuildAudioChannel(channelID snowflake.ID) (fluxer.GuildAudioChannel, bool)

	// GuildTextChannel returns a fluxer.GuildTextChannel from the ChannelCache and a bool indicating if it exists.
	GuildTextChannel(channelID snowflake.ID) (fluxer.GuildTextChannel, bool)

	// GuildVoiceChannel returns a fluxer.GuildVoiceChannel from the ChannelCache and a bool indicating if it exists.
	GuildVoiceChannel(channelID snowflake.ID) (fluxer.GuildVoiceChannel, bool)

	// GuildCategoryChannel returns a fluxer.GuildCategoryChannel from the ChannelCache and a bool indicating if it exists.
	GuildCategoryChannel(channelID snowflake.ID) (fluxer.GuildCategoryChannel, bool)
}

type ChannelCache interface {
	ChannelCache() Cache[fluxer.GuildChannel]

	Channel(channelID snowflake.ID) (fluxer.GuildChannel, bool)
	Channels() iter.Seq[fluxer.GuildChannel]
	ChannelsForGuild(guildID snowflake.ID) iter.Seq[fluxer.GuildChannel]
	ChannelsLen() int
	AddChannel(channel fluxer.GuildChannel)
	RemoveChannel(channelID snowflake.ID) (fluxer.GuildChannel, bool)
	RemoveChannelsByGuildID(guildID snowflake.ID)
}

type ConfigOpt func(config *config)

type DefaultCache[T any] struct {
	// contains filtered or unexported fields
}

type EmojiCache interface {
	EmojiCache() GroupedCache[fluxer.Emoji]

	Emoji(guildID snowflake.ID, emojiID snowflake.ID) (fluxer.Emoji, bool)
	Emojis(guildID snowflake.ID) iter.Seq[fluxer.Emoji]
	EmojisAllLen() int
	EmojisLen(guildID snowflake.ID) int
	AddEmoji(emoji fluxer.Emoji)
	RemoveEmoji(guildID snowflake.ID, emojiID snowflake.ID) (fluxer.Emoji, bool)
	RemoveEmojisByGuildID(guildID snowflake.ID)
}

type FilterFunc[T any] func(T) bool

type Flags int

type GroupedCache[T any] interface {
	// Get returns a copy of the entity with the given groupID and ID and a bool wheaten it was found or not.
	Get(groupID snowflake.ID, id snowflake.ID) (T, bool)

	// Put stores the given entity with the given groupID and ID as key. If the entity is already present, it will be overwritten.
	Put(groupID snowflake.ID, id snowflake.ID, entity T)

	// Remove removes the entity with the given groupID and ID as key and returns a copy of the entity and a bool whether it was removed or not.
	Remove(groupID snowflake.ID, id snowflake.ID) (T, bool)

	// GroupRemove removes all entities in the given groupID.
	GroupRemove(groupID snowflake.ID)

	// RemoveIf removes all entities that pass the given GroupedFilterFunc.
	RemoveIf(filterFunc GroupedFilterFunc[T])

	// GroupRemoveIf removes all entities that pass the given GroupedFilterFunc within the groupID.
	GroupRemoveIf(groupID snowflake.ID, filterFunc GroupedFilterFunc[T])

	// Len returns the total number of entities in the cache.
	Len() int

	// GroupLen returns the number of entities in the cache within the groupID.
	GroupLen(groupID snowflake.ID) int

	// All returns an [iter.Seq2] of all entities in the cache.
	All() iter.Seq2[snowflake.ID, T]

	// GroupAll returns an [iter.Seq] of all entities in the cache within the groupID.
	GroupAll(groupID snowflake.ID) iter.Seq[T]
}

type GroupedFilterFunc[T any] func(groupID snowflake.ID, entity T) bool

type GuildCache interface {
	GuildCache() Cache[fluxer.Guild]

	IsGuildUnready(guildID snowflake.ID) bool
	SetGuildUnready(guildID snowflake.ID, unready bool)
	UnreadyGuildIDs() []snowflake.ID

	IsGuildUnavailable(guildID snowflake.ID) bool
	SetGuildUnavailable(guildID snowflake.ID, unavailable bool)
	UnavailableGuildIDs() []snowflake.ID

	Guild(guildID snowflake.ID) (fluxer.Guild, bool)
	Guilds() iter.Seq[fluxer.Guild]
	GuildsLen() int
	AddGuild(guild fluxer.Guild)
	RemoveGuild(guildID snowflake.ID) (fluxer.Guild, bool)
}

type GuildScheduledEventCache interface {
	GuildScheduledEventCache() GroupedCache[fluxer.GuildScheduledEvent]

	GuildScheduledEvent(guildID snowflake.ID, guildScheduledEventID snowflake.ID) (fluxer.GuildScheduledEvent, bool)
	GuildScheduledEvents(guildID snowflake.ID) iter.Seq[fluxer.GuildScheduledEvent]
	GuildScheduledEventsAllLen() int
	GuildScheduledEventsLen(guildID snowflake.ID) int
	AddGuildScheduledEvent(guildScheduledEvent fluxer.GuildScheduledEvent)
	RemoveGuildScheduledEvent(guildID snowflake.ID, guildScheduledEventID snowflake.ID) (fluxer.GuildScheduledEvent, bool)
	RemoveGuildScheduledEventsByGuildID(guildID snowflake.ID)
}

type MemberCache interface {
	MemberCache() GroupedCache[fluxer.Member]

	Member(guildID snowflake.ID, userID snowflake.ID) (fluxer.Member, bool)
	Members(guildID snowflake.ID) iter.Seq[fluxer.Member]
	MembersAllLen() int
	MembersLen(guildID snowflake.ID) int
	AddMember(member fluxer.Member)
	RemoveMember(guildID snowflake.ID, userID snowflake.ID) (fluxer.Member, bool)
	RemoveMembersByGuildID(guildID snowflake.ID)
}

type MessageCache interface {
	MessageCache() GroupedCache[fluxer.Message]

	Message(channelID snowflake.ID, messageID snowflake.ID) (fluxer.Message, bool)
	Messages(channelID snowflake.ID) iter.Seq[fluxer.Message]
	MessagesAllLen() int
	MessagesLen(guildID snowflake.ID) int
	AddMessage(message fluxer.Message)
	RemoveMessage(channelID snowflake.ID, messageID snowflake.ID) (fluxer.Message, bool)
	RemoveMessagesByChannelID(channelID snowflake.ID)
	RemoveMessagesByGuildID(guildID snowflake.ID)
}

type Policy[T any] func(entity T) bool

type PresenceCache interface {
	PresenceCache() GroupedCache[fluxer.Presence]

	Presence(guildID snowflake.ID, userID snowflake.ID) (fluxer.Presence, bool)
	Presences(guildID snowflake.ID) iter.Seq[fluxer.Presence]
	PresencesAllLen() int
	PresencesLen(guildID snowflake.ID) int
	AddPresence(presence fluxer.Presence)
	RemovePresence(guildID snowflake.ID, userID snowflake.ID) (fluxer.Presence, bool)
	RemovePresencesByGuildID(guildID snowflake.ID)
}

type RoleCache interface {
	RoleCache() GroupedCache[fluxer.Role]

	Role(guildID snowflake.ID, roleID snowflake.ID) (fluxer.Role, bool)
	Roles(guildID snowflake.ID) iter.Seq[fluxer.Role]
	RolesAllLen() int
	RolesLen(guildID snowflake.ID) int
	AddRole(role fluxer.Role)
	RemoveRole(guildID snowflake.ID, roleID snowflake.ID) (fluxer.Role, bool)
	RemoveRolesByGuildID(guildID snowflake.ID)
}

type SelfUserCache interface {
	SelfUser() (fluxer.OAuth2User, bool)
	SetSelfUser(selfUser fluxer.OAuth2User)
}

type Set[T comparable] interface {
	// Add adds an item to the set.
	Add(item T)
	// Remove removes an item from the set.
	Remove(item T)
	// Has returns true if the item is in the set, false otherwise.
	Has(item T) bool
	// Len returns the number of items in the set.
	Len() int
	// Clear removes all items from the set.
	Clear()
	// All returns an iterator over all items in the set.
	All() iter.Seq[T]
}

type StickerCache interface {
	StickerCache() GroupedCache[fluxer.Sticker]

	Sticker(guildID snowflake.ID, stickerID snowflake.ID) (fluxer.Sticker, bool)
	Stickers(guildID snowflake.ID) iter.Seq[fluxer.Sticker]
	StickersAllLen() int
	StickersLen(guildID snowflake.ID) int
	AddSticker(sticker fluxer.Sticker)
	RemoveSticker(guildID snowflake.ID, stickerID snowflake.ID) (fluxer.Sticker, bool)
	RemoveStickersByGuildID(guildID snowflake.ID)
}

type VoiceStateCache interface {
	VoiceStateCache() GroupedCache[fluxer.VoiceState]

	VoiceState(guildID snowflake.ID, userID snowflake.ID) (fluxer.VoiceState, bool)
	VoiceStates(guildID snowflake.ID) iter.Seq[fluxer.VoiceState]
	VoiceStatesAllLen() int
	VoiceStatesLen(guildID snowflake.ID) int
	AddVoiceState(voiceState fluxer.VoiceState)
	RemoveVoiceState(guildID snowflake.ID, userID snowflake.ID) (fluxer.VoiceState, bool)
	RemoveVoiceStatesByGuildID(guildID snowflake.ID)
}