Added poll to the Message object [Suggestion #2201]

lib/discordgo/message.go

@@ -169,6 +169,9 @@ type Message struct {
 	StickerItems  []*StickerItem `json:"sticker_items"`
 	ApplicationID int64          `json:"application_id,string"`
 
+	// Poll object
+	Poll *Poll `json:"poll"`
+
 	// Data of the role subscription purchase or renewal that prompted this role subscription message.
 	RoleSubscriptionData *RoleSubscriptionData `json:"role_subscription_data,omitempty"`
 }
@@ -301,6 +304,7 @@ type MessageSend struct {
 	Reference       *MessageReference   `json:"message_reference,omitempty"`
 	Flags           MessageFlags        `json:"flags,omitempty"`
 	StickerIDs      []int64             `json:"sticker_ids"`
+	Poll            *Poll               `json:"poll,omitempty"`
 
 	// TODO: Remove this when compatibility is not required.
 	File *File `json:"-"`

lib/discordgo/structs.go

@@ -1761,6 +1761,57 @@ type AutoModerationAction struct {
 	Metadata *AutoModerationActionMetadata `json:"metadata,omitempty"`
 }
 
+// PollLayoutType represents the layout of a poll.
+type PollLayoutType int
+
+// Valid PollLayoutType values.
+const (
+	PollLayoutTypeDefault PollLayoutType = 1
+)
+
+// PollMedia contains common data used by question and answers.
+type PollMedia struct {
+	Text  string          `json:"text,omitempty"`
+	Emoji *ComponentEmoji `json:"emoji,omitempty"` // TODO: rename the type
+}
+
+// PollAnswer represents a single answer in a poll.
+type PollAnswer struct {
+	// NOTE: should not be set on creation.
+	AnswerID int        `json:"answer_id,omitempty"`
+	Media    *PollMedia `json:"poll_media"`
+}
+
+// PollAnswerCount stores counted poll votes for a single answer.
+type PollAnswerCount struct {
+	ID      int  `json:"id"`
+	Count   int  `json:"count"`
+	MeVoted bool `json:"me_voted"`
+}
+
+// PollResults contains voting results on a poll.
+type PollResults struct {
+	Finalized    bool               `json:"is_finalized"`
+	AnswerCounts []*PollAnswerCount `json:"answer_counts"`
+}
+
+// Poll contains all poll related data.
+type Poll struct {
+	Question         PollMedia      `json:"question"`
+	Answers          []PollAnswer   `json:"answers"`
+	AllowMultiselect bool           `json:"allow_multiselect"`
+	LayoutType       PollLayoutType `json:"layout_type,omitempty"`
+
+	// NOTE: should be set only on creation, when fetching use Expiry.
+	Duration int `json:"duration,omitempty"`
+
+	// NOTE: available only when fetching.
+
+	Results *PollResults `json:"results,omitempty"`
+	// NOTE: as Discord documentation notes, this field might be null even when fetching.
+	Expiry *time.Time `json:"expiry,omitempty"`
+}
+
 type SKUType int
 
 // Valid SKUType values

lib/dstate/helpers.go

@@ -88,6 +88,7 @@ func MessageStateFromDgo(m *discordgo.Message) *MessageState {
 		Content:              m.Content,
 		MessageSnapshots:     convertMessageSnapshots(m.MessageSnapshots),
 		Embeds:               embeds,
+		Poll:             	  m.poll,
 		Mentions:             mentions,
 		Attachments:          attachments,
 		MentionRoles:         m.MentionRoles,

lib/dstate/interface.go

@@ -415,6 +415,7 @@ type MessageState struct {
 	MentionRoles     []int64
 	Attachments      []discordgo.MessageAttachment
 	Stickers         []discordgo.Sticker
+	Poll             *discordgo.Poll
 
 	ParsedCreatedAt time.Time
 	ParsedEditedAt  time.Time