refactor(types): split discord.ts into multiple files (#4088)

* Split reference types

* Split webhook events types

* Split interactions types

* Split gateway types

* Move application related types to applications.ts

* Split auditLog types

* Split autoModeration types

* Split channel types

* Split emoji types

* Split entitlement types

* Split guild types

* Split guildScheduledEvent types

* Split GuildTemplate types

* Split Invite types

* Split message types

* Split poll types

* Split sku types

* Split soundboard types

* Split stageInstances types

* Split sticker types

* Split subscription types

* Split user types

* Split voice types

* Split webhooks types

* Split oauth2 types

* Split opcodes types

* Split permission types

* Split teams types

* Sort out remaining types

* Rename to singlar to match discord docs

packages/gateway/src/manager.ts

@@ -271,7 +271,7 @@ export function createGatewayManager(options: CreateGatewayManagerOptions): Gate
       )
     },
     calculateWorkerId(shardId) {
-      const workerId = Math.min(Math.floor(shardId / gateway.shardsPerWorker), gateway.totalWorkers - 1);
+      const workerId = Math.min(Math.floor(shardId / gateway.shardsPerWorker), gateway.totalWorkers - 1)
       gateway.logger.debug(
         `[Gateway] Calculating workerId: Shard: ${shardId} -> Worker: ${workerId} -> Per Worker: ${gateway.shardsPerWorker} -> Total: ${gateway.totalWorkers}`,
       )

packages/types/src/discord/application.ts

@@ -0,0 +1,163 @@
+/** Types for: https://discord.com/developers/docs/resources/application */
+
+import type { DiscordGuild } from './guild.js'
+import type { OAuth2Scope } from './oauth2.js'
+import type { DiscordTeam } from './teams.js'
+import type { DiscordUser } from './user.js'
+import type { DiscordWebhookEventType } from './webhookEvents.js'
+
+/** https://discord.com/developers/docs/resources/application#application-object-application-structure */
+export interface DiscordApplication {
+  /** The name of the app */
+  name: string
+  /** The description of the app */
+  description: string
+  /** An array of rpc origin urls, if rpc is enabled */
+  rpc_origins?: string[]
+  /** The url of the app's terms of service */
+  terms_of_service_url?: string
+  /** The url of the app's privacy policy */
+  privacy_policy_url?: string
+  /** The hex encoded key for verification in interactions and the GameSDK's GetTicket */
+  verify_key: string
+  /** If this application is a game sold on Discord, this field will be the id of the "Game SKU" that is created, if exists */
+  primary_sku_id?: string
+  /** If this application is a game sold on Discord, this field will be the URL slug that links to the store page */
+  slug?: string
+  /** The application's public flags */
+  flags?: ApplicationFlags
+  /** The id of the app */
+  id: string
+  /** The icon hash of the app */
+  icon: string | null
+  /** When false only app owner can join the app's bot to guilds */
+  bot_public: boolean
+  /** When true the app's bot will only join upon completion of the full oauth2 code grant flow */
+  bot_require_code_grant: boolean
+  /** Partial user object containing info on the owner of the application */
+  owner?: Partial<DiscordUser>
+  /** If the application belongs to a team, this will be a list of the members of that team */
+  team: DiscordTeam | null
+  /** Guild associated with the app. For example, a developer support server. */
+  guild_id?: string
+  /** A partial object of the associated guild */
+  guild?: Partial<DiscordGuild>
+  /** If this application is a game sold on Discord, this field will be the hash of the image on store embeds */
+  cover_image?: string
+  /** up to 5 tags describing the content and functionality of the application */
+  tags?: string[]
+  /** settings for the application's default in-app authorization link, if enabled */
+  install_params?: DiscordInstallParams
+  /** Default scopes and permissions for each supported installation context. */
+  integration_types_config?: Partial<Record<`${DiscordApplicationIntegrationType}`, DiscordApplicationIntegrationTypeConfiguration>>
+  /** the application's default custom authorization link, if enabled */
+  custom_install_url?: string
+  /** the application's role connection verification entry point, which when configured will render the app as a verification method in the guild role verification configuration */
+  role_connections_verification_url?: string | null
+  /** An approximate count of the app's guild membership. */
+  approximate_guild_count?: number
+  /** Approximate count of users that have installed the app. */
+  approximate_user_install_count?: number
+  /** Partial user object for the bot user associated with the app */
+  bot?: Partial<DiscordUser>
+  /** Array of redirect URIs for the app */
+  redirect_uris?: string[]
+  /** Interactions endpoint URL for the app */
+  interactions_endpoint_url?: string | null
+  /** Event webhook URL for the app to receive webhook events */
+  event_webhooks_url?: string | null
+  /** If webhook events are enabled for the app. 1 to disable, and 2 to enable. */
+  event_webhooks_status: DiscordApplicationEventWebhookStatus
+  /** List of Webhook event types the app subscribes to */
+  event_webhooks_types?: DiscordWebhookEventType[]
+}
+
+/** https://discord.com/developers/docs/resources/application#application-object-application-integration-types */
+export enum DiscordApplicationIntegrationType {
+  /** App is installable to servers */
+  GuildInstall = 0,
+  /** App is installable to users */
+  UserInstall = 1,
+}
+
+/** https://discord.com/developers/docs/resources/application#application-object-application-integration-type-configuration-object */
+export interface DiscordApplicationIntegrationTypeConfiguration {
+  /** Install params for each installation context's default in-app authorization link */
+  oauth2_install_params?: DiscordInstallParams
+}
+
+/** https://discord.com/developers/docs/resources/application#application-object-application-event-webhook-status */
+export enum DiscordApplicationEventWebhookStatus {
+  /** Webhook events are disabled by developer */
+  Disabled = 1,
+  /** Webhook events are enabled by developer */
+  Enabled = 2,
+  /** Webhook events are disabled by Discord, usually due to inactivity */
+  DisabledByDiscord = 3,
+}
+
+/** https://discord.com/developers/docs/resources/application#application-object-application-flags */
+export enum ApplicationFlags {
+  /** Indicates if an app uses the Auto Moderation API. */
+  ApplicationAutoModerationRuleCreateBadge = 1 << 6,
+  /** Intent required for bots in **100 or more servers** to receive 'presence_update' events */
+  GatewayPresence = 1 << 12,
+  /** Intent required for bots in under 100 servers to receive 'presence_update' events */
+  GatewayPresenceLimited = 1 << 13,
+  /** Intent required for bots in **100 or more servers** to receive member-related events like 'guild_member_add'. */
+  GatewayGuildMembers = 1 << 14,
+  /** Intent required for bots in under 100 servers to receive member-related events like 'guild_member_add'.  */
+  GatewayGuildMembersLimited = 1 << 15,
+  /** Indicates unusual growth of an app that prevents verification */
+  VerificationPendingGuildLimit = 1 << 16,
+  /** Indicates if an app is embedded within the Discord client (currently unavailable publicly) */
+  Embedded = 1 << 17,
+  /** Intent required for bots in **100 or more servers** to receive [message content](https://support-dev.discord.com/hc/en-us/articles/4404772028055) */
+  GatewayMessageContent = 1 << 18,
+  /** Intent required for bots in under 100 servers to receive [message content](https://support-dev.discord.com/hc/en-us/articles/4404772028055), found in Bot Settings */
+  GatewayMessageContentLimited = 1 << 19,
+  /** Indicates if an app has registered global application commands */
+  ApplicationCommandBadge = 1 << 23,
+}
+
+/** https://discord.com/developers/docs/resources/application#install-params-object-install-params-structure */
+export interface DiscordInstallParams {
+  /** Scopes to add the application to the server with */
+  scopes: OAuth2Scope[]
+  /** Permissions to request for the bot role */
+  permissions: string
+}
+
+/** https://discord.com/developers/docs/resources/application#get-application-activity-instance-activity-instance-object */
+export interface DiscordActivityInstance {
+  /** Application ID */
+  application_id: string
+  /** Activity Instance ID */
+  instance_id: string
+  /** Unique identifier for the launch */
+  launch_id: string
+  /** The Location the instance is runnning in */
+  location: DiscordActivityLocation
+  /** The IDs of the Users currently connected to the instance */
+  users: string[]
+}
+
+/** https://discord.com/developers/docs/resources/application#get-application-activity-instance-activity-location-object */
+export interface DiscordActivityLocation {
+  /** The unique identifier for the location */
+  id: string
+  /** Enum describing kind of location */
+  kind: DiscordActivityLocationKind
+  /** The id of the Channel */
+  channel_id: string
+  /** The id of the Guild */
+  guild_id?: string | null
+}
+
+/** https://discord.com/developers/docs/resources/application#get-application-activity-instance-activity-location-kind-enum */
+export enum DiscordActivityLocationKind {
+  /** The Location is a Guild Channel */
+  GuildChannel = 'gc',
+  /** The Location is a Private Channel, such as a DM or GDM */
+  PrivateChannel = 'pc',
+}

packages/types/src/discord/auditLog.ts

@@ -0,0 +1,344 @@
+/** Types for: https://discord.com/developers/docs/resources/audit-log */
+
+import type { DiscordAutoModerationRule } from './autoModeration.js'
+import type { DiscordChannel, DiscordOverwrite, DiscordThreadMetadata } from './channel.js'
+import type { DiscordEmoji } from './emoji.js'
+import type { DiscordGuild, DiscordGuildOnboarding, DiscordGuildOnboardingPrompt, DiscordIntegration, DiscordMember } from './guild.js'
+import type { DiscordScheduledEvent } from './guildScheduledEvent.js'
+import type { DiscordApplicationCommand, DiscordApplicationCommandPermissions } from './interactions.js'
+import type { DiscordInvite, DiscordInviteMetadata } from './invite.js'
+import type { DiscordRole } from './permissions.js'
+import type { DiscordStageInstance } from './stageInstance.js'
+import type { DiscordSticker } from './sticker.js'
+import type { DiscordUser } from './user.js'
+import type { DiscordWebhook } from './webhook.js'
+
+/** https://discord.com/developers/docs/resources/audit-log#audit-log-object-audit-log-structure */
+export interface DiscordAuditLog {
+  /** List of webhooks found in the audit log */
+  webhooks: DiscordWebhook[]
+  /** List of users found in the audit log */
+  users: DiscordUser[]
+  /** List of audit log entries, sorted from most to least recent */
+  audit_log_entries: DiscordAuditLogEntry[]
+  /** List of partial integration objects */
+  integrations: Partial<DiscordIntegration>[]
+  /**
+   * List of threads found in the audit log.
+   * Threads referenced in `THREAD_CREATE` and `THREAD_UPDATE` events are included in the threads map since archived threads might not be kept in memory by clients.
+   */
+  threads: DiscordChannel[]
+  /** List of guild scheduled events found in the audit log */
+  guild_scheduled_events?: DiscordScheduledEvent[]
+  /** List of auto moderation rules referenced in the audit log */
+  auto_moderation_rules?: DiscordAutoModerationRule[]
+  /** List of application commands referenced in the audit log */
+  application_commands: DiscordApplicationCommand[]
+}
+
+/** https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-audit-log-entry-structure */
+export interface DiscordAuditLogEntry {
+  /** ID of the affected entity (webhook, user, role, etc.) */
+  target_id: string | null
+  /** Changes made to the `target_id` */
+  changes?: DiscordAuditLogChange[]
+  /** User or app that made the changes */
+  user_id: string | null
+  /** ID of the entry */
+  id: string
+  /** Type of action that occurred */
+  action_type: AuditLogEvents
+  /** Additional info for certain event types */
+  options?: DiscordOptionalAuditEntryInfo
+  /** Reason for the change (1-512 characters) */
+  reason?: string
+}
+
+/** https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-audit-log-events */
+export enum AuditLogEvents {
+  /** Server settings were updated */
+  GuildUpdate = 1,
+  /** Channel was created */
+  ChannelCreate = 10,
+  /** Channel settings were updated */
+  ChannelUpdate,
+  /** Channel was deleted */
+  ChannelDelete,
+  /** Permission overwrite was added to a channel */
+  ChannelOverwriteCreate,
+  /** Permission overwrite was updated for a channel */
+  ChannelOverwriteUpdate,
+  /** Permission overwrite was deleted from a channel */
+  ChannelOverwriteDelete,
+  /** Member was removed from server */
+  MemberKick = 20,
+  /** Members were pruned from server */
+  MemberPrune,
+  /** Member was banned from server */
+  MemberBanAdd,
+  /** Server ban was lifted for a member */
+  MemberBanRemove,
+  /** Member was updated in server */
+  MemberUpdate,
+  /** Member was added or removed from a role */
+  MemberRoleUpdate,
+  /** Member was moved to a different voice channel */
+  MemberMove,
+  /** Member was disconnected from a voice channel */
+  MemberDisconnect,
+  /** Bot user was added to server */
+  BotAdd,
+  /** Role was created */
+  RoleCreate = 30,
+  /** Role was edited */
+  RoleUpdate,
+  /** Role was deleted */
+  RoleDelete,
+  /** Server invite was created */
+  InviteCreate = 40,
+  /** Server invite was updated */
+  InviteUpdate,
+  /** Server invite was deleted */
+  InviteDelete,
+  /** Webhook was created */
+  WebhookCreate = 50,
+  /** Webhook properties or channel were updated */
+  WebhookUpdate,
+  /** Webhook was deleted */
+  WebhookDelete,
+  /** Emoji was created */
+  EmojiCreate = 60,
+  /** Emoji name was updated */
+  EmojiUpdate,
+  /** Emoji was deleted */
+  EmojiDelete,
+  /** Single message was deleted */
+  MessageDelete = 72,
+  /** Multiple messages were deleted */
+  MessageBulkDelete,
+  /** Messaged was pinned to a channel */
+  MessagePin,
+  /** Message was unpinned from a channel */
+  MessageUnpin,
+  /** App was added to server */
+  IntegrationCreate = 80,
+  /** App was updated (as an example, its scopes were updated) */
+  IntegrationUpdate,
+  /** App was removed from server */
+  IntegrationDelete,
+  /** Stage instance was created (stage channel becomes live) */
+  StageInstanceCreate,
+  /** Stage instace details were updated */
+  StageInstanceUpdate,
+  /** Stage instance was deleted (stage channel no longer live) */
+  StageInstanceDelete,
+  /** Sticker was created */
+  StickerCreate = 90,
+  /** Sticker details were updated */
+  StickerUpdate,
+  /** Sticker was deleted */
+  StickerDelete,
+  /** Event was created */
+  GuildScheduledEventCreate = 100,
+  /** Event was updated */
+  GuildScheduledEventUpdate,
+  /** Event was cancelled */
+  GuildScheduledEventDelete,
+  /** Thread was created in a channel */
+  ThreadCreate = 110,
+  /** Thread was updated */
+  ThreadUpdate,
+  /** Thread was deleted */
+  ThreadDelete,
+  /** Permissions were updated for a command */
+  ApplicationCommandPermissionUpdate = 121,
+  /** Soundboard sound was created */
+  SoundboardSoundCreate = 130,
+  /** Soundboard sound was updated */
+  SoundboardSoundUpdate,
+  /** Soundboard sound was deleted */
+  SoundboardSoundDelete,
+  /** Auto moderation rule was created */
+  AutoModerationRuleCreate = 140,
+  /** Auto moderation rule was updated */
+  AutoModerationRuleUpdate,
+  /** Auto moderation rule was deleted */
+  AutoModerationRuleDelete,
+  /** Message was blocked by AutoMod according to a rule. */
+  AutoModerationBlockMessage,
+  /** Message was flagged by AutoMod */
+  AudoModerationFlagMessage,
+  /** Member was timed out by AutoMod */
+  AutoModerationMemberTimedOut,
+  /** Creator monetization request was created */
+  CreatorMonetizationRequestCreated = 150,
+  /** Creator monetization terms were accepted */
+  CreatorMonetizationTermsAccepted,
+  /** Guild Onboarding Question was created */
+  OnBoardingPromptCreate = 163,
+  /** Guild Onboarding Question was updated */
+  OnBoardingPromptUpdate,
+  /** Guild Onboarding Question was deleted */
+  OnBoardingPromptDelete,
+  /** Guild Onboarding was created */
+  OnBoardingCreate,
+  /** Guild Onboarding was updated */
+  OnBoardingUpdate,
+  /** Guild Server Guide was created */
+  HomeSettingsCreate = 190,
+  /** Guild Server Guide was updated */
+  HomeSettingsUpdate,
+}
+
+/** https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-audit-log-events */
+export type DiscordAuditLogChange =
+  | DiscordAuditLogChangeObject<DiscordGuild>
+  | DiscordAuditLogChangeObject<DiscordChannel>
+  | DiscordAuditLogChangeObject<DiscordOverwrite>
+  | DiscordAuditLogChangeObject<DiscordMember>
+  | DiscordAuditLogChangePartialRole
+  | DiscordAuditLogChangeObject<DiscordRole>
+  | DiscordAuditLogChangeInvite
+  | DiscordAuditLogChangeInviteMetadata
+  | DiscordAuditLogChangeWebhook
+  | DiscordAuditLogChangeObject<DiscordEmoji>
+  | DiscordAuditLogChangeObject<DiscordIntegration>
+  | DiscordAuditLogChangeObject<DiscordStageInstance>
+  | DiscordAuditLogChangeObject<DiscordSticker>
+  | DiscordAuditLogChangeObject<DiscordThreadMetadata>
+  | DiscordAuditLogChangeApplicationCommandPermissions
+  | DiscordAuditLogChangeObject<DiscordAutoModerationRule>
+  | DiscordAuditLogChangeObject<DiscordGuildOnboardingPrompt>
+  | DiscordAuditLogChangeObject<DiscordGuildOnboarding>
+
+/** https://discord.com/developers/docs/resources/audit-log#audit-log-entry-object-optional-audit-entry-info */
+export interface DiscordOptionalAuditEntryInfo {
+  /**
+   * ID of the app whose permissions were targeted.
+   *
+   * @remarks
+   * Oly present on event of type: `APPLICATION_COMMAND_PERMISSION_UPDATE`
+   */
+  application_id?: string
+  /**
+   * Name of the Auto Moderation rule that was triggered.
+   *
+   * @remarks
+   * Only present on event of types: `AUTO_MODERATION_BLOCK_MESSAGE`, `AUTO_MODERATION_FLAG_TO_CHANNEL`, `AUTO_MODERATION_USER_COMMUNICATION_DISABLED`
+   */
+  auto_moderation_rule_name?: string
+  /**
+   * Trigger type of the Auto Moderation rule that was triggered.
+   *
+   * @remarks
+   * Only present on event of types: `AUTO_MODERATION_BLOCK_MESSAGE`, `AUTO_MODERATION_FLAG_TO_CHANNEL`, `AUTO_MODERATION_USER_COMMUNICATION_DISABLED`
+   */
+  auto_moderation_rule_trigger_type?: string
+  /**
+   * Channel in which the entities were targeted.
+   *
+   * @remarks
+   * Only present on event of types: `MEMBER_MOVE`, `MESSAGE_PIN`, `MESSAGE_UNPIN`, `MESSAGE_DELETE`, `STAGE_INSTANCE_CREATE`, `STAGE_INSTANCE_UPDATE`, `STAGE_INSTANCE_DELETE`
+   */
+  channel_id?: string
+  /**
+   * Number of entities that were targeted.
+   *
+   * @remarks
+   * Only present on event of types: `MESSAGE_DELETE`, `MESSAGE_BULK_DELETE`, `MEMBER_DISCONNECT`, `MEMBER_MOVE`
+   */
+  count?: string
+  /**
+   * Number of days after which inactive members were kicked.
+   *
+   * @remarks
+   * Only present on event of type: `MEMBER_PRUNE`
+   */
+  delete_member_days?: string
+  /**
+   * ID of the overwritten entity.
+   *
+   * @remarks
+   * Only present on event of types: `CHANNEL_OVERWRITE_CREATE`, `CHANNEL_OVERWRITE_UPDATE`, `CHANNEL_OVERWRITE_DELETE`
+   */
+  id?: string
+  /**
+   * Number of members removed by the prune.
+   *
+   * @remarks
+   * Only present on event of types: `MEMBER_PRUNE`
+   */
+  members_removed?: string
+  /**
+   * ID of the message that was targeted.
+   *
+   * @remarks
+   * Only present on event of types: `MESSAGE_PIN`, `MESSAGE_UNPIN`, `STAGE_INSTANCE_CREATE`, `STAGE_INSTANCE_UPDATE`, `STAGE_INSTANCE_DELETE`
+   */
+  message_id?: string
+  /**
+   * Name of the role if type is "0" (not present if type is "1").
+   *
+   * @remarks
+   * Only present on event of types: `CHANNEL_OVERWRITE_CREATE`, `CHANNEL_OVERWRITE_UPDATE`, `CHANNEL_OVERWRITE_DELETE`
+   */
+  role_name?: string
+  /**
+   * Type of overwritten entity - "0", for "role", or "1" for "member".
+   *
+   * @remarks
+   * Only present on event of types: `CHANNEL_OVERWRITE_CREATE`, `CHANNEL_OVERWRITE_UPDATE`, `CHANNEL_OVERWRITE_DELETE`
+   */
+  type?: string
+  /**
+   * The type of integration which performed the action
+   *
+   * @remarks
+   * Only present on event of types: `MEMBER_KICK`, `MEMBER_ROLE_UPDATE`
+   */
+  integration_type?: string
+}
+
+/** https://discord.com/developers/docs/resources/audit-log#audit-log-change-object-audit-log-change-structure */
+export type DiscordAuditLogChangeObject<T> = {
+  [K in keyof T]: {
+    new_value?: T[K]
+    old_value?: T[K]
+    key: K
+  }
+}[keyof T]
+
+// Done manually as it is clearer in this way
+/** Partial role audit log entry change exception */
+export type DiscordAuditLogChangePartialRole = { new_value: { id: string; name: string }[]; key: '$add' | '$remove' }
+
+/**
+ * Invite audit log entry change exception
+ *
+ * @remarks
+ * While the docs say that 'channel.id' will never exist, we keep it as it is very complex to remove, the user should not use it and use the provided 'channel_id' value instead
+ */
+export type DiscordAuditLogChangeInvite = DiscordAuditLogChangeObject<DiscordInvite> | DiscordAuditLogChangeObject<{ channel_id: string }>
+
+/**
+ * Invite Metadata audit log entry change exception
+ *
+ * @remarks
+ * While the docs say that 'channel.id' will never exist, we keep it as it is very complex to remove, the user should not use it and use the provided 'channel_id' value instead
+ */
+export type DiscordAuditLogChangeInviteMetadata =
+  | DiscordAuditLogChangeObject<DiscordInviteMetadata>
+  | DiscordAuditLogChangeObject<{ channel_id: string }>
+
+/** Webhook audit log entry change exception */
+export type DiscordAuditLogChangeWebhook =
+  | DiscordAuditLogChangeObject<Omit<DiscordWebhook, 'avatar'>>
+  | DiscordAuditLogChangeObject<{ avatar_hash: DiscordWebhook['avatar'] }>
+
+// Done manually as it is clearer in this way
+/** Command Permission audit log entry change exception */
+export type DiscordAuditLogChangeApplicationCommandPermissions = {
+  new_value?: DiscordApplicationCommandPermissions
+  old_value?: DiscordApplicationCommandPermissions
+  key: `${number}`
+}

packages/types/src/discord/autoModeration.ts

@@ -0,0 +1,151 @@
+/** Types for: https://discord.com/developers/docs/resources/auto-moderation */
+
+/** https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-auto-moderation-rule-structure */
+export interface DiscordAutoModerationRule {
+  /** The id of this rule */
+  id: string
+  /** The guild id of the rule */
+  guild_id: string
+  /** The name of the rule */
+  name: string
+  /** The id of the user who created this rule. */
+  creator_id: string
+  /** Indicates in what event context a rule should be checked. */
+  event_type: AutoModerationEventTypes
+  /** The type of trigger for this rule */
+  trigger_type: AutoModerationTriggerTypes
+  /** The metadata used to determine whether a rule should be triggered. */
+  trigger_metadata: DiscordAutoModerationRuleTriggerMetadata
+  /** Actions which will execute whenever a rule is triggered. */
+  actions: DiscordAutoModerationAction[]
+  /** Whether the rule is enabled. */
+  enabled: boolean
+  /** The role ids that are whitelisted. Max 20. */
+  exempt_roles: string[]
+  /** The channel ids that are whitelisted. Max 50. */
+  exempt_channels: string[]
+}
+
+/** https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types */
+export enum AutoModerationTriggerTypes {
+  /** Check if content contains words from a user defined list of keywords. Max 6 per guild */
+  Keyword = 1,
+  /** Check if content represents generic spam. Max 1 per guild */
+  Spam = 3,
+  /** Check if content contains words from internal pre-defined word sets. Max 1 per guild */
+  KeywordPreset,
+  /** Check if content contains more unique mentions than allowed. Max 1 per guild */
+  MentionSpam,
+  /** Check if member profile contains words from a user defined list of keywords. Max 1 per guild */
+  MemberProfile,
+}
+
+/** https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata */
+export interface DiscordAutoModerationRuleTriggerMetadata {
+  /**
+   * The keywords needed to match.
+   *
+   * @remarks
+   * Only present with {@link AutoModerationTriggerTypes.Keyword} and {@link AutoModerationTriggerTypes.MemberProfile}.
+   *
+   * Can have up to 1000 elements in the array and each string can have up to 60 characters
+   */
+  keyword_filter?: string[]
+  /**
+   * Regular expression patterns which will be matched against content.
+   *
+   * @remarks
+   * Only present with {@link AutoModerationTriggerTypes.Keyword} and {@link AutoModerationTriggerTypes.MemberProfile}.
+   *
+   * Can have up to 10 elements in the array and each string can have up to 260 characters
+   */
+  regex_patterns: string[]
+  /**
+   * The pre-defined lists of words to match from.
+   *
+   * @remarks
+   * Only present with {@link AutoModerationTriggerTypes.KeywordPreset}.
+   */
+  presets?: DiscordAutoModerationRuleTriggerMetadataPresets[]
+  /**
+   * The substrings which will exempt from triggering the preset trigger type.
+   *
+   * @remarks
+   * Only present with {@link AutoModerationTriggerTypes.Keyword}, {@link AutoModerationTriggerTypes.KeywordPreset} and {@link AutoModerationTriggerTypes.MemberProfile}.
+   *
+   * When used with {@link AutoModerationTriggerTypes.Keyword} and {@link AutoModerationTriggerTypes.MemberProfile} there can have up to 100 elements in the array and each string can have up to 60 characters.
+   * When used with {@link AutoModerationTriggerTypes.KeywordPreset} there can have up to 1000 elements in the array and each string can have up to 60 characters.
+   */
+  allow_list?: string[]
+  /**
+   * Total number of mentions (role & user) allowed per message.
+   *
+   * @remarks
+   * Only present with {@link AutoModerationTriggerTypes.MentionSpam}.
+   *
+   * Maximum of 50
+   */
+  mention_total_limit?: number
+  /**
+   * Whether to automatically detect mention raids.
+   *
+   * @remarks
+   * Only present with {@link AutoModerationTriggerTypes.MentionSpam}.
+   */
+  mention_raid_protection_enabled?: boolean
+}
+
+/** https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-keyword-preset-types */
+export enum DiscordAutoModerationRuleTriggerMetadataPresets {
+  /** Words that may be considered forms of swearing or cursing */
+  Profanity = 1,
+  /** Words that refer to sexually explicit behavior or activity */
+  SexualContent,
+  /** Personal insults or words that may be considered hate speech */
+  Slurs,
+}
+
+/** https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-event-types */
+export enum AutoModerationEventTypes {
+  /** When a user sends a message */
+  MessageSend = 1,
+  /** Wen a member edits their profile */
+  MemberUpdate,
+}
+
+/** https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-action-object-auto-moderation-action-structure */
+export interface DiscordAutoModerationAction {
+  /** The type of action to take when a rule is triggered */
+  type: AutoModerationActionType
+  /** additional metadata needed during execution for this specific action type */
+  metadata: DiscordAutoModerationActionMetadata
+}
+
+/** https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-action-object-action-types */
+export enum AutoModerationActionType {
+  /** Blocks the content of a message according to the rule */
+  BlockMessage = 1,
+  /** Logs user content to a specified channel */
+  SendAlertMessage,
+  /**
+   * Times out user for specified duration
+   *
+   * @remarks
+   * A timeout action can only be set up for {@link AutoModerationTriggerTypes.Keyword} and {@link AutoModerationTriggerTypes.MentionSpam} rules.
+   *
+   * The `MODERATE_MEMBERS` permission is required to use the timeout action type.
+   */
+  Timeout,
+  /** prevents a member from using text, voice, or other interactions */
+  BlockMemberInteraction,
+}
+
+/** https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-action-object-action-metadata */
+export interface DiscordAutoModerationActionMetadata {
+  /** The id of channel to which user content should be logged. Only in ActionType.SendAlertMessage */
+  channel_id?: string
+  /** Additional explanation that will be shown to members whenever their message is blocked. Maximum of 150 characters. Only supported for AutoModerationActionType.BlockMessage */
+  custom_message?: string
+  /** Timeout duration in seconds maximum of 2419200 seconds (4 weeks). Only supported for TriggerType.Keyword && Only in ActionType.Timeout */
+  duration_seconds?: number
+}

packages/types/src/discord/channel.ts

@@ -0,0 +1,374 @@
+/** Types for: https://discord.com/developers/docs/resources/channel */
+
+import type { DiscordMessageComponents } from './interactions.js'
+import type { DiscordAllowedMentions, DiscordAttachment, DiscordEmbed, MessageFlags } from './message.js'
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/channel#channel-object-channel-structure */
+export interface DiscordChannel {
+  /** The id of the channel */
+  id: string
+  /** The type of channel */
+  type: ChannelTypes
+  /** The id of the guild */
+  guild_id?: string
+  /** Sorting position of the channel (channels with the same position are sorted by id) */
+  position?: number
+  /** Explicit permission overwrites for members and roles */
+  permission_overwrites?: DiscordOverwrite[]
+  /** The name of the channel (1-100 characters) */
+  name?: string
+  /** The channel topic (0-4096 characters for GUILD_FORUM channels, 0-1024 characters for all others) */
+  topic?: string | null
+  /** Whether the channel is nsfw */
+  nsfw?: boolean
+  /** The id of the last message sent in this channel (may not point to an existing or valid message) */
+  last_message_id?: string | null
+  /** The bitrate (in bits) of the voice or stage channel */
+  bitrate?: number
+  /** The user limit of the voice or stage channel */
+  user_limit?: number
+  /** Amount of seconds a user has to wait before sending another message (0-21600); bots, as well as users with the permission `manage_messages` or `manage_channel`, are unaffected */
+  rate_limit_per_user?: number
+  /** the recipients of the DM */
+  recipients?: DiscordUser[]
+  /** icon hash of the group DM */
+  icon?: string
+  /** Id of the creator of the thread */
+  owner_id?: string
+  /** Application id of the group DM creator if it is bot-created */
+  application_id?: string
+  /** For group DM channels: whether the channel is managed by an application via the `gdm.join` OAuth2 scope. */
+  managed?: boolean
+  /** For guild channels: Id of the parent category for a channel (each parent category can contain up to 50 channels), for threads: id of the text channel this thread was created */
+  parent_id?: string | null
+  /** When the last pinned message was pinned. This may be null in events such as GUILD_CREATE when a message is not pinned. */
+  last_pin_timestamp?: string | null
+  /** Voice region id for the voice or stage channel, automatic when set to null */
+  rtc_region?: string | null
+  /** The camera video quality mode of the voice channel, 1 when not present */
+  video_quality_mode?: VideoQualityModes
+  /** An approximate count of messages in a thread, stops counting at 50 */
+  message_count?: number
+  /** An approximate count of users in a thread, stops counting at 50 */
+  member_count?: number
+  /** Thread-specific fields not needed by other channels */
+  thread_metadata?: DiscordThreadMetadata
+  /** Thread member object for the current user, if they have joined the thread, only included on certain API endpoints */
+  member?: DiscordThreadMember
+  /** Default duration for newly created threads, in minutes, to automatically archive the thread after recent activity, can be set to: 60, 1440, 4320, 10080 */
+  default_auto_archive_duration?: number
+  /** computed permissions for the invoking user in the channel, including overwrites, only included when part of the resolved data received on a slash command interaction. This does not include implicit permissions, which may need to be checked separately. */
+  permissions?: string
+  /** The flags of the channel */
+  flags?: ChannelFlags
+  /** number of messages ever sent in a thread, it's similar to `message_count` on message creation, but will not decrement the number when a message is deleted */
+  total_message_sent?: number
+  /** The set of tags that can be used in a GUILD_FORUM channel */
+  available_tags?: DiscordForumTag[]
+  /** The IDs of the set of tags that have been applied to a thread in a GUILD_FORUM channel */
+  applied_tags?: string[]
+  /** the emoji to show in the add reaction button on a thread in a GUILD_FORUM channel */
+  default_reaction_emoji?: DiscordDefaultReactionEmoji | null
+  /** the initial rate_limit_per_user to set on newly created threads in a channel. this field is copied to the thread at creation time and does not live update. */
+  default_thread_rate_limit_per_user?: number
+  /** the default sort order type used to order posts in GUILD_FORUM channels. Defaults to null, which indicates a preferred sort order hasn't been set by a channel admin */
+  default_sort_order?: SortOrderTypes | null
+  /** the default forum layout view used to display posts in `GUILD_FORUM` channels. Defaults to `0`, which indicates a layout view has not been set by a channel admin */
+  default_forum_layout?: ForumLayout
+  /** When a thread is created this will be true on that channel payload for the thread. */
+  newly_created?: boolean
+}
+
+/** https://discord.com/developers/docs/resources/channel#channel-object-channel-types */
+export enum ChannelTypes {
+  /** A text channel within a server */
+  GuildText,
+  /** A direct message between users */
+  DM,
+  /** A voice channel within a server */
+  GuildVoice,
+  /** A direct message between multiple users */
+  GroupDm,
+  /** An organizational category that contains up to 50 channels */
+  GuildCategory,
+  /** A channel that users can follow and crosspost into their own server */
+  GuildAnnouncement,
+  /** A temporary sub-channel within a GUILD_ANNOUNCEMENT channel */
+  AnnouncementThread = 10,
+  /** A temporary sub-channel within a GUILD_TEXT or GUILD_FORUM channel */
+  PublicThread,
+  /** A temporary sub-channel within a GUILD_TEXT channel that is only viewable by those invited and those with the MANAGE_THREADS permission */
+  PrivateThread,
+  /** A voice channel for hosting events with an audience */
+  GuildStageVoice,
+  /** A channel in a hub containing the listed servers */
+  GuildDirectory,
+  /** A channel which can only contains threads */
+  GuildForum,
+  /** Channel that can only contain threads, similar to GUILD_FORUM channels */
+  GuildMedia,
+}
+
+/** https://discord.com/developers/docs/resources/channel#channel-object-video-quality-modes */
+export enum VideoQualityModes {
+  /** Discord chooses the quality for optimal performance */
+  Auto = 1,
+  /** 720p */
+  Full,
+}
+
+/** https://discord.com/developers/docs/resources/channel#channel-object-channel-flags */
+export enum ChannelFlags {
+  None,
+  /** this thread is pinned to the top of its parent `GUILD_FORUM` channel */
+  Pinned = 1 << 1,
+  /** Whether a tag is required to be specified when creating a thread in a `GUILD_FORUM` or a GUILD_MEDIA channel. Tags are specified in the `applied_tags` field. */
+  RequireTag = 1 << 4,
+  /** When set hides the embedded media download options. Available only for media channels. */
+  HideMediaDownloadOptions = 1 << 15,
+}
+
+/** https://discord.com/developers/docs/resources/channel#channel-object-sort-order-types */
+export enum SortOrderTypes {
+  /** Sort forum posts by activity */
+  LatestActivity,
+  /** Sort forum posts by creation time (from most recent to oldest) */
+  CreationDate,
+}
+
+/** https://discord.com/developers/docs/resources/channel#channel-object-forum-layout-types */
+export enum ForumLayout {
+  /** No default has been set for forum channel. */
+  NotSet = 0,
+  /** Display posts as a list. */
+  ListView = 1,
+  /** Display posts as a collection of tiles. */
+  GalleryView = 2,
+}
+
+/** https://discord.com/developers/docs/resources/channel#followed-channel-object-followed-channel-structure */
+export interface DiscordFollowedChannel {
+  /** Source message id */
+  channel_id: string
+  /** Created target webhook id */
+  webhook_id: string
+}
+
+/** https://discord.com/developers/docs/resources/channel#overwrite-object-overwrite-structure */
+export enum OverwriteTypes {
+  Role,
+  Member,
+}
+
+/** https://discord.com/developers/docs/resources/channel#overwrite-object-overwrite-structure */
+export interface DiscordOverwrite {
+  /** Either 0 (role) or 1 (member) */
+  type: OverwriteTypes
+  /** Role or user id */
+  id: string
+  /** Permission bit set */
+  allow?: string
+  /** Permission bit set */
+  deny?: string
+}
+
+/** https://discord.com/developers/docs/resources/channel#thread-metadata-object-thread-metadata-structure */
+export interface DiscordThreadMetadata {
+  /** Whether the thread is archived */
+  archived: boolean
+  /** Duration in minutes to automatically archive the thread after recent activity */
+  auto_archive_duration: 60 | 1440 | 4320 | 10080
+  /** When a thread is locked, only users with `MANAGE_THREADS` can unarchive it */
+  locked: boolean
+  /** whether non-moderators can add other non-moderators to a thread; only available on private threads */
+  invitable?: boolean
+  /** Timestamp when the thread's archive status was last changed, used for calculating recent activity */
+  archive_timestamp: string
+  /** Timestamp when the thread was created; only populated for threads created after 2022-01-09 */
+  create_timestamp?: string | null
+}
+
+/** https://discord.com/developers/docs/resources/channel#thread-member-object-thread-member-structure */
+export interface DiscordThreadMember {
+  /** Any user-thread settings, currently only used for notifications */
+  flags: number
+  /** The id of the thread */
+  id: string
+  /** The id of the user */
+  user_id: string
+  /** The time the current user last joined the thread */
+  join_timestamp: string
+}
+
+/** https://discord.com/developers/docs/resources/channel#thread-member-object-thread-member-structure, the first asterisk */
+export interface DiscordThreadMemberGuildCreate {
+  /** Any user-thread settings, currently only used for notifications */
+  flags: number
+  /** The time the current user last joined the thread */
+  join_timestamp: string
+}
+
+/** https://discord.com/developers/docs/resources/channel#default-reaction-object-default-reaction-structure */
+export interface DiscordDefaultReactionEmoji {
+  /** The id of a guild's custom emoji */
+  emoji_id: string
+  /** The unicode character of the emoji */
+  emoji_name: string | null
+}
+
+/** https://discord.com/developers/docs/resources/channel#forum-tag-object-forum-tag-structure */
+export interface DiscordForumTag {
+  /** The id of the tag */
+  id: string
+  /** The name of the tag (0-20 characters) */
+  name: string
+  /** Whether this tag can only be added to or removed from threads by a member with the MANAGE_THREADS permission */
+  moderated: boolean
+  /** The id of a guild's custom emoji At most one of emoji_id and emoji_name may be set. */
+  emoji_id: string
+  /** The unicode character of the emoji */
+  emoji_name: string | null
+}
+
+/** https://discord.com/developers/docs/resources/channel#modify-channel */
+export interface DiscordModifyChannel {
+  /** 1-100 character channel name */
+  name?: string
+  /** The type of channel; only conversion between text and news is supported and only in guilds with the "NEWS" feature */
+  type?: ChannelTypes
+  /** The position of the channel in the left-hand listing */
+  position?: number | null
+  /** 0-1024 character channel topic */
+  topic?: string | null
+  /** Whether the channel is nsfw */
+  nsfw?: boolean | null
+  /** Amount of seconds a user has to wait before sending another message (0-21600); bots, as well as users with the permission `manage_messages` or `manage_channel`, are unaffected */
+  rate_limit_per_user?: number | null
+  /** The bitrate (in bits) of the voice channel; 8000 to 96000 (128000 for VIP servers) */
+  bitrate?: number | null
+  /** The user limit of the voice channel; 0 refers to no limit, 1 to 99 refers to a user limit */
+  user_limit?: number | null
+  /** Channel or category-specific permissions */
+  permission_overwrites?: DiscordOverwrite[] | null
+  /** Id of the new parent category for a channel */
+  parent_id?: string | null
+  /** Voice region id for the voice channel, automatic when set to null */
+  rtc_region?: string | null
+  /** The camera video quality mode of the voice channel */
+  video_quality_mode?: VideoQualityModes
+  /** Whether the thread is archived */
+  archived?: boolean
+  /** Duration in minutes to automatically archive the thread after recent activity */
+  auto_archive_duration?: 60 | 1440 | 4320 | 10080
+  /** When a thread is locked, only users with `MANAGE_THREADS` can unarchive it */
+  locked?: boolean
+  /** whether non-moderators can add other non-moderators to a thread; only available on private threads */
+  invitable?: boolean
+  /** The set of tags that can be used in a GUILD_FORUM channel */
+  available_tags?: Array<{
+    /** The id of the tag */
+    id: string
+    /** The name of the tag (0-20 characters) */
+    name: string
+    /** Whether this tag can only be added to or removed from threads by a member with the MANAGE_THREADS permission */
+    moderated: boolean
+    /** The id of a guild's custom emoji At most one of emoji_id and emoji_name may be set. */
+    emoji_id: string
+    /** The unicode character of the emoji */
+    emoji_name: string
+  }>
+  /** The IDs of the set of tags that have been applied to a thread in a GUILD_FORUM channel; limited to 5 */
+  applied_tags?: string[]
+  /** the emoji to show in the add reaction button on a thread in a GUILD_FORUM channel */
+  default_reaction_emoji?: {
+    /** The id of a guild's custom emoji */
+    emoji_id: string
+    /** The unicode character of the emoji */
+    emoji_name: string | null
+  }
+  /** the initial rate_limit_per_user to set on newly created threads in a channel. this field is copied to the thread at creation time and does not live update. */
+  default_thread_rate_limit_per_user?: number
+  /** the default sort order type used to order posts in forum channels */
+  default_sort_order?: SortOrderTypes | null
+  /** the default forum layout view used to display posts in `GUILD_FORUM` channels. Defaults to `0`, which indicates a layout view has not been set by a channel admin */
+  default_forum_layout?: ForumLayout
+}
+
+/** https://discord.com/developers/docs/resources/channel#edit-channel-permissions-json-params */
+export interface DiscordEditChannelPermissionOverridesOptions {
+  /** Permission bit set */
+  allow: string
+  /** Permission bit set */
+  deny: string
+  /** Either 0 (role) or 1 (member) */
+  type: OverwriteTypes
+}
+
+/** https://discord.com/developers/docs/resources/channel#follow-announcement-channel-json-params */
+export interface DiscordFollowAnnouncementChannel {
+  /** The id of the channel to send announcements to. */
+  webhook_channel_id: string
+}
+
+/** https://discord.com/developers/docs/resources/channel#start-thread-in-forum-or-media-channel-jsonform-params */
+export interface DiscordCreateForumPostWithMessage {
+  /** 1-100 character channel name */
+  name: string
+  /** duration in minutes to automatically archive the thread after recent activity, can be set to: 60, 1440, 4320, 10080 */
+  auto_archive_duration?: 60 | 1440 | 4320 | 10080
+  /** amount of seconds a user has to wait before sending another message (0-21600) */
+  rate_limit_per_user?: number
+  /** contents of the first message in the forum thread */
+  message: {
+    /** Message contents (up to 2000 characters) */
+    content?: string
+    /** Embedded rich content (up to 6000 characters) */
+    embeds?: DiscordEmbed[]
+    /** Allowed mentions for the message */
+    allowed_mentions?: DiscordAllowedMentions[]
+    /** Components to include with the message */
+    components?: DiscordMessageComponents[]
+    /** IDs of up to 3 stickers in the server to send in the message */
+    sticker_ids?: string[]
+    /** JSON-encoded body of non-file params, only for multipart/form-data requests. See {@link https://discord.com/developers/docs/reference#uploading-files Uploading Files} */
+    payload_json?: string
+    /** Attachment objects with filename and description. See {@link https://discord.com/developers/docs/reference#uploading-files Uploading Files} */
+    attachments?: DiscordAttachment[]
+    /** Message flags combined as a bitfield, only SUPPRESS_EMBEDS can be set */
+    flags?: MessageFlags
+  }
+  /** the IDs of the set of tags that have been applied to a thread in a GUILD_FORUM channel */
+  applied_tags?: string[]
+}
+
+/** https://discord.com/developers/docs/resources/channel#list-public-archived-threads-response-body */
+// TODO: this should be ArchivedThreads, not Active
+export interface DiscordActiveThreads {
+  threads: DiscordChannel[]
+  members: DiscordThreadMember[]
+}
+
+/** https://discord.com/developers/docs/resources/channel#list-public-archived-threads-response-body */
+export type DiscordArchivedThreads = DiscordActiveThreads & {
+  // TODO: this should be has_more, not hasMore
+  hasMore: boolean
+}
+
+// TODO: What does this type exactly match to? The API doesn't seem to have a list ACTIVE threads, only list archived threads
+export interface DiscordListActiveThreads {
+  /** The active threads */
+  threads: DiscordChannel[]
+  /** A thread member object for each returned thread the current user has joined */
+  members: DiscordThreadMember[]
+}
+
+/**
+ * https://discord.com/developers/docs/resources/channel#list-public-archived-threads
+ * https://discord.com/developers/docs/resources/channel#list-private-archived-threads
+ * https://discord.com/developers/docs/resources/channel#list-joined-private-archived-threads
+ */
+export interface DiscordListArchivedThreads extends DiscordListActiveThreads {
+  /** Whether there are potentially additional threads that could be returned on a subsequent call */
+  has_more: boolean
+}

packages/types/src/discord/emoji.ts

@@ -0,0 +1,41 @@
+/** Types for: https://discord.com/developers/docs/resources/emoji */
+
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/emoji#emoji-object-emoji-structure */
+export interface DiscordEmoji {
+  /** Emoji name (can only be null in reaction emoji objects) */
+  name?: string
+  /** Emoji id */
+  id?: string
+  /** Roles allowed to use this emoji */
+  roles?: string[]
+  /** User that created this emoji */
+  user?: DiscordUser
+  /** Whether this emoji must be wrapped in colons */
+  require_colons?: boolean
+  /** Whether this emoji is managed */
+  managed?: boolean
+  /** Whether this emoji is animated */
+  animated?: boolean
+  /** Whether this emoji can be used, may be false due to loss of Server Boosts */
+  available?: boolean
+}
+
+/** https://discord.com/developers/docs/resources/emoji#create-guild-emoji-json-params */
+export interface DiscordCreateGuildEmoji {
+  /** Name of the emoji */
+  name: string
+  /** The 128x128 emoji image. Emojis and animated emojis have a maximum file size of 256kb. Attempting to upload an emoji larger than this limit will fail and return 400 Bad Request and an error message, but not a JSON status code. If a URL is provided to the image parameter, Discordeno will automatically convert it to a base64 string internally. */
+  image: string
+  /** Roles allowed to use this emoji */
+  roles?: string[]
+}
+
+/** https://discord.com/developers/docs/resources/emoji#modify-guild-emoji-json-params */
+export interface DiscordModifyGuildEmoji {
+  /** Name of the emoji */
+  name?: string
+  /** Roles allowed to use this emoji */
+  roles?: string[] | null
+}

packages/types/src/discord/entitlement.ts

@@ -0,0 +1,45 @@
+/** Types for: https://discord.com/developers/docs/resources/entitlement */
+
+/** https://discord.com/developers/docs/resources/entitlement#entitlement-object-entitlement-structure */
+export interface DiscordEntitlement {
+  /** ID of the entitlement */
+  id: string
+  /** ID of the SKU */
+  sku_id: string
+  /** ID of the user that is granted access to the entitlement's sku */
+  user_id?: string
+  /** ID of the guild that is granted access to the entitlement's sku */
+  guild_id?: string
+  /** ID of the parent application */
+  application_id: string
+  /** Type of entitlement */
+  type: DiscordEntitlementType
+  /** Entitlement was deleted */
+  deleted: boolean
+  /** Start date at which the entitlement is valid. */
+  starts_at: string | null
+  /** Date at which the entitlement is no longer valid. */
+  ends_at: string | null
+  /** For consumable items, whether or not the entitlement has been consumed */
+  consumed?: boolean
+}
+
+/** https://discord.com/developers/docs/resources/entitlement#entitlement-object-entitlement-types */
+export enum DiscordEntitlementType {
+  /** Entitlement was purchased by user */
+  Purchase = 1,
+  /** Entitlement for Discord Nitro subscription */
+  PremiumSubscription = 2,
+  /** Entitlement was gifted by developer */
+  DeveloperGift = 3,
+  /** Entitlement was purchased by a dev in application test mode */
+  TestModePurchase = 4,
+  /** Entitlement was granted when the SKU was free */
+  FreePurchase = 5,
+  /** Entitlement was gifted by another user */
+  UserGift = 6,
+  /** Entitlement was claimed by user for free as a Nitro Subscriber */
+  PremiumPurchase = 7,
+  /** Entitlement was purchased as an app subscription */
+  ApplicationSubscription = 8,
+}

packages/types/src/discord/gateway.ts

@@ -0,0 +1,910 @@
+/**
+ * Types for:
+ *  - https://discord.com/developers/docs/events/gateway
+ *  - https://discord.com/developers/docs/events/gateway-events
+ */
+
+import type { DiscordApplication } from './application.js'
+import type { AutoModerationTriggerTypes, DiscordAutoModerationAction } from './autoModeration.js'
+import type { DiscordChannel, DiscordThreadMember } from './channel.js'
+import type { DiscordEmoji } from './emoji.js'
+import type { DiscordIntegration, DiscordMember, DiscordMemberWithUser, DiscordUnavailableGuild } from './guild.js'
+import type { TargetTypes } from './invite.js'
+import type { DiscordReactionType } from './message.js'
+import type { DiscordRole } from './permissions.js'
+import type { DiscordSoundboardSound } from './soundboard.js'
+import type { DiscordSticker } from './sticker.js'
+import type { DiscordAvatarDecorationData, DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/events/gateway#list-of-intents */
+export enum GatewayIntents {
+  /**
+   * - GUILD_CREATE
+   * - GUILD_UPDATE
+   * - GUILD_DELETE
+   * - GUILD_ROLE_CREATE
+   * - GUILD_ROLE_UPDATE
+   * - GUILD_ROLE_DELETE
+   * - CHANNEL_CREATE
+   * - CHANNEL_UPDATE
+   * - CHANNEL_DELETE
+   * - CHANNEL_PINS_UPDATE
+   * - THREAD_CREATE
+   * - THREAD_UPDATE
+   * - THREAD_DELETE
+   * - THREAD_LIST_SYNC
+   * - THREAD_MEMBER_UPDATE
+   * - THREAD_MEMBERS_UPDATE
+   * - STAGE_INSTANCE_CREATE
+   * - STAGE_INSTANCE_UPDATE
+   * - STAGE_INSTANCE_DELETE
+   */
+  Guilds = 1 << 0,
+  /**
+   * - GUILD_MEMBER_ADD
+   * - GUILD_MEMBER_UPDATE
+   * - GUILD_MEMBER_REMOVE
+   * - THREAD_MEMBERS_UPDATE
+   *
+   * This is a privileged intent.
+   */
+  GuildMembers = 1 << 1,
+  /**
+   * - GUILD_AUDIT_LOG_ENTRY_CREATE
+   * - GUILD_BAN_ADD
+   * - GUILD_BAN_REMOVE
+   */
+  GuildModeration = 1 << 2,
+  /**
+   * - GUILD_EMOJIS_UPDATE
+   * - GUILD_STICKERS_UPDATE
+   * - GUILD_SOUNDBOARD_SOUND_CREATE
+   * - GUILD_SOUNDBOARD_SOUND_UPDATE
+   * - GUILD_SOUNDBOARD_SOUND_DELETE
+   * - GUILD_SOUNDBOARD_SOUNDS_UPDATE
+   */
+  GuildExpressions = 1 << 3,
+  /**
+   * - GUILD_INTEGRATIONS_UPDATE
+   * - INTEGRATION_CREATE
+   * - INTEGRATION_UPDATE
+   * - INTEGRATION_DELETE
+   */
+  GuildIntegrations = 1 << 4,
+  /**
+   * - WEBHOOKS_UPDATE
+   */
+  GuildWebhooks = 1 << 5,
+  /**
+   * - INVITE_CREATE
+   * - INVITE_DELETE
+   */
+  GuildInvites = 1 << 6,
+  /**
+   * - VOICE_STATE_UPDATE
+   * - VOICE_CHANNEL_EFFECT_SEND
+   */
+  GuildVoiceStates = 1 << 7,
+  /**
+   * - PRESENCE_UPDATE
+   *
+   * This is a privileged intent.
+   */
+  GuildPresences = 1 << 8,
+  /**
+   * - MESSAGE_CREATE
+   * - MESSAGE_UPDATE
+   * - MESSAGE_DELETE
+   * - MESSAGE_DELETE_BULK
+   *
+   * The messages do not contain content by default.
+   * If you want to receive their content too, you need to turn on the privileged `MESSAGE_CONTENT` intent. */
+  GuildMessages = 1 << 9,
+  /**
+   * - MESSAGE_REACTION_ADD
+   * - MESSAGE_REACTION_REMOVE
+   * - MESSAGE_REACTION_REMOVE_ALL
+   * - MESSAGE_REACTION_REMOVE_EMOJI
+   */
+  GuildMessageReactions = 1 << 10,
+  /**
+   * - TYPING_START
+   */
+  GuildMessageTyping = 1 << 11,
+  /**
+   * - CHANNEL_CREATE
+   * - MESSAGE_CREATE
+   * - MESSAGE_UPDATE
+   * - MESSAGE_DELETE
+   * - CHANNEL_PINS_UPDATE
+   */
+  DirectMessages = 1 << 12,
+  /**
+   * - MESSAGE_REACTION_ADD
+   * - MESSAGE_REACTION_REMOVE
+   * - MESSAGE_REACTION_REMOVE_ALL
+   * - MESSAGE_REACTION_REMOVE_EMOJI
+   */
+  DirectMessageReactions = 1 << 13,
+  /**
+   * - TYPING_START
+   */
+  DirectMessageTyping = 1 << 14,
+  /**
+   * This intent will add all content related values to message events.
+   *
+   * This is a privileged intent.
+   */
+  MessageContent = 1 << 15,
+  /**
+   * - GUILD_SCHEDULED_EVENT_CREATE
+   * - GUILD_SCHEDULED_EVENT_UPDATE
+   * - GUILD_SCHEDULED_EVENT_DELETE
+   * - GUILD_SCHEDULED_EVENT_USER_ADD this is experimental and unstable.
+   * - GUILD_SCHEDULED_EVENT_USER_REMOVE this is experimental and unstable.
+   */
+  GuildScheduledEvents = 1 << 16,
+  /**
+   * - AUTO_MODERATION_RULE_CREATE
+   * - AUTO_MODERATION_RULE_UPDATE
+   * - AUTO_MODERATION_RULE_DELETE
+   */
+  AutoModerationConfiguration = 1 << 20,
+  /**
+   * - AUTO_MODERATION_ACTION_EXECUTION
+   */
+  AutoModerationExecution = 1 << 21,
+  /**
+   * - MESSAGE_POLL_VOTE_ADD
+   * - MESSAGE_POLL_VOTE_REMOVE
+   */
+  GuildMessagePolls = 1 << 24,
+  /**
+   * - MESSAGE_POLL_VOTE_ADD
+   * - MESSAGE_POLL_VOTE_REMOVE
+   */
+  DirectMessagePolls = 1 << 25,
+}
+
+export { GatewayIntents as Intents }
+
+// TODO: Add TransportCompression: https://discord.com/developers/docs/events/gateway#transport-compression
+
+/** https://discord.com/developers/docs/events/gateway#get-gateway-bot */
+export interface DiscordGetGatewayBot {
+  /** The WSS URL that can be used for connecting to the gateway */
+  url: string
+  /** The recommended number of shards to use when connecting */
+  shards: number
+  /** Information on the current session start limit */
+  session_start_limit: DiscordSessionStartLimit
+}
+
+/** https://discord.com/developers/docs/events/gateway#session-start-limit-object */
+export interface DiscordSessionStartLimit {
+  /** The total number of session starts the current user is allowed */
+  total: number
+  /** The remaining number of session starts the current user is allowed */
+  remaining: number
+  /** The number of milliseconds after which the limit resets */
+  reset_after: number
+  /** The number of identify requests allowed per 5 seconds */
+  max_concurrency: number
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#receive-events */
+// TODO: Move 'RESUMED' from GatewayEventNames to GatewayDispatchEventNames
+export type GatewayDispatchEventNames =
+  | 'READY'
+  | 'APPLICATION_COMMAND_PERMISSIONS_UPDATE'
+  | 'AUTO_MODERATION_RULE_CREATE'
+  | 'AUTO_MODERATION_RULE_UPDATE'
+  | 'AUTO_MODERATION_RULE_DELETE'
+  | 'AUTO_MODERATION_ACTION_EXECUTION'
+  | 'CHANNEL_CREATE'
+  | 'CHANNEL_UPDATE'
+  | 'CHANNEL_DELETE'
+  | 'CHANNEL_PINS_UPDATE'
+  | 'THREAD_CREATE'
+  | 'THREAD_UPDATE'
+  | 'THREAD_DELETE'
+  | 'THREAD_LIST_SYNC'
+  | 'THREAD_MEMBER_UPDATE'
+  | 'THREAD_MEMBERS_UPDATE'
+  | 'GUILD_AUDIT_LOG_ENTRY_CREATE'
+  | 'GUILD_CREATE'
+  | 'GUILD_UPDATE'
+  | 'GUILD_DELETE'
+  | 'GUILD_BAN_ADD'
+  | 'GUILD_BAN_REMOVE'
+  | 'GUILD_EMOJIS_UPDATE'
+  | 'GUILD_STICKERS_UPDATE'
+  | 'GUILD_INTEGRATIONS_UPDATE'
+  | 'GUILD_MEMBER_ADD'
+  | 'GUILD_MEMBER_REMOVE'
+  | 'GUILD_MEMBER_UPDATE'
+  | 'GUILD_MEMBERS_CHUNK'
+  | 'GUILD_ROLE_CREATE'
+  | 'GUILD_ROLE_UPDATE'
+  | 'GUILD_ROLE_DELETE'
+  | 'GUILD_SCHEDULED_EVENT_CREATE'
+  | 'GUILD_SCHEDULED_EVENT_UPDATE'
+  | 'GUILD_SCHEDULED_EVENT_DELETE'
+  | 'GUILD_SCHEDULED_EVENT_USER_ADD'
+  | 'GUILD_SCHEDULED_EVENT_USER_REMOVE'
+  | 'GUILD_SOUNDBOARD_SOUND_CREATE'
+  | 'GUILD_SOUNDBOARD_SOUND_UPDATE'
+  | 'GUILD_SOUNDBOARD_SOUND_DELETE'
+  | 'GUILD_SOUNDBOARD_SOUNDS_UPDATE'
+  | 'SOUNDBOARD_SOUNDS'
+  | 'INTEGRATION_CREATE'
+  | 'INTEGRATION_UPDATE'
+  | 'INTEGRATION_DELETE'
+  | 'INTERACTION_CREATE'
+  | 'INVITE_CREATE'
+  | 'INVITE_DELETE'
+  | 'MESSAGE_CREATE'
+  | 'MESSAGE_UPDATE'
+  | 'MESSAGE_DELETE'
+  | 'MESSAGE_DELETE_BULK'
+  | 'MESSAGE_REACTION_ADD'
+  | 'MESSAGE_REACTION_REMOVE'
+  | 'MESSAGE_REACTION_REMOVE_ALL'
+  | 'MESSAGE_REACTION_REMOVE_EMOJI'
+  | 'PRESENCE_UPDATE'
+  | 'STAGE_INSTANCE_CREATE'
+  | 'STAGE_INSTANCE_UPDATE'
+  | 'STAGE_INSTANCE_DELETE'
+  | 'TYPING_START'
+  | 'USER_UPDATE'
+  | 'VOICE_CHANNEL_EFFECT_SEND'
+  | 'VOICE_STATE_UPDATE'
+  | 'VOICE_SERVER_UPDATE'
+  | 'WEBHOOKS_UPDATE'
+  | 'ENTITLEMENT_CREATE'
+  | 'ENTITLEMENT_UPDATE'
+  | 'ENTITLEMENT_DELETE'
+  | 'SUBSCRIPTION_CREATE'
+  | 'SUBSCRIPTION_UPDATE'
+  | 'SUBSCRIPTION_DELETE'
+  | 'MESSAGE_POLL_VOTE_ADD'
+  | 'MESSAGE_POLL_VOTE_REMOVE'
+
+/** https://discord.com/developers/docs/events/gateway-events#receive-events */
+export type GatewayEventNames = GatewayDispatchEventNames | 'RESUMED'
+
+/** https://discord.com/developers/docs/events/gateway-events#payload-structure */
+export interface DiscordGatewayPayload {
+  /** opcode for the payload */
+  op: number
+  /** Event data */
+  d: unknown | null
+  /** Sequence number, used for resuming sessions and heartbeats */
+  s: number | null
+  /** The event name for this payload */
+  t: GatewayEventNames | null
+}
+
+// TODO: Add Identify: https://discord.com/developers/docs/events/gateway-events#identify-identify-structure
+// TODO: Add Identify Connection Properties: https://discord.com/developers/docs/events/gateway-events#identify-identify-connection-properties
+// TODO: Add Resume: https://discord.com/developers/docs/events/gateway-events#resume-resume-structure
+// TODO: Add Request Guild Members: https://discord.com/developers/docs/events/gateway-events#request-guild-members-request-guild-members-structure
+// TODO: Add Request Soundboard Sounds: https://discord.com/developers/docs/events/gateway-events#request-soundboard-sounds-request-soundboard-sounds-structure
+// TODO: Add Voice State Update: https://discord.com/developers/docs/events/gateway-events#update-voice-state-gateway-voice-state-update-structure
+// TODO: Add Presence Update: https://discord.com/developers/docs/events/gateway-events#update-presence-gateway-presence-update-structure
+
+/** https://discord.com/developers/docs/events/gateway-events#update-presence-status-types */
+export enum PresenceStatus {
+  online,
+  dnd,
+  idle,
+  offline,
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#hello-hello-structure */
+export interface DiscordHello {
+  /** The interval (in milliseconds) the client should heartbeat with */
+  heartbeat_interval: number
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#ready-ready-event-fields */
+export interface DiscordReady {
+  /** Gateway version */
+  v: number
+  /** Information about the user including email */
+  user: DiscordUser
+  /** The guilds the user is in */
+  guilds: DiscordUnavailableGuild[]
+  /** Used for resuming connections */
+  session_id: string
+  /** Gateway url for resuming connections */
+  resume_gateway_url: string
+  /** The shard information associated with this session, if sent when identifying */
+  shard?: [number, number]
+  /** Contains id and flags */
+  application: Partial<DiscordApplication> & Pick<DiscordApplication, 'id' | 'flags'>
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#auto-moderation-action-execution-auto-moderation-action-execution-event-fields */
+export interface DiscordAutoModerationActionExecution {
+  /** The id of the guild */
+  guild_id: string
+  /** The id of the rule that was executed */
+  rule_id: string
+  /** The id of the user which generated the content which triggered the rule */
+  user_id: string
+  /** The content from the user */
+  content: string
+  /** Action which was executed */
+  action: DiscordAutoModerationAction
+  /** The trigger type of the rule that was executed. */
+  rule_trigger_type: AutoModerationTriggerTypes
+  /** The id of the channel in which user content was posted */
+  channel_id?: string | null
+  /** The id of the message. Will not exist if message was blocked by automod or content was not part of any message */
+  message_id?: string | null
+  /** The id of any system auto moderation messages posted as a result of this action */
+  alert_system_message_id?: string | null
+  /** The word or phrase that triggerred the rule. */
+  matched_keyword: string | null
+  /** The substring in content that triggered the rule */
+  matched_content: string | null
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#thread-list-sync-thread-list-sync-event-fields */
+export interface DiscordThreadListSync {
+  /** The id of the guild */
+  guild_id: string
+  /** The parent channel ids whose threads are being synced. If omitted, then threads were synced for the entire guild. This array may contain channelIds that have no active threads as well, so you know to clear that data */
+  channel_ids?: string[]
+  /** All active threads in the given channels that the current user can access */
+  threads: DiscordChannel[]
+  /** All thread member objects from the synced threads for the current user, indicating which threads the current user has been added to */
+  members: DiscordThreadMember[]
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#thread-member-update-thread-member-update-event-extra-fields */
+export interface DiscordThreadMemberUpdate {
+  /** The id of the thread */
+  id: string
+  /** The id of the guild */
+  guild_id: string
+  /** The timestamp when the bot joined this thread. */
+  joined_at: string
+  /** The flags this user has for this thread. Not useful for bots. */
+  flags: number
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#thread-members-update-thread-members-update-event-fields */
+export interface DiscordThreadMembersUpdate {
+  /** The id of the thread */
+  id: string
+  /** The id of the guild */
+  guild_id: string
+  /** The users who were added to the thread */
+  added_members?: DiscordThreadMember[]
+  /** The id of the users who were removed from the thread */
+  removed_member_ids?: string[]
+  /** the approximate number of members in the thread, capped at 50 */
+  member_count: number
+}
+
+/** https://discord.com/developers/docs/events/gateway#channel-pins-update */
+export interface DiscordChannelPinsUpdate {
+  /** The id of the guild */
+  guild_id?: string
+  /** The id of the channel */
+  channel_id: string
+  /** The time at which the most recent pinned message was pinned */
+  last_pin_timestamp?: string | null
+}
+
+// TODO: Add Guild Create: https://discord.com/developers/docs/events/gateway-events#guild-create-guild-create-extra-fields
+// TODO: Add Create Guild Audit Log Entry: https://discord.com/developers/docs/events/gateway-events#guild-audit-log-entry-create-guild-audit-log-entry-create-event-extra-fields
+
+// TODO: Give both a name: https://discord.com/developers/docs/events/gateway-events#guild-ban-add-guild-ban-add-event-fields, https://discord.com/developers/docs/events/gateway-events#guild-ban-remove-guild-ban-remove-event-fields
+/**
+ * https://discord.com/developers/docs/events/gateway-events#guild-ban-add-guild-ban-add-event-fields
+ * https://discord.com/developers/docs/events/gateway-events#guild-ban-remove-guild-ban-remove-event-fields
+ */
+export interface DiscordGuildBanAddRemove {
+  /** id of the guild */
+  guild_id: string
+  /** The banned user */
+  user: DiscordUser
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-emojis-update-guild-emojis-update-event-fields */
+export interface DiscordGuildEmojisUpdate {
+  /** id of the guild */
+  guild_id: string
+  /** Array of emojis */
+  emojis: DiscordEmoji[]
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-stickers-update-guild-stickers-update-event-fields */
+export interface DiscordGuildStickersUpdate {
+  /** id of the guild */
+  guild_id: string
+  /** Array of sticker */
+  stickers: DiscordSticker[]
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-integrations-update-guild-integrations-update-event-fields */
+export interface DiscordGuildIntegrationsUpdate {
+  /** id of the guild whose integrations were updated */
+  guild_id: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-member-add-guild-member-add-extra-fields */
+export interface DiscordGuildMemberAdd extends DiscordMemberWithUser {
+  /** id of the guild */
+  guild_id: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-member-remove-guild-member-remove-event-fields */
+export interface DiscordGuildMemberRemove {
+  /** The id of the guild */
+  guild_id: string
+  /** The user who was removed */
+  user: DiscordUser
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-member-update-guild-member-update-event-fields */
+export interface DiscordGuildMemberUpdate {
+  /** The id of the guild */
+  guild_id: string
+  /** User role ids */
+  roles: string[]
+  /** The user */
+  user: DiscordUser
+  /** Nickname of the user in the guild */
+  nick?: string | null
+  /** the member's [guild avatar hash](https://discord.com/developers/docs/reference#image-formatting) */
+  avatar: string
+  /** the member's guild banner hash */
+  banner: string
+  /** When the user joined the guild */
+  joined_at: string
+  /** When the user starting boosting the guild */
+  premium_since?: string | null
+  /** whether the user is deafened in voice channels */
+  deaf?: boolean
+  /** whether the user is muted in voice channels */
+  mute?: boolean
+  /** Whether the user has not yet passed the guild's Membership Screening requirements */
+  pending?: boolean
+  /** when the user's [timeout](https://support.discord.com/hc/en-us/articles/4413305239191-Time-Out-FAQ) will expire and the user will be able to communicate in the guild again, null or a time in the past if the user is not timed out. Will throw a 403 error if the user has the ADMINISTRATOR permission or is the owner of the guild */
+  communication_disabled_until?: string
+  /** Data for the member's guild avatar decoration */
+  avatar_decoration_data?: DiscordAvatarDecorationData
+  /** Guild member flags */
+  flags?: number
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-members-chunk-guild-members-chunk-event-fields */
+export interface DiscordGuildMembersChunk {
+  /** The id of the guild */
+  guild_id: string
+  /** Set of guild members */
+  members: DiscordMemberWithUser[]
+  /** The chunk index in the expected chunks for this response (0 <= chunk_index < chunk_count) */
+  chunk_index: number
+  /** The total number of expected chunks for this response */
+  chunk_count: number
+  /** If passing an invalid id to `REQUEST_GUILD_MEMBERS`, it will be returned here */
+  not_found?: string[]
+  /** If passing true to `REQUEST_GUILD_MEMBERS`, presences of the returned members will be here */
+  presences?: DiscordPresenceUpdate[]
+  /** The nonce used in the Guild Members Request */
+  nonce?: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-role-create-guild-role-create-event-fields */
+export interface DiscordGuildRoleCreate {
+  /** The id of the guild */
+  guild_id: string
+  /** The role created */
+  role: DiscordRole
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-role-update-guild-role-update-event-fields */
+export interface DiscordGuildRoleUpdate {
+  /** The id of the guild */
+  guild_id: string
+  /** The role updated */
+  role: DiscordRole
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-role-delete-guild-role-delete-event-fields */
+export interface DiscordGuildRoleDelete {
+  /** id of the guild */
+  guild_id: string
+  /** id of the role */
+  role_id: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-scheduled-event-user-add-guild-scheduled-event-user-add-event-fields */
+export interface DiscordScheduledEventUserAdd {
+  /** id of the guild scheduled event */
+  guild_scheduled_event_id: string
+  /** id of the user */
+  user_id: string
+  /** id of the guild */
+  guild_id: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#guild-scheduled-event-user-remove-guild-scheduled-event-user-remove-event-fields */
+export interface DiscordScheduledEventUserRemove {
+  /** id of the guild scheduled event */
+  guild_scheduled_event_id: string
+  /** id of the user */
+  user_id: string
+  /** id of the guild */
+  guild_id: string
+}
+
+/** https://discord.com/developers/docs/topics/gateway-events#guild-soundboard-sound-delete-guild-soundboard-sound-delete-event-fields */
+export interface DiscordSoundboardSoundDelete {
+  /** ID of the sound that was deleted */
+  sound_id: string
+  /** ID of the guild the sound was in */
+  guild_id: string
+}
+
+/** https://discord.com/developers/docs/topics/gateway-events#guild-soundboard-sounds-update-guild-soundboard-sounds-update-event-fields */
+export interface DiscordSoundboardSoundsUpdate {
+  /** The guild's soundboard sounds */
+  soundboard_sounds: DiscordSoundboardSound[]
+  /** ID of the guild the sound was in */
+  guild_id: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#soundboard-sounds-soundboard-sounds-event-fields */
+export interface DiscordSoundboardSounds {
+  /** The guild's soundboard sounds */
+  soundboard_sounds: DiscordSoundboardSound[]
+  /** ID of the guild the sound was in */
+  guild_id: string
+}
+
+// TODO: Add separate type for Integration Create and Integration Update: https://discord.com/developers/docs/events/gateway-events#integration-create-integration-create-event-additional-fields, https://discord.com/developers/docs/events/gateway-events#integration-update-integration-update-event-additional-fields
+/**
+ * https://discord.com/developers/docs/events/gateway-events#integration-create-integration-create-event-additional-fields
+ * https://discord.com/developers/docs/events/gateway-events#integration-update-integration-update-event-additional-fields
+ */
+export interface DiscordIntegrationCreateUpdate extends DiscordIntegration {
+  /** Id of the guild */
+  guild_id: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#integration-delete-integration-delete-event-fields */
+export interface DiscordIntegrationDelete {
+  /** Integration id */
+  id: string
+  /** Id of the guild */
+  guild_id: string
+  /** Id of the bot/OAuth2 application for this discord integration */
+  application_id?: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#invite-create-invite-create-event-fields */
+export interface DiscordInviteCreate {
+  /** The channel the invite is for */
+  channel_id: string
+  /** The unique invite code */
+  code: string
+  /** The time at which the invite was created */
+  created_at: string
+  /** The guild of the invite */
+  guild_id?: string
+  /** The user that created the invite */
+  inviter?: DiscordUser
+  /** How long the invite is valid for (in seconds) */
+  max_age: number
+  /** The maximum number of times the invite can be used */
+  max_uses: number
+  /** The type of target for this voice channel invite */
+  target_type: TargetTypes
+  /** The target user for this invite */
+  target_user?: DiscordUser
+  /** The embedded application to open for this voice channel embedded application invite */
+  target_application?: Partial<DiscordApplication>
+  /** Whether or not the invite is temporary (invited users will be kicked on disconnect unless they're assigned a role) */
+  temporary: boolean
+  /** How many times the invite has been used (always will be 0) */
+  uses: number
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#invite-delete-invite-delete-event-fields */
+export interface DiscordInviteDelete {
+  /** The channel of the invite */
+  channel_id: string
+  /** The guild of the invite */
+  guild_id?: string
+  /** The unique invite code */
+  code: string
+}
+
+// TODO: Add Message Create: https://discord.com/developers/docs/events/gateway-events#message-create-message-create-extra-fields
+
+/** https://discord.com/developers/docs/events/gateway-events#message-delete-message-delete-event-fields */
+export interface DiscordMessageDelete {
+  /** The id of the message */
+  id: string
+  /** The id of the channel */
+  channel_id: string
+  /** The id of the guild */
+  guild_id?: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#message-delete-bulk-message-delete-bulk-event-fields */
+export interface DiscordMessageDeleteBulk {
+  /** The ids of the messages */
+  ids: string[]
+  /** The id of the channel */
+  channel_id: string
+  /** The id of the guild */
+  guild_id?: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#message-reaction-add-message-reaction-add-event-fields */
+export interface DiscordMessageReactionAdd {
+  /** The id of the user */
+  user_id: string
+  /** The id of the channel */
+  channel_id: string
+  /** The id of the message */
+  message_id: string
+  /** The id of the guild */
+  guild_id?: string
+  /** The member who reacted if this happened in a guild */
+  member?: DiscordMemberWithUser
+  /** The emoji used to react */
+  emoji: Partial<DiscordEmoji>
+  /** The id of the author of this message */
+  message_author_id?: string
+  /** true if this is a super-reaction */
+  burst: boolean
+  /** Colors used for super-reaction animation in "#rrggbb" format */
+  burst_colors?: string[]
+  /** The type of reaction */
+  type: DiscordReactionType
+}
+
+// TODO: This should provably not depend on DiscordMessageReactionAdd
+/** https://discord.com/developers/docs/events/gateway-events#message-reaction-remove-message-reaction-remove-event-fields */
+export interface DiscordMessageReactionRemove extends Omit<DiscordMessageReactionAdd, 'member' | 'burst_colors'> {}
+
+// TODO: This should provably not depend on DiscordMessageReactionAdd
+/** https://discord.com/developers/docs/events/gateway-events#message-reaction-remove-all-message-reaction-remove-all-event-fields */
+export interface DiscordMessageReactionRemoveAll extends Pick<DiscordMessageReactionAdd, 'channel_id' | 'message_id' | 'guild_id'> {}
+
+// TODO: This should provably not depend on DiscordMessageReactionAdd
+/** https://discord.com/developers/docs/events/gateway-events#message-reaction-remove-emoji-message-reaction-remove-emoji-event-fields */
+export type DiscordMessageReactionRemoveEmoji = Pick<DiscordMessageReactionAdd, 'channel_id' | 'guild_id' | 'message_id' | 'emoji'>
+
+/** https://discord.com/developers/docs/events/gateway-events#presence-update-presence-update-event-fields */
+export interface DiscordPresenceUpdate {
+  /** Either "idle", "dnd", "online", or "offline" */
+  status: 'idle' | 'dnd' | 'online' | 'offline'
+  /** The user presence is being updated for */
+  user: DiscordUser
+  /** id of the guild */
+  guild_id: string
+  /** User's current activities */
+  activities: DiscordActivity[]
+  /** User's platform-dependent status */
+  client_status: DiscordClientStatus
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#client-status-object */
+export interface DiscordClientStatus {
+  /** The user's status set for an active desktop (Windows, Linux, Mac) application session */
+  desktop?: string
+  /** The user's status set for an active mobile (iOS, Android) application session */
+  mobile?: string
+  /** The user's status set for an active web (browser, bot account) application session */
+  web?: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#activity-object */
+export interface DiscordActivity {
+  /** The activity's name */
+  name: string
+  /** Activity type */
+  type: ActivityTypes
+  /** Stream url, is validated when type is 1 */
+  url?: string | null
+  /** Unix timestamp of when the activity was added to the user's session */
+  created_at: number
+  /** What the player is currently doing */
+  details?: string | null
+  /** The user's current party status */
+  state?: string | null
+  /** Whether or not the activity is an instanced game session */
+  instance?: boolean
+  /** Activity flags `OR`d together, describes what the payload includes */
+  flags?: number
+  /** Unix timestamps for start and/or end of the game */
+  timestamps?: DiscordActivityTimestamps
+  /** Application id for the game */
+  application_id?: string
+  /** The emoji used for a custom status */
+  emoji?: DiscordActivityEmoji | null
+  /** Information for the current party of the player */
+  party?: DiscordActivityParty
+  /** Images for the presence and their hover texts */
+  assets?: DiscordActivityAssets
+  /** Secrets for Rich Presence joining and spectating */
+  secrets?: DiscordActivitySecrets
+  /** The custom buttons shown in the Rich Presence (max 2) */
+  buttons?: DiscordActivityButton[]
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#activity-object-activity-types */
+export enum ActivityTypes {
+  Playing = 0,
+  Streaming = 1,
+  Listening = 2,
+  Watching = 3,
+  Custom = 4,
+  Competing = 5,
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#activity-object-activity-timestamps */
+export interface DiscordActivityTimestamps {
+  /** Unix time (in milliseconds) of when the activity started */
+  start?: number
+  /** Unix time (in milliseconds) of when the activity ends */
+  end?: number
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#activity-object-activity-emoji */
+export interface DiscordActivityEmoji {
+  /** The name of the emoji */
+  name: string
+  /** Whether this emoji is animated */
+  animated?: boolean
+  /** The id of the emoji */
+  id?: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#activity-object-activity-party */
+export interface DiscordActivityParty {
+  /** Used to show the party's current and maximum size */
+  size?: [currentSize: number, maxSize: number]
+  /** The id of the party */
+  id?: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#activity-object-activity-assets */
+export interface DiscordActivityAssets {
+  /** Text displayed when hovering over the large image of the activity */
+  large_text?: string
+  /** Text displayed when hovering over the small image of the activity */
+  small_text?: string
+  /** The id for a large asset of the activity, usually a snowflake */
+  large_image?: string
+  /** The id for a small asset of the activity, usually a snowflake */
+  small_image?: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#activity-object-activity-secrets */
+export interface DiscordActivitySecrets {
+  /** The secret for joining a party */
+  join?: string
+  /** The secret for spectating a game */
+  spectate?: string
+  /** The secret for a specific instanced match */
+  match?: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#activity-object-activity-flags */
+export enum ActivityFlags {
+  Instance = 1 << 0,
+  Join = 1 << 1,
+  Spectate = 1 << 2,
+  JoinRequest = 1 << 3,
+  Sync = 1 << 4,
+  Play = 1 << 5,
+  PartyPrivacyFriends = 1 << 6,
+  PartyPrivacyVoiceChannel = 1 << 7,
+  Embedded = 1 << 8,
+}
+
+/** https://discord.com/developers/docs/events/gateway#activity-object-activity-buttons */
+export interface DiscordActivityButton {
+  /** The text shown on the button (1-32 characters) */
+  label: string
+  /** The url opened when clicking the button (1-512 characters) */
+  url: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#typing-start-typing-start-event-fields */
+export interface DiscordTypingStart {
+  /** Unix time (in seconds) of when the user started typing */
+  timestamp: number
+  /** id of the channel */
+  channel_id: string
+  /** id of the guild */
+  guild_id?: string
+  /** id of the user */
+  user_id: string
+  /** The member who started typing if this happened in a guild */
+  member?: DiscordMember
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#voice-channel-effect-send-voice-channel-effect-send-event-fields */
+export interface DiscordVoiceChannelEffectSend {
+  /** ID of the channel the effect was sent in */
+  channel_id: string
+  /** ID of the guild the effect was sent in */
+  guild_id: string
+  /** ID of the user who sent the effect */
+  user_id: string
+  /** The emoji sent, for emoji reaction and soundboard effects */
+  emoji?: DiscordEmoji | null
+  /** The type of emoji animation, for emoji reaction and soundboard effects */
+  animation_type?: DiscordVoiceChannelEffectAnimationType | null
+  /** The ID of the emoji animation, for emoji reaction and soundboard effects */
+  animation_id?: number | null
+  /** The ID of the soundboard sound, for soundboard effects */
+  sound_id?: string | number
+  /** The volume of the soundboard sound, from 0 to 1, for soundboard effects */
+  sound_volume?: number
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#voice-channel-effect-send-animation-types */
+export enum DiscordVoiceChannelEffectAnimationType {
+  /** A fun animation, sent by a Nitro subscriber */
+  Premium = 0,
+  /** The standard animation */
+  Basic = 1,
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#voice-server-update-voice-server-update-event-fields */
+export interface DiscordVoiceServerUpdate {
+  /** Voice connection token */
+  token: string
+  /** The guild this voice server update is for */
+  guild_id: string
+  /** The voice server host */
+  endpoint: string | null
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#webhooks-update-webhooks-update-event-fields */
+export interface DiscordWebhookUpdate {
+  /** id of the guild */
+  guild_id: string
+  /** id of the channel */
+  channel_id: string
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#message-poll-vote-add-message-poll-vote-add-fields */
+export interface DiscordPollVoteAdd {
+  /** ID of the user. Usually a snowflake */
+  user_id: string
+  /** ID of the channel. Usually a snowflake */
+  channel_id: string
+  /** ID of the message. Usually a snowflake */
+  message_id: string
+  /** ID of the guild. Usually a snowflake */
+  guild_id?: string
+  /** ID of the answer. */
+  answer_id: number
+}
+
+/** https://discord.com/developers/docs/events/gateway-events#message-poll-vote-remove-message-poll-vote-remove-fields */
+export interface DiscordPollVoteRemove {
+  /** ID of the user. Usually a snowflake */
+  user_id: string
+  /** ID of the channel. Usually a snowflake */
+  channel_id: string
+  /** ID of the message. Usually a snowflake */
+  message_id: string
+  /** ID of the guild. Usually a snowflake */
+  guild_id?: string
+  /** ID of the answer. */
+  answer_id: number
+}

packages/types/src/discord/guild.ts

@@ -0,0 +1,689 @@
+/** Types for: https://discord.com/developers/docs/resources/guild */
+
+import type { ChannelTypes, DiscordChannel, DiscordOverwrite, SortOrderTypes } from './channel.js'
+import type { DiscordEmoji } from './emoji.js'
+import type { DiscordPresenceUpdate } from './gateway.js'
+import type { OAuth2Scope } from './oauth2.js'
+import type { DiscordRole } from './permissions.js'
+import type { DiscordSoundboardSound } from './soundboard.js'
+import type { DiscordStageInstance } from './stageInstance.js'
+import type { DiscordSticker } from './sticker.js'
+import type { DiscordAvatarDecorationData, DiscordUser } from './user.js'
+import type { DiscordVoiceState } from './voice.js'
+
+/** https://discord.com/developers/docs/resources/guild#guild-object-guild-structure */
+export interface DiscordGuild {
+  /** Guild name (2-100 characters, excluding trailing and leading whitespace) */
+  name: string
+  /** True if the user is the owner of the guild */
+  owner?: boolean
+  /** Afk timeout in seconds */
+  afk_timeout: number
+  /** True if the server widget is enabled */
+  widget_enabled?: boolean
+  /** Verification level required for the guild */
+  verification_level: VerificationLevels
+  /** Default message notifications level */
+  default_message_notifications: DefaultMessageNotificationLevels
+  /** Explicit content filter level */
+  explicit_content_filter: ExplicitContentFilterLevels
+  /** Enabled guild features */
+  features: GuildFeatures[]
+  /** Required MFA level for the guild */
+  mfa_level: MfaLevels
+  /** System channel flags */
+  system_channel_flags: SystemChannelFlags
+  /** True if this is considered a large guild */
+  large?: boolean
+  /** True if this guild is unavailable due to an outage */
+  unavailable?: boolean
+  /** Total number of members in this guild */
+  member_count?: number
+  /** The maximum number of presences for the guild (the default value, currently 25000, is in effect when null is returned) */
+  max_presences?: number | null
+  /** The maximum number of members for the guild */
+  max_members?: number
+  /** The vanity url code for the guild */
+  vanity_url_code: string | null
+  /** The description of a guild */
+  description: string | null
+  /** Premium tier (Server Boost level) */
+  premium_tier: PremiumTiers
+  /** The number of boosts this guild currently has */
+  premium_subscription_count?: number
+  /** The maximum amount of users in a video channel */
+  max_video_channel_users?: number
+  /** Maximum amount of users in a stage video channel */
+  max_stage_video_channel_users?: number
+  /** Approximate number of members in this guild, returned from the GET /guilds/id endpoint when with_counts is true */
+  approximate_member_count?: number
+  /** Approximate number of non-offline members in this guild, returned from the GET /guilds/id endpoint when with_counts is true */
+  approximate_presence_count?: number
+  /** Guild NSFW level */
+  nsfw_level: GuildNsfwLevel
+  /** Whether the guild has the boost progress bar enabled */
+  premium_progress_bar_enabled: boolean
+  /** Guild id */
+  id: string
+  /** Icon hash */
+  icon: string | null
+  /** Icon hash, returned when in the template object */
+  icon_hash?: string | null
+  /** Splash hash */
+  splash: string | null
+  /** Discovery splash hash; only present for guilds with the "DISCOVERABLE" feature */
+  discovery_splash: string | null
+  /** Id of the owner */
+  owner_id: string
+  /** Total permissions for the user in the guild (excludes overwrites and implicit permissions) */
+  permissions?: string
+  /** Id of afk channel */
+  afk_channel_id: string | null
+  /** The channel id that the widget will generate an invite to, or null if set to no invite */
+  widget_channel_id?: string | null
+  /** Roles in the guild */
+  roles: DiscordRole[]
+  /** Custom guild emojis */
+  emojis: DiscordEmoji[]
+  /** Application id of the guild creator if it is bot-created */
+  application_id: string | null
+  /** The id of the channel where guild notices such as welcome messages and boost events are posted */
+  system_channel_id: string | null
+  /** The id of the channel where community guilds can display rules and/or guidelines */
+  rules_channel_id: string | null
+  /** When this guild was joined at */
+  joined_at?: string
+  /** States of members currently in voice channels; lacks the guild_id key */
+  voice_states?: Omit<DiscordVoiceState, 'guildId'>[]
+  /** Users in the guild */
+  members?: DiscordMember[]
+  /** Channels in the guild */
+  channels?: DiscordChannel[]
+  /** All active threads in the guild that the current user has permission to view */
+  threads?: DiscordChannel[]
+  /** Presences of the members in the guild, will only include non-offline members if the size is greater than large threshold */
+  presences?: Partial<DiscordPresenceUpdate>[]
+  /** Banner hash */
+  banner: string | null
+  /** The preferred locale of a Community guild; used in server discovery and notices from Discord; defaults to "en-US" */
+  preferred_locale: string
+  /** The id of the channel where admins and moderators of Community guilds receive notices from Discord */
+  public_updates_channel_id: string | null
+  /** The welcome screen of a Community guild, shown to new members, returned in an Invite's guild object */
+  welcome_screen?: DiscordWelcomeScreen
+  /** Stage instances in the guild */
+  stage_instances?: DiscordStageInstance[]
+  /** Custom guild stickers */
+  stickers?: DiscordSticker[]
+  /** The id of the channel where admins and moderators of Community guilds receive safety alerts from Discord */
+  safety_alerts_channel_id: string | null
+  /**
+   * Soundboard sounds in the guild
+   *
+   * @remarks
+   * Only sent by the gateway
+   */
+  soundboard_sounds?: DiscordSoundboardSound[]
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-object-default-message-notification-level */
+export enum DefaultMessageNotificationLevels {
+  /** Members will receive notifications for all messages by default */
+  AllMessages,
+  /** Members will receive notifications only for messages that \@mention them by default */
+  OnlyMentions,
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-object-explicit-content-filter-level */
+export enum ExplicitContentFilterLevels {
+  /** Media content will not be scanned */
+  Disabled,
+  /** Media content sent by members without roles will be scanned */
+  MembersWithoutRoles,
+  /** Media content sent by all members will be scanned */
+  AllMembers,
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-object-mfa-level */
+export enum MfaLevels {
+  /** Guild has no MFA/2FA requirement for moderation actions */
+  None,
+  /** Guild has a 2FA requirement for moderation actions */
+  Elevated,
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-object-verification-level */
+export enum VerificationLevels {
+  /** Unrestricted */
+  None,
+  /** Must have verified email on account */
+  Low,
+  /** Must be registered on Discord for longer than 5 minutes */
+  Medium,
+  /** Must be a member of the server for longer than 10 minutes */
+  High,
+  /** Must have a verified phone number */
+  VeryHigh,
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-object-guild-nsfw-level */
+export enum GuildNsfwLevel {
+  Default,
+  Explicit,
+  Safe,
+  AgeRestricted,
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-object-premium-tier */
+export enum PremiumTiers {
+  /** Guild has not unlocked any Server Boost perks */
+  None,
+  /** Guild has unlocked Server Boost level 1 perks */
+  Tier1,
+  /** Guild has unlocked Server Boost level 2 perks */
+  Tier2,
+  /** Guild has unlocked Server Boost level 3 perks */
+  Tier3,
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-object-system-channel-flags */
+export enum SystemChannelFlags {
+  /** Suppress member join notifications */
+  SuppressJoinNotifications = 1 << 0,
+  /** Suppress server boost notifications */
+  SuppressPremiumSubscriptions = 1 << 1,
+  /** Suppress server setup tips */
+  SuppressGuildReminderNotifications = 1 << 2,
+  /** Hide member join sticker reply buttons */
+  SuppressJoinNotificationReplies = 1 << 3,
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-object-guild-features */
+export enum GuildFeatures {
+  /** Guild has access to set an invite splash background */
+  InviteSplash = 'INVITE_SPLASH',
+  /** Guild has access to set 384 kbps bitrate in voice (previously VIP voice servers) */
+  VipRegions = 'VIP_REGIONS',
+  /** Guild has access to set a vanity URL */
+  VanityUrl = 'VANITY_URL',
+  /** Guild is verified */
+  Verified = 'VERIFIED',
+  /** Guild is partnered */
+  Partnered = 'PARTNERED',
+  /** Guild can enable welcome screen, Membership Screening, stage channels and discovery, and receives community updates */
+  Community = 'COMMUNITY',
+  /** Guild has enabled monetization. */
+  CreatorMonetizableProvisional = 'CREATOR_MONETIZABLE_PROVISIONAL',
+  /** Guild has enabled the role subscription promo page. */
+  CreatorStorePage = 'CREATOR_STORE_PAGE',
+  /** Guild has been set as a support server on the App Directory */
+  DeveloperSupportServer = 'DEVELOPER_SUPPORT_SERVER',
+  /** Guild has access to create news channels */
+  News = 'NEWS',
+  /** Guild is able to be discovered in the directory */
+  Discoverable = 'DISCOVERABLE',
+  /** Guild is able to be featured in the directory */
+  Featurable = 'FEATURABLE',
+  /** Guild has access to set an animated guild icon */
+  AnimatedIcon = 'ANIMATED_ICON',
+  /** Guild has access to set a guild banner image */
+  Banner = 'BANNER',
+  /** Guild has enabled the welcome screen */
+  WelcomeScreenEnabled = 'WELCOME_SCREEN_ENABLED',
+  /** Guild has enabled [Membership Screening](https://discord.com/developers/docs/resources/guild#membership-screening-object) */
+  MemberVerificationGateEnabled = 'MEMBER_VERIFICATION_GATE_ENABLED',
+  /** Guild has increased custom soundboard sound slots. */
+  MoreSoundboard = 'MORE_SOUNDBOARD',
+  /** Guild can be previewed before joining via Membership Screening or the directory */
+  PreviewEnabled = 'PREVIEW_ENABLED',
+  /** Guild has enabled ticketed events */
+  TicketedEventsEnabled = 'TICKETED_EVENTS_ENABLED',
+  /** Guild has increased custom sticker slots */
+  MoreStickers = 'MORE_STICKERS',
+  /** Guild is able to set role icons */
+  RoleIcons = 'ROLE_ICONS',
+  /** Guild has role subscriptions that can be purchased. */
+  RoleSubscriptionsAvailableForPurchase = 'ROLE_SUBSCRIPTIONS_AVAILABLE_FOR_PURCHASE',
+  /** Guild has enabled role subscriptions. */
+  RoleSubscriptionsEnabled = 'ROLE_SUBSCRIPTIONS_ENABLED',
+  /** Guild has created soundboard sounds. */
+  Soundboard = 'SOUNDBOARD',
+  /** Guild has set up auto moderation rules */
+  AutoModeration = 'AUTO_MODERATION',
+  /** Guild has paused invites, preventing new users from joining */
+  InvitesDisabled = 'INVITES_DISABLED',
+  /** Guild has access to set an animated guild banner image */
+  AnimatedBanner = 'ANIMATED_BANNER',
+  /** Guild has disabled alerts for join raids in the configured safety alerts channel */
+  RaidAlertsDisabled = 'RAID_ALERTS_DISABLED',
+  /** Guild is using the old permissions configuration behavior */
+  ApplicationCommandPermissionsV2 = 'APPLICATION_COMMAND_PERMISSIONS_V2',
+}
+
+/** https://discord.com/developers/docs/resources/guild#unavailable-guild-object */
+export interface DiscordUnavailableGuild extends Pick<DiscordGuild, 'id' | 'unavailable'> {}
+
+/** https://discord.com/developers/docs/resources/guild#guild-preview-object-guild-preview-structure */
+export interface DiscordGuildPreview {
+  /** Guild id */
+  id: string
+  /** Guild name (2-100 characters) */
+  name: string
+  /** Icon hash */
+  icon: string | null
+  /** Splash hash */
+  splash: string | null
+  /** Discovery splash hash */
+  discovery_splash: string | null
+  /** Custom guild emojis */
+  emojis: DiscordEmoji[]
+  /** Enabled guild features */
+  features: GuildFeatures[]
+  /** Approximate number of members in this guild */
+  approximate_member_count: number
+  /** Approximate number of online members in this guild */
+  approximate_presence_count: number
+  /** The description for the guild, if the guild is discoverable */
+  description: string | null
+  /** Custom guild stickers */
+  stickers: DiscordSticker[]
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-widget-settings-object-guild-widget-settings-structure */
+export interface DiscordGuildWidgetSettings {
+  /** whether the widget is enabled */
+  enabled: boolean
+  /** the widget channel id */
+  channel_id: string | null
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-widget-object-guild-widget-structure */
+export interface DiscordGuildWidget {
+  id: string
+  name: string
+  instant_invite: string
+  channels: Array<{
+    id: string
+    name: string
+    position: number
+  }>
+  members: Array<{
+    id: string
+    username: string
+    discriminator: string
+    avatar?: string | null
+    status: string
+    avatar_url: string
+  }>
+  presence_count: number
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-member-object-guild-member-structure */
+export interface DiscordMember {
+  /** Whether the user is deafened in voice channels */
+  deaf?: boolean
+  /** Whether the user is muted in voice channels */
+  mute?: boolean
+  /** Whether the user has not yet passed the guild's Membership Screening requirements */
+  pending?: boolean
+  /** The user this guild member represents */
+  user?: DiscordUser
+  /** This user's guild nickname */
+  nick?: string | null
+  /** The member's custom avatar for this server. */
+  avatar?: string
+  /** The member's guild banner */
+  banner?: string
+  /** Array of role object ids */
+  roles: string[]
+  /** When the user joined the guild */
+  joined_at: string
+  /** When the user started boosting the guild */
+  premium_since?: string | null
+  /** The permissions this member has in the guild. Only present on interaction events and OAuth2 current member fetch. */
+  permissions?: string
+  /** when the user's timeout will expire and the user will be able to communicate in the guild again (set null to remove timeout), null or a time in the past if the user is not timed out */
+  communication_disabled_until?: string | null
+  /** Guild member flags */
+  flags: number
+  /** data for the member's guild avatar decoration */
+  avatar_decoration_data?: DiscordAvatarDecorationData | null
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-member-object-guild-member-structure */
+export interface DiscordMemberWithUser extends DiscordMember {
+  /** The user object for this member */
+  user: DiscordUser
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-member-object-guild-member-flags */
+export enum MemberFlags {
+  /**
+   * Member has left and rejoined the guild
+   *
+   * @remarks
+   * This value is not editable
+   */
+  DidRejoin = 1 << 0,
+  /**
+   * Member has completed onboarding
+   *
+   * @remarks
+   * This value is not editable
+   */
+  CompletedOnboarding = 1 << 1,
+  /** Member is exempt from guild verification requirements */
+  BypassesVerification = 1 << 2,
+  /**
+   * Member has started onboarding
+   *
+   * @remarks
+   * This value is not editable
+   */
+  StartedOnboarding = 1 << 3,
+  /**
+   * Member is a guest and can only access the voice channel they were invited to
+   *
+   * @remarks
+   * This value is not editable
+   */
+  IsGuest = 1 << 4,
+  /**
+   * Member has started Server Guide new member actions
+   *
+   * @remarks
+   * This value is not editable
+   */
+  StartedHomeActions = 1 << 5,
+  /**
+   * Member has completed Server Guide new member actions
+   *
+   * @remarks
+   * This value is not editable
+   */
+  CompletedHomeActions = 1 << 6,
+  /**
+   * Member's username, display name, or nickname is blocked by AutoMod
+   *
+   * @remarks
+   * This value is not editable
+   */
+  AutomodQuarantinedUsername = 1 << 7,
+  /**
+   * Member has dismissed the DM settings upsell
+   *
+   * @remarks
+   * This value is not editable
+   */
+  DmSettingsUpsellAcknowledged = 1 << 9,
+}
+
+/** https://discord.com/developers/docs/resources/guild#integration-object-integration-structure */
+export interface DiscordIntegration {
+  /** Integration Id */
+  id: string
+  /** Integration name */
+  name: string
+  /** Integration type (twitch, youtube, discord, or guild_subscription). */
+  type: 'twitch' | 'youtube' | 'discord'
+  /** Is this integration enabled */
+  enabled?: boolean
+  /** Is this integration syncing */
+  syncing?: boolean
+  /** Role Id that this integration uses for "subscribers" */
+  role_id?: string
+  /** Whether emoticons should be synced for this integration (twitch only currently) */
+  enable_emoticons?: boolean
+  /** The behavior of expiring subscribers */
+  expire_behavior?: IntegrationExpireBehaviors
+  /** The grace period (in days) before expiring subscribers */
+  expire_grace_period?: number
+  /** When this integration was last synced */
+  synced_at?: string
+  /** How many subscribers this integration has */
+  subscriber_count?: number
+  /** Has this integration been revoked */
+  revoked?: boolean
+  /** User for this integration */
+  user?: DiscordUser
+  /** Integration account information */
+  account: DiscordIntegrationAccount
+  /** The bot/OAuth2 application for discord integrations */
+  application?: DiscordIntegrationApplication
+  /** the scopes the application has been authorized for */
+  scopes: OAuth2Scope[]
+}
+
+/** https://discord.com/developers/docs/resources/guild#integration-object-integration-expire-behaviors */
+export enum IntegrationExpireBehaviors {
+  RemoveRole,
+  Kick,
+}
+
+/** https://discord.com/developers/docs/resources/guild#integration-account-object-integration-account-structure */
+export interface DiscordIntegrationAccount {
+  /** Id of the account */
+  id: string
+  /** Name of the account */
+  name: string
+}
+
+/** https://discord.com/developers/docs/resources/guild#integration-application-object-integration-application-structure */
+export interface DiscordIntegrationApplication {
+  /** The id of the app */
+  id: string
+  /** The name of the app */
+  name: string
+  /** the icon hash of the app */
+  icon: string | null
+  /** The description of the app */
+  description: string
+  /** The bot associated with this application */
+  bot?: DiscordUser
+}
+
+/** https://discord.com/developers/docs/resources/guild#ban-object-ban-structure */
+export interface DiscordBan {
+  /** The reason for the ban */
+  reason: string | null
+  /** The banned user */
+  user: DiscordUser
+}
+
+/** https://discord.com/developers/docs/resources/guild#welcome-screen-object-welcome-screen-structure */
+export interface DiscordWelcomeScreen {
+  /** The server description shown in the welcome screen */
+  description: string | null
+  /** The channels shown in the welcome screen, up to 5 */
+  welcome_channels: DiscordWelcomeScreenChannel[]
+}
+
+/** https://discord.com/developers/docs/resources/guild#welcome-screen-object-welcome-screen-channel-structure */
+export interface DiscordWelcomeScreenChannel {
+  /** The description shown for the channel */
+  description: string
+  /** The channel's id */
+  channel_id: string
+  /** The emoji id, if the emoji is custom */
+  emoji_id: string | null
+  /** The emoji name if custom, the unicode character if standard, or `null` if no emoji is set */
+  emoji_name: string | null
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-onboarding-object-guild-onboarding-structure */
+export interface DiscordGuildOnboarding {
+  /** ID of the guild this onboarding is part of */
+  guild_id: string
+  /** Prompts shown during onboarding and in customize community */
+  prompts: DiscordGuildOnboardingPrompt[]
+  /** Channel IDs that members get opted into automatically */
+  default_channel_ids: string[]
+  /** Whether onboarding is enabled in the guild */
+  enabled: boolean
+  /** Current mode of onboarding */
+  mode: DiscordGuildOnboardingMode
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-onboarding-object-onboarding-prompt-structure */
+export interface DiscordGuildOnboardingPrompt {
+  /** ID of the prompt */
+  id: string
+  /** Type of prompt */
+  type: DiscordGuildOnboardingPromptType
+  /** Options available within the prompt */
+  options: DiscordGuildOnboardingPromptOption[]
+  /** Title of the prompt */
+  title: string
+  /** Indicates whether users are limited to selecting one option for the prompt */
+  single_select: boolean
+  /** Indicates whether the prompt is required before a user completes the onboarding flow */
+  required: boolean
+  /** Indicates whether the prompt is present in the onboarding flow. If `false`, the prompt will only appear in the Channels & Roles tab */
+  in_onboarding: boolean
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-onboarding-object-prompt-option-structure */
+export interface DiscordGuildOnboardingPromptOption {
+  /** ID of the prompt option */
+  id: string
+  /** IDs for channels a member is added to when the option is selected */
+  channel_ids: string[]
+  /** IDs for roles assigned to a member when the option is selected */
+  role_ids: string[]
+  /**
+   * Emoji of the option
+   *
+   * @remarks
+   * When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
+   */
+  emoji?: DiscordEmoji
+  /**
+   * Emoji ID of the option
+   *
+   * @remarks
+   * When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
+   */
+  emoji_id?: string
+  /**
+   * Emoji name of the option
+   *
+   * @remarks
+   * When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
+   */
+  emoji_name?: string
+  /**
+   * Whether the emoji is animated
+   *
+   * @remarks
+   * When creating or updating a prompt option, the `emoji_id`, `emoji_name`, and `emoji_animated` fields must be used instead of the emoji object.
+   */
+  emoji_animated?: boolean
+  /** Title of the option */
+  title: string
+  /** Description of the option */
+  description: string | null
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-onboarding-object-onboarding-mode */
+export enum DiscordGuildOnboardingMode {
+  /** Counts only Default Channels towards constraints */
+  OnboardingDefault,
+  /** Counts Default Channels and Questions towards constraints */
+  OnboardingAdvanced,
+}
+
+/** https://discord.com/developers/docs/resources/guild#guild-onboarding-object-prompt-types */
+export enum DiscordGuildOnboardingPromptType {
+  MultipleChoice,
+  DropDown,
+}
+
+/** https://discord.com/developers/docs/resources/guild#create-guild-channel-json-params */
+export interface DiscordCreateGuildChannel {
+  /** Channel name (1-100 characters) */
+  name: string
+  /** The type of channel */
+  type?: ChannelTypes
+  /** Channel topic (0-1024 characters) */
+  topic?: string
+  /** The bitrate (in bits) of the voice channel (voice only) */
+  bitrate?: number
+  /** The user limit of the voice channel (voice only) */
+  user_limit?: number
+  /** Amount of seconds a user has to wait before sending another message (0-21600); bots, as well as users with the permission `manage_messages` or `manage_channel`, are unaffected */
+  rate_limit_per_user?: number
+  /** Sorting position of the channel */
+  position?: number
+  /** The channel's permission overwrites */
+  permission_overwrites?: DiscordOverwrite[]
+  /** Id of the parent category for a channel */
+  parent_id?: string
+  /** Whether the channel is nsfw */
+  nsfw?: boolean
+  /** Default duration (in minutes) that clients (not the API) use for newly created threads in this channel, to determine when to automatically archive the thread after the last activity */
+  default_auto_archive_duration?: number
+  /** Emoji to show in the add reaction button on a thread in a forum channel */
+  default_reaction_emoji?: {
+    /** The id of a guild's custom emoji. Exactly one of `emojiId` and `emojiName` must be set. */
+    emoji_id?: string | null
+    /** The unicode character of the emoji. Exactly one of `emojiId` and `emojiName` must be set. */
+    emoji_name?: string | null
+  }
+  /** Set of tags that can be used in a forum channel */
+  available_tags?: Array<{
+    /** The id of the tag */
+    id: string
+    /** The name of the tag (0-20 characters) */
+    name: string
+    /** whether this tag can only be added to or removed from threads by a member with the MANAGE_THREADS permission */
+    moderated: boolean
+    /** The id of a guild's custom emoji */
+    emoji_id: string
+    /** The unicode character of the emoji */
+    emoji_name?: string
+  }>
+  /** the default sort order type used to order posts in forum channels */
+  default_sort_order?: SortOrderTypes | null
+}
+
+/** https://discord.com/developers/docs/resources/guild#modify-guild-channel-positions */
+export interface DiscordModifyGuildChannelPositions {
+  /** Channel id */
+  id: string
+  /** Sorting position of the channel */
+  position?: number | null
+  /** Syncs the permission overwrites with the new parent, if moving to a new category */
+  lock_positions?: boolean | null
+  /** The new parent ID for the channel that is moved */
+  parent_id?: string | null
+}
+
+/** https://discord.com/developers/docs/resources/guild#bulk-guild-ban-bulk-ban-response */
+export interface DiscordBulkBan {
+  /** list of user ids, that were successfully banned */
+  banned_users: string[]
+  /** list of user ids, that were not banned */
+  failed_users: string[]
+}
+
+/** https://discord.com/developers/docs/resources/guild#get-guild-prune-count */
+export interface DiscordPrunedCount {
+  pruned: number
+}
+
+/** https://discord.com/developers/docs/resources/guild#get-guild-vanity-url */
+// TODO: This should provably have another name for clarity to what it really rappresent
+export interface DiscordVanityUrl {
+  code: string | null
+  uses: number
+}
+
+/** https://discord.com/developers/docs/resources/guild#modify-guild-welcome-screen */
+export interface DiscordModifyGuildWelcomeScreen {
+  /** Whether the welcome screen is enabled */
+  enabled?: boolean | null
+  /** Channels linked in the welcome screen and their display options */
+  welcome_screen?: DiscordWelcomeScreenChannel[] | null
+  /** The server description to show in the welcome screen */
+  description?: string | null
+}

packages/types/src/discord/guildScheduledEvent.ts

@@ -0,0 +1,137 @@
+/** Types for: https://discord.com/developers/docs/resources/guild-scheduled-event */
+
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-structure */
+export interface DiscordScheduledEvent {
+  /** the id of the scheduled event */
+  id: string
+  /** the guild id which the scheduled event belongs to */
+  guild_id: string
+  /** the channel id in which the scheduled event will be hosted if specified */
+  channel_id: string | null
+  /** the id of the user that created the scheduled event */
+  creator_id?: string | null
+  /** the name of the scheduled event */
+  name: string
+  /** the description of the scheduled event */
+  description?: string
+  /** the time the scheduled event will start */
+  scheduled_start_time: string
+  /** the time the scheduled event will end if it does end. */
+  scheduled_end_time: string | null
+  /** the privacy level of the scheduled event */
+  privacy_level: ScheduledEventPrivacyLevel
+  /** the status of the scheduled event */
+  status: ScheduledEventStatus
+  /** the type of hosting entity associated with a scheduled event */
+  entity_type: ScheduledEventEntityType
+  /** any additional id of the hosting entity associated with event */
+  entity_id: string | null
+  /** the entity metadata for the scheduled event */
+  entity_metadata: DiscordScheduledEventEntityMetadata | null
+  /** the user that created the scheduled event */
+  creator?: DiscordUser
+  /** the number of users subscribed to the scheduled event */
+  user_count?: number
+  /** the cover image hash of the scheduled event */
+  image?: string | null
+  /** the definition for how often this event should recur */
+  recurrence_rule: DiscordScheduledEventRecurrenceRule | null
+}
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-privacy-level */
+export enum ScheduledEventPrivacyLevel {
+  /** the scheduled event is only accessible to guild members */
+  GuildOnly = 2,
+}
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-entity-types */
+export enum ScheduledEventEntityType {
+  StageInstance = 1,
+  Voice,
+  External,
+}
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-status */
+export enum ScheduledEventStatus {
+  Scheduled = 1,
+  Active,
+  Completed,
+  Canceled,
+}
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-object-guild-scheduled-event-entity-metadata */
+export interface DiscordScheduledEventEntityMetadata {
+  /** location of the event */
+  location?: string
+}
+
+// TODO: missing ScheduledEventUser: https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-user-object-guild-scheduled-event-user-structure
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-recurrence-rule-object-guild-scheduled-event-recurrence-rule-structure */
+export interface DiscordScheduledEventRecurrenceRule {
+  /** Starting time of the recurrence interval */
+  start: string
+  /** Ending time of the recurrence interval */
+  end: string | null
+  /** How often the event occurs */
+  frequency: DiscordScheduledEventRecurrenceRuleFrequency
+  /** The spacing between the events, defined by `frequency`. For example, `frequency` of `Weekly` and an `interval` of `2` would be "every-other week" */
+  interval: number
+  /** Set of specific days within a week for the event to recur on */
+  by_weekday: DiscordScheduledEventRecurrenceRuleWeekday[] | null
+  /** List of specific days within a specific week (1-5) to recur on */
+  by_n_weekday: DiscordScheduledEventRecurrenceRuleNWeekday[] | null
+  /** Set of specific months to recur on */
+  by_month: DiscordScheduledEventRecurrenceRuleMonth[] | null
+  /** Set of specific dates within a month to recur on */
+  by_month_day: number[] | null
+  /** Set of days within a year to recur on (1-364) */
+  by_year_day: number[] | null
+  /** The total amount of times that the event is allowed to recur before stopping */
+  count: number | null
+}
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-recurrence-rule-object-guild-scheduled-event-recurrence-rule-frequency */
+export enum DiscordScheduledEventRecurrenceRuleFrequency {
+  Yearly,
+  Monthly,
+  Weekly,
+  Daily,
+}
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-recurrence-rule-object-guild-scheduled-event-recurrence-rule-weekday */
+export enum DiscordScheduledEventRecurrenceRuleWeekday {
+  Monday,
+  Tuesday,
+  Wednesday,
+  Thursday,
+  Friday,
+  Saturday,
+  Sunday,
+}
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-recurrence-rule-object-guild-scheduled-event-recurrence-rule-nweekday-structure */
+export interface DiscordScheduledEventRecurrenceRuleNWeekday {
+  /** The week to reoccur on. 1 - 5 */
+  n: number
+  /** The day within the week to reoccur on */
+  day: DiscordScheduledEventRecurrenceRuleWeekday
+}
+
+/** https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event-recurrence-rule-object-guild-scheduled-event-recurrence-rule-month */
+export enum DiscordScheduledEventRecurrenceRuleMonth {
+  January = 1,
+  February,
+  March,
+  April,
+  May,
+  June,
+  July,
+  August,
+  September,
+  October,
+  November,
+  December,
+}

packages/types/src/discord/guildTemplate.ts

@@ -0,0 +1,82 @@
+/** Types for: https://discord.com/developers/docs/resources/guild-template */
+
+import type { PickPartial } from '../shared.js'
+import type { DiscordChannel, DiscordOverwrite } from './channel.js'
+import type { DiscordGuild } from './guild.js'
+import type { DiscordRole } from './permissions.js'
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/guild-template#guild-template-object-guild-template-structure */
+export interface DiscordTemplate {
+  /** The template code (unique Id) */
+  code: string
+  /** Template name */
+  name: string
+  /** The description for the template */
+  description: string | null
+  /** Number of times this template has been used */
+  usage_count: number
+  /** The Id of the user who created the template */
+  creator_id: string
+  /** The user who created the template */
+  creator: DiscordUser
+  /** When this template was created */
+  created_at: string
+  /** When this template was last synced to the source guild */
+  updated_at: string
+  /** The Id of the guild this template is based on */
+  source_guild_id: string
+  /** The guild snapshot this template contains */
+  serialized_source_guild: DiscordTemplateSerializedSourceGuild
+  is_dirty: boolean | null
+}
+
+/** https://discord.com/developers/docs/resources/guild-template#guild-template-object-guild-template-structure specificly the serialized_source_guild property */
+export type DiscordTemplateSerializedSourceGuild = Omit<
+  PickPartial<
+    DiscordGuild,
+    | 'name'
+    | 'description'
+    | 'verification_level'
+    | 'default_message_notifications'
+    | 'explicit_content_filter'
+    | 'preferred_locale'
+    | 'afk_timeout'
+    | 'system_channel_flags'
+  >,
+  'roles' | 'channels' | 'afk_channel_id' | 'system_channel_id'
+> & {
+  afk_channel_id: number | null
+  system_channel_id: number | null
+  roles: Array<
+    Omit<PickPartial<DiscordRole, 'name' | 'color' | 'hoist' | 'mentionable' | 'permissions' | 'icon' | 'unicode_emoji'>, 'id'> & {
+      id: number
+    }
+  >
+  channels: Array<
+    Omit<
+      PickPartial<
+        DiscordChannel,
+        | 'name'
+        | 'type'
+        | 'position'
+        | 'topic'
+        | 'bitrate'
+        | 'user_limit'
+        | 'nsfw'
+        | 'rate_limit_per_user'
+        | 'default_auto_archive_duration'
+        | 'available_tags'
+        | 'default_reaction_emoji'
+        | 'default_thread_rate_limit_per_user'
+        | 'default_sort_order'
+        | 'default_forum_layout'
+      >,
+      'id' | 'permission_overwrites' | 'parent_id'
+    > & {
+      id: number
+      permission_overwrites: DiscordOverwrite & { id: number }
+      parent_id: number | null
+    }
+  >
+}

packages/types/src/discord/interactions.ts

@@ -0,0 +1,672 @@
+/**
+ * Types for:
+ * - https://discord.com/developers/docs/interactions/receiving-and-responding
+ * - https://discord.com/developers/docs/interactions/application-commands
+ * - https://discord.com/developers/docs/interactions/message-components
+ */
+
+import type { DiscordApplicationIntegrationType } from './application.js'
+import type { ChannelTypes, DiscordChannel } from './channel.js'
+import type { DiscordEntitlement } from './entitlement.js'
+import type { DiscordGuild, DiscordMember, DiscordMemberWithUser } from './guild.js'
+import type { DiscordAttachment, DiscordMessage } from './message.js'
+import type { DiscordRole } from './permissions.js'
+import type { Localization } from './reference.js'
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-structure */
+export interface DiscordInteraction {
+  /** Id of the interaction */
+  id: string
+  /** Id of the application this interaction is for */
+  application_id: string
+  /** The type of interaction */
+  type: InteractionTypes
+  /** Guild that the interaction was sent from */
+  guild?: Partial<DiscordGuild>
+  /** The guild it was sent from */
+  guild_id?: string
+  /** The channel it was sent from */
+  channel: Partial<DiscordChannel>
+  /**
+   * The ID of channel it was sent from
+   *
+   * @remarks
+   * It is recommended that you begin using this channel field to identify the source channel of the interaction as they may deprecate the existing channel_id field in the future.
+   */
+  channel_id?: string
+  /** Guild member data for the invoking user, including permissions */
+  member?: DiscordInteractionMember
+  /** User object for the invoking user, if invoked in a DM */
+  user?: DiscordUser
+  /** A continuation token for responding to the interaction */
+  token: string
+  /** Read-only property, always `1` */
+  version: 1
+  /** For the message the button was attached to */
+  message?: DiscordMessage
+  /** the command data payload */
+  data?: DiscordInteractionData
+  /** The selected language of the invoking user */
+  locale?: string
+  /** The guild's preferred locale, if invoked in a guild */
+  guild_locale?: string
+  /** The computed permissions for a bot or app in the context of a specific interaction (including channel overwrites) */
+  app_permissions: string
+  /** For monetized apps, any entitlements for the invoking user, representing access to premium SKUs */
+  entitlements: DiscordEntitlement[]
+  /** Mapping of installation contexts that the interaction was authorized for to related user or guild IDs. */
+  authorizing_integration_owners: DiscordAuthorizingIntegrationOwners
+  /** Context where the interaction was triggered from */
+  context?: DiscordInteractionContextType
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-type */
+export enum InteractionTypes {
+  Ping = 1,
+  ApplicationCommand = 2,
+  MessageComponent = 3,
+  ApplicationCommandAutocomplete = 4,
+  ModalSubmit = 5,
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-context-types */
+export enum DiscordInteractionContextType {
+  /** Interaction can be used within servers */
+  Guild = 0,
+  /** Interaction can be used within DMs with the app's bot user */
+  BotDm = 1,
+  /** Interaction can be used within Group DMs and DMs other than the app's bot user */
+  PrivateChannel = 2,
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-authorizing-integration-owners-object */
+export type DiscordAuthorizingIntegrationOwners = Partial<Record<DiscordApplicationIntegrationType, string>>
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-data */
+export interface DiscordInteractionData {
+  /** The type of component */
+  component_type?: MessageComponentTypes
+  /** The custom id provided for this component. */
+  custom_id?: string
+  /** The components if its a Modal Submit interaction. */
+  components?: DiscordMessageComponents
+  /** The values chosen by the user. */
+  values?: string[]
+  /** The Id of the invoked command */
+  id: string
+  /** The name of the invoked command */
+  name: string
+  /** the type of the invoked command */
+  type: ApplicationCommandTypes
+  /** Converted users + roles + channels + attachments */
+  resolved?: DiscordInteractionDataResolved
+  /** The params + values from the user */
+  options?: DiscordInteractionDataOption[]
+  /** The target id if this is a context menu command. */
+  target_id?: string
+  /** the id of the guild the command is registered to */
+  guild_id?: string
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-resolved-data-structure */
+export interface DiscordInteractionDataResolved {
+  /** The Ids and Message objects */
+  messages?: Record<string, DiscordMessage>
+  /** The Ids and User objects */
+  users?: Record<string, DiscordUser>
+  /** The Ids and partial Member objects */
+  members?: Record<string, Omit<DiscordInteractionMember, 'user' | 'deaf' | 'mute'>>
+  /** The Ids and Role objects */
+  roles?: Record<string, DiscordRole>
+  /** The Ids and partial Channel objects */
+  channels?: Record<string, Pick<DiscordChannel, 'id' | 'name' | 'type' | 'permissions'>>
+  /** The ids and attachment objects */
+  attachments: Record<string, DiscordAttachment>
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-application-command-interaction-data-option-structure */
+export interface DiscordInteractionDataOption {
+  /** Name of the parameter */
+  name: string
+  /** Value of application command option type */
+  type: ApplicationCommandOptionTypes
+  /** Value of the option resulting from user input */
+  value?: string | boolean | number
+  /** Present if this option is a group or subcommand */
+  options?: DiscordInteractionDataOption[]
+  /** `true` if this option is the currently focused option for autocomplete */
+  focused?: boolean
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#message-interaction-object-message-interaction-structure */
+export interface DiscordMessageInteraction {
+  /** Id of the interaction */
+  id: string
+  /** The type of interaction */
+  type: InteractionTypes
+  /** The name of the ApplicationCommand including the name of the subcommand/subcommand group */
+  name: string
+  /** The user who invoked the interaction */
+  user: DiscordUser
+  /** The member who invoked the interaction in the guild */
+  member?: Partial<DiscordMember>
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-response-object-interaction-callback-type */
+export enum InteractionResponseTypes {
+  /** ACK a `Ping` */
+  Pong = 1,
+  /** Respond to an interaction with a message */
+  ChannelMessageWithSource = 4,
+  /** ACK an interaction and edit a response later, the user sees a loading state */
+  DeferredChannelMessageWithSource = 5,
+  /** For components, ACK an interaction and edit the original message later; the user does not see a loading state */
+  DeferredUpdateMessage = 6,
+  /** For components, edit the message the component was attached to */
+  UpdateMessage = 7,
+  /** For Application Command Options, send an autocomplete result */
+  ApplicationCommandAutocompleteResult = 8,
+  /** For Command or Component interactions, send a Modal response */
+  Modal = 9,
+  /**
+   * Respond to an interaction with an upgrade button, only available for apps with monetization enabled
+   *
+   * @deprecated You should migrate to the premium button components
+   */
+  PremiumRequired = 10,
+  /**
+   * Launch the Activity associated with the app.
+   *
+   * @remarks
+   * Only available for apps with Activities enabled
+   */
+  LaunchActivity = 12,
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-response-object */
+export interface DiscordInteractionCallbackResponse {
+  /** The interaction object associated with the interaction response */
+  interaction: DiscordInteractionCallback
+  /** The resource that was created by the interaction response. */
+  resource?: DiscordInteractionResource
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-object */
+export interface DiscordInteractionCallback {
+  /** ID of the interaction */
+  id: string
+  /** Interaction type */
+  type: InteractionTypes
+  /** Instance ID of the Activity if one was launched or joined */
+  activity_instance_id?: string
+  /** ID of the message that was created by the interaction */
+  response_message_id?: string
+  /** Whether or not the message is in a loading state */
+  response_message_loading?: boolean
+  /** Whether or not the response message was ephemeral */
+  response_message_ephemeral?: boolean
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-resource-object */
+export interface DiscordInteractionResource {
+  type: InteractionResponseTypes
+  /**
+   * Represents the Activity launched by this interaction.
+   *
+   * @remarks
+   * Only present if type is `LAUNCH_ACTIVITY`.
+   */
+  activity_instance?: DiscordActivityInstanceResource
+  /**
+   * Message created by the interaction.
+   *
+   * @remarks
+   * Only present if type is either `CHANNEL_MESSAGE_WITH_SOURCE` or `UPDATE_MESSAGE`.
+   */
+  message?: DiscordMessage
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-callback-interaction-callback-activity-instance-resource */
+export interface DiscordActivityInstanceResource {
+  /** Instance ID of the Activity if one was launched or joined. */
+  id: string
+}
+
+/** https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-structure */
+export interface DiscordApplicationCommand extends DiscordCreateApplicationCommand {
+  /** Unique ID of command */
+  id: string
+  /** ID of the parent application */
+  application_id: string
+  /** Guild id of the command, if not global */
+  guild_id?: string
+}
+
+/** https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-types */
+export enum ApplicationCommandTypes {
+  /** A text-based command that shows up when a user types `/` */
+  ChatInput = 1,
+  /** A UI-based command that shows up when you right click or tap on a user */
+  User,
+  /** A UI-based command that shows up when you right click or tap on a message */
+  Message,
+  /** A UI-based command that represents the primary way to invoke an app's Activity */
+  PrimaryEntryPoint,
+}
+
+/** https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure */
+export interface DiscordApplicationCommandOption {
+  /** Type of option */
+  type: ApplicationCommandOptionTypes
+  /**
+   * Name of command, 1-32 characters.
+   *
+   * @remarks
+   * This value should be unique within an array of {@link DiscordApplicationCommandOption}
+   *
+   * {@link ApplicationCommandTypes.ChatInput | ChatInput} command names must match the following regex `^[-_\p{L}\p{N}\p{sc=Deva}\p{sc=Thai}]{1,32}$` with the unicode flag set.
+   * If there is a lowercase variant of any letters used, you must use those.
+   * Characters with no lowercase variants and/or uncased letters are still allowed.
+   *
+   * {@link ApplicationCommandTypes.User | User} and {@link ApplicationCommandTypes.Message | Message} commands may be mixed case and can include spaces.
+   */
+  name: string
+  /** Localization object for the `name` field. Values follow the same restrictions as `name` */
+  name_localizations?: Localization | null
+  /** 1-100 character description */
+  description: string
+  /** Localization object for the `description` field. Values follow the same restrictions as `description` */
+  description_localizations?: Localization | null
+  /**
+   * If the parameter is required or optional. default `false`
+   *
+   * @remarks
+   * Valid in all option types except {@link ApplicationCommandOptionTypes.SubCommand | SubCommand} and {@link ApplicationCommandOptionTypes.SubCommandGroup | SubCommandGroup}
+   */
+  required?: boolean
+  /**
+   * Choices for the option from which the user can choose, max 25
+   *
+   * @remarks
+   * Only valid in options of type {@link ApplicationCommandOptionTypes.String | String}, {@link ApplicationCommandOptionTypes.Integer | Integer}, or {@link ApplicationCommandOptionTypes.Number | Number}
+   *
+   * If you provide an array of choices, they will be the ONLY accepted values for this option
+   */
+  choices?: DiscordApplicationCommandOptionChoice[]
+  /**
+   * If the option is a subcommand or subcommand group type, these nested options will be the parameters
+   *
+   * @remarks
+   * Only valid in option of type {@link ApplicationCommandOptionTypes.SubCommand | SubCommand} or {@link ApplicationCommandOptionTypes.SubCommandGroup | SubCommandGroup}
+   */
+  options?: DiscordApplicationCommandOption[]
+  /**
+   * If autocomplete interactions are enabled for this option.
+   *
+   * @remarks
+   * Only valid in options of type {@link ApplicationCommandOptionTypes.String | String}, {@link ApplicationCommandOptionTypes.Integer | Integer}, or {@link ApplicationCommandOptionTypes.Number | Number}
+   *
+   * When {@link DiscordApplicationCommandOption.choices | choices} are provided, this may not be set to true
+   */
+  autocomplete?: boolean
+  /**
+   * The channels shown will be restricted to these types
+   *
+   * @remarks
+   * Only valid in option of type {@link ApplicationCommandOptionTypes.Channel | Channel}
+   */
+  channel_types?: ChannelTypes[]
+  /**
+   * The minimum permitted value
+   *
+   * @remarks
+   * Only valid in options of type {@link ApplicationCommandOptionTypes.Integer | Integer} or {@link ApplicationCommandOptionTypes.Number | Number}
+   */
+  min_value?: number
+  /**
+   * The maximum permitted value
+   *
+   * @remarks
+   * Only valid in options of type {@link ApplicationCommandOptionTypes.Integer | Integer} or {@link ApplicationCommandOptionTypes.Number | Number}
+   */
+  max_value?: number
+  /**
+   * The minimum permitted length, should be in the range of from 0 to 600
+   *
+   * @remarks
+   * Only valid in options of type {@link ApplicationCommandOptionTypes.String | String}
+   */
+  min_length?: number
+  /**
+   * The maximum permitted length, should be in the range of from 0 to 600
+   *
+   * @remarks
+   * Only valid in options of type {@link ApplicationCommandOptionTypes.String | String}
+   */
+  max_length?: number
+}
+
+/** https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-type */
+export enum ApplicationCommandOptionTypes {
+  SubCommand = 1,
+  SubCommandGroup,
+  String,
+  Integer,
+  Boolean,
+  User,
+  Channel,
+  Role,
+  Mentionable,
+  Number,
+  Attachment,
+}
+
+/** https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-choice-structure */
+export interface DiscordApplicationCommandOptionChoice {
+  /** 1-100 character choice name */
+  name: string
+  /** Localization object for the `name` field. Values follow the same restrictions as `name` */
+  name_localizations?: Localization | null
+  /** Value for the choice, up to 100 characters if string */
+  value: string | number
+}
+
+/** https://discord.com/developers/docs/interactions/application-commands#application-command-object-entry-point-command-handler-types */
+export enum DiscordInteractionEntryPointCommandHandlerType {
+  /** The app handles the interaction using an interaction token */
+  AppHandler = 1,
+  /** Discord handles the interaction by launching an Activity and sending a follow-up message without coordinating with the app */
+  DiscordLaunchActivity = 2,
+}
+
+/** https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-guild-application-command-permissions-structure */
+export interface DiscordGuildApplicationCommandPermissions {
+  /** ID of the command or the application ID. When the `id` field is the application ID instead of a command ID, the permissions apply to all commands that do not contain explicit overwrites. */
+  id: string
+  /** ID of the application the command belongs to */
+  application_id: string
+  /** ID of the guild */
+  guild_id: string
+  /** Permissions for the command in the guild, max of 100 */
+  permissions: DiscordApplicationCommandPermissions[]
+}
+
+/** https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permissions-structure */
+export interface DiscordApplicationCommandPermissions {
+  /** ID of the role, user, or channel. It can also be a permission constant */
+  id: string
+  /** ApplicationCommandPermissionTypes.Role, ApplicationCommandPermissionTypes.User, or ApplicationCommandPermissionTypes.Channel */
+  type: ApplicationCommandPermissionTypes
+  /** `true` to allow, `false`, to disallow */
+  permission: boolean
+}
+
+/** https://discord.com/developers/docs/interactions/application-commands#application-command-permissions-object-application-command-permission-type */
+export enum ApplicationCommandPermissionTypes {
+  Role = 1,
+  User,
+  Channel,
+}
+
+/** https://discord.com/developers/docs/interactions/message-components#component-object-component-types */
+export enum MessageComponentTypes {
+  /** A container for other components */
+  ActionRow = 1,
+  /** A button object */
+  Button,
+  /** A select menu for picking from choices */
+  SelectMenu,
+  /** A text input object */
+  InputText,
+  /** Select menu for users */
+  SelectMenuUsers,
+  /** Select menu for roles */
+  SelectMenuRoles,
+  /** Select menu for users and roles */
+  SelectMenuUsersAndRoles,
+  /** Select menu for channels */
+  SelectMenuChannels,
+}
+
+export type DiscordMessageComponents = DiscordMessageComponent[]
+export type DiscordMessageComponent = DiscordActionRow | DiscordSelectMenuComponent | DiscordButtonComponent | DiscordInputTextComponent
+
+/** https://discord.com/developers/docs/interactions/message-components#actionrow */
+export interface DiscordActionRow {
+  /** Action rows are a group of buttons. */
+  type: MessageComponentTypes.ActionRow
+  /** The components in this row */
+  components: Exclude<DiscordMessageComponent, DiscordActionRow>[]
+}
+
+/** https://discord.com/developers/docs/interactions/message-components#button-object-button-structure */
+export interface DiscordButtonComponent {
+  /** All button components have type 2 */
+  type: MessageComponentTypes.Button
+  /**
+   * Text that appears on the button
+   *
+   * @remarks
+   * A label can have a max of 80 characters
+   * A button of style {@link ButtonStyles.Premium | Premium} cannot have a label
+   */
+  label?: string
+  /**
+   * A dev-defined unique string sent on click (max 100 characters).
+   *
+   * @remarks
+   * A button of style {@link ButtonStyles.Link | Link} or {@link ButtonStyles.Premium | Premium} cannot have a custom_id
+   */
+  custom_id?: string
+  /** For different styles/colors of the buttons */
+  style: ButtonStyles
+  /**
+   * Emoji object that includes fields of name, id, and animated supporting unicode and custom emojis.
+   *
+   * @remarks
+   * A button of style {@link ButtonStyles.Premium | Premium} cannot have an emoji
+   */
+  emoji?: {
+    /** Emoji id */
+    id?: string
+    /** Emoji name */
+    name?: string
+    /** Whether this emoji is animated */
+    animated?: boolean
+  }
+  /**
+   * Url for {@link ButtonStyles.Link | link} buttons that can navigate a user to the web.
+   *
+   * @remarks
+   * Buttons of style {@link ButtonStyles.Link | Link} must have an url, any other button with a different style can not have an url
+   */
+  url?: string
+  /** Whether or not this button is disabled */
+  disabled?: boolean
+  /**
+   * Identifier for a purchasable SKU
+   *
+   * @remarks
+   * Buttons of style {@link ButtonStyles.Premium | Premium} must have a sku_id, any other button with a different style can not have a a sku_id
+   */
+  sku_id?: string
+}
+
+/** https://discord.com/developers/docs/interactions/message-components#button-object-button-styles */
+export enum ButtonStyles {
+  /** A blurple button */
+  Primary = 1,
+  /** A grey button */
+  Secondary,
+  /** A green button */
+  Success,
+  /** A red button */
+  Danger,
+  /** A button that navigates to a URL */
+  Link,
+  /** A blurple button to show a Premium item in the shop */
+  Premium,
+}
+
+/** https://discord.com/developers/docs/interactions/message-components#select-menu-object-select-menu-structure */
+export interface DiscordSelectMenuComponent {
+  type:
+    | MessageComponentTypes.SelectMenu
+    | MessageComponentTypes.SelectMenuChannels
+    | MessageComponentTypes.SelectMenuRoles
+    | MessageComponentTypes.SelectMenuUsers
+    | MessageComponentTypes.SelectMenuUsersAndRoles
+  /** A custom identifier for this component. Maximum 100 characters. */
+  custom_id: string
+  /** A custom placeholder text if nothing is selected. Maximum 150 characters. */
+  placeholder?: string
+  /** The minimum number of items that must be selected. Default 1. Between 1-25. */
+  min_values?: number
+  /** The maximum number of items that can be selected. Default 1. Between 1-25. */
+  max_values?: number
+  /**
+   * List of default values for auto-populated select menu components
+   *
+   * @remarks
+   * The number of default values must be in the range defined by min_values and max_values
+   */
+  default_values?: DiscordSelectMenuDefaultValue[]
+  /** List of channel types to include in a channel select menu options list */
+  channel_types?: ChannelTypes[]
+  /** The choices! Maximum of 25 items. */
+  options?: DiscordSelectOption[]
+  /**
+   * Whether select menu is disabled
+   *
+   * @default false
+   */
+  disabled?: boolean
+}
+
+/** https://discord.com/developers/docs/interactions/message-components#select-menu-object-select-option-structure */
+export interface DiscordSelectOption {
+  /** The user-facing name of the option. Maximum 25 characters. */
+  label: string
+  /** The dev-defined value of the option. Maximum 100 characters. */
+  value: string
+  /** An additional description of the option. Maximum 50 characters. */
+  description?: string
+  /** The id, name, and animated properties of an emoji. */
+  emoji?: {
+    /** Emoji id */
+    id?: string
+    /** Emoji name */
+    name?: string
+    /** Whether this emoji is animated */
+    animated?: boolean
+  }
+  /** Will render this option as already-selected by default. */
+  default?: boolean
+}
+
+/** https://discord.com/developers/docs/interactions/message-components#select-menu-object-select-default-value-structure */
+export interface DiscordSelectMenuDefaultValue {
+  /** ID of a user, role, or channel */
+  id: string
+  /** Type of value that id represents. */
+  type: 'user' | 'role' | 'channel'
+}
+
+/** https://discord.com/developers/docs/interactions/message-components#text-input-object-text-input-structure */
+export interface DiscordInputTextComponent {
+  /** InputText Component is of type 3 */
+  type: MessageComponentTypes.InputText
+  /** The style of the InputText */
+  style: TextStyles
+  /** whether this component is required to be filled, default true */
+  required?: boolean
+  /** The customId of the InputText */
+  custom_id: string
+  /** The label of the InputText (max 45 characters) */
+  label: string
+  /** The placeholder of the InputText */
+  placeholder?: string
+  /** The minimum length of the text the user has to provide */
+  min_length?: number
+  /** The maximum length of the text the user has to provide */
+  max_length?: number
+  /** Pre-filled value for input text. */
+  value?: string
+}
+
+/** https://discord.com/developers/docs/interactions/message-components#text-input-object-text-input-styles */
+export enum TextStyles {
+  /** Intended for short single-line text */
+  Short = 1,
+  /** Intended for much longer inputs */
+  Paragraph = 2,
+}
+
+/** https://discord.com/developers/docs/interactions/receiving-and-responding#interaction-object-interaction-structure specifcly the member propriety */
+export interface DiscordInteractionMember extends DiscordMemberWithUser {
+  /** Total permissions of the member in the channel, including overwrites, returned when in the interaction object */
+  permissions: string
+}
+
+// TODO: This type does not match any structure discord defines it is however a subset of the props in
+// https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-structure
+// that is used by DiscordApplicationCommand.
+// We should provably remove this type and merge it with DiscordApplicationCommand and re-define it as
+// https://discord.com/developers/docs/interactions/application-commands#create-global-application-command-json-params
+// as that would match the name
+export interface DiscordCreateApplicationCommand {
+  /** Type of command, defaults to `ApplicationCommandTypes.ChatInput` */
+  type?: ApplicationCommandTypes
+  /**
+   * Name of command, 1-32 characters.
+   * `ApplicationCommandTypes.ChatInput` command names must match the following regex `^[-_\p{L}\p{N}\p{sc=Deva}\p{sc=Thai}]{1,32}$` with the unicode flag set.
+   * If there is a lowercase variant of any letters used, you must use those.
+   * Characters with no lowercase variants and/or uncased letters are still allowed.
+   * ApplicationCommandTypes.User` and `ApplicationCommandTypes.Message` commands may be mixed case and can include spaces.
+   */
+  name: string
+  /** Localization object for `name` field. Values follow the same restrictions as `name` */
+  name_localizations?: Localization | null
+  /** Description for `ApplicationCommandTypes.ChatInput` commands, 1-100 characters. */
+  description?: string
+  /** Localization object for `description` field. Values follow the same restrictions as `description` */
+  description_localizations?: Localization | null
+  /** Parameters for the command, max of 25 */
+  options?: DiscordApplicationCommandOption[]
+  /** Set of permissions represented as a bit set */
+  default_member_permissions?: string | null
+  /**
+   * Installation contexts where the command is available
+   *
+   * @remarks
+   * This value is available only for globally-scoped commands
+   * Defaults to the application configured contexts
+   */
+  integration_types?: DiscordApplicationIntegrationType[]
+  /**
+   * Interaction context(s) where the command can be used
+   *
+   * @remarks
+   * This value is available only for globally-scoped commands
+   * By default, all interaction context types included for new commands.
+   */
+  contexts?: DiscordInteractionContextType[] | null
+  /**
+   * Indicates whether the command is available in DMs with the app, only for globally-scoped commands. By default, commands are visible.
+   *
+   * @deprecated use {@link contexts} instead
+   */
+  dm_permission?: boolean
+  /** Indicates whether the command is age-restricted, defaults to false */
+  nsfw?: boolean
+  /** Auto incrementing version identifier updated during substantial record changes */
+  version?: string
+  /**
+   * Determines whether the interaction is handled by the app's interactions handler or by Discord
+   *
+   * @remarks
+   * This can only be set for application commands of type `PRIMARY_ENTRY_POINT` for applications with the `EMBEDDED` flag (i.e. applications that have an Activity).
+   */
+  handler?: DiscordInteractionEntryPointCommandHandlerType
+}

packages/types/src/discord/invite.ts

@@ -0,0 +1,79 @@
+/** Types for: https://discord.com/developers/docs/resources/invite */
+
+import type { DiscordApplication } from './application.js'
+import type { DiscordChannel } from './channel.js'
+import type { DiscordGuild, DiscordMember } from './guild.js'
+import type { DiscordScheduledEvent } from './guildScheduledEvent.js'
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/invite#invite-object-invite-structure */
+export interface DiscordInvite {
+  /** The type of invite */
+  type: DiscordInviteType
+  /** The invite code (unique Id) */
+  code: string
+  /** The guild this invite is for */
+  guild?: Partial<DiscordGuild>
+  /** The channel this invite is for */
+  channel: Partial<DiscordChannel> | null
+  /** The user who created the invite */
+  inviter?: DiscordUser
+  /** The type of target for this voice channel invite */
+  target_type?: TargetTypes
+  /** The target user for this invite */
+  target_user?: DiscordUser
+  /** The embedded application to open for this voice channel embedded application invite */
+  target_application?: Partial<DiscordApplication>
+  /** Approximate count of online members (only present when target_user is set) */
+  approximate_presence_count?: number
+  /** Approximate count of total members */
+  approximate_member_count?: number
+  /** The expiration date of this invite, returned from the `GET /invites/<code>` endpoint when `with_expiration` is `true` */
+  expires_at?: string | null
+  /** Stage instance data if there is a public Stage instance in the Stage channel this invite is for */
+  stage_instance?: DiscordInviteStageInstance
+  /** guild scheduled event data */
+  guild_scheduled_event?: DiscordScheduledEvent
+}
+
+/** https://discord.com/developers/docs/resources/invite#invite-object-invite-types */
+export enum DiscordInviteType {
+  Guild,
+  GroupDm,
+  Friend,
+}
+
+/** https://discord.com/developers/docs/resources/invite#invite-object-invite-target-types */
+export enum TargetTypes {
+  Stream = 1,
+  EmbeddedApplication,
+}
+
+/** https://discord.com/developers/docs/resources/invite#invite-metadata-object-invite-metadata-structure */
+export interface DiscordInviteMetadata extends DiscordInvite {
+  /** Number of times this invite has been used */
+  uses: number
+  /** Max number of times this invite can be used */
+  max_uses: number
+  /** Duration (in seconds) after which the invite expires */
+  max_age: number
+  /** Whether this invite only grants temporary membership */
+  temporary: boolean
+  /** When this invite was created */
+  created_at: string
+}
+
+/**
+ * https://discord.com/developers/docs/resources/invite#invite-stage-instance-object-invite-stage-instance-structure
+ * @deprecated
+ */
+export interface DiscordInviteStageInstance {
+  /** The members speaking in the Stage */
+  members: Partial<DiscordMember>[]
+  /** The number of users in the Stage */
+  participant_count: number
+  /** The number of users speaking in the Stage */
+  speaker_count: number
+  /** The topic of the Stage instance (1-120 characters) */
+  topic: string
+}

packages/types/src/discord/message.ts

@@ -0,0 +1,561 @@
+/** Types for: https://discord.com/developers/docs/resources/message */
+
+import type { DiscordApplication } from './application.js'
+import type { DiscordChannel, DiscordThreadMember } from './channel.js'
+import type { DiscordEmoji } from './emoji.js'
+import type { DiscordMember } from './guild.js'
+import type { DiscordAuthorizingIntegrationOwners, DiscordMessageComponents, DiscordMessageInteraction, InteractionTypes } from './interactions.js'
+import type { DiscordPoll } from './poll.js'
+import type { DiscordSticker, DiscordStickerItem } from './sticker.js'
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/message#message-object-message-structure */
+export interface DiscordMessage {
+  /** id of the message */
+  id: string
+  /** id of the channel the message was sent in */
+  channel_id: string
+  /**
+   * id of the guild the message was sent in
+   * Note: For MESSAGE_CREATE and MESSAGE_UPDATE events, the message object may not contain a guild_id or member field since the events are sent directly to the receiving user and the bot who sent the message, rather than being sent through the guild like non-ephemeral messages.
+   */
+  guild_id?: string
+  /**
+   * The author of this message (not guaranteed to be a valid user)
+   * Note: The author object follows the structure of the user object, but is only a valid user in the case where the message is generated by a user or bot user. If the message is generated by a webhook, the author object corresponds to the webhook's id, username, and avatar. You can tell if a message is generated by a webhook by checking for the webhook_id on the message object.
+   */
+  author: DiscordUser
+  /**
+   * Member properties for this message's author
+   * Note: The member object exists in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events from text-based guild channels. This allows bots to obtain real-time member data without requiring bots to store member state in memory.
+   */
+  member?: DiscordMember
+  /** Contents of the message */
+  content?: string
+  /** When this message was sent */
+  timestamp: string
+  /** When this message was edited (or null if never) */
+  edited_timestamp: string | null
+  /** Whether this was a TTS message */
+  tts: boolean
+  /** Whether this message mentions everyone */
+  mention_everyone: boolean
+  /**
+   * Users specifically mentioned in the message
+   * Note: The user objects in the mentions array will only have the partial member field present in `MESSAGE_CREATE` and `MESSAGE_UPDATE` events from text-based guild channels.
+   */
+  mentions: Array<DiscordUser & { member?: Partial<DiscordMember> }>
+  /** Roles specifically mentioned in this message */
+  mention_roles?: string[]
+  /**
+   * Channels specifically mentioned in this message
+   * Note: Not all channel mentions in a message will appear in `mention_channels`. Only textual channels that are visible to everyone in a discoverable guild will ever be included. Only crossposted messages (via Channel Following) currently include `mention_channels` at all. If no mentions in the message meet these requirements, this field will not be sent.
+   */
+  mention_channels?: DiscordChannelMention[]
+  /** Any attached files */
+  attachments: DiscordAttachment[]
+  /** Any embedded content */
+  embeds: DiscordEmbed[]
+  /** Reactions to the message */
+  reactions?: DiscordReaction[]
+  /** Used for validating a message was sent */
+  nonce?: number | string
+  /** Whether this message is pinned */
+  pinned: boolean
+  /** If the message is generated by a webhook, this is the webhook's id */
+  webhook_id?: string
+  /** Type of message */
+  type: MessageTypes
+  /** Sent with Rich Presence-related chat embeds */
+  activity?: DiscordMessageActivity
+  /** Sent with Rich Presence-related chat embeds */
+  application?: Partial<DiscordApplication>
+  /** if the message is an Interaction or application-owned webhook, this is the id of the application */
+  application_id?: string
+  /** Data showing the source of a crosspost, channel follow add, pin, or reply message */
+  message_reference?: Omit<DiscordMessageReference, 'failIfNotExists'>
+  /** Message flags combined as a bitfield */
+  flags?: MessageFlags
+  /**
+   * The stickers sent with the message (bots currently can only receive messages with stickers, not send)
+   * @deprecated
+   */
+  stickers?: DiscordSticker[]
+  /**
+   * The message associated with the 'message_reference'
+   * Note: This field is only returned for messages with a 'type' of '19', '21', or '23'. If the message is one of these but the 'referenced_message' field is not present, the backend did not attempt to fetch the message that was being replied to, so its state is unknown. If the field exists but is null, the referenced message was deleted.
+   */
+  referenced_message?: DiscordMessage
+  /** The message associated with the `message_reference`. This is a minimal subset of fields in a message (e.g. `author` is excluded.)  */
+  message_snapshots?: DiscordMessageSnapshot[]
+  /** sent if the message is sent as a result of an interaction */
+  interaction_metadata?: DiscordMessageInteractionMetadata
+  /**
+   * Sent if the message is a response to an Interaction
+   *
+   * @deprecated Deprecated in favor of {@link interaction_metadata}
+   */
+  interaction?: DiscordMessageInteraction
+  /** The thread that was started from this message, includes thread member object */
+  thread?: Omit<DiscordChannel, 'member'> & { member: DiscordThreadMember }
+  /** The components related to this message */
+  components?: DiscordMessageComponents
+  /** Sent if the message contains stickers */
+  sticker_items?: DiscordStickerItem[]
+  /** A generally increasing integer (there may be gaps or duplicates) that represents the approximate position of the message in a thread, it can be used to estimate the relative position of the message in a thread in company with `total_message_sent` on parent thread */
+  position?: number
+  /** The poll object */
+  poll?: DiscordPoll
+  /** The call associated with the message */
+  call?: DiscordMessageCall
+}
+
+/** https://discord.com/developers/docs/resources/message#message-object-message-types */
+export enum MessageTypes {
+  Default,
+  RecipientAdd,
+  RecipientRemove,
+  Call,
+  ChannelNameChange,
+  ChannelIconChange,
+  ChannelPinnedMessage,
+  UserJoin,
+  GuildBoost,
+  GuildBoostTier1,
+  GuildBoostTier2,
+  GuildBoostTier3,
+  ChannelFollowAdd,
+  GuildDiscoveryDisqualified = 14,
+  GuildDiscoveryRequalified,
+  GuildDiscoveryGracePeriodInitialWarning,
+  GuildDiscoveryGracePeriodFinalWarning,
+  ThreadCreated,
+  Reply,
+  ChatInputCommand,
+  ThreadStarterMessage,
+  GuildInviteReminder,
+  ContextMenuCommand,
+  AutoModerationAction,
+  RoleSubscriptionPurchase,
+  InteractionPremiumUpsell,
+  StageStart,
+  StageEnd,
+  StageSpeaker,
+  StageTopic = 31,
+  GuildApplicationPremiumSubscription,
+  GuildIncidentAlertModeEnabled = 36,
+  GuildIncidentAlertModeDisabled,
+  GuildIncidentReportRaid,
+  GuildIncidentReportFalseAlarm,
+  PurchaseNotification = 44,
+  PollResult = 46,
+}
+
+/** https://discord.com/developers/docs/resources/message#message-object-message-activity-structure */
+export interface DiscordMessageActivity {
+  /** Type of message activity */
+  type: MessageActivityTypes
+  /** `party_id` from a Rich Presence event */
+  party_id?: string
+}
+
+/** https://discord.com/developers/docs/resources/message#message-object-message-activity-types */
+export enum MessageActivityTypes {
+  Join = 1,
+  Spectate = 2,
+  Listen = 3,
+  JoinRequest = 5,
+}
+
+/** https://discord.com/developers/docs/resources/message#message-object-message-flags */
+export enum MessageFlags {
+  /** This message has been published to subscribed channels (via Channel Following) */
+  Crossposted = 1 << 0,
+  /** This message originated from a message in another channel (via Channel Following) */
+  IsCrosspost = 1 << 1,
+  /** Do not include any embeds when serializing this message */
+  SuppressEmbeds = 1 << 2,
+  /** The source message for this crosspost has been deleted (via Channel Following) */
+  SourceMessageDeleted = 1 << 3,
+  /** This message came from the urgent message system */
+  Urgent = 1 << 4,
+  /** This message has an associated thread, with the same id as the message */
+  HasThread = 1 << 5,
+  /** This message is only visible to the user who invoked the Interaction */
+  Ephemeral = 1 << 6,
+  /** This message is an Interaction Response and the bot is "thinking" */
+  Loading = 1 << 7,
+  /** This message failed to mention some roles and add their members to the thread */
+  FailedToMentionSomeRolesInThread = 1 << 8,
+  /** This message will not trigger push and desktop notifications */
+  SuppressNotifications = 1 << 12,
+  /** This message is a voice message */
+  IsVoiceMessage = 1 << 13,
+}
+
+/** https://discord.com/developers/docs/resources/message#message-interaction-metadata-object */
+export type DiscordMessageInteractionMetadata =
+  | DiscordApplicationCommandInteractionMetadata
+  | DiscordMessageComponentInteractionMetadata
+  | DiscordModalSubmitInteractionMetadata
+
+/** https://discord.com/developers/docs/resources/message#message-interaction-metadata-object-application-command-interaction-metadata-structure */
+export interface DiscordApplicationCommandInteractionMetadata {
+  /** Id of the interaction */
+  id: string
+  /** The type of interaction */
+  type: InteractionTypes
+  /** User who triggered the interaction */
+  user: DiscordUser
+  /** IDs for installation context(s) related to an interaction */
+  authorizing_integration_owners: DiscordAuthorizingIntegrationOwners
+  /** ID of the original response message, present only on follow-up messages */
+  original_response_message_id?: string
+  /** The user the command was run on, present only on user command interactions */
+  target_user?: DiscordUser
+  /** The ID of the message the command was run on, present only on message command interactions. The original response message will also have message_reference and referenced_message pointing to this message. */
+  target_message_id?: string
+}
+
+/** https://discord.com/developers/docs/resources/message#message-interaction-metadata-object-message-component-interaction-metadata-structure */
+export interface DiscordMessageComponentInteractionMetadata {
+  id: string
+  /** The type of interaction */
+  type: InteractionTypes
+  /** User who triggered the interaction */
+  user: DiscordUser
+  /** IDs for installation context(s) related to an interaction */
+  authorizing_integration_owners: DiscordAuthorizingIntegrationOwners
+  /** ID of the original response message, present only on follow-up messages */
+  original_response_message_id?: string
+  /** ID of the message that contained interactive component, present only on messages created from component interactions */
+  interacted_message_id?: string
+}
+
+/** https://discord.com/developers/docs/resources/message#message-interaction-metadata-object-modal-submit-interaction-metadata-structure */
+export interface DiscordModalSubmitInteractionMetadata {
+  id: string
+  /** The type of interaction */
+  type: InteractionTypes
+  /** User who triggered the interaction */
+  user: DiscordUser
+  /** IDs for installation context(s) related to an interaction */
+  authorizing_integration_owners: DiscordAuthorizingIntegrationOwners
+  /** ID of the original response message, present only on follow-up messages */
+  original_response_message_id?: string
+  /** Metadata for the interaction that was used to open the modal, present only on modal submit interactions */
+  triggering_interaction_metadata?: DiscordMessageInteractionMetadata
+}
+
+/** https://discord.com/developers/docs/resources/message#message-call-object-message-call-object-structure */
+export interface DiscordMessageCall {
+  /** Array of user object ids that participated in the call */
+  participants: string[]
+  /** Time when call ended */
+  ended_timestamp: string
+}
+
+/** https://discord.com/developers/docs/resources/message#message-reference-structure */
+export interface DiscordMessageReference {
+  /** Type of reference */
+  type?: DiscordMessageReferenceType
+  /** id of the originating message */
+  message_id?: string
+  /**
+   * id of the originating message's channel
+   * Note: `channel_id` is optional when creating a reply, but will always be present when receiving an event/response that includes this data model.
+   */
+  channel_id?: string
+  /** id of the originating message's guild */
+  guild_id?: string
+  /** When sending, whether to error if the referenced message doesn't exist instead of sending as a normal (non-reply) message, default true */
+  fail_if_not_exists: boolean
+}
+
+/** https://discord.com/developers/docs/resources/message#message-reference-types */
+export enum DiscordMessageReferenceType {
+  /**
+   * A standard reference used by replies.
+   *
+   * @remarks
+   * When the type is set to this value, the field referenced_message on the message will be present
+   */
+  Default,
+  /**
+   * Reference used to point to a message at a point in time.
+   *
+   * @remarks
+   * When the type is set to this value, the field message_snapshot on the message will be present
+   *
+   * This value can only be used for basic messages;
+   * i.e. messages which do not have strong bindings to a non global entity.
+   * Thus we support only messages with `DEFAULT` or `REPLY` types, but disallowed if there are any polls, calls, or components.
+   */
+  Forward,
+}
+
+/** https://discord.com/developers/docs/resources/message#message-snapshot-structure */
+export interface DiscordMessageSnapshot {
+  /** Minimal subset of fields in the forwarded message */
+  message: Pick<
+    DiscordMessage,
+    | 'type'
+    | 'content'
+    | 'embeds'
+    | 'attachments'
+    | 'timestamp'
+    | 'edited_timestamp'
+    | 'flags'
+    | 'mentions'
+    | 'mention_roles'
+    | 'stickers'
+    | 'sticker_items'
+    | 'components'
+  >
+}
+
+/** https://discord.com/developers/docs/resources/message#reaction-object-reaction-structure */
+export interface DiscordReaction {
+  /** Total number of times this emoji has been used to react (including super reacts) */
+  count: number
+  /**	Reaction count details object */
+  count_details: DiscordReactionCountDetails
+  /** Whether the current user reacted using this emoji */
+  me: boolean
+  /**	Whether the current user super-reacted using this emoji */
+  me_burst: boolean
+  /** Emoji information */
+  emoji: Partial<DiscordEmoji>
+  /** HEX colors used for super reaction */
+  burst_colors: string[]
+}
+
+/** https://discord.com/developers/docs/resources/message#reaction-count-details-object-reaction-count-details-structure */
+export interface DiscordReactionCountDetails {
+  /** Count of super reactions */
+  burst: number
+  /**	Count of normal reactions */
+  normal: number
+}
+
+/** https://discord.com/developers/docs/resources/message#embed-object-embed-structure */
+export interface DiscordEmbed {
+  /** Title of embed */
+  title?: string
+  /** Type of embed (always "rich" for webhook embeds) */
+  type?: EmbedTypes
+  /** Description of embed */
+  description?: string
+  /** Url of embed */
+  url?: string
+  /** Color code of the embed */
+  color?: number
+  /** Timestamp of embed content */
+  timestamp?: string
+  /** Footer information */
+  footer?: DiscordEmbedFooter
+  /** Image information */
+  image?: DiscordEmbedImage
+  /** Thumbnail information */
+  thumbnail?: DiscordEmbedThumbnail
+  /** Video information */
+  video?: DiscordEmbedVideo
+  /** Provider information */
+  provider?: DiscordEmbedProvider
+  /** Author information */
+  author?: DiscordEmbedAuthor
+  /** Fields information */
+  fields?: DiscordEmbedField[]
+}
+
+/** https://discord.com/developers/docs/resources/message#embed-object-embed-types */
+export type EmbedTypes = 'rich' | 'image' | 'video' | 'gifv' | 'article' | 'link' | 'poll_result'
+
+/** https://discord.com/developers/docs/resources/message#embed-object-embed-thumbnail-structure */
+export interface DiscordEmbedThumbnail {
+  /** Source url of thumbnail (only supports http(s) and attachments) */
+  url: string
+  /** A proxied url of the thumbnail */
+  proxy_url?: string
+  /** Height of thumbnail */
+  height?: number
+  /** Width of thumbnail */
+  width?: number
+}
+
+/** https://discord.com/developers/docs/resources/message#embed-object-embed-video-structure */
+export interface DiscordEmbedVideo {
+  /** Source url of video */
+  url?: string
+  /** A proxied url of the video */
+  proxy_url?: string
+  /** Height of video */
+  height?: number
+  /** Width of video */
+  width?: number
+}
+
+/** https://discord.com/developers/docs/resources/message#embed-object-embed-image-structure */
+export interface DiscordEmbedImage {
+  /** Source url of image (only supports http(s) and attachments) */
+  url: string
+  /** A proxied url of the image */
+  proxy_url?: string
+  /** Height of image */
+  height?: number
+  /** Width of image */
+  width?: number
+}
+
+/** https://discord.com/developers/docs/resources/message#embed-object-embed-provider-structure */
+export interface DiscordEmbedProvider {
+  /** Name of provider */
+  name?: string
+  /** Url of provider */
+  url?: string
+}
+
+/** https://discord.com/developers/docs/resources/message#embed-object-embed-author-structure */
+export interface DiscordEmbedAuthor {
+  /** Name of author */
+  name: string
+  /** Url of author */
+  url?: string
+  /** Url of author icon (only supports http(s) and attachments) */
+  icon_url?: string
+  /** A proxied url of author icon */
+  proxy_icon_url?: string
+}
+
+/** https://discord.com/developers/docs/resources/message#embed-object-embed-footer-structure */
+export interface DiscordEmbedFooter {
+  /** Footer text */
+  text: string
+  /** Url of footer icon (only supports http(s) and attachments) */
+  icon_url?: string
+  /** A proxied url of footer icon */
+  proxy_icon_url?: string
+}
+
+/** https://discord.com/developers/docs/resources/message#embed-object-embed-field-structure */
+export interface DiscordEmbedField {
+  /** Name of the field */
+  name: string
+  /** Value of the field */
+  value: string
+  /** Whether or not this field should display inline */
+  inline?: boolean
+}
+
+/** https://discord.com/developers/docs/resources/message#attachment-object-attachment-structure */
+export interface DiscordAttachment {
+  /** Name of file attached */
+  filename: string
+  /** The title of the file */
+  title?: string
+  /** The attachment's [media type](https://en.wikipedia.org/wiki/Media_type) */
+  content_type?: string
+  /** Size of file in bytes */
+  size: number
+  /** Source url of file */
+  url: string
+  /** A proxied url of file */
+  proxy_url: string
+  /** Attachment id */
+  id: string
+  /** description for the file (max 1024 characters) */
+  description?: string
+  /** Height of file (if image) */
+  height?: number | null
+  /** Width of file (if image) */
+  width?: number | null
+  /** whether this attachment is ephemeral. Ephemeral attachments will automatically be removed after a set period of time. Ephemeral attachments on messages are guaranteed to be available as long as the message itself exists. */
+  ephemeral?: boolean
+  /** The duration of the audio file for a voice message */
+  duration_secs?: number
+  /** A base64 encoded bytearray representing a sampled waveform for a voice message */
+  waveform?: string
+  /** Attachment flags combined as a bitfield */
+  flags?: AttachmentFlags
+}
+
+/** https://discord.com/developers/docs/resources/message#attachment-object-attachment-flags */
+export enum AttachmentFlags {
+  None,
+  /** This attachment has been edited using the remix feature on mobile */
+  IsRemix = 1 << 2,
+}
+
+/** https://discord.com/developers/docs/resources/message#channel-mention-object-channel-mention-structure */
+export interface DiscordChannelMention {
+  /** id of the channel */
+  id: string
+  /** id of the guild containing the channel */
+  guild_id: string
+  /** The type of channel */
+  type: number
+  /** The name of the channel */
+  name: string
+}
+
+/** https://discord.com/developers/docs/resources/message#allowed-mentions-object-allowed-mention-types */
+export enum AllowedMentionsTypes {
+  /** Controls role mentions */
+  RoleMentions = 'roles',
+  /** Controls user mentions */
+  UserMentions = 'users',
+  /** Controls \@everyone and \@here mentions */
+  EveryoneMentions = 'everyone',
+}
+
+/** https://discord.com/developers/docs/resources/message#allowed-mentions-object-allowed-mentions-structure */
+export interface DiscordAllowedMentions {
+  /** An array of allowed mention types to parse from the content. */
+  parse?: AllowedMentionsTypes[]
+  /** For replies, whether to mention the author of the message being replied to (default false) */
+  replied_user?: boolean
+  /** Array of role_ids to mention (Max size of 100) */
+  roles?: string[]
+  /** Array of user_ids to mention (Max size of 100) */
+  users?: string[]
+}
+
+// TODO: Implement RoleSubscriptionData https://discord.com/developers/docs/resources/message#role-subscription-data-object-role-subscription-data-object-structure
+
+/** https://discord.com/developers/docs/resources/message#create-message-jsonform-params */
+export interface DiscordCreateMessage {
+  /** The message contents (up to 2000 characters) */
+  content?: string
+  /** Can be used to verify a message was sent (up to 25 characters). Value will appear in the Message Create event. */
+  nonce?: string | number
+  /** true if this is a TTS message */
+  tts?: boolean
+  /** Embedded `rich` content (up to 6000 characters) */
+  embeds?: DiscordEmbed[]
+  /** Allowed mentions for the message */
+  allowed_mentions?: DiscordAllowedMentions
+  /** Include to make your message a reply */
+  message_reference?: {
+    /** id of the originating message */
+    message_id?: string
+    /**
+     * id of the originating message's channel
+     * Note: `channel_id` is optional when creating a reply, but will always be present when receiving an event/response that includes this data model.
+     */
+    channel_id?: string
+    /** id of the originating message's guild */
+    guild_id?: string
+    /** When sending, whether to error if the referenced message doesn't exist instead of sending as a normal (non-reply) message, default true */
+    fail_if_not_exists: boolean
+  }
+  /** The components you would like to have sent in this message */
+  components?: DiscordMessageComponents
+  /** IDs of up to 3 stickers in the server to send in the message */
+  stickerIds?: [string] | [string, string] | [string, string, string]
+}
+
+/** https://discord.com/developers/docs/resources/message#get-reactions-reaction-types */
+export enum DiscordReactionType {
+  Normal,
+  Burst,
+}

packages/types/src/discord/oauth2.ts

@@ -0,0 +1,206 @@
+/** Types for: https://discord.com/developers/docs/topics/oauth2 */
+
+import type { DiscordApplication } from './application.js'
+import type { DiscordGuild } from './guild.js'
+import type { DiscordUser } from './user.js'
+import type { DiscordIncomingWebhook } from './webhook.js'
+
+/** https://discord.com/developers/docs/topics/oauth2#shared-resources-oauth2-scopes */
+export enum OAuth2Scope {
+  /**
+   * Allows your app to fetch data from a user's "Now Playing/Recently Played" list
+   *
+   * @remarks
+   * This scope is not currently available for apps
+   */
+  ActivitiesRead = 'activities.read',
+  /**
+   * Allows your app to update a user's activity
+   *
+   * @remarks
+   * This scope not currently available for apps.
+   */
+  ActivitiesWrite = 'activities.write',
+  /** Allows your app to read build data for a user's applications */
+  ApplicationsBuildsRead = 'applications.builds.read',
+  /**
+   * Allows your app to upload/update builds for a user's applications
+   *
+   * @remarks
+   * This scope requires Discord approval to be used
+   */
+  ApplicationsBuildsUpload = 'applications.builds.upload',
+  /** Allows your app to add commands to a guild - included by default with the `bot` scope */
+  ApplicationsCommands = 'applications.commands',
+  /**
+   * Allows your app to update its Application Commands via this bearer token
+   *
+   * @remarks
+   * This scope can only be used when using a [Client Credential Grant](https://discord.com/developers/docs/topics/oauth2#client-credentials-grant)
+   */
+  ApplicationsCommandsUpdate = 'applications.commands.update',
+  /** Allows your app to update permissions for its commands in a guild a user has permissions to */
+  ApplicationCommandsPermissionsUpdate = 'applications.commands.permissions.update',
+  /** Allows your app to read entitlements for a user's applications */
+  ApplicationsEntitlements = 'applications.entitlements',
+  /** Allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications */
+  ApplicationsStoreUpdate = 'applications.store.update',
+  /** For oauth2 bots, this puts the bot in the user's selected guild by default */
+  Bot = 'bot',
+  /** Allows requests to [/users/@me/connections](https://discord.com/developers/docs/resources/user#get-user-connections) */
+  Connections = 'connections',
+  /**
+   * Allows your app to see information about the user's DMs and group DMs
+   *
+   * @remarks
+   * This scope requires Discord approval to be used
+   */
+  DMChannelsRead = 'dm_channels.read',
+  /** Adds the `email` filed to [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user) */
+  Email = 'email',
+  /** Allows your app to join users to a group dm */
+  GroupDMJoins = 'gdm.join',
+  /** Allows requests to [/users/@me/guilds](https://discord.com/developers/docs/resources/user#get-current-user-guilds) */
+  Guilds = 'guilds',
+  /** Allows requests to [/guilds/{guild.id}/members/{user.id}](https://discord.com/developers/docs/resources/guild#add-guild-member) */
+  GuildsJoin = 'guilds.join',
+  /** Allows requests to [/users/@me/guilds/{guild.id}/member](https://discord.com/developers/docs/resources/user#get-current-user-guild-member) */
+  GuildsMembersRead = 'guilds.members.read',
+  /**
+   * Allows requests to [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user)
+   *
+   * @remarks
+   * The return object from [/users/@me](https://discord.com/developers/docs/resources/user#get-current-user)
+   * does NOT contain the `email` field unless the scope `email` is also used
+   */
+  Identify = 'identify',
+  /**
+   * For local rpc server api access, this allows you to read messages from all client channels
+   * (otherwise restricted to channels/guilds your app creates)
+   */
+  MessagesRead = 'messages.read',
+  /**
+   * Allows your app to know a user's friends and implicit relationships
+   *
+   * @remarks
+   * This scope requires Discord approval to be used
+   */
+  RelationshipsRead = 'relationships.read',
+  /** Allows your app to update a user's connection and metadata for the app */
+  RoleConnectionsWrite = 'role_connections.write',
+  /**
+   * For local rpc server access, this allows you to control a user's local Discord client
+   *
+   * @remarks
+   * This scope requires Discord approval to be used
+   */
+  RPC = 'rpc',
+  /**
+   * For local rpc server access, this allows you to update a user's activity
+   *
+   * @remarks
+   * This scope requires Discord approval to be used
+   */
+  RPCActivitiesWrite = 'rpc.activities.write',
+  /**
+   * For local rpc server api access, this allows you to receive notifications pushed out to the user
+   *
+   * @remarks
+   * This scope requires Discord approval to be used
+   */
+  RPCNotificationsRead = 'rpc.notifications.read',
+  /**
+   * For local rpc server access, this allows you to read a user's voice settings and listen for voice events
+   *
+   * @remarks
+   * This scope requires Discord approval to be used
+   */
+  RPCVoiceRead = 'rpc.voice.read',
+  /**
+   * For local rpc server access, this allows you to update a user's voice settings
+   *
+   * @remarks
+   * This scope requires Discord approval to be used
+   */
+  RPCVoiceWrite = 'rpc.voice.write',
+  /**
+   * Allows your app to connect to voice on user's behalf and see all the voice members
+   *
+   * @remarks
+   * This scope requires Discord approval to be used
+   */
+  Voice = 'voice',
+  /** Generate a webhook that is returned in the oauth token response for authorization code grants */
+  WebhookIncoming = 'webhook.incoming',
+}
+
+/** https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-redirect-url-example */
+export interface DiscordTokenExchangeAuthorizationCode {
+  grant_type: 'authorization_code'
+  /** The code for the token exchange */
+  code: string
+  /** The redirect_uri associated with this authorization */
+  redirect_uri: string
+}
+
+/** https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-access-token-response */
+export interface DiscordAccessTokenResponse {
+  /** The access token of the user */
+  access_token: string
+  /** The type of token */
+  token_type: string
+  /** The number of seconds after that the access token is expired */
+  expires_in: number
+  /**
+   * The refresh token to refresh the access token
+   *
+   * @remarks
+   * When the token exchange is a client credentials type grant this value is not defined.
+   */
+  refresh_token: string
+  /** The scopes for the access token */
+  scope: string
+  /** The webhook the user created for the application. Requires the `webhook.incoming` scope */
+  webhook?: DiscordIncomingWebhook
+  /** The guild the bot has been added. Requires the `bot` scope */
+  guild?: DiscordGuild
+}
+
+/**
+ * https://discord.com/developers/docs/topics/oauth2#authorization-code-grant
+ * https://discord.com/developers/docs/topics/oauth2#client-credentials-grant
+ */
+export type DiscordTokenExchange = DiscordTokenExchangeAuthorizationCode | DiscordTokenExchangeRefreshToken | DiscordTokenExchangeClientCredentials
+
+/** https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-refresh-token-exchange-example */
+export interface DiscordTokenExchangeRefreshToken {
+  grant_type: 'refresh_token'
+  /** the user's refresh token */
+  refresh_token: string
+}
+
+/** https://discord.com/developers/docs/topics/oauth2#authorization-code-grant-token-revocation-example */
+export interface DiscordTokenRevocation {
+  /** The access token to revoke */
+  token: string
+  /** Optional, the type of token you are using for the revocation */
+  token_type_hint?: 'access_token' | 'refresh_token'
+}
+
+/** https://discord.com/developers/docs/topics/oauth2#client-credentials-grant */
+export interface DiscordTokenExchangeClientCredentials {
+  grant_type: 'client_credentials'
+  /** The scope(s) for the access token */
+  scope: OAuth2Scope[]
+}
+
+/** https://discord.com/developers/docs/topics/oauth2#get-current-authorization-information-response-structure */
+export interface DiscordCurrentAuthorization {
+  application: DiscordApplication
+  /** the scopes the user has authorized the application for */
+  scopes: OAuth2Scope[]
+  /** when the access token expires */
+  expires: string
+  /** the user who has authorized, if the user has authorized with the `identify` scope */
+  user?: DiscordUser
+}

packages/types/src/discord/opcodes.ts

@@ -0,0 +1,67 @@
+/** Types for: https://discord.com/developers/docs/topics/opcodes-and-status-codes */
+
+/** https://discord.com/developers/docs/topics/opcodes-and-status-codes#gateway-gateway-opcodes */
+export enum GatewayOpcodes {
+  /** An event was dispatched. */
+  Dispatch,
+  /** Fired periodically by the client to keep the connection alive. */
+  Heartbeat,
+  /** Starts a new session during the initial handshake. */
+  Identify,
+  /** Update the client's presence. */
+  PresenceUpdate,
+  /** Used to join/leave or move between voice channels. */
+  VoiceStateUpdate,
+  /** Resume a previous session that was disconnected. */
+  Resume = 6,
+  /** You should attempt to reconnect and resume immediately. */
+  Reconnect,
+  /** Request information about offline guild members in a large guild. */
+  RequestGuildMembers,
+  /** The session has been invalidated. You should reconnect and identify/resume accordingly. */
+  InvalidSession,
+  /** Sent immediately after connecting, contains the `heartbeat_interval` to use. */
+  Hello,
+  /** Sent in response to receiving a heartbeat to acknowledge that it has been received. */
+  HeartbeatACK,
+  /** Used to request soundboard sounds for a list of guilds. */
+  RequestSoundboardSounds = 31,
+}
+
+/** https://discord.com/developers/docs/topics/opcodes-and-status-codes#gateway-gateway-close-event-codes */
+export enum GatewayCloseEventCodes {
+  /** A normal closure of the gateway. You may attempt to reconnect. */
+  NormalClosure = 1000,
+  /** The endpoint is going away. Invalidates bot and bot will appear offline.  */
+  GoingAway = 1001,
+  /** We're not sure what went wrong. Try reconnecting? */
+  UnknownError = 4000,
+  /** You sent an invalid [Gateway opcode](https://discord.com/developers/docs/topics/opcodes-and-status-codes#gateway-gateway-opcodes) or an invalid payload for an opcode. Don't do that! */
+  UnknownOpcode,
+  /** You sent an invalid [payload](https://discord.com/developers/docs/topics/gateway#sending-payloads) to us. Don't do that! */
+  DecodeError,
+  /** You sent us a payload prior to [identifying](https://discord.com/developers/docs/topics/gateway-events#identify), or this session has been invalidated. */
+  NotAuthenticated,
+  /** The account token sent with your [identify payload](https://discord.com/developers/docs/topics/gateway-events#identify) is incorrect. */
+  AuthenticationFailed,
+  /** You sent more than one identify payload. Don't do that! */
+  AlreadyAuthenticated,
+  /** The sequence sent when [resuming](https://discord.com/developers/docs/topics/gateway-events#resume) the session was invalid. Reconnect and start a new session. */
+  InvalidSeq = 4007,
+  /** Woah nelly! You're sending payloads to us too quickly. Slow it down! You will be disconnected on receiving this. */
+  RateLimited,
+  /** Your session timed out. Reconnect and start a new one. */
+  SessionTimedOut,
+  /** You sent us an invalid [shard when identifying](https://discord.com/developers/docs/topics/gateway#sharding). */
+  InvalidShard,
+  /** The session would have handled too many guilds - you are required to [shard](https://discord.com/developers/docs/topics/gateway#sharding) your connection in order to connect. */
+  ShardingRequired,
+  /** You sent an invalid version for the gateway. */
+  InvalidApiVersion,
+  /** You sent an invalid intent for a [Gateway Intent](https://discord.com/developers/docs/topics/gateway#gateway-intents). You may have incorrectly calculated the bitwise value. */
+  InvalidIntents,
+  /** You sent a disallowed intent for a [Gateway Intent](https://discord.com/developers/docs/topics/gateway#gateway-intents). You may have tried to specify an intent that you [have not enabled or are not approved for](https://discord.com/developers/docs/topics/gateway#privileged-intents). */
+  DisallowedIntents,
+}
+
+// TODO: Add HTTPJsonErrorCodes: https://discord.com/developers/docs/topics/opcodes-and-status-codes#json-json-error-codes

packages/types/src/discord/permissions.ts

@@ -0,0 +1,157 @@
+/** Types for: https://discord.com/developers/docs/topics/permissions */
+
+/** https://discord.com/developers/docs/topics/permissions#permissions-bitwise-permission-flags */
+export const BitwisePermissionFlags = {
+  /** Allows creation of instant invites */
+  CREATE_INSTANT_INVITE: 1n << 0n,
+  /** Allows kicking members */
+  KICK_MEMBERS: 1n << 1n,
+  /** Allows banning members */
+  BAN_MEMBERS: 1n << 2n,
+  /** Allows all permissions and bypasses channel permission overwrites */
+  ADMINISTRATOR: 1n << 3n,
+  /** Allows management and editing of channels */
+  MANAGE_CHANNELS: 1n << 4n,
+  /** Allows management and editing of the guild */
+  MANAGE_GUILD: 1n << 5n,
+  /** Allows for the addition of reactions to messages */
+  ADD_REACTIONS: 1n << 6n,
+  /** Allows for viewing of audit logs */
+  VIEW_AUDIT_LOG: 1n << 7n,
+  /** Allows for using priority speaker in a voice channel */
+  PRIORITY_SPEAKER: 1n << 8n,
+  /** Allows the user to go live */
+  STREAM: 1n << 9n,
+  /** Allows guild members to view a channel, which includes reading messages in text channels and joining voice channels */
+  VIEW_CHANNEL: 1n << 10n,
+  /** Allows for sending messages in a channel. (does not allow sending messages in threads) */
+  SEND_MESSAGES: 1n << 11n,
+  /** Allows for sending of /tts messages */
+  SEND_TTS_MESSAGES: 1n << 12n,
+  /** Allows for deletion of other users messages */
+  MANAGE_MESSAGES: 1n << 13n,
+  /** Links sent by users with this permission will be auto-embedded */
+  EMBED_LINKS: 1n << 14n,
+  /** Allows for uploading images and files */
+  ATTACH_FILES: 1n << 15n,
+  /** Allows for reading of message history */
+  READ_MESSAGE_HISTORY: 1n << 16n,
+  /** Allows for using the \@everyone tag to notify all users in a channel, and the \@here tag to notify all online users in a channel */
+  MENTION_EVERYONE: 1n << 17n,
+  /** Allows the usage of custom emojis from other servers */
+  USE_EXTERNAL_EMOJIS: 1n << 18n,
+  /** Allows for viewing guild insights */
+  VIEW_GUILD_INSIGHTS: 1n << 19n,
+  /** Allows for joining of a voice channel */
+  CONNECT: 1n << 20n,
+  /** Allows for speaking in a voice channel */
+  SPEAK: 1n << 21n,
+  /** Allows for muting members in a voice channel */
+  MUTE_MEMBERS: 1n << 22n,
+  /** Allows for deafening of members in a voice channel */
+  DEAFEN_MEMBERS: 1n << 23n,
+  /** Allows for moving of members between voice channels */
+  MOVE_MEMBERS: 1n << 24n,
+  /** Allows for using voice-activity-detection in a voice channel */
+  USE_VAD: 1n << 25n,
+  /** Allows for modification of own nickname */
+  CHANGE_NICKNAME: 1n << 26n,
+  /** Allows for modification of other users nicknames */
+  MANAGE_NICKNAMES: 1n << 27n,
+  /** Allows management and editing of roles */
+  MANAGE_ROLES: 1n << 28n,
+  /** Allows management and editing of webhooks */
+  MANAGE_WEBHOOKS: 1n << 29n,
+  /** Allows for editing and deleting emojis, stickers, and soundboard sounds created by all users */
+  MANAGE_GUILD_EXPRESSIONS: 1n << 30n,
+  /** Allows members to use application commands in text channels */
+  USE_SLASH_COMMANDS: 1n << 31n,
+  /** Allows for requesting to speak in stage channels. */
+  REQUEST_TO_SPEAK: 1n << 32n,
+  /** Allows for editing and deleting scheduled events created by all users */
+  MANAGE_EVENTS: 1n << 33n,
+  /** Allows for deleting and archiving threads, and viewing all private threads */
+  MANAGE_THREADS: 1n << 34n,
+  /** Allows for creating public and announcement threads */
+  CREATE_PUBLIC_THREADS: 1n << 35n,
+  /** Allows for creating private threads */
+  CREATE_PRIVATE_THREADS: 1n << 36n,
+  /** Allows the usage of custom stickers from other servers */
+  USE_EXTERNAL_STICKERS: 1n << 37n,
+  /** Allows for sending messages in threads */
+  SEND_MESSAGES_IN_THREADS: 1n << 38n,
+  /** Allows for launching activities (applications with the `EMBEDDED` flag) in a voice channel. */
+  USE_EMBEDDED_ACTIVITIES: 1n << 39n,
+  /** Allows for timing out users to prevent them from sending or reacting to messages in chat and threads, and from speaking in voice and stage channels */
+  MODERATE_MEMBERS: 1n << 40n,
+  /** Allows for viewing role subscription insights. */
+  VIEW_CREATOR_MONETIZATION_ANALYTICS: 1n << 41n,
+  /** Allows for using soundboard in a voice channel. */
+  USE_SOUNDBOARD: 1n << 42n,
+  /** Allows for creating emojis, stickers, and soundboard sounds, and editing and deleting those created by the current user */
+  CREATE_GUILD_EXPRESSIONS: 1n << 43n,
+  /** Allows for creating scheduled events, and editing and deleting those created by the current user */
+  CREATE_EVENTS: 1n << 44n,
+  /** Allows the usage of custom soundboards sounds from other servers */
+  USE_EXTERNAL_SOUNDS: 1n << 45n,
+  /** Allows sending voice messages */
+  SEND_VOICE_MESSAGES: 1n << 46n,
+  /** Allows sending polls */
+  SEND_POLLS: 1n << 49n,
+  /** Allows user-installed apps to send public responses. When disabled, users will still be allowed to use their apps but the responses will be ephemeral. This only applies to apps not also installed to the server. */
+  USE_EXTERNAL_APPS: 1n << 50n,
+} as const
+
+/** https://discord.com/developers/docs/topics/permissions#permissions-bitwise-permission-flags */
+export type PermissionStrings = keyof typeof BitwisePermissionFlags
+
+/** https://discord.com/developers/docs/topics/permissions#role-object-role-structure */
+export interface DiscordRole {
+  /** Role id */
+  id: string
+  /** If this role is showed separately in the user listing */
+  hoist: boolean
+  /** Permission bit set */
+  permissions: string
+  /** Whether this role is managed by an integration */
+  managed: boolean
+  /** Whether this role is mentionable */
+  mentionable: boolean
+  /** The tags this role has */
+  tags?: DiscordRoleTags
+  /** the role emoji hash */
+  icon?: string
+  /** Role name */
+  name: string
+  /** Integer representation of hexadecimal color code */
+  color: number
+  /** Position of this role (roles with the same position are sorted by id) */
+  position: number
+  /** role unicode emoji */
+  unicode_emoji?: string
+  /** Role flags combined as a bitfield */
+  flags: RoleFlags
+}
+
+/** https://discord.com/developers/docs/topics/permissions#role-object-role-tags-structure */
+export interface DiscordRoleTags {
+  /** The id of the bot this role belongs to */
+  bot_id?: string
+  /** The id of the integration this role belongs to */
+  integration_id?: string
+  /** Whether this is the guild's premium subscriber role */
+  premium_subscriber?: null
+  /** Id of this role's subscription sku and listing. */
+  subscription_listing_id?: string
+  /** Whether this role is available for purchase. */
+  available_for_purchase?: null
+  /** Whether this is a guild's linked role */
+  guild_connections?: null
+}
+
+/** https://discord.com/developers/docs/topics/permissions#role-object-role-flags */
+export enum RoleFlags {
+  None,
+  /** Role can be selected by members in an onboarding prompt */
+  InPrompt = 1 << 0,
+}

packages/types/src/discord/poll.ts

@@ -0,0 +1,93 @@
+/** Types for: https://discord.com/developers/docs/resources/poll */
+
+import type { DiscordEmoji } from './emoji.js'
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/poll#poll-object-poll-object-structure */
+export interface DiscordPoll {
+  /** The question of the poll. Only `text` is supported. */
+  question: DiscordPollMedia
+  /** Each of the answers available in the poll. There is a maximum of 10 answers per poll. */
+  answers: DiscordPollAnswer[]
+  /**
+   * The time when the poll ends.
+   *
+   * @remarks
+   * `expiry` is marked as nullable to support non-expiring polls in the future, but all polls have an expiry currently.
+   */
+  expiry: string | null
+  /** Whether a user can select multiple answers */
+  allow_multiselect: boolean
+  /** The layout type of the poll */
+  layout_type: DiscordPollLayoutType
+  /**
+   * The results of the poll
+   *
+   * @remarks
+   * This value will not be sent by discord under specific conditions where they don't fetch them on their backend. When this value is missing it should be interpreted as "Unknown results" and not as "No results"
+   * The results may not be totally accurate while the poll has not ended. When it ends discord will re-calculate all the results and set {@link DiscordPollResult.is_finalized} to true
+   */
+  results?: DiscordPollResult
+}
+
+/** https://discord.com/developers/docs/resources/poll#layout-type */
+export enum DiscordPollLayoutType {
+  /** The default layout */
+  Default = 1,
+}
+
+/** https://discord.com/developers/docs/resources/poll#poll-media-object-poll-media-object-structure */
+export interface DiscordPollMedia {
+  /**
+   * The text of the field
+   *
+   * @remarks
+   * `text` should always be non-null for both questions and answers, but this is subject to changes.
+   * The maximum length of `text` is 300 for the question, and 55 for any answer.
+   */
+  text?: string
+  /**
+   * The emoji of the field
+   *
+   * @remarks
+   * When creating a poll answer with an emoji, one only needs to send either the `id` (custom emoji) or `name` (default emoji) as the only field.
+   */
+  emoji?: Partial<DiscordEmoji>
+}
+
+/** https://discord.com/developers/docs/resources/poll#poll-answer-object-poll-answer-object-structure */
+export interface DiscordPollAnswer {
+  /**
+   * The id of the answer
+   *
+   * @remarks
+   * This id labels each answer. It starts at 1 and goes up sequentially. Discord recommend against depending on this value as is a implementation detail.
+   */
+  answer_id: number
+  /** The data of the answer */
+  poll_media: DiscordPollMedia
+}
+
+/** https://discord.com/developers/docs/resources/poll#poll-results-object-poll-results-object-structure */
+export interface DiscordPollResult {
+  /** Whether the votes have been precisely counted */
+  is_finalized: boolean
+  /** The counts for each answer */
+  answer_counts: DiscordPollAnswerCount[]
+}
+
+/** https://discord.com/developers/docs/resources/poll#poll-results-object-poll-results-object-structure */
+export interface DiscordPollAnswerCount {
+  /** The {@link DiscordPollAnswer.answer_id | answer_id} */
+  id: number
+  /** The number of votes for this answer */
+  count: number
+  /** Whether the current user voted for this answer */
+  me_voted: boolean
+}
+
+/** https://discord.com/developers/docs/resources/poll#get-answer-voters-response-body */
+export interface DiscordGetAnswerVotesResponse {
+  /** Users who voted for this answer */
+  users: DiscordUser[]
+}

packages/types/src/discord/reference.ts

@@ -0,0 +1,50 @@
+/** Types for: https://discord.com/developers/docs/reference */
+
+/**
+ * https://discord.com/developers/docs/reference#image-formatting
+ *
+ * @remarks
+ * json is only for stickers
+ */
+export type ImageFormat = 'jpg' | 'jpeg' | 'png' | 'webp' | 'gif' | 'json'
+
+/** https://discord.com/developers/docs/reference#image-formatting */
+export type ImageSize = 16 | 32 | 64 | 128 | 256 | 512 | 1024 | 2048 | 4096
+
+/** https://discord.com/developers/docs/reference#locales */
+export enum Locales {
+  Indonesian = 'id',
+  Danish = 'da',
+  German = 'de',
+  EnglishUk = 'en-GB',
+  EnglishUs = 'en-US',
+  Spanish = 'es-ES',
+  SpanishLatam = 'es-419',
+  French = 'fr',
+  Croatian = 'hr',
+  Italian = 'it',
+  Lithuanian = 'lt',
+  Hungarian = 'hu',
+  Dutch = 'nl',
+  Norwegian = 'no',
+  Polish = 'pl',
+  PortugueseBrazilian = 'pt-BR',
+  RomanianRomania = 'ro',
+  Finnish = 'fi',
+  Swedish = 'sv-SE',
+  Vietnamese = 'vi',
+  Turkish = 'tr',
+  Czech = 'cs',
+  Greek = 'el',
+  Bulgarian = 'bg',
+  Russian = 'ru',
+  Ukrainian = 'uk',
+  Hindi = 'hi',
+  Thai = 'th',
+  ChineseChina = 'zh-CN',
+  Japanese = 'ja',
+  ChineseTaiwan = 'zh-TW',
+  Korean = 'ko',
+}
+
+export type Localization = Partial<Record<Locales, string>>

packages/types/src/discord/sku.ts

@@ -0,0 +1,39 @@
+/** Types for: https://discord.com/developers/docs/resources/sku */
+
+/** https://discord.com/developers/docs/resources/sku#sku-object-sku-structure */
+export interface DiscordSku {
+  /** ID of SKU */
+  id: string
+  /** Type of SKU */
+  type: DiscordSkuType
+  /** ID of the parent application */
+  application_id: string
+  /** Customer-facing name of your premium offering */
+  name: string
+  /** System-generated URL slug based on the SKU's name */
+  slug: string
+  /** SKU flags combined as a bitfield */
+  flags: SkuFlags
+}
+
+/** https://discord.com/developers/docs/resources/sku#sku-object-sku-types */
+export enum DiscordSkuType {
+  /** Durable one-time purchase */
+  Durable = 2,
+  /** Consumable one-time purchase */
+  Consumable = 3,
+  /** Represents a recurring subscription */
+  Subscription = 5,
+  /** System-generated group for each SUBSCRIPTION SKU created */
+  SubscriptionGroup = 6,
+}
+
+/** https://discord.com/developers/docs/resources/sku#sku-object-sku-flags */
+export enum SkuFlags {
+  /** SKU is available for purchase */
+  Available = 1 << 2,
+  /** Recurring SKU that can be purchased by a user and applied to a single server. Grants access to every user in that server. */
+  GuildSubscription = 1 << 7,
+  /** Recurring SKU purchased by a user for themselves. Grants access to the purchasing user in every server. */
+  UserSubscription = 1 << 8,
+}

packages/types/src/discord/soundboard.ts

@@ -0,0 +1,23 @@
+/** Types for: https://discord.com/developers/docs/resources/soundboard */
+
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/soundboard#soundboard-sound-object-soundboard-sound-structure */
+export interface DiscordSoundboardSound {
+  /** The name of this sound */
+  name: string
+  /** The id of this sound */
+  sound_id: string
+  /** The volume of this sound, from 0 to 1 */
+  volume: number
+  /** The id of this sound's custom emoji */
+  emoji_id: string | null
+  /** The unicode character of this sound's standard emoji */
+  emoji_name: string | null
+  /** The id of the guild this sound is in */
+  guild_id?: string
+  /** Whether this sound can be used, may be false due to loss of Server Boosts */
+  available: boolean
+  /** The user who created this sound */
+  user?: DiscordUser
+}

packages/types/src/discord/stageInstance.ts

@@ -0,0 +1,18 @@
+/** Types for: https://discord.com/developers/docs/resources/stage-instance */
+
+/** https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-stage-instance-structure */
+// TODO: this is missing a bunch of fields, including: privacy_level, discoverable_disabled
+export interface DiscordStageInstance {
+  /** The topic of the Stage instance (1-120 characters) */
+  topic: string
+  /** The id of this Stage instance */
+  id: string
+  /** The guild id of the associated Stage channel */
+  guild_id: string
+  /** The id of the associated Stage channel */
+  channel_id: string
+  /** The id of the scheduled event for this Stage instance */
+  guild_scheduled_event_id?: string
+}
+
+// TODO: Add DiscordStageInstancePrivacyLevel https://discord.com/developers/docs/resources/stage-instance#stage-instance-object-privacy-level

packages/types/src/discord/sticker.ts

@@ -0,0 +1,73 @@
+/** Types for: https://discord.com/developers/docs/resources/sticker */
+
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-structure */
+export interface DiscordSticker {
+  /** [Id of the sticker](https://discord.com/developers/docs/reference#image-formatting) */
+  id: string
+  /** Id of the pack the sticker is from */
+  pack_id?: string
+  /** Name of the sticker */
+  name: string
+  /** Description of the sticker */
+  description: string
+  /** a unicode emoji representing the sticker's expression */
+  tags: string
+  /** [type of sticker](https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-types) */
+  type: StickerTypes
+  /** [Type of sticker format](https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-format-types) */
+  format_type: StickerFormatTypes
+  /**  Whether or not the sticker is available */
+  available?: boolean
+  /** Id of the guild that owns this sticker */
+  guild_id?: string
+  /** The user that uploaded the sticker */
+  user?: DiscordUser
+  /** A sticker's sort order within a pack */
+  sort_value?: number
+}
+
+/** https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-types */
+export enum StickerTypes {
+  /** an official sticker in a pack */
+  Standard = 1,
+  /** a sticker uploaded to a guild for the guild's members */
+  Guild,
+}
+
+/** https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-format-types */
+export enum StickerFormatTypes {
+  Png = 1,
+  APng,
+  Lottie,
+  Gif,
+}
+
+/** https://discord.com/developers/docs/resources/sticker#sticker-item-object-sticker-item-structure */
+export interface DiscordStickerItem {
+  /** Id of the sticker */
+  id: string
+  /** Name of the sticker */
+  name: string
+  /** [Type of sticker format](https://discord.com/developers/docs/resources/sticker#sticker-object-sticker-format-types) */
+  format_type: StickerFormatTypes
+}
+
+/** https://discord.com/developers/docs/resources/sticker#sticker-pack-object-sticker-pack-structure */
+export interface DiscordStickerPack {
+  /** id of the sticker pack */
+  id: string
+  /** the stickers in the pack */
+  stickers: DiscordSticker[]
+  /** name of the sticker pack */
+  name: string
+  /** id of the pack's SKU */
+  sku_id: string
+  /** id of a sticker in the pack which is shown as the pack's icon */
+  cover_sticker_id?: string
+  /** description of the sticker pack */
+  description: string
+  /** id of the sticker pack's [banner image](https://discord.com/developers/docs/reference#image-formatting) */
+  banner_asset_id?: string
+}

packages/types/src/discord/subscription.ts

@@ -0,0 +1,35 @@
+/** Types for: https://discord.com/developers/docs/resources/subscription */
+
+/** https://discord.com/developers/docs/resources/subscription#subscription-object */
+export interface DiscordSubscription {
+  /** ID of the subscription */
+  id: string
+  /** ID of the user who is subscribed */
+  user_id: string
+  /** List of SKUs subscribed to */
+  sku_ids: string[]
+  /** List of entitlements granted for this subscription */
+  entitlement_ids: string[]
+  /** List of SKUs that this user will be subscribed to at renewal */
+  renewal_sku_ids: string[] | null
+  /** Start of the current subscription period */
+  current_period_start: string
+  /** End of the current subscription period */
+  current_period_end: string
+  /** Current status of the subscription */
+  status: DiscordSubscriptionStatus
+  /** When the subscription was canceled */
+  canceled_at: string | null
+  /** ISO3166-1 alpha-2 country code of the payment source used to purchase the subscription. Missing unless queried with a private OAuth scope. */
+  country?: string
+}
+
+/** https://discord.com/developers/docs/resources/subscription#subscription-statuses */
+export enum DiscordSubscriptionStatus {
+  /** Subscription is active and scheduled to renew. */
+  Active,
+  /** Subscription is active but will not renew. */
+  Ending,
+  /** Subscription is inactive and not being charged. */
+  Inactive,
+}

packages/types/src/discord/teams.ts

@@ -0,0 +1,51 @@
+/** Types for: https://discord.com/developers/docs/topics/teams */
+
+import type { DiscordUser } from './user.js'
+
+/* https://discord.com/developers/docs/topics/teams#team-member-roles-team-member-role-types */
+export enum DiscordTeamMemberRole {
+  /** Owners are the most permissiable role, and can take destructive, irreversible actions like deleting the team itself. Teams are limited to 1 owner. */
+  Owner = 'owner',
+  /** Admins have similar access as owners, except they cannot take destructive actions on the team or team-owned apps. */
+  Admin = 'admin',
+  /**
+   * Developers can access information about team-owned apps, like the client secret or public key.
+   * They can also take limited actions on team-owned apps, like configuring interaction endpoints or resetting the bot token.
+   * Members with the Developer role *cannot* manage the team or its members, or take destructive actions on team-owned apps.
+   */
+  Developer = 'developer',
+  /** Read-only members can access information about a team and any team-owned apps. Some examples include getting the IDs of applications and exporting payout records. */
+  ReadOnly = 'read_only',
+}
+
+/** https://discord.com/developers/docs/topics/teams#data-models-team-object */
+export interface DiscordTeam {
+  /** Hash of the image of the team's icon */
+  icon: string | null
+  /** Unique ID of the team */
+  id: string
+  /** Members of the team */
+  members: DiscordTeamMember[]
+  /** User ID of the current team owner */
+  owner_user_id: string
+  /** Name of the team */
+  name: string
+}
+
+/** https://discord.com/developers/docs/topics/teams#data-models-team-member-object */
+export interface DiscordTeamMember {
+  /** The user's membership state on the team */
+  membership_state: TeamMembershipStates
+  /** The id of the parent team of which they are a member */
+  team_id: string
+  /** The avatar, discriminator, id, username, and global_name of the user */
+  user: Partial<DiscordUser> & Pick<DiscordUser, 'avatar' | 'discriminator' | 'id' | 'username' | 'global_name'>
+  /** Role of the team member */
+  role: DiscordTeamMemberRole
+}
+
+/** https://discord.com/developers/docs/topics/teams#data-models-membership-state-enum */
+export enum TeamMembershipStates {
+  Invited = 1,
+  Accepted,
+}

packages/types/src/discord/user.ts

@@ -0,0 +1,148 @@
+/** Types for: https://discord.com/developers/docs/resources/user */
+
+import type { DiscordIntegration } from './guild.js'
+
+/** https://discord.com/developers/docs/resources/user#user-object-user-structure */
+export interface DiscordUser {
+  /** The user's username, not unique across the platform */
+  username: string
+  /** The user's display name, if it is set. For bots, this is the application name */
+  global_name: string | null
+  /** The user's chosen language option */
+  locale?: string
+  /** The flags on a user's account */
+  flags?: number
+  /** The type of Nitro subscription on a user's account */
+  premium_type?: PremiumTypes
+  /** The public flags on a user's account */
+  public_flags?: number
+  /** the user's banner color encoded as an integer representation of hexadecimal color code */
+  accent_color?: number
+  /** The user's id */
+  id: string
+  /** The user's discord-tag */
+  discriminator: string
+  /** The user's avatar hash */
+  avatar: string | null
+  /** Whether the user belongs to an OAuth2 application */
+  bot?: boolean
+  /** Whether the user is an Official Discord System user (part of the urgent message system) */
+  system?: boolean
+  /** Whether the user has two factor enabled on their account */
+  mfa_enabled?: boolean
+  /** Whether the email on this account has been verified */
+  verified?: boolean
+  /** The user's email */
+  email?: string | null
+  /** the user's banner, or null if unset */
+  banner?: string
+  /** data for the user's avatar decoration */
+  avatar_decoration_data?: DiscordAvatarDecorationData
+}
+
+/** https://discord.com/developers/docs/resources/user#user-object-user-flags */
+export enum UserFlags {
+  DiscordEmployee = 1 << 0,
+  PartneredServerOwner = 1 << 1,
+  HypeSquadEventsMember = 1 << 2,
+  BugHunterLevel1 = 1 << 3,
+  HouseBravery = 1 << 6,
+  HouseBrilliance = 1 << 7,
+  HouseBalance = 1 << 8,
+  EarlySupporter = 1 << 9,
+  TeamUser = 1 << 10,
+  BugHunterLevel2 = 1 << 14,
+  VerifiedBot = 1 << 16,
+  EarlyVerifiedBotDeveloper = 1 << 17,
+  DiscordCertifiedModerator = 1 << 18,
+  BotHttpInteractions = 1 << 19,
+  ActiveDeveloper = 1 << 22,
+}
+
+/** https://discord.com/developers/docs/resources/user#user-object-premium-types */
+export enum PremiumTypes {
+  None,
+  NitroClassic,
+  Nitro,
+  NitroBasic,
+}
+
+/** https://discord.com/developers/docs/resources/user#avatar-decoration-data-object-avatar-decoration-data-structure */
+export interface DiscordAvatarDecorationData {
+  /** the avatar decoration hash */
+  asset: string
+  /** id of the avatar decoration's SKU */
+  sku_id: string
+}
+
+/** https://discord.com/developers/docs/resources/user#connection-object-connection-structure */
+export interface DiscordConnection {
+  /** id of the connection account */
+  id: string
+  /** the username of the connection account */
+  name: string
+  /** the service of this connection */
+  type: DiscordConnectionServiceType
+  /** whether the connection is revoked */
+  revoked?: boolean
+  /** an array of partial server integrations */
+  integrations?: Partial<DiscordIntegration>[]
+  /** whether the connection is verified */
+  verified: boolean
+  /** whether friend sync is enabled for this connection */
+  friend_sync: boolean
+  /** whether activities related to this connection will be shown in presence updates */
+  show_activity: boolean
+  /** whether this connection has a corresponding third party OAuth2 token */
+  two_way_link: boolean
+  /** visibility of this connection */
+  visibility: DiscordConnectionVisibility
+}
+
+/** https://discord.com/developers/docs/resources/user#connection-object-services */
+export enum DiscordConnectionServiceType {
+  AmazonMusic = 'amazon-music',
+  BattleNet = 'battlenet',
+  Bungie = 'Bungie.net',
+  Bluesky = 'bluesky',
+  Crunchyroll = 'crunchyroll',
+  Domain = 'domain',
+  eBay = 'ebay',
+  EpicGames = 'epicgames',
+  Facebook = 'facebook',
+  GitHub = 'github',
+  Instagram = 'instagram',
+  LeagueOfLegends = 'leagueoflegends',
+  Mastodon = 'mastodon',
+  PayPal = 'paypal',
+  PlayStationNetwork = 'playstation',
+  Reddit = 'reddit',
+  RiotGames = 'riotgames',
+  Roblox = 'roblox',
+  Spotify = 'spotify',
+  Skype = 'skype',
+  Steam = 'steam',
+  TikTok = 'tiktok',
+  Twitch = 'twitch',
+  Twitter = 'twitter',
+  Xbox = 'xbox',
+  YouTube = 'youtube',
+}
+
+/** https://discord.com/developers/docs/resources/user#connection-object-visibility-types */
+export enum DiscordConnectionVisibility {
+  /** invisible to everyone except the user themselves */
+  None = 0,
+  /** visible to everyone */
+  Everyone = 1,
+}
+
+/** https://discord.com/developers/docs/resources/user#application-role-connection-object-application-role-connection-structure */
+export interface DiscordApplicationRoleConnection {
+  /** the vanity name of the platform a bot has connected (max 50 characters) */
+  platform_name: string | null
+  /** the username on the platform a bot has connected (max 100 characters) */
+  platform_username: string | null
+  /** object mapping application role connection metadata keys to their stringified value (max 100 characters) for the user on the platform a bot has connected */
+  metadata: Record<string, string>
+}

packages/types/src/discord/voice.ts

@@ -0,0 +1,47 @@
+/** Types for: https://discord.com/developers/docs/resources/voice */
+
+import type { DiscordMemberWithUser } from './guild.js'
+
+/** https://discord.com/developers/docs/resources/voice#voice-state-object-voice-state-structure */
+export interface DiscordVoiceState {
+  /** The session id for this voice state */
+  session_id: string
+  /** The guild id this voice state is for */
+  guild_id?: string
+  /** The channel id this user is connected to */
+  channel_id: string | null
+  /** The user id this voice state is for */
+  user_id: string
+  /** The guild member this voice state is for */
+  member?: DiscordMemberWithUser
+  /** Whether this user is deafened by the server */
+  deaf: boolean
+  /** Whether this user is muted by the server */
+  mute: boolean
+  /** Whether this user is locally deafened */
+  self_deaf: boolean
+  /** Whether this user is locally muted */
+  self_mute: boolean
+  /** Whether this user is streaming using "Go Live" */
+  self_stream?: boolean
+  /** Whether this user's camera is enabled */
+  self_video: boolean
+  /** Whether this user is muted by the current user */
+  suppress: boolean
+  /** The time at which the user requested to speak */
+  request_to_speak_timestamp: string | null
+}
+
+/** https://discord.com/developers/docs/resources/voice#voice-region-object-voice-region-structure */
+export interface DiscordVoiceRegion {
+  /** Unique Id for the region */
+  id: string
+  /** Name of the region */
+  name: string
+  /** true for a single server that is closest to the current user's client */
+  optimal: boolean
+  /** Whether this is a deprecated voice region (avoid switching to these) */
+  deprecated: boolean
+  /** Whether this is a custom voice region (used for events/etc) */
+  custom: boolean
+}

packages/types/src/discord/webhook.ts

@@ -0,0 +1,83 @@
+/** Types for: https://discord.com/developers/docs/resources/webhook */
+
+import type { DiscordChannel } from './channel.js'
+import type { DiscordGuild } from './guild.js'
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/resources/webhook#webhook-object-webhook-structure */
+export type DiscordWebhook = DiscordIncomingWebhook | DiscordApplicationWebhook
+
+/** https://discord.com/developers/docs/resources/webhook#webhook-object-webhook-structure */
+export interface DiscordIncomingWebhook {
+  /** The type of the webhook */
+  type: WebhookTypes
+  /** The secure token of the webhook (returned for Incoming Webhooks) */
+  token?: string
+  /** The url used for executing the webhook (returned by the webhooks OAuth2 flow) */
+  url?: string
+  /** The id of the webhook */
+  id: string
+  /** The guild id this webhook is for */
+  guild_id?: string
+  /** The channel id this webhook is for */
+  channel_id: string
+  /** The user this webhook was created by (not returned when getting a webhook with its token) */
+  user?: DiscordUser
+  /** The default name of the webhook */
+  name: string | null
+  /** The default user avatar hash of the webhook */
+  avatar: string | null
+  /** The bot/OAuth2 application that created this webhook */
+  application_id: string | null
+  /** The guild of the channel that this webhook is following (returned for Channel Follower Webhooks) */
+  source_guild?: Partial<DiscordGuild>
+  /** The channel that this webhook is following (returned for Channel Follower Webhooks) */
+  source_channel?: Partial<DiscordChannel>
+}
+
+/** https://discord.com/developers/docs/resources/webhook#webhook-object-webhook-structure */
+export interface DiscordApplicationWebhook {
+  /** The type of the webhook */
+  type: WebhookTypes.Application
+  /** The secure token of the webhook (returned for Incoming Webhooks) */
+  token?: string
+  /** The url used for executing the webhook (returned by the webhooks OAuth2 flow) */
+  url?: string
+
+  /** The id of the webhook */
+  id: string
+  /** The guild id this webhook is for */
+  guild_id?: string | null
+  /** The channel id this webhook is for */
+  channel_id?: string | null
+  /** The user this webhook was created by (not returned when getting a webhook with its token) */
+  user?: DiscordUser
+  /** The default name of the webhook */
+  name: string | null
+  /** The default user avatar hash of the webhook */
+  avatar: string | null
+  /** The bot/OAuth2 application that created this webhook */
+  application_id: string | null
+  /** The guild of the channel that this webhook is following (returned for Channel Follower Webhooks), field will be absent if the webhook creator has since lost access to the guild where the followed channel resides */
+  source_guild?: Partial<DiscordGuild>
+  /** The channel that this webhook is following (returned for Channel Follower Webhooks), field will be absent if the webhook creator has since lost access to the guild where the followed channel resides */
+  source_channel?: Partial<DiscordChannel>
+}
+
+/** https://discord.com/developers/docs/resources/webhook#webhook-object-webhook-types */
+export enum WebhookTypes {
+  /** Incoming Webhooks can post messages to channels with a generated token */
+  Incoming = 1,
+  /** Channel Follower Webhooks are internal webhooks used with Channel Following to post new messages into channels */
+  ChannelFollower,
+  /** Application webhooks are webhooks used with Interactions */
+  Application,
+}
+
+/** https://discord.com/developers/docs/resources/webhook#create-webhook-json-params */
+export interface DiscordCreateWebhook {
+  /** Name of the webhook (1-80 characters) */
+  name: string
+  /** Image url for the default webhook avatar */
+  avatar?: string | null
+}

packages/types/src/discord/webhookEvents.ts

@@ -0,0 +1,59 @@
+/** Types for: https://discord.com/developers/docs/events/webhook-events */
+
+import type { DiscordApplicationIntegrationType } from './application.js'
+import type { DiscordEntitlement } from './entitlement.js'
+import type { DiscordGuild } from './guild.js'
+import type { OAuth2Scope } from './oauth2.js'
+import type { DiscordUser } from './user.js'
+
+/** https://discord.com/developers/docs/events/webhook-events#payload-structure */
+export interface DiscordEventWebhookEvent {
+  /** Version scheme for the webhook event. Currently always 1 */
+  version: 1
+  /** ID of your app */
+  application_id: string
+  /** Type of webhook, either 0 for PING or 1 for webhook events */
+  type: DiscordWebhookEventType
+  /** Event data payload */
+  event?: DiscordEventWebhookEventBody
+}
+
+/** https://discord.com/developers/docs/events/webhook-events#webhook-types */
+export enum DiscordEventWebhookType {
+  /** PING event sent to verify your Webhook Event URL is active */
+  Ping = 0,
+  /** Webhook event (details for event in event body object) */
+  Event = 1,
+}
+
+/** https://discord.com/developers/docs/events/webhook-events#event-body-object */
+export interface DiscordEventWebhookEventBody {
+  /** Event type */
+  type: DiscordWebhookEventType
+  /** Timestamp of when the event occurred in ISO8601 format */
+  timestamp: string
+  /** Data for the event. The shape depends on the event type */
+  data?: DiscordEventWebhookApplicationAuthorizedBody | DiscordEntitlement
+}
+
+/** https://discord.com/developers/docs/events/webhook-events#event-types */
+export enum DiscordWebhookEventType {
+  /** Sent when an app was authorized by a user to a server or their account */
+  ApplicationAuthorized = 'APPLICATION_AUTHORIZED',
+  /** Entitlement was created */
+  EntitlementCreate = 'ENTITLEMENT_CREATE',
+  /** User was added to a Quest (currently unavailable) */
+  QuestUserEnrollment = 'QUEST_USER_ENROLLMENT',
+}
+
+/** https://discord.com/developers/docs/events/webhook-events#application-authorized-application-authorized-structure */
+export interface DiscordEventWebhookApplicationAuthorizedBody {
+  /** Installation context for the authorization. Either guild (0) if installed to a server or user (1) if installed to a user's account */
+  integration_type?: DiscordApplicationIntegrationType
+  /** User who authorized the app */
+  user: DiscordUser
+  /** List of scopes the user authorized */
+  scopes: OAuth2Scope[]
+  /** Server which app was authorized for (when integration type is 0) */
+  guild?: DiscordGuild
+}

packages/types/src/discordeno.ts

@@ -1,60 +1,66 @@
+import type {
+  ApplicationFlags,
+  DiscordApplicationEventWebhookStatus,
+  DiscordApplicationIntegrationType,
+  DiscordInstallParams,
+} from './discord/application.js'
+import type { AuditLogEvents } from './discord/auditLog.js'
 import type {
   AutoModerationActionType,
   AutoModerationEventTypes,
   AutoModerationTriggerTypes,
-  DiscordApplicationCommandOption,
-  DiscordApplicationCommandOptionChoice,
-  DiscordApplicationEventWebhookStatus,
-  DiscordApplicationIntegrationType,
-  DiscordAttachment,
   DiscordAutoModerationRuleTriggerMetadataPresets,
+} from './discord/autoModeration.js'
+import type {
+  ChannelTypes,
   DiscordChannel,
   DiscordDefaultReactionEmoji,
-  DiscordEmbed,
   DiscordForumTag,
+  ForumLayout,
+  OverwriteTypes,
+  SortOrderTypes,
+  VideoQualityModes,
+} from './discord/channel.js'
+import type {
+  DefaultMessageNotificationLevels,
   DiscordGuildOnboardingMode,
   DiscordGuildOnboardingPrompt,
-  DiscordInstallParams,
-  DiscordInteractionContextType,
-  DiscordInteractionEntryPointCommandHandlerType,
-  DiscordMessageReferenceType,
-  DiscordPollAnswer,
-  DiscordPollLayoutType,
-  DiscordPollMedia,
-  DiscordReactionType,
-  DiscordRole,
-  DiscordScheduledEventRecurrenceRule,
-  DiscordWebhookEventType,
-} from './discord.js'
-import type {
-  AllowedMentionsTypes,
-  ApplicationCommandTypes,
-  ApplicationFlags,
-  AuditLogEvents,
-  BigString,
-  ButtonStyles,
-  Camelize,
-  ChannelTypes,
-  DefaultMessageNotificationLevels,
   ExplicitContentFilterLevels,
-  ForumLayout,
   GuildFeatures,
-  InteractionResponseTypes,
-  Localization,
-  MessageComponentTypes,
-  MessageFlags,
-  OverwriteTypes,
-  PermissionStrings,
+  SystemChannelFlags,
+  VerificationLevels,
+} from './discord/guild.js'
+import type {
+  DiscordScheduledEventRecurrenceRule,
   ScheduledEventEntityType,
   ScheduledEventPrivacyLevel,
   ScheduledEventStatus,
-  SortOrderTypes,
-  SystemChannelFlags,
-  TargetTypes,
+} from './discord/guildScheduledEvent.js'
+import type {
+  ApplicationCommandTypes,
+  ButtonStyles,
+  DiscordApplicationCommandOption,
+  DiscordApplicationCommandOptionChoice,
+  DiscordInteractionContextType,
+  DiscordInteractionEntryPointCommandHandlerType,
+  InteractionResponseTypes,
+  MessageComponentTypes,
   TextStyles,
-  VerificationLevels,
-  VideoQualityModes,
-} from './shared.js'
+} from './discord/interactions.js'
+import type { TargetTypes } from './discord/invite.js'
+import type {
+  AllowedMentionsTypes,
+  DiscordAttachment,
+  DiscordEmbed,
+  DiscordMessageReferenceType,
+  DiscordReactionType,
+  MessageFlags,
+} from './discord/message.js'
+import type { DiscordRole, PermissionStrings } from './discord/permissions.js'
+import type { DiscordPollAnswer, DiscordPollLayoutType, DiscordPollMedia } from './discord/poll.js'
+import type { Localization } from './discord/reference.js'
+import type { DiscordWebhookEventType } from './discord/webhookEvents.js'
+import type { BigString, Camelize } from './shared.js'
 
 /** https://discord.com/developers/docs/resources/channel#create-message-jsonform-params */
 export interface CreateMessageOptions {
@@ -605,6 +611,8 @@ export interface RequestGuildMembers {
   nonce?: string
 }
 
+/** https://discord.com/developers/docs/topics/gateway#request-guild-members */
+
 export interface CreateGuildChannel {
   /** Channel name (1-100 characters) */
   name: string

packages/types/src/index.ts

@@ -1,3 +1,30 @@
-export * from './discord.js'
+export * from './discord/application.js'
+export * from './discord/auditLog.js'
+export * from './discord/autoModeration.js'
+export * from './discord/channel.js'
+export * from './discord/emoji.js'
+export * from './discord/entitlement.js'
+export * from './discord/gateway.js'
+export * from './discord/guild.js'
+export * from './discord/guildScheduledEvent.js'
+export * from './discord/guildTemplate.js'
+export * from './discord/interactions.js'
+export * from './discord/invite.js'
+export * from './discord/message.js'
+export * from './discord/oauth2.js'
+export * from './discord/opcodes.js'
+export * from './discord/permissions.js'
+export * from './discord/poll.js'
+export * from './discord/reference.js'
+export * from './discord/sku.js'
+export * from './discord/soundboard.js'
+export * from './discord/stageInstance.js'
+export * from './discord/sticker.js'
+export * from './discord/subscription.js'
+export * from './discord/teams.js'
+export * from './discord/user.js'
+export * from './discord/voice.js'
+export * from './discord/webhook.js'
+export * from './discord/webhookEvents.js'
 export * from './discordeno.js'
 export * from './shared.js'