kord-core/dev.kord.core.supplier/RestEntitySupplier

RestEntitySupplier

class RestEntitySupplier(val kord: Kord) : EntitySupplier(source)

EntitySupplier that uses a RestClient to resolve entities.

Error codes besides 429(Too Many Requests) will throw a RestRequestException, 404(Not Found) will be caught by the xOrNull variant and return null instead.

This supplier will always be able to resolve entities if they exist according to Discord, entities will always be up-to-date at the moment of the call.

Constructors

RestEntitySupplier

constructor(kord: Kord)

Properties

guilds

open override val guilds: Flow<Guild>

Requests all guilds this bot is known to be part of.

kord

val kord: Kord

regions

open override val regions: Flow<Region>

Requests all regions known to this bot.

Functions

getActiveThreads

open override fun getActiveThreads(guildId: Snowflake): Flow<ThreadChannel>

getApplicationCommandPermissions

open suspend fun getApplicationCommandPermissions(applicationId: Snowflake, guildId: Snowflake, commandId: Snowflake): ApplicationCommandPermissions

getApplicationCommandPermissionsOrNull

open suspend override fun getApplicationCommandPermissionsOrNull(applicationId: Snowflake, guildId: Snowflake, commandId: Snowflake): ApplicationCommandPermissions

getApplicationInfo

suspend fun getApplicationInfo(): Application

Requests to get the information of the current application.

getAuditLogEntries

fun getAuditLogEntries(guildId: Snowflake, request: AuditLogGetRequest = AuditLogGetRequest()): Flow<DiscordAuditLogEntry>

inline fun getAuditLogEntries(guildId: Snowflake, builder: AuditLogGetRequestBuilder.() -> Unit): Flow<DiscordAuditLogEntry>

getAutoModerationRule

open suspend fun getAutoModerationRule(guildId: Snowflake, ruleId: Snowflake): AutoModerationRule

Requests an AutoModerationRule by its id.

getAutoModerationRuleOrNull

open suspend override fun getAutoModerationRuleOrNull(guildId: Snowflake, ruleId: Snowflake): AutoModerationRule?

Requests an AutoModerationRule by its id. Returns null if it wasn't found.

getAutoModerationRules

open override fun getAutoModerationRules(guildId: Snowflake): Flow<AutoModerationRule>

Requests to get all AutoModerationRules currently configured for the Guild with the given guildId.

getChannel

open suspend fun getChannel(id: Snowflake): Channel

Requests the Channel with the given id.

getChannelOf

inline suspend fun <T : Channel> EntitySupplier.getChannelOf(id: Snowflake): T

Requests the Channel with the given id as type T.

getChannelOfOrNull

inline suspend fun <T : Channel> EntitySupplier.getChannelOfOrNull(id: Snowflake): T?

Requests the Channel with the given id as type T, returns null if the channel isn't present or if the channel is not of type T.

getChannelOrNull

open suspend override fun getChannelOrNull(id: Snowflake): Channel?

Requests the Channel with the given id, returns null when the channel isn't present.

getChannelPins

open override fun getChannelPins(channelId: Snowflake): Flow<Message>

Requests the pinned messages of the Channel with the given channelId.

getChannelWebhooks

open override fun getChannelWebhooks(channelId: Snowflake): Flow<Webhook>

Requests the webhooks of the MessageChannel with the given channelId.

getCurrentUserGuilds

open override fun getCurrentUserGuilds(limit: Int?): Flow<Guild>

Requests guilds this bot is known to be part of.

getEmoji

open suspend fun getEmoji(guildId: Snowflake, emojiId: Snowflake): GuildEmoji

Requests the GuildEmoji with the emojiId in the Guild wit the given guildId.

getEmojiOrNull

open suspend override fun getEmojiOrNull(guildId: Snowflake, emojiId: Snowflake): GuildEmoji?

Requests the GuildEmoji with the emojiId in the Guild wit the given guildId, returns null when the emoji isn't present.

getEmojis

open override fun getEmojis(guildId: Snowflake): Flow<GuildEmoji>

Requests the guild emojis of the Guild with the given guildId.

getEntitlements

open override fun getEntitlements(applicationId: Snowflake, request: EntitlementsListRequest): Flow<Entitlement>

Requests to get all Entitlements for the Application with the given applicationId.

getFollowupMessage

open suspend fun getFollowupMessage(applicationId: Snowflake, interactionToken: String, messageId: Snowflake): FollowupMessage

Requests a followup message for an interaction response.

getFollowupMessageOrNull

open suspend override fun getFollowupMessageOrNull(applicationId: Snowflake, interactionToken: String, messageId: Snowflake): FollowupMessage?

Requests a followup message for an interaction response. Returns null if the followup message isn't present.

getGlobalApplicationCommand

open suspend fun getGlobalApplicationCommand(applicationId: Snowflake, commandId: Snowflake): GlobalApplicationCommand

getGlobalApplicationCommandOf

inline suspend fun <T : GlobalApplicationCommand> EntitySupplier.getGlobalApplicationCommandOf(applicationId: Snowflake, id: Snowflake): T

Requests the GlobalApplicationCommand with the given id as type T.

getGlobalApplicationCommandOfOrNull

inline suspend fun <T : GlobalApplicationCommand> EntitySupplier.getGlobalApplicationCommandOfOrNull(applicationId: Snowflake, id: Snowflake): T?

Requests the GuildApplicationCommand with the given id as type T, returns null if the command application isn't present or if the channel is not of type T.

getGlobalApplicationCommandOrNull

open suspend override fun getGlobalApplicationCommandOrNull(applicationId: Snowflake, commandId: Snowflake): GlobalApplicationCommand?

getGlobalApplicationCommands

open override fun getGlobalApplicationCommands(applicationId: Snowflake, withLocalizations: Boolean?): Flow<GlobalApplicationCommand>

getGlobalApplicationOf

inline suspend fun <T : GlobalApplicationCommand> EntitySupplier.getGlobalApplicationOf(applicationId: Snowflake, id: Snowflake): T

Requests the GlobalApplicationCommand with the given id as type T.

getGlobalApplicationOfOrNull

inline suspend fun <T : GlobalApplicationCommand> EntitySupplier.getGlobalApplicationOfOrNull(applicationId: Snowflake, id: Snowflake): T?

Requests the GlobalApplicationCommand with the given id as type T, returns null if the command application isn't present or if the channel is not of type T.

getGuild

open suspend fun getGuild(id: Snowflake): Guild

Requests the Guild with the given id.

getGuildApplicationCommand

open suspend fun getGuildApplicationCommand(applicationId: Snowflake, guildId: Snowflake, commandId: Snowflake): GuildApplicationCommand

getGuildApplicationCommandOf

inline suspend fun <T : GuildApplicationCommand> EntitySupplier.getGuildApplicationCommandOf(applicationId: Snowflake, guildId: Snowflake, id: Snowflake): T

Requests the GuildApplicationCommand with the given id as type T.

getGuildApplicationCommandOfOrNull

inline suspend fun <T : GuildApplicationCommand> EntitySupplier.getGuildApplicationCommandOfOrNull(applicationId: Snowflake, guildId: Snowflake, id: Snowflake): T?

Requests the GuildApplicationCommand with the given id as type T, returns null if the command application isn't present or if the channel is not of type T.

getGuildApplicationCommandOrNull

open suspend override fun getGuildApplicationCommandOrNull(applicationId: Snowflake, guildId: Snowflake, commandId: Snowflake): GuildApplicationCommand?

getGuildApplicationCommandPermissions

open override fun getGuildApplicationCommandPermissions(applicationId: Snowflake, guildId: Snowflake): Flow<ApplicationCommandPermissions>

getGuildApplicationCommands

open override fun getGuildApplicationCommands(applicationId: Snowflake, guildId: Snowflake, withLocalizations: Boolean?): Flow<GuildApplicationCommand>

getGuildBan

open suspend fun getGuildBan(guildId: Snowflake, userId: Snowflake): Ban

Requests the Ban for the user the given userId in the Guild wit the given guildId, returns null when the ban isn't present.

getGuildBanOrNull

open suspend override fun getGuildBanOrNull(guildId: Snowflake, userId: Snowflake): Ban?

Requests the Ban for the user the given userId in the Guild wit the given guildId, returns null when the ban isn't present.

getGuildBans

open override fun getGuildBans(guildId: Snowflake, limit: Int?): Flow<Ban>

Requests the bans of the Guild with the given guildId.

getGuildChannels

open override fun getGuildChannels(guildId: Snowflake): Flow<TopGuildChannel>

Requests the channels of the Guild with the given guildId, channels with an Unknown type will be filtered out of the list.

getGuildMembers

open override fun getGuildMembers(guildId: Snowflake, limit: Int?): Flow<Member>

Requests the members of the Guild with the given guildId.

getGuildOnboarding

suspend fun getGuildOnboarding(guildId: Snowflake): GuildOnboarding

Requests the onboarding object for the Guild with the given guildId.

getGuildOnboardingOrNull

suspend fun getGuildOnboardingOrNull(guildId: Snowflake): GuildOnboarding?

Requests the onboarding object for the Guild with the given guildId. Returns null if it wasn't found.

getGuildOrNull

open suspend override fun getGuildOrNull(id: Snowflake): Guild?

Requests the Guild with the given id, returns null when the guild isn't present.

getGuildPreview

open suspend fun getGuildPreview(guildId: Snowflake): GuildPreview

Requests the preview of the guild matching the guildId. If the bot is not in the guild, then the guild must be lurkable.

getGuildPreviewOrNull

open suspend override fun getGuildPreviewOrNull(guildId: Snowflake): GuildPreview?

Requests the preview of the guild matching the guildId. If the bot is not in the guild, then the guild must be lurkable. Returns null if the preview was not found.

getGuildRoles

open override fun getGuildRoles(guildId: Snowflake): Flow<Role>

Requests the roles of the Guild with the given guildId.

getGuildScheduledEvent

open suspend fun getGuildScheduledEvent(guildId: Snowflake, eventId: Snowflake): GuildScheduledEvent

getGuildScheduledEventMembers

open fun getGuildScheduledEventMembers(guildId: Snowflake, eventId: Snowflake, limit: Int? = null): Flow<Member>

getGuildScheduledEventMembersAfter

open override fun getGuildScheduledEventMembersAfter(guildId: Snowflake, eventId: Snowflake, after: Snowflake, limit: Int?): Flow<Member>

getGuildScheduledEventMembersBefore

open override fun getGuildScheduledEventMembersBefore(guildId: Snowflake, eventId: Snowflake, before: Snowflake, limit: Int?): Flow<Member>

getGuildScheduledEventOrNull

open suspend override fun getGuildScheduledEventOrNull(guildId: Snowflake, eventId: Snowflake): GuildScheduledEvent?

getGuildScheduledEvents

open override fun getGuildScheduledEvents(guildId: Snowflake): Flow<GuildScheduledEvent>

getGuildScheduledEventUsers

open fun getGuildScheduledEventUsers(guildId: Snowflake, eventId: Snowflake, limit: Int? = null): Flow<User>

getGuildScheduledEventUsersAfter

open override fun getGuildScheduledEventUsersAfter(guildId: Snowflake, eventId: Snowflake, after: Snowflake, limit: Int?): Flow<User>

getGuildScheduledEventUsersBefore

open override fun getGuildScheduledEventUsersBefore(guildId: Snowflake, eventId: Snowflake, before: Snowflake, limit: Int?): Flow<User>

getGuildSticker

open suspend fun getGuildSticker(guildId: Snowflake, id: Snowflake): GuildSticker

getGuildStickerOrNull

open suspend override fun getGuildStickerOrNull(guildId: Snowflake, id: Snowflake): GuildSticker?

getGuildStickers

open override fun getGuildStickers(guildId: Snowflake): Flow<GuildSticker>

getGuildVoiceRegions

open override fun getGuildVoiceRegions(guildId: Snowflake): Flow<Region>

Requests the regions of the Guild with the given guildId.

getGuildWebhooks

open override fun getGuildWebhooks(guildId: Snowflake): Flow<Webhook>

Requests the webhooks of the Guild with the given guildId.

getGuildWelcomeScreen

suspend fun getGuildWelcomeScreen(guildId: Snowflake): WelcomeScreen

getGuildWelcomeScreenOrNull

suspend fun getGuildWelcomeScreenOrNull(guildId: Snowflake): WelcomeScreen?

getGuildWidget

open suspend fun getGuildWidget(guildId: Snowflake): GuildWidget

Requests to get the widget of a Guild with the given id.

getGuildWidgetOrNull

open suspend override fun getGuildWidgetOrNull(guildId: Snowflake): GuildWidget?

Requests to get the widget of a Guild with the given id, returns null if the GuildWidget isn't present.

getInvite

suspend fun getInvite(code: String, withCounts: Boolean = true, withExpiration: Boolean = true, scheduledEventId: Snowflake? = null): Invite

getInviteOrNull

suspend fun getInviteOrNull(code: String, withCounts: Boolean = true, withExpiration: Boolean = true, scheduledEventId: Snowflake? = null): Invite?

getJoinedPrivateArchivedThreads

open override fun getJoinedPrivateArchivedThreads(channelId: Snowflake, before: Snowflake?, limit: Int?): Flow<ThreadChannel>

getMember

open suspend fun getMember(guildId: Snowflake, userId: Snowflake): Member

Requests the Member with the given userId in the Guild wit the given guildId.

getMemberOrNull

open suspend override fun getMemberOrNull(guildId: Snowflake, userId: Snowflake): Member?

Requests the Member with the given userId in the Guild wit the given guildId, returns null when the member isn't present.

getMessage

open suspend fun getMessage(channelId: Snowflake, messageId: Snowflake): Message

Requests the Message with the given messageId in the MessageChannel with the given channelId.

getMessageOrNull

open suspend override fun getMessageOrNull(channelId: Snowflake, messageId: Snowflake): Message?

Requests the Message with the given messageId in the MessageChannel with the given channelId, returns null when the message isn't present.

getMessagesAfter

open override fun getMessagesAfter(messageId: Snowflake, channelId: Snowflake, limit: Int?): Flow<Message>

Requests a flow of messages created after the Message with the messageId in the MessageChannel with the channelId.

getMessagesAround

open override fun getMessagesAround(messageId: Snowflake, channelId: Snowflake, limit: Int): Flow<Message>

Requests a flow of messages created around the Message with the messageId in the MessageChannel with the channelId.

getMessagesBefore

open override fun getMessagesBefore(messageId: Snowflake, channelId: Snowflake, limit: Int?): Flow<Message>

Requests a flow of messages created before the Message with the messageId in the MessageChannel with the channelId.

getNitroStickerPacks

open override fun getNitroStickerPacks(): Flow<StickerPack>

getOriginalInteraction

suspend fun getOriginalInteraction(applicationId: Snowflake, token: String): Message

Requests the initial interaction response.

getOriginalInteractionOrNull

suspend fun getOriginalInteractionOrNull(applicationId: Snowflake, token: String): Message?

Requests the initial interaction response, returns null if the initial interaction response isn't present.

getPrivateArchivedThreads

open override fun getPrivateArchivedThreads(channelId: Snowflake, before: Instant?, limit: Int?): Flow<ThreadChannel>

getPublicArchivedThreads

open override fun getPublicArchivedThreads(channelId: Snowflake, before: Instant?, limit: Int?): Flow<ThreadChannel>

getReactors

fun getReactors(channelId: Snowflake, messageId: Snowflake, emoji: ReactionEmoji): Flow<User>

getRole

open suspend fun getRole(guildId: Snowflake, roleId: Snowflake): Role

Requests the Role with the given roleId in the Guild wit the given guildId.

getRoleOrNull

open suspend override fun getRoleOrNull(guildId: Snowflake, roleId: Snowflake): Role?

Requests the Role with the given roleId in the Guild wit the given guildId, returns null when the role isn't present.

getSelf

open suspend fun getSelf(): User

Requests the User this bot represents.

getSelfOrNull

open suspend override fun getSelfOrNull(): User?

Requests the User this bot represents, returns null when the user isn't present.

getStageInstance

open suspend fun getStageInstance(channelId: Snowflake): StageInstance

getStageInstanceOrNull

open suspend override fun getStageInstanceOrNull(channelId: Snowflake): StageInstance?

getSticker

open suspend fun getSticker(id: Snowflake): Sticker

getStickerOrNull

open suspend override fun getStickerOrNull(id: Snowflake): Sticker?

getSubscription

open suspend fun getSubscription(skuId: Snowflake, subscriptionId: Snowflake): Subscription

Requests a Subscription by its id.

getSubscriptionOrNull

open suspend override fun getSubscriptionOrNull(skuId: Snowflake, subscriptionId: Snowflake): Subscription?

Requests a Subscription by its id. Returns null if it wasn't found.

getSubscriptions

open override fun getSubscriptions(skuId: Snowflake, request: SkuSubscriptionsListRequest): Flow<Subscription>

Requests to get all Subscriptions containing the Sku with the given skuId.

getTemplate

open suspend fun getTemplate(code: String): Template

Requests the Template with the given code. returns null when the webhook isn't present.

getTemplateOrNull

open suspend override fun getTemplateOrNull(code: String): Template?

Requests the Template with the given code. returns null when the template isn't present.

getTemplates

open override fun getTemplates(guildId: Snowflake): Flow<Template>

getThreadMembers

open override fun getThreadMembers(channelId: Snowflake): Flow<ThreadMember>

getUser

open suspend fun getUser(id: Snowflake): User

Requests the User with the given id.

getUserOrNull

open suspend override fun getUserOrNull(id: Snowflake): User?

Requests the User with the given id, returns null when the user isn't present.

getWebhook

open suspend fun getWebhook(id: Snowflake): Webhook

Requests the Webhook with the given id.

getWebhookMessage

open suspend fun getWebhookMessage(webhookId: Snowflake, token: String, messageId: Snowflake, threadId: Snowflake? = null): Message

Requests the Message with the given messageId previously sent from a Webhook with the given webhookId using the token for authentication.

getWebhookMessageOrNull

open suspend override fun getWebhookMessageOrNull(webhookId: Snowflake, token: String, messageId: Snowflake, threadId: Snowflake?): Message?

Requests the Message with the given messageId previously sent from a Webhook with the given webhookId using the token for authentication, returns null when the message isn't present.

getWebhookOrNull

open suspend override fun getWebhookOrNull(id: Snowflake): Webhook?

Requests the Webhook with the given id, returns null when the webhook isn't present.

getWebhookWithToken

open suspend fun getWebhookWithToken(id: Snowflake, token: String): Webhook

Requests the Webhook with the given id using the token for authentication.

getWebhookWithTokenOrNull

open suspend override fun getWebhookWithTokenOrNull(id: Snowflake, token: String): Webhook?

Requests the Webhook with the given id using the token for authentication, returns null when the webhook isn't present.

toString

open override fun toString(): String

withFallback

infix fun EntitySupplier.withFallback(other: EntitySupplier): EntitySupplier

Creates supplier providing a strategy which will first operate on this supplier. When an entity is not present from the first supplier it will be fetched from other instead. Operations that return flows will only fall back to other when the returned flow contained no elements.