add guild onboarding (#238)

discord/guild_onboarding.go

@@ -0,0 +1,37 @@
+package discord
+
+import "github.com/disgoorg/snowflake/v2"
+
+type GuildOnboarding struct {
+	GuildID           snowflake.ID            `json:"guild_id"`
+	Prompts           []GuildOnboardingPrompt `json:"prompts"`
+	DefaultChannelIDs []snowflake.ID          `json:"default_channel_ids"`
+	Enabled           bool                    `json:"enabled"`
+}
+
+type GuildOnboardingPrompt struct {
+	ID           snowflake.ID                  `json:"id"`
+	Options      []GuildOnboardingPromptOption `json:"options"`
+	Title        string                        `json:"title"`
+	SingleSelect bool                          `json:"single_select"`
+	Required     bool                          `json:"required"`
+	InOnboarding bool                          `json:"in_onboarding"`
+	Type         GuildOnboardingPromptType     `json:"type"`
+}
+
+type GuildOnboardingPromptOption struct {
+	ID          snowflake.ID   `json:"id"`
+	ChannelIDs  []snowflake.ID `json:"channel_ids"`
+	RoleIDs     []snowflake.ID `json:"role_ids"`
+	EmojiID     *snowflake.ID  `json:"emoji_id"`
+	EmojiName   *string        `json:"emoji_name"`
+	Title       string         `json:"title"`
+	Description *string        `json:"description"`
+}
+
+type GuildOnboardingPromptType int
+
+const (
+	GuildOnboardingPromptTypeMultipleChoice GuildOnboardingPromptType = iota
+	GuildOnboardingPromptTypeDropdown
+)

rest/guilds.go

@@ -55,6 +55,8 @@ type Guilds interface {
 
 	GetGuildWelcomeScreen(guildID snowflake.ID, opts ...RequestOpt) (*discord.GuildWelcomeScreen, error)
 	UpdateGuildWelcomeScreen(guildID snowflake.ID, screenUpdate discord.GuildWelcomeScreenUpdate, opts ...RequestOpt) (*discord.GuildWelcomeScreen, error)
+
+	GetGuildOnboarding(guildID snowflake.ID, opts ...RequestOpt) (*discord.GuildOnboarding, error)
 }
 
 type guildImpl struct {
@@ -290,3 +292,8 @@ func (s *guildImpl) UpdateGuildWelcomeScreen(guildID snowflake.ID, screenUpdate
 	err = s.client.Do(UpdateGuildWelcomeScreen.Compile(nil, guildID), screenUpdate, &welcomeScreen, opts...)
 	return
 }
+
+func (s *guildImpl) GetGuildOnboarding(guildID snowflake.ID, opts ...RequestOpt) (onboarding *discord.GuildOnboarding, err error) {
+	err = s.client.Do(GetGuildOnboarding.Compile(nil, guildID), nil, &onboarding, opts...)
+	return
+}

rest/rest_endpoints.go

@@ -89,6 +89,8 @@ var (
 	GetGuildWelcomeScreen    = NewEndpoint(http.MethodGet, "/guilds/{guild.id}/welcome-screen")
 	UpdateGuildWelcomeScreen = NewEndpoint(http.MethodPatch, "/guilds/{guild.id}/welcome-screen")
 
+	GetGuildOnboarding = NewEndpoint(http.MethodGet, "/guilds/{guild.id}/onboarding")
+
 	UpdateCurrentUserVoiceState = NewEndpoint(http.MethodPatch, "/guilds/{guild.id}/voice-states/@me")
 	UpdateUserVoiceState        = NewEndpoint(http.MethodPatch, "/guilds/{guild.id}/voice-states/{user.id}")
 )