@wolfstar/plugin-gateway 0.13.0 → 0.14.0-next-20261009112235

package/README.md

@@ -221,7 +221,8 @@ without touching the cache again.
 - `client.replayDispatch({ t, d, s? }, shardId, state?)` emits `raw` and the matching event, with the same Structures
   and `old` arguments the connected client emitted. It never reads or writes the cache, and never emits `dispatch`.
   Dispatches of a guild replay in order, like on a connected client. `client.replayDispatchTypes` lists the types it
-  handles: `READY` and `INTERACTION_CREATE` are not replayed, so `client.user` stays `null` until something sets it,
+  handles: `READY` and `INTERACTION_CREATE` are not replayed, so `client.user` stays `null` until something sets it (and
+  `client.application` partial until `fetch()`),
   and shard lifecycle events never fire. The promise rejects when a listener or the handler throws, which lets the
   caller retry the dispatch; async listeners are awaited.
 
@@ -684,7 +685,7 @@ already ships (`User`, `Message`, `Attachment`, `Embed`, `Reaction`, `Poll`, `Em
 cache, CDN URLs, and actions through the client. The ones it has no counterpart for yet (`Guild`,
 `GuildMember`, `Role`, `ThreadMember`, `GuildScheduledEvent`, ...) extend its base `Structure`.
 They live in one folder per domain, each with an `index.ts`, mirroring `@discordjs/structures`:
-`automoderation/`, `channels/` (and `channels/mixins/`), `emojis/`, `guilds/`, `invites/`,
+`applications/`, `automoderation/`, `channels/` (and `channels/mixins/`), `emojis/`, `guilds/`, `invites/`,
 `messages/`, `polls/`, `presences/`, `soundboards/`, `stageInstances/`, `stickers/`, `users/`,
 `voice/`, and `webhooks/`.
 
@@ -1029,6 +1030,29 @@ await webhook.editMessage(message.id, "Awoo!");
 const fetched = await client.fetchWebhook(webhookId, token); // no bot authorization needed
 ```
 
+### Application
+
+`client.application` is a `ClientApplication`, the entry point for what the application owns rather than a guild.
+Unlike discord.js, where it is `null` until `READY`, it is never `null`: the client builds it from `clientId`, so it
+exists before `READY` and without a gateway connection (a client replaying another process's dispatches never sees
+`READY`, and keeps it that way). Until then it is `partial`: only `id` is known, `READY` patches the very same
+instance with the `flags`, and `fetch()` with everything else. It lives on the client, not in the cache.
+
+```ts
+client.application.partial; // true until fetch() or edit() resolves
+await client.application.fetch(); // GET /applications/@me
+client.application.name; // "Wolf"
+client.application.owner; // a Team, a User, or null
+client.application.iconURL();
+
+await client.application.edit({ description: "Awoo", tags: ["wolf"] });
+await client.application.editRoleConnectionMetadataRecords(records);
+```
+
+`owner` is the `Team` (with its `members`, each a `TeamMember`) when a team owns the application, the owner `User`
+otherwise. `application.commands`, `application.emojis` and the entitlements will be added to `ClientApplication`
+by their own features, there are no placeholders for them.
+
 ### Messages
 
 `Message` follows discord.js: `attachments`, `embeds`, `mentions` (`MessageMentions`), `reactions`

package/dist/esm/index.d.ts

@@ -2,7 +2,7 @@ import { Client, ClientOptions, Listener } from "@wolfstar/http-framework";
 import { OptionalWebSocketManagerOptions, ShardRange, WebSocketManager } from "@discordjs/ws";
 import { API, Client as Client$1 } from "@discordjs/core";
 import { Awaitable, Cache as Cache$1, CacheEntityName, CacheEntityTypes, CacheFactory, CachePolicies, EntityCache, GatewaySessionStore, IterableEntityCache } from "@wolfstar/plugin-cache";
-import { APIActionRowComponent, APIAllowedMentions, APIApplication, APIApplicationCommand, APIAttachment, APIAuditLogChange, APIAuthorizingIntegrationOwnersMap, APIAutoModerationAction, APIAutoModerationRule, APIAutoModerationRuleTriggerMetadata, APIAvatarDecorationData, APIButtonComponentWithCustomId, APIButtonComponentWithSKUId, APIButtonComponentWithURL, APIChannel, APIChannelMention, APIChannelSelectComponent, APICheckboxComponent, APICheckboxGroupComponent, APICheckboxGroupOption, APICollectibles, APIComponentInActionRow, APIComponentInMessageActionRow, APIContainerComponent, APIEmbed, APIEmbedAuthor, APIEmbedField, APIEmbedFooter, APIEmbedImage, APIEmbedProvider, APIEmbedThumbnail, APIEmbedVideo, APIEmoji, APIEntitlement, APIExtendedInvite, APIFileComponent, APIFileUploadComponent, APIGuild, APIGuildForumDefaultReactionEmoji, APIGuildForumTag, APIGuildMember, APIGuildOnboarding, APIGuildOnboardingPrompt, APIGuildOnboardingPromptOption, APIGuildPreview, APIGuildScheduledEvent, APIGuildScheduledEventEntityMetadata, APIGuildScheduledEventRecurrenceRule, APIGuildScheduledEventRecurrenceRuleNWeekday, APIGuildWelcomeScreen, APIGuildWidget, APIGuildWidgetMember, APIIncidentsData, APIInviteChannel, APIInviteGuild, APILabelComponent, APIMediaGalleryComponent, APIMediaGalleryItem, APIMentionableSelectComponent, APIMessage, APIMessageActivity, APIMessageCall, APIMessageComponent, APIMessageComponentEmoji, APIMessageInteractionMetadata, APIMessageReference, APIMessageRoleSubscriptionData, APIMessageSharedClientTheme, APIMessageTopLevelComponent, APIModalComponent, APIOverwrite, APIPartialEmoji, APIPoll, APIPollAnswer, APIRadioGroupComponent, APIRadioGroupOption, APIReaction, APIRole, APIRoleSelectComponent, APIRoleTags, APISKU, APISectionComponent, APISelectMenuDefaultValue, APISelectMenuOption, APISeparatorComponent, APISoundboardSound, APIStageInstance, APISticker, APIStickerPack, APIStringSelectComponent, APISubscription, APITemplate, APITextDisplayComponent, APITextInputComponent, APIThreadChannel, APIThreadMember, APIThumbnailComponent, APIUnfurledMediaItem, APIUser, APIUserPrimaryGuild, APIUserSelectComponent, APIVoiceRegion, APIWebhook, ActivityFlags, ActivityType, AllowedMentionsTypes, ApplicationCommandOptionType, ApplicationFlags, AttachmentFlags, AuditLogEvent, AutoModerationActionType, AutoModerationRuleEventType, AutoModerationRuleKeywordPresetType, AutoModerationRuleTriggerType, ButtonStyle, ChannelFlags, ChannelType, FileUploadType, ForumLayoutType, GatewayActivity, GatewayActivityAssets, GatewayActivityUpdateData, GatewayAutoModerationActionExecutionDispatchData, GatewayChannelInfoDispatchData, GatewayChannelPinsUpdateDispatchData, GatewayDispatchEvents, GatewayDispatchPayload, GatewayGuildDeleteDispatchData, GatewayGuildIntegrationsUpdateDispatchData, GatewayGuildMemberRemoveDispatchData, GatewayGuildMembersChunkDispatchData, GatewayGuildRoleDeleteDispatchData, GatewayGuildScheduledEventUserAddDispatchData, GatewayGuildScheduledEventUserRemoveDispatchData, GatewayGuildSoundboardSoundDeleteDispatchData, GatewayIntegrationDeleteDispatchData, GatewayIntentBits, GatewayInviteCreateDispatchData, GatewayInviteDeleteDispatchData, GatewayMessageDeleteBulkDispatchData, GatewayMessageDeleteDispatchData, GatewayMessageReactionRemoveAllDispatchData, GatewayPresenceClientStatus, GatewayPresenceUpdateData, GatewayRateLimitedDispatchData, GatewayReadyDispatchData, GatewayRequestChannelInfoField, GatewayThreadDeleteDispatchData, GatewayThreadListSync, GatewayThreadMembersUpdateDispatchData, GatewayTypingStartDispatchData, GatewayVoiceServerUpdateDispatchData, GatewayWebhooksUpdateDispatchData, GuildDefaultMessageNotifications, GuildExplicitContentFilter, GuildMemberFlags, GuildOnboardingMode, GuildOnboardingPromptType, GuildPremiumTier, GuildScheduledEventEntityType, GuildScheduledEventPrivacyLevel, GuildScheduledEventRecurrenceRuleFrequency, GuildScheduledEventRecurrenceRuleMonth, GuildScheduledEventRecurrenceRuleWeekday, GuildScheduledEventStatus, GuildSystemChannelFlags, GuildVerificationLevel, GuildWidgetStyle, InteractionType, InviteTargetType, InviteType, Locale, MessageActivityType, MessageFlags, MessageReferenceType, MessageSearchAuthorType, MessageSearchEmbedType, MessageSearchHasType, MessageSearchSortMode, NameplatePalette, OverwriteType, PermissionFlagsBits, PollLayoutType, PresenceUpdateReceiveStatus, PresenceUpdateStatus, RESTAPIPoll, RESTGetAPIGuildVanityUrlResult, RESTPatchAPIChannelJSONBody, RESTPatchAPIGuildJSONBody, RESTPostAPIApplicationCommandsJSONBody, RESTPostAPIChannelMessageJSONBody, RESTPostAPIGuildsJSONBody, ReactionType, RoleFlags, SelectMenuDefaultValueType, SeparatorSpacingSize, Snowflake, SortOrderType, StageInstancePrivacyLevel, StickerFormatType, ThreadAutoArchiveDuration, ThreadChannelType, UserFlags, VideoQualityMode } from "discord-api-types/v10";
+import { APIActionRowComponent, APIAllowedMentions, APIApplication, APIApplicationCommand, APIAttachment, APIAuditLogChange, APIAuthorizingIntegrationOwnersMap, APIAutoModerationAction, APIAutoModerationRule, APIAutoModerationRuleTriggerMetadata, APIAvatarDecorationData, APIButtonComponentWithCustomId, APIButtonComponentWithSKUId, APIButtonComponentWithURL, APIChannel, APIChannelMention, APIChannelSelectComponent, APICheckboxComponent, APICheckboxGroupComponent, APICheckboxGroupOption, APICollectibles, APIComponentInActionRow, APIComponentInMessageActionRow, APIContainerComponent, APIEmbed, APIEmbedAuthor, APIEmbedField, APIEmbedFooter, APIEmbedImage, APIEmbedProvider, APIEmbedThumbnail, APIEmbedVideo, APIEmoji, APIEntitlement, APIExtendedInvite, APIFileComponent, APIFileUploadComponent, APIGuild, APIGuildForumDefaultReactionEmoji, APIGuildForumTag, APIGuildMember, APIGuildOnboarding, APIGuildOnboardingPrompt, APIGuildOnboardingPromptOption, APIGuildPreview, APIGuildScheduledEvent, APIGuildScheduledEventEntityMetadata, APIGuildScheduledEventRecurrenceRule, APIGuildScheduledEventRecurrenceRuleNWeekday, APIGuildWelcomeScreen, APIGuildWidget, APIGuildWidgetMember, APIIncidentsData, APIInviteChannel, APIInviteGuild, APILabelComponent, APIMediaGalleryComponent, APIMediaGalleryItem, APIMentionableSelectComponent, APIMessage, APIMessageActivity, APIMessageCall, APIMessageComponent, APIMessageComponentEmoji, APIMessageInteractionMetadata, APIMessageReference, APIMessageRoleSubscriptionData, APIMessageSharedClientTheme, APIMessageTopLevelComponent, APIModalComponent, APIOverwrite, APIPartialEmoji, APIPoll, APIPollAnswer, APIRadioGroupComponent, APIRadioGroupOption, APIReaction, APIRole, APIRoleSelectComponent, APIRoleTags, APISKU, APISectionComponent, APISelectMenuDefaultValue, APISelectMenuOption, APISeparatorComponent, APISoundboardSound, APIStageInstance, APISticker, APIStickerPack, APIStringSelectComponent, APISubscription, APITeam, APITeamMember, APITemplate, APITextDisplayComponent, APITextInputComponent, APIThreadChannel, APIThreadMember, APIThumbnailComponent, APIUnfurledMediaItem, APIUser, APIUserPrimaryGuild, APIUserSelectComponent, APIVoiceRegion, APIWebhook, ActivityFlags, ActivityType, AllowedMentionsTypes, ApplicationCommandOptionType, ApplicationFlags, ApplicationIntegrationType, ApplicationRoleConnectionMetadataType, ApplicationWebhookEventStatus, ApplicationWebhookEventType, AttachmentFlags, AuditLogEvent, AutoModerationActionType, AutoModerationRuleEventType, AutoModerationRuleKeywordPresetType, AutoModerationRuleTriggerType, ButtonStyle, ChannelFlags, ChannelType, FileUploadType, ForumLayoutType, GatewayActivity, GatewayActivityAssets, GatewayActivityUpdateData, GatewayAutoModerationActionExecutionDispatchData, GatewayChannelInfoDispatchData, GatewayChannelPinsUpdateDispatchData, GatewayDispatchEvents, GatewayDispatchPayload, GatewayGuildDeleteDispatchData, GatewayGuildIntegrationsUpdateDispatchData, GatewayGuildMemberRemoveDispatchData, GatewayGuildMembersChunkDispatchData, GatewayGuildRoleDeleteDispatchData, GatewayGuildScheduledEventUserAddDispatchData, GatewayGuildScheduledEventUserRemoveDispatchData, GatewayGuildSoundboardSoundDeleteDispatchData, GatewayIntegrationDeleteDispatchData, GatewayIntentBits, GatewayInviteCreateDispatchData, GatewayInviteDeleteDispatchData, GatewayMessageDeleteBulkDispatchData, GatewayMessageDeleteDispatchData, GatewayMessageReactionRemoveAllDispatchData, GatewayPresenceClientStatus, GatewayPresenceUpdateData, GatewayRateLimitedDispatchData, GatewayReadyDispatchData, GatewayRequestChannelInfoField, GatewayThreadDeleteDispatchData, GatewayThreadListSync, GatewayThreadMembersUpdateDispatchData, GatewayTypingStartDispatchData, GatewayVoiceServerUpdateDispatchData, GatewayWebhooksUpdateDispatchData, GuildDefaultMessageNotifications, GuildExplicitContentFilter, GuildMemberFlags, GuildOnboardingMode, GuildOnboardingPromptType, GuildPremiumTier, GuildScheduledEventEntityType, GuildScheduledEventPrivacyLevel, GuildScheduledEventRecurrenceRuleFrequency, GuildScheduledEventRecurrenceRuleMonth, GuildScheduledEventRecurrenceRuleWeekday, GuildScheduledEventStatus, GuildSystemChannelFlags, GuildVerificationLevel, GuildWidgetStyle, InteractionType, InviteTargetType, InviteType, Locale, LocalizationMap, MessageActivityType, MessageFlags, MessageReferenceType, MessageSearchAuthorType, MessageSearchEmbedType, MessageSearchHasType, MessageSearchSortMode, NameplatePalette, OAuth2Scopes, OverwriteType, PermissionFlagsBits, PollLayoutType, PresenceUpdateReceiveStatus, PresenceUpdateStatus, RESTAPIPoll, RESTGetAPIGuildVanityUrlResult, RESTPatchAPIChannelJSONBody, RESTPatchAPIGuildJSONBody, RESTPostAPIApplicationCommandsJSONBody, RESTPostAPIChannelMessageJSONBody, RESTPostAPIGuildsJSONBody, ReactionType, RoleFlags, SelectMenuDefaultValueType, SeparatorSpacingSize, Snowflake, SortOrderType, StageInstancePrivacyLevel, StickerFormatType, TeamMemberMembershipState, TeamMemberRole, ThreadAutoArchiveDuration, ThreadChannelType, UserFlags, VideoQualityMode } from "discord-api-types/v10";
 import { APIActualInvite, ActionRowComponent, Activity as Activity$1, ActivityFlagsBitField as ActivityFlagsBitField$1, AnnouncementChannel as AnnouncementChannel$1, AnnouncementThreadChannel as AnnouncementThreadChannel$1, Attachment as Attachment$1, AttachmentFlagsBitField as AttachmentFlagsBitField$1, AutoModerationRule as AutoModerationRule$1, BitField, BitField as BitField$1, BitFieldResolvable, BitFieldResolvable as BitFieldResolvable$1, CategoryChannel as CategoryChannel$1, Channel as Channel$1, ChannelFlagsBitField as ChannelFlagsBitField$1, ChannelSelectMenuComponent as ChannelSelectMenuComponent$1, Component as Component$1, ContainerComponent as ContainerComponent$1, DMChannel as DMChannel$1, Embed as Embed$1, Emoji as Emoji$1, FileComponent as FileComponent$1, FileUploadComponent as FileUploadComponent$1, ForumChannel as ForumChannel$1, GroupDMChannel as GroupDMChannel$1, InteractiveButtonComponent as InteractiveButtonComponent$1, Invite, LinkButtonComponent as LinkButtonComponent$1, MediaChannel as MediaChannel$1, MediaGalleryComponent as MediaGalleryComponent$1, MediaGalleryItem as MediaGalleryItem$1, MentionableSelectMenuComponent as MentionableSelectMenuComponent$1, Message as Message$1, MessageFlagsBitField as MessageFlagsBitField$1, Partialize as Partialize$1, PermissionsBitField, Poll as Poll$1, PollAnswer as PollAnswer$1, PremiumButtonComponent as PremiumButtonComponent$1, Presence as Presence$1, PrivateThreadChannel as PrivateThreadChannel$1, PublicThreadChannel as PublicThreadChannel$1, Reaction, RoleSelectMenuComponent as RoleSelectMenuComponent$1, SectionComponent as SectionComponent$1, SeparatorComponent as SeparatorComponent$1, SoundboardSound as SoundboardSound$1, StageChannel as StageChannel$1, StageInstance as StageInstance$1, Sticker as Sticker$1, StickerPack as StickerPack$1, StringSelectMenuComponent as StringSelectMenuComponent$1, Structure as Structure$1, TextChannel as TextChannel$1, TextDisplayComponent as TextDisplayComponent$1, TextInputComponent as TextInputComponent$1, ThumbnailComponent as ThumbnailComponent$1, UnfurledMediaItem as UnfurledMediaItem$1, User as User$1, UserSelectMenuComponent as UserSelectMenuComponent$1, VoiceChannel as VoiceChannel$1, VoiceState as VoiceState$1, Webhook as Webhook$1 } from "@discordjs/structures";
 import { BaseImageURLOptions, EmojiURLOptions, ImageURLOptions, REST, RawFile } from "@discordjs/rest";
 import { Collection, ReadonlyCollection } from "@discordjs/collection";
@@ -3851,6 +3851,20 @@ export declare class GuildEmojiManager extends CachedManager<"emojis", GuildEmoj
    * @throws {TypeError} When the store cannot enumerate its entries.
    */
   listCached(): Promise<GuildEmoji[]>;
+  /**
+   * Finds a custom emoji by its ID across every guild held in the cache, without calling the API.
+   *
+   * @remarks
+   * Emojis are keyed by guild and ID, so it enumerates the whole entity cache like {@link GuildEmojiManager.listCached}.
+   * The manager's own guild plays no part in the lookup.
+   *
+   * @param emojiId The ID of the emoji.
+   * @returns The cached emoji, `null` when no guild has it or this entity is not cached.
+   * @throws {TypeError} When the store cannot enumerate its entries.
+   * @internal
+   */
+  findCachedInAnyGuild(emojiId: string): Promise<GuildEmoji | null>;
+  private collectCached;
   protected fetchRaw(emojiId: string): Promise<{
     id: import("discord-api-types/globals").Snowflake | null;
     name: string | null;
@@ -10672,6 +10686,303 @@ export declare class UserManager extends CachedManager<"users", User, [userId: s
   private requireId;
 }
 //#endregion
+//#region src/structures/applications/Application.d.ts
+/**
+ * The raw fields of an application: its ID, and any of the others. `READY` only carries the ID and flags, so a
+ * partial application holds just these.
+ */
+export type ApplicationData = Pick<APIApplication, "id"> & Partial<Omit<APIApplication, "id">>;
+/**
+ * The public attributes of an application, like discord.js's `Application`.
+ *
+ * @typeParam Data The raw application data this structure wraps.
+ */
+export declare class Application<Data extends ApplicationData = ApplicationData> extends Structure<Data> {
+  get id(): string;
+  /**
+   * The name of the application, or `null` while it is not known.
+   */
+  get name(): string | null;
+  /**
+   * The description of the application, or `null` if it has none or is not known.
+   */
+  get description(): string | null;
+  /**
+   * The hash of the application's icon, or `null` if it has none or is not known.
+   */
+  get icon(): string | null;
+  /**
+   * The hash of the application's cover image, or `null` if it has none or is not known.
+   */
+  get cover(): string | null;
+  get createdTimestamp(): number;
+  get createdAt(): Date;
+  /**
+   * Gets the URL of the application's icon, or `null` if it has none.
+   *
+   * @param options The image options.
+   */
+  iconURL(options?: BaseImageURLOptions): string | null;
+  /**
+   * Gets the URL of the application's cover image, or `null` if it has none.
+   *
+   * @param options The image options.
+   */
+  coverURL(options?: BaseImageURLOptions): string | null;
+  /**
+   * The name of the application, its ID while the name is not known.
+   */
+  toString(): string;
+}
+//#endregion
+//#region src/structures/applications/TeamMember.d.ts
+/**
+ * The relations of a {@link TeamMember}, set by its {@link Team}.
+ */
+export interface TeamMemberRelations {
+  team?: Team | null;
+}
+/**
+ * A member of a {@link Team}, like discord.js's `TeamMember`.
+ */
+export declare class TeamMember extends Structure<APITeamMember> {
+  #private;
+  [kRelations]: TeamMemberRelations;
+  /**
+   * @param data The raw team member.
+   * @param relations The team the member belongs to, set by the team itself.
+   */
+  constructor(data: APITeamMember, relations?: TeamMemberRelations);
+  /**
+   * The ID of the member's user.
+   */
+  get id(): string;
+  /**
+   * The team the member belongs to, or `null` when the member was built by hand.
+   */
+  get team(): Team | null;
+  /**
+   * The permissions of the member in the team. Discord only ever sends `["*"]`.
+   */
+  get permissions(): readonly string[];
+  /**
+   * Whether the member accepted the invite to the team, or is still invited.
+   */
+  get membershipState(): TeamMemberMembershipState;
+  /**
+   * The role of the member in the team.
+   */
+  get role(): TeamMemberRole;
+  /**
+   * The user of the member.
+   */
+  get user(): User;
+  /**
+   * The mention of the member's user.
+   */
+  toString(): string;
+}
+//#endregion
+//#region src/structures/applications/Team.d.ts
+/**
+ * A team of developers owning an application, like discord.js's `Team`.
+ */
+export declare class Team extends Structure<APITeam> {
+  #private;
+  get id(): string;
+  get name(): string;
+  /**
+   * The hash of the team's icon, or `null` if it has none.
+   */
+  get icon(): string | null;
+  /**
+   * The ID of the user owning the team.
+   */
+  get ownerId(): string;
+  /**
+   * The members of the team, by the ID of their user.
+   */
+  get members(): Collection<string, TeamMember>;
+  /**
+   * The member owning the team, if it is among {@link Team.members}.
+   */
+  get owner(): TeamMember | null;
+  get createdTimestamp(): number;
+  get createdAt(): Date;
+  /**
+   * Gets the URL of the team's icon, or `null` if it has none.
+   *
+   * @param options The image options.
+   */
+  iconURL(options?: BaseImageURLOptions): string | null;
+  toString(): string;
+}
+//#endregion
+//#region src/structures/applications/ClientApplication.d.ts
+/**
+ * The install parameters of an application: the scopes and permissions it asks for when it is added.
+ */
+export interface ApplicationInstallParams {
+  scopes: OAuth2Scopes[];
+  permissions: Readonly<PermissionsBitField>;
+}
+/**
+ * The install parameters of an application for each integration type (guild or user install).
+ */
+export type ApplicationIntegrationTypesConfig = { [Type in ApplicationIntegrationType]?: {
+  oauth2InstallParams: ApplicationInstallParams | null;
+}; };
+/**
+ * The install parameters to set, with permissions in any form a `PermissionsBitField` resolves.
+ */
+export interface ApplicationInstallParamsOptions {
+  scopes: OAuth2Scopes[];
+  permissions: PermissionResolvable;
+}
+/**
+ * The options to edit the application with.
+ *
+ * @remarks
+ * Omitted fields are left unchanged. Images are data URIs (`data:image/png;base64,...`) or anything `resolveImage`
+ * reads (contents, a path, a URL, a stream, a blob), `null` removes them.
+ */
+export interface ClientApplicationEditOptions {
+  customInstallURL?: string;
+  description?: string;
+  eventWebhooksURL?: string | null;
+  eventWebhooksStatus?: ApplicationWebhookEventStatus;
+  eventWebhooksTypes?: ApplicationWebhookEventType[];
+  flags?: ApplicationFlagsResolvable;
+  icon?: ImageResolvable | null;
+  coverImage?: ImageResolvable | null;
+  interactionsEndpointURL?: string | null;
+  roleConnectionsVerificationURL?: string | null;
+  tags?: string[];
+  installParams?: ApplicationInstallParamsOptions;
+  integrationTypesConfig?: { [Type in ApplicationIntegrationType]?: {
+    oauth2InstallParams?: ApplicationInstallParamsOptions;
+  }; };
+}
+/**
+ * A role connection metadata record of an application, with camelCased fields like discord.js.
+ */
+export interface ApplicationRoleConnectionMetadata {
+  name: string;
+  nameLocalizations?: LocalizationMap;
+  description: string;
+  descriptionLocalizations?: LocalizationMap;
+  key: string;
+  type: ApplicationRoleConnectionMetadataType;
+}
+/**
+ * The application of the bot, the entry point for everything owned by the application rather than by a guild, like
+ * discord.js's `ClientApplication`.
+ *
+ * @remarks
+ * Unlike discord.js, `client.application` exists from the construction of the client, with only its ID known until
+ * `READY` patches in the flags, and {@link ClientApplication.fetch} the rest: check {@link ClientApplication.partial}
+ * before relying on the other fields.
+ */
+export declare class ClientApplication extends Application {
+  #private;
+  /**
+   * Whether only the ID and flags of the application are known: it has neither been fetched nor edited yet.
+   */
+  get partial(): boolean;
+  /**
+   * The flags of the application.
+   */
+  get flags(): Readonly<ApplicationFlagsBitField>;
+  /**
+   * The tags describing the application, at most five.
+   */
+  get tags(): string[];
+  /**
+   * The scopes and permissions the application asks for when it is added to a guild, or `null` if it sets none.
+   */
+  get installParams(): ApplicationInstallParams | null;
+  /**
+   * The install parameters of the application for each integration type, or `null` if it sets none.
+   */
+  get integrationTypesConfig(): ApplicationIntegrationTypesConfig | null;
+  /**
+   * The URL the application is installed through, instead of Discord's own install link.
+   */
+  get customInstallURL(): string | null;
+  /**
+   * The team owning the application, else the user who does, `null` while it is not known.
+   */
+  get owner(): Team | User | null;
+  /**
+   * Whether anyone can add the bot to a guild, or `null` if it is not known.
+   */
+  get botPublic(): boolean | null;
+  /**
+   * Whether the bot only joins guilds after the full OAuth2 code grant flow, or `null` if it is not known.
+   */
+  get botRequireCodeGrant(): boolean | null;
+  /**
+   * The ID of the guild linked to the application, or `null` if there is none.
+   */
+  get guildId(): string | null;
+  /**
+   * The guild linked to the application, from the cache.
+   */
+  get guild(): Guild | null;
+  /**
+   * The approximate number of guilds the bot is in, or `null` if it is not known.
+   */
+  get approximateGuildCount(): number | null;
+  /**
+   * The approximate number of users who installed the application, or `null` if it is not known.
+   */
+  get approximateUserInstallCount(): number | null;
+  /**
+   * The URL interactions are sent to, or `null` if there is none.
+   */
+  get interactionsEndpointURL(): string | null;
+  /**
+   * The URL of the role connections verification, or `null` if there is none.
+   */
+  get roleConnectionsVerificationURL(): string | null;
+  /**
+   * The URL event webhooks are sent to, or `null` if there is none.
+   */
+  get eventWebhooksURL(): string | null;
+  /**
+   * Whether event webhooks are enabled, or `null` if it is not known.
+   */
+  get eventWebhooksStatus(): ApplicationWebhookEventStatus | null;
+  /**
+   * The event types sent to {@link ClientApplication.eventWebhooksURL}, or `null` if it is not known.
+   */
+  get eventWebhooksTypes(): ApplicationWebhookEventType[] | null;
+  /**
+   * Fetches the application from the API, and patches this structure with it.
+   *
+   * @returns This application.
+   */
+  fetch(): Promise<this>;
+  /**
+   * Edits the application, and patches this structure with the result.
+   *
+   * @param options The fields to edit.
+   * @returns This application.
+   */
+  edit(options: ClientApplicationEditOptions): Promise<this>;
+  /**
+   * Fetches the role connection metadata records of the application.
+   */
+  fetchRoleConnectionMetadataRecords(): Promise<ApplicationRoleConnectionMetadata[]>;
+  /**
+   * Replaces the role connection metadata records of the application.
+   *
+   * @param records The records to set, up to five. Records left out are removed.
+   * @returns The records as stored.
+   */
+  editRoleConnectionMetadataRecords(records: readonly ApplicationRoleConnectionMetadata[]): Promise<ApplicationRoleConnectionMetadata[]>;
+}
+//#endregion
 //#region src/structures/users/ClientUser.d.ts
 /**
  * The presence to set for the bot user. Omitted fields keep their current value.
@@ -11467,6 +11778,17 @@ export declare class GatewayClient extends Client {
    * `null` if neither source answers (the failure is reported through `error`).
    */
   user: ClientUser | null;
+  /**
+   * The application of the bot, like discord.js's `Client#application`.
+   *
+   * @remarks
+   * Unlike discord.js, it is never `null`: it is built from {@link GatewayClientOptions.clientId} when the client is,
+   * so it exists before `READY` and without any gateway connection. It is then partial, see
+   * {@link ClientApplication.partial}: `READY` patches the same instance with the application's flags, and
+   * {@link ClientApplication.fetch} with the rest. It is kept on the client, not in the cache: it is a single small
+   * object, and every process gets the same `READY`.
+   */
+  readonly application: ClientApplication;
   readonly users: UserManager;
   readonly guilds: GuildManager;
   readonly channels: ChannelManager;
@@ -13228,6 +13550,19 @@ export declare function basename(path: string, ext?: string): string;
  * @param thing The file.
  */
 export declare function findName(thing: unknown): string;
+/**
+ * Finds a custom emoji by its ID in the cache of every guild, like discord.js's `resolveGuildEmoji`.
+ *
+ * @remarks
+ * Emojis are cached per guild, so it enumerates the whole emoji cache: it needs a store able to list its entries, and
+ * never calls the API.
+ *
+ * @param client The client whose cache to search.
+ * @param emojiId The ID of the emoji.
+ * @returns The emoji, `null` when no cached guild has it.
+ * @throws {TypeError} When the emoji cache cannot enumerate its entries.
+ */
+export declare function resolveGuildEmoji(client: GatewayClient, emojiId: Snowflake): Promise<GuildEmoji | null>;
 /**
  * Resolves a SKU, or its ID, to its ID.
  *