tempest

type AccessoryComponent interface {
	AnyComponent
	// contains filtered or unexported methods
}

type ActionRowChildComponent interface {
	AnyComponent
	// contains filtered or unexported methods
}

type ActionRowComponent struct {
	Type       ComponentType             `json:"type"` // Always = ACTION_ROW_COMPONENT_TYPE (1)
	ID         uint32                    `json:"id,omitempty"`
	Components []ActionRowChildComponent `json:"components,omitzero"` // Up to 5 interactive [ButtonComponent]s or a single [SelectComponent]
}

type Activity struct {
	Name string       `json:"name"`
	Type ActivityType `json:"type"`
	URL  string       `json:"url,omitempty"` // Stream URL, only for Streaming type
}

type ActivityType uint8

type AllowedMentions struct {
	Parse       []AllowedMentionsType `json:"parse,omitzero"`
	Roles       []Snowflake           `json:"roles,omitzero"`
	Users       []Snowflake           `json:"users,omitzero"`
	RepliedUser bool                  `json:"replied_user"`
}

type AllowedMentionsType string

type AnyComponent interface {
	// contains filtered or unexported methods
}

type ApplicationIntegrationType uint8

type Attachment struct {
	ID           Snowflake `json:"id"`
	FileName     string    `json:"filename"`
	Title        string    `json:"title,omitempty"`
	Description  string    `json:"description,omitempty"`
	ContentType  string    `json:"content_type,omitempty"`
	Size         uint64    `json:"size"`
	URL          string    `json:"url"`
	ProxyURL     string    `json:"proxy_url"`
	Height       uint32    `json:"height,omitempty"`
	Width        uint32    `json:"width,omitempty"`
	Ephemeral    bool      `json:"ephemeral"`
	DurationSecs float64   `json:"duration_secs,omitempty"`
	Waveform     string    `json:"waveform,omitempty"`
	Flags        uint64    `json:"flags,omitempty"`
}

type AvatarDecoration struct {
	AssetHash string    `json:"avatar"` // Hash code used to access user's avatar decoration.
	SkuID     Snowflake `json:"sku_id"`
}

type BaseClient struct {
	ApplicationID Snowflake
	Rest          *Rest
	// contains filtered or unexported fields
}

type BaseClientOptions struct {
	Token                      string
	DefaultInteractionContexts []InteractionContextType

	PreCommandHook   func(cmd Command, itx *CommandInteraction) bool // Function that runs before each command. Return type signals whether to continue command execution (return with false to stop early).
	PostCommandHook  func(cmd Command, itx *CommandInteraction)      // Function that runs after each command.
	ComponentHandler func(itx *ComponentInteraction)                 // Function that runs for each unhandled component.
	ModalHandler     func(itx *ModalInteraction)                     // Function that runs for each unhandled modal.

	Logger *log.Logger // Optional custom logger. If tracing is enabled, this logger will be used for all internal messages. If none is provided, the default Stdout logger will be used instead.
}

type BitSet uint64

type ButtonComponent struct {
	Type     ComponentType `json:"type"` // Always = BUTTON_COMPONENT_TYPE (2)
	ID       uint32        `json:"id,omitempty"`
	Style    ButtonStyle   `json:"style"`
	Label    string        `json:"label,omitempty"`
	Emoji    *Emoji        `json:"emoji,omitempty"` // It may only contain id, name, and animated from regular Emoji struct.
	CustomID string        `json:"custom_id,omitempty"`
	SkuID    Snowflake     `json:"sku_id,omitempty"` // Identifier for a purchasable SKU, only available when using premium-style buttons. Premium buttons do not send an interaction to your app when clicked.
	URL      string        `json:"url,omitempty"`
	Disabled bool          `json:"disabled"`
}

type ButtonStyle uint8

type ChannelMention struct {
	ID      Snowflake   `json:"id"`
	Name    string      `json:"name"`
	GuildID Snowflake   `json:"guild_id"`
	Type    ChannelType `json:"type"`
}

type ChannelType uint8

type CheckboxComponent struct {
	Type     ComponentType `json:"type"`         // Always = CHECKBOX_COMPONENT_TYPE (23)
	ID       uint32        `json:"id,omitempty"` // Optional identifier for component
	CustomID string        `json:"custom_id,omitempty"`
	Default  bool          `json:"default"` // Whether to render this option as selected by default.
}

type CheckboxGroupComponent struct {
	Type      ComponentType         `json:"type"`         // Always = CHECKBOX_GROUP_COMPONENT_TYPE (22)
	ID        uint32                `json:"id,omitempty"` // Optional identifier for component
	CustomID  string                `json:"custom_id,omitempty"`
	Options   []CheckboxGroupOption `json:"options,omitzero"`
	MinValues uint8                 `json:"min_values,omitempty"`
	MaxValues uint8                 `json:"max_values,omitempty"`
	Required  bool                  `json:"required"`
}

type CheckboxGroupOption struct {
	Value       string `json:"value"`
	Label       string `json:"label"`
	Description string `json:"description,omitempty"`
	Default     bool   `json:"default"` // Whether to render this option as selected by default.
}

type Command struct {
	ID                       Snowflake                    `json:"-"` // It's not needed on app side to work.
	Type                     CommandType                  `json:"type,omitempty"`
	ApplicationID            Snowflake                    `json:"application_id"`
	GuildID                  Snowflake                    `json:"guild_id,omitempty"`
	Name                     string                       `json:"name"`
	NameLocalizations        map[Language]string          `json:"name_localizations,omitzero"`
	Description              string                       `json:"description"`
	DescriptionLocalizations map[Language]string          `json:"description_localizations,omitzero"`
	Options                  []CommandOption              `json:"options,omitzero"`
	RequiredPermissions      PermissionFlags              `json:"default_member_permissions,string,omitempty"` // Set of permissions represented as a bit set that are required from user/member to use command. Set it to 0 to make command unavailable for regular members (guild administrators still can use it).
	IntegrationTypes         []ApplicationIntegrationType `json:"integration_types,omitzero"`
	Contexts                 []InteractionContextType     `json:"contexts,omitzero"` // Interaction context(s) where the command can be used, only for globally-scoped commands. By default, all interaction context types included for new commands.
	NSFW                     bool                         `json:"nsfw"`              // https://docs.discord.com/developers/interactions/application-commands#agerestricted-commands
	Version                  Snowflake                    `json:"version,omitempty"` // Autoincrementing version identifier updated during substantial record changes.
	Handler                  CommandHandlerType           `json:"handler,omitempty"`

	AutoCompleteHandler func(itx CommandInteraction) []CommandOptionChoice `json:"-"` // Custom handler for auto complete interactions. It's a Tempest specific field.
	SlashCommandHandler func(itx *CommandInteraction)                      `json:"-"` // Custom handler for slash command interactions. It's a Tempest specific field. It receives pointer to CommandInteraction as it's being used with pre & post client hooks.
}

type CommandHandlerType uint8

type CommandInteraction struct {
	*Interaction
	Data CommandInteractionData `json:"data"`
}

type CommandInteractionData struct {
	ID       Snowflake                  `json:"id"`
	Name     string                     `json:"name"`
	Type     CommandType                `json:"type"`
	Resolved *InteractionDataResolved   `json:"resolved,omitempty"`
	Options  []CommandInteractionOption `json:"options,omitzero"`
	GuildID  Snowflake                  `json:"guild_id,omitempty"`
	TargetID Snowflake                  `json:"target_id,omitempty"` // ID of either user or message targeted. Depends whether it was user command or message command.
}

type CommandInteractionOption struct {
	Name    string                     `json:"name"`
	Type    OptionType                 `json:"type"`
	Value   any                        `json:"value,omitempty"` // string, float64 (double or integer) or bool
	Options []CommandInteractionOption `json:"options,omitzero"`
	Focused bool                       `json:"focused"`
}

type CommandOption struct {
	Type                     OptionType            `json:"type"`
	Name                     string                `json:"name"`
	NameLocalizations        map[Language]string   `json:"name_localizations,omitzero"`
	Description              string                `json:"description"`
	DescriptionLocalizations map[Language]string   `json:"description_localizations,omitzero"`
	Required                 bool                  `json:"required"`
	Choices                  []CommandOptionChoice `json:"choices,omitzero"`
	Options                  []CommandOption       `json:"options,omitzero"`
	ChannelTypes             []ChannelType         `json:"channel_types,omitzero"`
	MinValue                 float64               `json:"min_value,omitempty"`
	MaxValue                 float64               `json:"max_value,omitempty"`
	MinLength                uint16                `json:"min_length,omitempty"`
	MaxLength                uint16                `json:"max_length,omitempty"`
	AutoComplete             bool                  `json:"autocomplete"` // Required to be = true if you want to catch it later in auto complete handler.
}

type CommandOptionChoice struct {
	Name              string              `json:"name"`
	NameLocalizations map[Language]string `json:"name_localizations,omitzero"` // https://docs.discord.com/developers/reference#locales
	Value             any                 `json:"value"`                       // string, float64 (double or integer) or bool
}

type CommandType uint8

type ComponentInteraction struct {
	*Interaction
	Data ComponentInteractionData `json:"data"`
}

type ComponentInteractionData struct {
	CustomID string                   `json:"custom_id"`
	Type     ComponentType            `json:"component_type"`
	Values   []string                 `json:"values,omitzero"` // Values the user selected in a select menu component
	Resolved *InteractionDataResolved `json:"resolved,omitempty"`
}

type ComponentType uint8

type ContainerChildComponent interface {
	AnyComponent
	// contains filtered or unexported methods
}

type ContainerComponent struct {
	Type        ComponentType             `json:"type"` // Always = CONTAINER_COMPONENT_TYPE (17)
	ID          uint32                    `json:"id,omitempty"`
	Components  []ContainerChildComponent `json:"components,omitzero"`    // Child components to nest within the container.
	AccentColor uint32                    `json:"accent_color,omitempty"` // The accent color of the container, as an RGB value from 0x000000 to 0xFFFFFF. (Write as a hex literal for best results.)
	Spoiler     bool                      `json:"spoiler"`                // Whether to mark the container as a spoiler.
}

type ContentComponent interface {
	AnyComponent
	// contains filtered or unexported methods
}

type CreateGuildEventData struct {
	*Guild

	JoinedAt    *time.Time `json:"joined_at"`
	Large       bool       `json:"large"`
	Unavailable bool       `json:"unavailable,omitempty"`
	MemberCount uint32     `json:"member_count"`

	Members  []Member         `json:"members"`
	Channels []PartialChannel `json:"channels"`
	Threads  []PartialChannel `json:"threads"`
}

type DefaultValueOption struct {
	ID   Snowflake        `json:"id"`   // Snowflake ID of a user, role, or channel
	Type DefaultValueType `json:"type"` // The type of value that the option represents. Should be consistent across all default value options.
}

type DefaultValueType string

type Embed struct {
	Title       string          `json:"title,omitempty"`
	URL         string          `json:"url,omitempty"`
	Author      *EmbedAuthor    `json:"author,omitempty"`
	Color       uint32          `json:"color,omitempty"`
	Thumbnail   *EmbedThumbnail `json:"thumbnail,omitempty"`
	Description string          `json:"description,omitempty"`
	Fields      []EmbedField    `json:"fields,omitzero"`
	Footer      *EmbedFooter    `json:"footer,omitempty"`
	Image       *EmbedImage     `json:"image,omitempty"`
	Video       *EmbedVideo     `json:"video,omitempty"`
	Provider    *EmbedProvider  `json:"provider,omitempty"`
	Timestamp   *time.Time      `json:"timestamp,omitempty"`
}

type EmbedAuthor struct {
	Name         string `json:"name"`
	URL          string `json:"url,omitempty"`
	IconURL      string `json:"icon_url,omitempty"`
	ProxyIconURL string `json:"proxy_icon_url,omitempty"`
}

type EmbedField struct {
	Name   string `json:"name"`
	Value  string `json:"value"`
	Inline bool   `json:"inline"`
}

type EmbedFooter struct {
	Text         string `json:"text"`
	IconURL      string `json:"icon_url,omitempty"`
	ProxyIconURL string `json:"proxy_icon_url,omitempty"`
}

type EmbedImage struct {
	URL      string `json:"url"`
	ProxyURL string `json:"proxy_url,omitempty"`
	Width    uint32 `json:"width,omitempty"`
	Height   uint32 `json:"height,omitempty"`
}

type EmbedProvider struct {
	URL  string `json:"url,omitempty"`
	Name string `json:"name,omitempty"`
}

type EmbedThumbnail struct {
	URL      string `json:"url"`
	ProxyURL string `json:"proxy_url,omitempty"`
	Width    uint32 `json:"width,omitempty"`
	Height   uint32 `json:"height,omitempty"`
}

type EmbedVideo struct {
	URL      string `json:"url,omitempty"`
	ProxyURL string `json:"proxy_url,omitempty"`
	Width    uint32 `json:"width,omitempty"`
	Height   uint32 `json:"height,omitempty"`
}

type Emoji struct {
	ID            Snowflake   `json:"id,omitempty"`
	Name          string      `json:"name,omitempty"` // Note: may be empty for deleted emojis.
	Roles         []Snowflake `json:"roles,omitzero"`
	User          *User       `json:"user,omitempty"`
	RequireColons bool        `json:"require_colons"`
	Managed       bool        `json:"managed"`
	Animated      bool        `json:"animated"`
	Available     bool        `json:"available"`
}

type Entitlement struct {
	ID            Snowflake       `json:"id"`
	SkuID         Snowflake       `json:"sku_id"`
	ApplicationID Snowflake       `json:"application_id"`
	UserID        Snowflake       `json:"user_id,omitempty"` // ID of the user that is granted access to the entitlement's sku
	Type          EntitlementType `json:"type"`
	Deleted       bool            `json:"deleted"` // Whether entitlement was deleted
	StartsAt      *time.Time      `json:"starts_at"`
	EndsAt        *time.Time      `json:"ends_at"`
	GuildID       Snowflake       `json:"guild_id,omitempty"`
	Consumed      bool            `json:"consumed"` // Whether entitlement was already used
}

type EntitlementType uint8

type EventName string

type EventPacket struct {
	Opcode   Opcode          `json:"op"`
	Sequence uint32          `json:"s,omitempty"`
	Event    EventName       `json:"t,omitempty"`
	Data     json.RawMessage `json:"d"`
}

type ExplicitContentFilter uint8

type File struct {
	Name   string // File's display name
	Reader io.Reader
}

type FileComponent struct {
	Type    ComponentType     `json:"type"` // Always = FILE_COMPONENT_TYPE (13)
	ID      uint32            `json:"id,omitempty"`
	File    UnfurledMediaItem `json:"file"` // This unfurled media item is unique in that it only supports attachment references using the attachment://<filename> syntax.
	Spoiler bool              `json:"spoiler"`

	Name string `json:"name,omitempty"` // This field is ignored and provided by the API as part of the response.
	Size uint32 `json:"size,omitempty"` // The size of the file in bytes. This field is ignored and provided by the API as part of the response.
}

type FileUploadComponent struct {
	Type      ComponentType `json:"type"`         // Always = FILE_UPLOAD_COMPONENT_TYPE (19)
	ID        uint32        `json:"id,omitempty"` // Optional identifier for component
	CustomID  string        `json:"custom_id,omitempty"`
	MinValues uint8         `json:"min_values,omitempty"`
	MaxValues uint8         `json:"max_values,omitempty"`
	Required  bool          `json:"required"`
}

type GatewayBot struct {
	URL               string            `json:"url"`
	ShardCount        uint16            `json:"shards"`
	SessionStartLimit SessionStartLimit `json:"session_start_limit"`
}

type GatewayClient struct {
	*BaseClient
	Gateway *ShardManager
	// contains filtered or unexported fields
}

type GatewayClientOptions struct {
	BaseClientOptions
	Trace              bool // Whether to enable detailed logging for shard manager and basic client actions.
	CustomEventHandler func(shardID uint16, packet EventPacket)
}

type Guild struct {
	ID                          Snowflake                `json:"id"`
	Name                        string                   `json:"name"`
	IconHash                    string                   `json:"icon,omitempty"`             // Hash code used to access guild's icon. Call Guild.IconURL to get direct url.
	SplashHash                  string                   `json:"splash,omitempty"`           // Hash code used to access guild's splash background. Call Guild.SplashURL to get direct url.
	DiscoverySplashHash         string                   `json:"discovery_splash,omitempty"` // Hash code used to access guild's special discovery splash background (only available for "DISCOVERABLE" guilds). Call Guild.DiscoverySplashURL to get direct url.
	OwnerID                     Snowflake                `json:"owner_id"`
	AFKChannelID                Snowflake                `json:"afk_channel_id,omitempty"`
	AFKChannelTimeout           uint32                   `json:"afk_timeout"`                 // AFK timeout value in seconds.
	WidgetEnabled               bool                     `json:"widget_enabled"`              // Whether server uses widget.
	WidgetChannelID             Snowflake                `json:"widget_channel_id,omitempty"` // The channel ID that the widget will generate an invite to, or null if set to no invite.
	DefaultMessageNotifications MessageNotificationLevel `json:"default_message_notifications"`
	ExplicitContentFilter       ExplicitContentFilter    `json:"explicit_content_filter"`
	Roles                       []Role                   `json:"roles,omitzero"`
	Emojis                      []Emoji                  `json:"emojis,omitzero"`
	Features                    []string                 `json:"features,omitzero"` // // https://docs.discord.com/developers/resources/guild#guild-object-guild-features
	MFALevel                    MFALevel                 `json:"mfa_level"`
	ApplicationID               Snowflake                `json:"application_id,omitempty"` // Application id of the guild creator if it is bot-created (never seen it in use).
	SystemChannelID             Snowflake                `json:"system_channel_id,omitempty"`
	SystemChannelFlags          SystemChannelFlags       `json:"system_channel_flags"`
	RulesChannelID              Snowflake                `json:"rules_channel_id,omitempty"`
	MaxPresences                uint32                   `json:"max_presences,omitempty"` // The maximum number of presences for the guild (null is always returned, apart from the largest of guilds).
	MaxMembers                  uint32                   `json:"max_members,omitempty"`
	VanityURL                   string                   `json:"vanity_url_code,omitempty"`
	Description                 string                   `json:"description,omitempty"`
	BannerHash                  string                   `json:"banner,omitempty"` // Hash code used to access guild's icon. Call Guild.BannerURL to get direct url.
	PremiumTier                 PremiumTier              `json:"premium_tier"`
	PremiumSubscriptionCount    uint32                   `json:"premium_subscription_count,omitempty"` // The number of boosts this guild currently has.
	PrefferedLocale             string                   `json:"preferred_locale,omitempty"`

	ApproximateMemberCount    uint32 `json:"approximate_member_count,omitempty"`
	ApproximatePresenceCount  uint32 `json:"approximate_presence_count,omitempty"`
	PremiumProgressBarEnabled bool   `json:"premium_progress_bar_enabled"`
}

type HTTPClient struct {
	*BaseClient
	PublicKey ed25519.PublicKey
}

type HTTPClientOptions struct {
	BaseClientOptions
	PublicKey string
	Trace     bool // Whether to enable basic logging for the client actions.
}

type HeartbeatEvent struct {
	Opcode   Opcode `json:"op"`
	Sequence uint32 `json:"d"`
}

type HelloEventData struct {
	HeartbeatInterval uint32 `json:"heartbeat_interval"`
}

type IdentifyEvent struct {
	Opcode Opcode              `json:"op"`
	Data   IdentifyPayloadData `json:"d"`
}

type IdentifyPayloadData struct {
	Token          string                        `json:"token"`
	Intents        uint32                        `json:"intents"`
	ShardOrder     [2]uint16                     `json:"shard"`           // [currentID, maxCount]
	LargeThreshold uint8                         `json:"large_threshold"` // 50 - 250
	Properties     IdentifyPayloadDataProperties `json:"properties"`
}

type IdentifyPayloadDataProperties struct {
	OS      string `json:"os"`
	Browser string `json:"browser"`
	Device  string `json:"device"`
}

type Interaction struct {
	ID            Snowflake       `json:"id"`
	ApplicationID Snowflake       `json:"application_id"`
	Type          InteractionType `json:"type"`
	Data          json.RawMessage `json:"data"`

	GuildID Snowflake `json:"guild_id,omitempty"`

	ChannelID Snowflake `json:"channel_id,omitempty"`
	Member    *Member   `json:"member,omitempty"`
	User      *User     `json:"user,omitempty"`
	Token     string    `json:"token"` // Temporary token used for responding to the interaction. It's not the same as bot token.

	PermissionFlags PermissionFlags `json:"app_permissions,string"` // Bitwise set of permissions the app/bot has within the channel the interaction was sent from (guild text channel or DM channel).
	Locale          Language        `json:"locale,omitempty"`       // Selected language of the invoking user.
	GuildLocale     string          `json:"guild_locale,omitempty"` // Guild's preferred locale, available if invoked in a guild.
	Entitlements    []Entitlement   `json:"entitlements,omitzero"`  // For monetized apps, any entitlements for the invoking user, representing access to premium SKUs.

	BaseClient    *BaseClient    `json:"-"` // Always provided.
	HTTPClient    *HTTPClient    `json:"-"` // Only provided if using HTTP Client.
	GatewayClient *GatewayClient `json:"-"` // Only provided if using Gateway Client.
	ShardID       uint16         `json:"-"` // Only provided if using Gateway Client. Shard ID = 0 is also a valid ID.
	// contains filtered or unexported fields
}

type InteractionContextType uint16 // use uint16 instead uint8 to avoid Go's json marshal logic that thinks of it as symbols.

type InteractionDataResolved struct {
	Users       map[Snowflake]User           `json:"users,omitzero"`
	Members     map[Snowflake]Member         `json:"members,omitzero"`
	Roles       map[Snowflake]Role           `json:"roles,omitzero"`
	Channels    map[Snowflake]PartialChannel `json:"channels,omitzero"`
	Messages    map[Snowflake]Message        `json:"messages,omitzero"`
	Attachments map[Snowflake]Attachment     `json:"attachments,omitzero"`
}

type InteractionType uint8

type InteractionTypeExtractor struct {
	Type InteractionType `json:"type"`
}

type InteractiveComponent interface {
	AnyComponent
	// contains filtered or unexported methods
}

type LabelChildComponent interface {
	AnyComponent
	// contains filtered or unexported methods
}

type LabelComponent struct {
	Type        ComponentType       `json:"type"`                  // Always = LABEL_COMPONENT_TYPE (18)
	ID          uint32              `json:"id,omitempty"`          // Optional identifier for component
	Label       string              `json:"label"`                 // The header text to show on the label; max 45 characters.
	Description string              `json:"description,omitempty"` // An additional description for the label; max 100 characters.
	Component   LabelChildComponent `json:"component"`             // The component nested within the label.
}

type Language string

type LayoutComponent interface {
	AnyComponent
	// contains filtered or unexported methods
}

type MFALevel uint8

type MediaGalleryComponent struct {
	Type  ComponentType      `json:"type"` // Always = MEDIA_GALLERY_COMPONENT_TYPE (12)
	ID    uint32             `json:"id,omitempty"`
	Items []MediaGalleryItem `json:"items,omitzero"` // 1 to 10 media gallery items
}

type MediaGalleryItem struct {
	Media       UnfurledMediaItem `json:"media"`
	Description string            `json:"description,omitempty"` // Alt text for the media, max 1024 characters
	Spoiler     bool              `json:"spoiler"`
}

type Member struct {
	User                       *User             `json:"user,omitempty"`
	Nickname                   string            `json:"nick,omitempty"`
	GuildAvatarHash            string            `json:"avatar,omitempty"` // Hash code used to access member's custom, guild avatar. Call Member.GuildAvatarURL to get direct url.
	GuildBannerHash            string            `json:"banner,omitempty"` // Hash code used to access member's custom, guild banner. Call Member.GuildBannerURL to get direct url.
	RoleIDs                    []Snowflake       `json:"roles"`
	JoinedAt                   *time.Time        `json:"joined_at"`
	PremiumSince               *time.Time        `json:"premium_since,omitempty"`
	Deaf                       bool              `json:"deaf"`
	Mute                       bool              `json:"mute"`
	Flags                      MemberFlags       `json:"flags"`
	Pending                    bool              `json:"pending"`
	PermissionFlags            PermissionFlags   `json:"permissions,string"`
	CommunicationDisabledUntil *time.Time        `json:"communication_disabled_until,omitempty"`
	AvatarDecorationData       *AvatarDecoration `json:"avatar_decoration_data,omitempty"`

	// It's not part of Member API data struct but tempest Client should always attach it for conveniency.
	GuildID Snowflake `json:"-"`
}

type MemberFlags BitSet

type Message struct {
	ID                  Snowflake                   `json:"id"`
	ChannelID           Snowflake                   `json:"channel_id"`
	Author              *User                       `json:"author,omitempty"`  // The author of this message.
	Content             string                      `json:"content,omitempty"` // The message's content.
	Timestamp           *time.Time                  `json:"timestamp"`
	EditedTimestamp     *time.Time                  `json:"edited_timestamp,omitempty"`
	TTS                 bool                        `json:"tts"`              // Whether this was a TTS message.
	MentionEveryone     bool                        `json:"mention_everyone"` // Whether this message mentions everyone.
	Mentions            []User                      `json:"mentions"`         // All users specifically mentioned in the message.
	MentionRoles        []Snowflake                 `json:"mention_roles"`
	MentionChannels     []ChannelMention            `json:"mention_channels,omitzero"`
	Attachments         []Attachment                `json:"attachments"`
	Embeds              []Embed                     `json:"embeds"`
	Reactions           []Reaction                  `json:"reactions,omitzero"`
	Pinned              bool                        `json:"pinned"`
	WebhookID           Snowflake                   `json:"webhook_id,omitempty"`
	Type                BitSet                      `json:"type,omitempty"` // https://docs.discord.com/developers/resources/channel#message-object-message-types
	ApplicationID       Snowflake                   `json:"application_id,omitempty"`
	MessageReference    *MessageReference           `json:"message_reference,omitempty"`
	Flags               MessageFlags                `json:"flags,omitempty"`
	ReferencedMessage   *Message                    `json:"referenced_message,omitempty"`
	InteractionMetadata *MessageInteractionMetadata `json:"interaction_metadata,omitempty"`
	Components          []MessageComponent          `json:"components,omitzero"` // All components included in the message.
	StickerItems        []StickerItem               `json:"sticker_items,omitzero"`
}

type MessageComponent interface {
	AnyComponent
	// contains filtered or unexported methods
}

type MessageFlags BitSet

type MessageInteractionMetadata struct {
	ID              Snowflake       `json:"id"`
	Type            InteractionType `json:"type"`
	User            User            `json:"user"`
	TargetUser      *User           `json:"target_user,omitempty"`
	TargetMessageID Snowflake       `json:"target_message_id,omitempty"`
}

type MessageNotificationLevel uint8

type MessageReference struct {
	Type            MessageReferenceType `json:"type,omitempty"`
	MessageID       Snowflake            `json:"message_id,omitempty"`
	ChannelID       Snowflake            `json:"channel_id,omitempty"`
	GuildID         Snowflake            `json:"guild_id,omitempty"`
	FailIfNotExists bool                 `json:"fail_if_not_exists"`
}

type MessageReferenceType uint8

type ModalComponent interface {
	AnyComponent
	// contains filtered or unexported methods
}

type ModalInteraction struct {
	*Interaction
	Data ModalInteractionData `json:"data"`
}

type ModalInteractionData struct {
	CustomID   string           `json:"custom_id"`
	Components []ModalComponent `json:"components,omitzero"` // The components that were sent inside the modal, having been filled with user input.
}

type NitroType uint8

type Opcode uint8

type OptionType uint8

type PartialChannel struct {
	ID              Snowflake       `json:"id"`
	Name            string          `json:"name"`
	PermissionFlags PermissionFlags `json:"permissions,string"`
	Type            ChannelType     `json:"type"`
}

type PermissionFlags BitSet

type Poll struct {
	Question    PollMedia      `json:"question"`
	Answers     []PollAnswer   `json:"answers,omitzero"`
	Duration    uint16         `json:"duration,omitempty"` // Number of hours the poll should be open for, up to 32 days (defaults to 24)
	Multiselect bool           `json:"allow_multiselect"`
	LayoutType  PoolLayoutType `json:"layout_type"`
}

type PollAnswer struct {
	AnswerID  uint32    `json:"answer_id,omitempty"`
	PollMedia PollMedia `json:"poll_media"`
}

type PollMedia struct {
	Text  string `json:"text,omitempty"`
	Emoji *Emoji `json:"emoji,omitempty"`
}

type PoolAnswerCounts struct {
	ID      uint32 `json:"id"` // The answer_id
	Count   uint32 `json:"count"`
	MeVoted bool   `json:"me_voted"`
}

type PoolLayoutType uint8

type PoolResult struct {
	Finalized    bool               `json:"is_finalized"`
	AnswerCounts []PoolAnswerCounts `json:"answer_counts"`
}

type PremiumTier uint8

type RadioGroupComponent struct {
	Type     ComponentType      `json:"type"`         // Always = RADIO_GROUP_COMPONENT_TYPE (21)
	ID       uint32             `json:"id,omitempty"` // Optional identifier for component
	CustomID string             `json:"custom_id,omitempty"`
	Options  []RadioGroupOption `json:"options,omitzero"` // List of options to show; min 2, max 10
	Required bool               `json:"required"`         // Whether a selection is required to submit the modal (defaults to true)
}

type RadioGroupOption struct {
	Value       string `json:"value"`
	Label       string `json:"label"`
	Description string `json:"description,omitempty"`
	Default     bool   `json:"default"` // Whether to render this option as selected by default.
}

type Reaction struct {
	Count        uint32               `json:"count"`
	CountDetails ReactionCountDetails `json:"count_details"`
	Me           bool                 `json:"me"`
	MeBurst      bool                 `json:"me_burst"`
	Emoji        Emoji                `json:"emoji"`
	BurstColors  []string             `json:"burst_colors"` // HEX colors used for super reaction
}

type ReactionCountDetails struct {
	Burst  uint32 `json:"burst"`
	Normal uint32 `json:"normal"`
}

type ReadyEventData struct {
	User             User               `json:"user"`
	Version          uint8              `json:"v"` // Version of Discord API version
	SessionID        string             `json:"session_id"`
	ResumeGatewayURL string             `json:"resume_gateway_url"`
	Guilds           []UnavailableGuild `json:"guilds"`
}

type Response struct {
	Type  ResponseType `json:"type"`
	Data  any          `json:"data,omitempty"`
	Files []File       `json:"-"`
}

type ResponseAutoComplete struct {
	Type ResponseType              `json:"type"`
	Data *ResponseAutoCompleteData `json:"data,omitempty"`
}

type ResponseAutoCompleteData struct {
	Choices []CommandOptionChoice `json:"choices,omitzero"` // The autocomplete choices to show, up to 25 in total.
}

type ResponseMessage struct {
	Type ResponseType         `json:"type"`
	Data *ResponseMessageData `json:"data,omitempty"`
}

type ResponseMessageData struct {
	TTS             bool               `json:"tts"`                        // Whether the message is a TTS message.
	Content         string             `json:"content,omitempty"`          // The message content.
	Embeds          []Embed            `json:"embeds,omitzero"`            // Up to 10 rich content embeds to include.
	AllowedMentions *AllowedMentions   `json:"allowed_mentions,omitempty"` // Data pertaining to the message's allowed mentions.
	Flags           MessageFlags       `json:"flags,omitempty"`            // A bitfield containing message flags. Note that only [SUPPRESS_EMBEDS_MESSAGE_FLAG], [EPHEMERAL_MESSAGE_FLAG], [IS_COMPONENTS_V2_MESSAGE_FLAG], [IS_VOICE_MESSAGE_MESSAGE_FLAG] and [SUPPRESS_NOTIFICATIONS_MESSAGE_FLAG] can be set.
	Components      []MessageComponent `json:"components,omitzero"`        // Any components to send alongside the message.
	Attachments     []Attachment       `json:"attachments,omitzero"`       // Any attachments to send alongside the message.
	Poll            *Poll              `json:"poll,omitempty"`             // An optional poll to include in the message.
}

type ResponseModal struct {
	Type ResponseType       `json:"type"`
	Data *ResponseModalData `json:"data,omitempty"`
}

type ResponseModalData struct {
	CustomID   string           `json:"custom_id"`           // A custom identifier for the modal. Must be non-empty and between 1-100 characters.
	Title      string           `json:"title"`               // The title of the modal. Must be under 45 characters.
	Components []ModalComponent `json:"components,omitzero"` // 1-5 components that will make up the modal's body. Will be returned populated with user-filled data.
}

type ResponseType uint8

type Rest struct {
	HTTPClient http.Client
	MaxRetries uint8
	// contains filtered or unexported fields
}

type ResumeEvent struct {
	Opcode Opcode          `json:"op"`
	Data   ResumeEventData `json:"d"`
}

type ResumeEventData struct {
	Token     string `json:"token"`
	SessionID string `json:"session_id"`
	Sequence  uint32 `json:"seq"` // Last sequence number received
}

type Role struct {
	ID              Snowflake       `json:"id"`
	Name            string          `json:"name"`
	Color           uint32          `json:"color"` // Integer representation of hexadecimal color code. Roles without colors (color == 0) do not count towards the final computed color in the user list.
	Hoist           bool            `json:"hoist"` // Whether this role is pinned in the user listing.
	IconHash        string          `json:"icon,omitempty"`
	UnicodeEmoji    string          `json:"unicode_emoji,omitempty"`
	Position        uint8           `json:"position"`
	PermissionFlags PermissionFlags `json:"permissions,string"`
	Managed         bool            `json:"managed"`     // Whether this role is managed by an integration.
	Mentionable     bool            `json:"mentionable"` // Whether this role is mentionable.
	Tags            RoleTag         `json:"tags"`
	Flags           BitSet          `json:"flags"` // https://docs.discord.com/developers/topics/permissions#role-object-role-flags
}

type RoleTag struct {
	BotID                 Snowflake `json:"bot_id,omitempty"`
	IntegrationID         Snowflake `json:"integration_id,omitempty"`          // The id of the integration this role belongs to.
	PremiumSubscriber     bool      `json:"premium_subscriber"`                // Whether this is the guild's Booster role.
	SubscriptionListingID Snowflake `json:"subscription_listing_id,omitempty"` // The id of this role's subscription sku and listing.
	AvailableForPurchase  bool      `json:"available_for_purchase"`
	GuildConnections      bool      `json:"guild_connections"` // Whether this role is a guild's linked role.
}

type SectionComponent struct {
	Type       ComponentType          `json:"type"` // Always = SECTION_COMPONENT_TYPE (9)
	ID         uint32                 `json:"id,omitempty"`
	Components []TextDisplayComponent `json:"components,omitzero"` // 1-3 text display components representing the section's text content.
	Accessory  AccessoryComponent     `json:"accessory,omitempty"` // A component contextually associated to the section's content.
}

type SelectComponent struct {
	Type          ComponentType        `json:"type"` // Either USER_SELECT_COMPONENT_TYPE, ROLE_SELECT_COMPONENT_TYPE, MENTIONABLE_SELECT_COMPONENT_TYPE or CHANNEL_SELECT_COMPONENT_TYPE
	ID            uint32               `json:"id,omitempty"`
	CustomID      string               `json:"custom_id,omitempty"`
	ChannelTypes  []ChannelType        `json:"channel_types,omitzero"`  // List of channel types to include in the channel select component; should be omitted for all other select types
	Placeholder   string               `json:"placeholder,omitempty"`   // Placeholder text if nothing is selected, max: 150 characters
	DefaultValues []DefaultValueOption `json:"default_values,omitzero"` // List of default values for auto-populated select menu components; must have between MinValues and MaxValues entries
	MinValues     uint8                `json:"min_values,omitempty"`    // The minimum number of items that must be chosen; defaults to 1 and must be between 0 and 25
	MaxValues     uint8                `json:"max_values,omitempty"`    // The maximum number of items that can be chosen; defaults to 1 and must be between 0 and 25
	Disabled      bool                 `json:"disabled"`                // Whether the select menu is disabled inside a message; default false. Will result in an error if used inside a modal!
}

type SelectMenuOption struct {
	Label       string `json:"label"`                 // Text label that appears on the option label, max 80 characters.
	Value       string `json:"value"`                 // Value to return back to app once clicked, max 100 characters.
	Description string `json:"description,omitempty"` // An additional description of the option, max 100 characters.
	Emoji       *Emoji `json:"emoji,omitempty"`       // It may only contain id, name, and animated from regular Emoji struct.
	Default     bool   `json:"default"`               // Whether to render this option as selected by default.
}

type SeparatorComponent struct {
	Type    ComponentType `json:"type"` // Always = SEPARATOR_COMPONENT_TYPE (14)
	ID      uint32        `json:"id,omitempty"`
	Divider bool          `json:"divider"`           // Whether a visual divider should be displayed in the component (defaults to true).
	Spacing uint8         `json:"spacing,omitempty"` // Size of separator padding—1 for small padding, 2 for large padding (defaults to 1).
}

type SessionStartLimit struct {
	ResetAfter     uint32 `json:"reset_after"`
	Total          uint16 `json:"total"`           // max 1000
	Remaining      uint16 `json:"remaining"`       // max 1000
	MaxConcurrency uint16 `json:"max_concurrency"` // Number of identify requests allowed per 5 seconds.
}

type Shard struct {
	ID uint16
	// contains filtered or unexported fields
}

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

type ShardState uint8

type SharedMap[K comparable, V any] struct {
	// contains filtered or unexported fields
}

type Snowflake uint64

type StatusType string

type StickerFormatType uint8

type StickerItem struct {
	ID         Snowflake         `json:"id"`
	Name       string            `json:"name"`
	FormatType StickerFormatType `json:"format_type"`
}

type StringSelectComponent struct {
	Type        ComponentType      `json:"type"` // Always = STRING_SELECT_COMPONENT_TYPE (3). For responses, only provided for modal interactions
	ID          uint32             `json:"id,omitempty"`
	CustomID    string             `json:"custom_id,omitempty"`
	Options     []SelectMenuOption `json:"options,omitzero"`
	Placeholder string             `json:"placeholder,omitempty"`
	MinValues   uint8              `json:"min_values,omitempty"`
	MaxValues   uint8              `json:"max_values,omitempty"`
	Disabled    bool               `json:"disabled"`
	Required    bool               `json:"required"`

	// Below 2 fields are controlled by API and should be readonly for us, developers.
	// https://docs.discord.com/developers/components/reference#string-select-string-select-interaction-response-structure
	ComponentType ComponentType `json:"component_type,omitempty"` // This field is ignored and provided by the API as part of the response (only provided for message interaction)
	Values        []string      `json:"values,omitzero"`          // This field is ignored and provided by the API as part of the response.
}

type SystemChannelFlags BitSet

type TestEntitlementPayload struct {
	SkuID     Snowflake `json:"sku_id"`
	OwnerID   Snowflake `json:"owner_id"`
	OwnerType uint8     `json:"owner_type"` // 1 for a guild subscription, 2 for a user subscription
}

type TextDisplayComponent struct {
	Type    ComponentType `json:"type"` // Always = TEXT_DISPLAY_COMPONENT_TYPE (10)
	ID      uint32        `json:"id,omitempty"`
	Content string        `json:"content"` // The Markdown content to display.
}

type TextInputComponent struct {
	Type        ComponentType  `json:"type"` // Always = TEXT_INPUT_COMPONENT_TYPE (4)
	ID          uint32         `json:"id,omitempty"`
	CustomID    string         `json:"custom_id,omitempty"`
	Style       TextInputStyle `json:"style"`
	Label       string         `json:"label,omitempty"`       // Deprecated: use `label` and `description` on a Label component instead
	MinLength   uint16         `json:"min_length,omitempty"`  // min: 0, max: 4000 characters
	MaxLength   uint16         `json:"max_length,omitempty"`  // min: 1, max: 4000 characters
	Required    bool           `json:"required"`              // Whether this component is required to be filled, defaults to true
	Value       string         `json:"value,omitempty"`       // Pre-filled value for this component; max 4000 characters. Once the user submits the modal, this will be populated with their input.
	Placeholder string         `json:"placeholder,omitempty"` // Placeholder text to display when no text is present. Max: 100 characters
}

type TextInputStyle uint8

type ThumbnailComponent struct {
	Type        ComponentType     `json:"type"` // Always = THUMBNAIL_COMPONENT_TYPE (11)
	ID          uint32            `json:"id,omitempty"`
	Media       UnfurledMediaItem `json:"media"`
	Description string            `json:"description,omitempty"` // Alt text for the media, max 1024 characters
	Spoiler     bool              `json:"spoiler"`
}

type UnavailableGuild struct {
	ID          Snowflake `json:"id"`
	Unavailable bool      `json:"unavailable"`
}

type UnfurledMediaItem struct {
	URL          string    `json:"url"` // 	Supports arbitrary urls and attachment://<filename> references
	ProxyURL     string    `json:"proxy_url,omitempty"`
	Width        uint32    `json:"width,omitempty"`
	Height       uint32    `json:"height,omitempty"`
	ContentType  string    `json:"content_type,omitempty"`  // This field is ignored and provided by the API as part of the response
	AttachmentID Snowflake `json:"attachment_id,omitempty"` // This field is ignored and provided by the API as part of the response
}

type UpdatePresenceEvent struct {
	Opcode Opcode                  `json:"op"`
	Data   UpdatePresenceEventData `json:"d"`
}

type UpdatePresenceEventData struct {
	Since      *int64     `json:"since"` // Unix time (in milliseconds) of when the client went idle, or null if the client is not idle
	Activities []Activity `json:"activities"`
	Emoji      Emoji      `json:"emoji"`
	AFK        bool       `json:"afk"`
}

type User struct {
	ID                   Snowflake         `json:"id"`
	Username             string            `json:"username"`
	GlobalName           string            `json:"global_name,omitempty"`  // User's display name. Tempest lib will make it equal to user.Username if it was empty.
	AvatarHash           string            `json:"avatar,omitempty"`       // Hash code used to access user's profile. Call User.AvatarURL to get direct url.
	Bot                  bool              `json:"bot"`                    // Whether it's bot/app account.
	System               bool              `json:"system"`                 // Whether user is Discord System Message account.
	BannerHash           string            `json:"banner,omitempty"`       // Hash code used to access user's baner. Call User.BannerURL to get direct url.
	AccentColor          uint32            `json:"accent_color,omitempty"` // User's banner color, encoded as an integer representation of hexadecimal color code.
	Locale               string            `json:"locale,omitempty"`
	PremiumType          NitroType         `json:"premium_type,omitempty"`
	PublicFlags          UserFlags         `json:"public_flags,omitempty"` // (Same as regular, user flags)
	AvatarDecorationData *AvatarDecoration `json:"avatar_decoration_data,omitempty"`
}

type UserFlags BitSet